はじめに

JWTが必要な理由とは？

1. JWTベースのユーザー認証は、Zoho Deskポータルでシングルサインオン（SSO）が有効になっている場合にのみ可能です。SSOを使用すると、エンドユーザーが様々なサポートシステムにアクセスするために、複数のサインイン認証情報を使用する必要がなくなります。SSOが有効になっていない場合、エンドユーザーはゲストユーザーとしてのみ、どこでもサポートのアドオンにアクセスできます。
                     
   
2. ポータル内のマルチブランドのヘルプセンターではなく、初期設定のヘルプセンターでシングルサインオン（SSO）が有効になっていることをご確認ください。

図1：どこでもサポートのアドオンでのJWTの実装

• JWTエンドポイント
  
• JWTシークレット
  

import io.jsonwebtoken.SignatureAlgorithm;

import javax.crypto.spec.SecretKeySpec;

import java.security.Key;

import io.jsonwebtoken.JwtBuilder;

import io.jsonwebtoken.Jwts;

import java.io.UnsupportedEncodingException;

 

 

public static String generateJwt(String userToken) throws UnsupportedEncodingException{

 String secretKey = "; //この値はアドオンが作成された後に付与されます。次に、こちらで指定された値を置き換えます

long notBeforeMillis = System.currentTimeMillis();

long notAfterMillis = notBeforeMillis + 300000;

 

SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256;

 

byte[] apiKeySecretBytes = secretKey.getBytes();

Key signingKey = new SecretKeySpec(apiKeySecretBytes, signatureAlgorithm.getJcaName());

 

JwtBuilder builder = Jwts.builder().signWith(signatureAlgorithm, signingKey);

 

String jwt = builder.claim("email_verified", true)

.claim("not_after", notAfterMillis)

.claim("not_before", notBeforeMillis)

.claim("email", <user_email_address_from_user_token>).compact();

return jwt;

}   

• userToken は、アプリから受信したユーザートークンを入力するパラメーターです。このパラメーターには、アプリにサインインしているユーザーの詳細が表示されます。したがって、ユーザートークンが、アプリからZohoのIAMサーバーを経由してJWTエンドポイントに送信されるときに、暗号化されていることを確認してください。JWTエンドポイントでは、ユーザートークンを復号し、信頼性を確認する必要があります。 
  
• email のパラメーターは、ユーザーのメールアドレスを返します。 
  
• email_verified は、メールアドレスが認証されているかどうかを返す、ブーリアン型（論理型）のパラメーターです。その後、OAuthのトークンをどこでもサポートのアドオンに送信します。 
  
• not_before と not_after パラメーターは、JWTの期限が切れるまでの期間を定義します。これらのパラメーターの値は、協定世界時（UTC：Coordinated Universal Time）形式で、ミリ秒単位で指定する必要があります。 
  
• 強力なセキュリティを確保するために、not_beforeパラメーターとnot_afterパラメーターの時間差が、600,000ミリ秒（10分）を超えないようにしてください。 
  

JWTの仕組みとは？

• ユーザートークンが無効な場合は、JWTレスポンスが、 email_verified パラメーターの値がfalseに設定されたまま、返送されます。
  
• IAMサーバーが、有効なJWTレスポンスを受信すると、エンドユーザーをヘルプデスクポータルのユーザーとみなすOAuth2トークンを送信します。 
  

どこでもサポートのアドオンの場合、JWTを取得するためには、セキュリティ上の理由から、GETメソッドを使用する必要があります。

留意事項

• JWTのURLは、設定ページでいつでも変更できます。 
  
• URLには、ユーザー情報をJWTサーバーに渡すための「user_token」というパラメーターを含める必要があります。 
  
• JWTレスポンスは、プレーンな文字列として返される必要があります。 
  
• JWTレスポンスには、 email 、 email_verified 、 not_before 、 not_after の各パラメーターを含める必要があります。
  
• アプリサーバー時間の変更は、 not_before と not_after パラメーターで設定した値に影響を与える可能性があります。そのため、アプリケーションサーバーの時刻が変更された場合は、JWTコードを必ず修正してください。  
  
• 現在、署名にはHMACSHA256アルゴリズムのみがサポートされています。 
  

関連情報：

どこでもサポートのWeb用のアドオンの利用

iOS向けどこでもサポートSDKの利用

Android向けどこでもサポートSDKの利用