プラン要件: JWT シングルサインオンには Growth プラン以上が必要で、14 日間の無料トライアルの間はご利用いただけません。見る 14 日間の無料トライアルの内容。
JSON Web Token (JWT) は、当事者間で情報をJSONオブジェクトとして安全に転送するためのコンパクトで自己完結型の方法を定義するオープンスタンダード (RFC 7519) です。この情報はデジタル署名されているため、検証および信頼できます。JWT SSOを使用すると、ユーザーがWebサイトにサインインしたときに、認証情報を再入力しなくても、Website Toolbox フォーラムに自動的にサインインできます。
コンフィギュレーション
JWT SSO を有効にするには:
- Website Toolbox アカウントにログインします。
- に移動 統合 → シングルサインオン。
- [サイトビルダー] で [選択] を選択します カスタム JWT ドロップダウンから。
- あなたのを入力してください クライアントシークレット。この秘密鍵は、サーバーで生成されたトークンを検証するために使用されます。コードで使用されているシークレットと一致する必要があります。
- (オプション) 次のように入力します クライアント発行者 ID。提供されている場合、
キスJWT ペイロードのクレームはこの値と一致する必要があります。
JWT ペイロード属性
JWT ペイロードには次の属性が含まれている必要があります。
| 属性 | タイプ | 必須 | [説明] |
|---|---|---|---|
Eメール |
ひも | はい | ユーザーのメールアドレス |
ユーザー名 |
ひも | いいえ | ユーザーのユーザー名 |
名前 |
ひも | いいえ | ユーザーのフルネーム |
ユーザ ID または 外部ユーザ ID |
整数 | いいえ | システムからのユーザー固有の ID |
アバター URL、 ピクチャ、または アバター_url |
ひも | いいえ | ユーザーのアバター画像の URL。これらの属性名はすべて認識されます。 |
キス |
ひも | いいえ | 発行者識別子。設定でクライアント発行者 ID を設定した場合、この値はそれと一致する必要があります。 |
iat |
整数 | いいえ | Unixエポック形式の発行時タイムスタンプ。入力された場合は、将来使用されないように検証されます |
経験値 |
整数 | いいえ | Unix エポック形式の有効期限タイムスタンプ。トークンを指定した場合、有効期限が切れている場合はトークンは拒否されます |
リダイレクト URL
https://FORUM_DOMAIN/oauth?action=doOauthCallback&service=JWT&code =JWT
FORUM_DOMAIN をご使用のフォーラムドメインに置き換えてください。 置換 JWT JWT トークンを使用してください。
ログインまたは登録後にユーザーを特定のページにリダイレクトするには、を追加します ジャンプ フォーラムと同じドメインを使用する URI でエンコードされたリンク先 URL を含むパラメーター。
サンプルコード
Node.js の例は次の場所にあります。 GitHub。
トラブルシューティング
- を使う HS256 署名アルゴリズム。
- 以下を確認してください クライアントシークレット フォーラム設定と一致します。
- 以下を確認してください Eメール クレームが存在します。
- 設定されている場合は、
キスと一致します クライアント発行者 ID。