Versions Compared

Version Old Version 5 New Version Current
Changes made by

Sachiko Winzer

Yuka Saito

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. レフトサイドナビゲーションから、管理＞システム構成を選択します。
  2. 認証をクリックして、認証方法項目を展開します。



  3. JWTシングルサインオンのトグルを有効にします。
    新しくJWT設定項目が表示されます。こちらから、JWT SSOに関連するすべての設定を行います。



  4. JWT設定項目を展開します。各オプションの詳細は、以下の表に示します。
    Image Removed
    Image Added


...

JWT SSO データベースオプションの設定

YellowfinのJWT設定項目には、JWT SSOを実装するための様々な設定が含まれており、最大限の柔軟性を提供します。次の表および手順に示すように、必要最小限の情報を含めるか、必要に応じてトークンをカスタマイズし、追加の詳細情報を含めるかを選択できます。

JWT設定項目を展開します。各オプションの詳細は、以下の表に示します。

...

Image Added

パラメーター名パラメーターの説明必須項目かどうかデフォルト設定
JWTトークンの配信方法

JWTトークンの配信方法を、URLパラメーター、またはCookieから選択します。

Cookieを選択した場合、JWTトークンは、JWT Cookie名項目のCookie名から取得されます。

NoURLパラメーター
JWT Cookie名この項目は、JWTトークンの配信方法で、Cookieを選択すると表示されます。このパラメーターは、使用されるCookie名を定義します。Noなし
JWT検証キー

JWTトークンの署名を検証するための検証キーを入力します。これはプレーンテキストです。バイナリキーは、Base 64でエンコードすることで渡すことができます。この場合、バイナリ検証キー項目はプレーンテキストに設定する必要があります。

これを使用する場合は、検証キーを入力した後でパスワードを更新ボタンをクリックしてください。
JWTトークンの作成時に、同じ検証キーを入力します。

Yesなし
バイナリ検証キーデフォルトでは、このパラメーターはプレーンテキストに設定されています。セキュリティを強化するには、Base64エンコードを選択します。Noプレーンテキスト
JWTの署名アルゴリズム

デフォルトでは、HMAC256に設定されています。その他のオプションは以下の通りです

HMAC512 , RSA256, RSA384, RSA512, ECD256, ECD384, ECD512

NoHMAC256
JWT発行者このパラメーターは、JWTトークン内の発行者属性を検証します。これを設定した場合、この項目の値は、JWTトークンの発行者項目と比較され、一致しない場合は、トークン検証が失敗します。Noなし
JWT User Id Attributeこのパラメーターは、Yellowfin UserIdを提供します。Yesなし
JWTクライアント参照ID Attributeこのパラメーターは、ユーザーが属するクライアント組織のクライアント参照IDの場所を提供します。通常、関連するクライアント組織を持たないYellowfin インスタンスの場合は、「1」に設定されます。Noなし
SSOエントリーオプション

このパラメータは、JWT SSOプロセスで作成されたセッションに渡されるコンマ区切りのWebサービスセッションパラメータ値を保持するJWT属性を取ります。

より詳細な情報は、カスタムパラメーターおよびパラメーターを使用したデータのカスタマイズ項目を参照してください。

Noなし
SSOカスタムセッション変数Attribute

このパラメーターを使用すると、SSO web サービス呼び出しのパラメーターをオプションを介して渡すことができるオプションを、JWT SSOプロセスにより作成されたセッションに渡すことができます。

これは属性ベースなので、個別のユーザーに適用できます。

より詳細な情報は、カスタムパラメーターおよびパラメーターを使用したデータのカスタマイズ項目を参照してください。

Noなし
JWTオンボーディングこのトグルを有効にすると、新規ユーザーが存在しない場合に、最初のログイン試行時にそのユーザーをプロビジョニングできます。NoOff


...

JWTオンボーディングのデータベースオプション

JWTオンボーディングトグルを有効にした場合、新規ユーザーを最初のログイン試行時に自動的にプロビジョニングすることができます。

パラメーター名パラメーターの説明必須項目かどうかデフォルト設定
First Name Attribute

このパラメーターは、新規ユーザーの名を取得するためのJWT属性の名前を定義します。

新規ユーザーの最初のログイン試行時に自動的にプロビジョニングをするには、これをFirstに設定します。

Yesなし
Surname Attribute

このパラメーターは、新規ユーザーの姓を取得するためのJWT属性の名前を定義します。

新規ユーザーの最初のログイン試行時に自動的にプロビジョニングをするには、これをLastに設定します。

Yesなし
Email Attribute

このパラメーターは、新規ユーザーの電子メールアドレスを取得するためのJWT属性の名前を定義します。これは、Yellowfinログイン時に、ユーザー名として使用されます。

新規ユーザーの最初のログイン試行時に自動的にプロビジョニングをするには、これをUserIdに設定します。

Yesなし
Language Attributeこのパラメーターは、新規ユーザーの言語コードを取得するためのJWT属性の名前を定義します。Noシステムのデフォルト
Password Attributeこのパラメーターは、新規ユーザーのパスワードを取得するためのJWT属性の名前を定義します。Noランダムのパスワード（32の英数字文字列）
Role Attribute

このパラメーターは、新規ユーザーのロールを取得するためのJWT属性の名前を定義します。これを省略した場合は、新規ユーザーにデフォルトのロールが割り当てられます。

Noデフォルトに設定してあるロール（詳細は、こちらを参照してください）
予備のロールこのドロップダウンリストでは、Role Attribute項目に入力したロールが、新規ユーザーのプロビジョニングに使用できない場合の予備のロールを選択できます。Noデフォルトに設定してあるロール（詳細は、こちらを参照してください）


...

Yellowfinで使用するJWTトークンの作成

JWTトークンの作成は、サードパーティ製ソフトウェアを介して行われるため、次の手順は、前述のオプションを独自のJWTトークンに統合する方法の例を紹介しています。これらの手順は、基本的なガイドとしてのみご利用ください。

...

  1. お好みのJWT トークンクリエイターへ移動します（今回の例では、 https://jwt.io/を使用しています）
  2. 最低限として、右側のPayload項目にユーザー名を追加します。
    Image Removed
    Image Added

    これは、YellowfinのJWT User Id Attribute項目に追加した内容と一致しなくてはいけません。



  3. JWT検証キー項目で検証キーを使用している場合は、右下のsignature項目内のテキスト項目に同じキーを入力します。
    Image Removed
    Image Added

    参考として、左側のカラーコーディングは、JWTトークンがどのように作成されるかを示しています。
  4. 左側のエンコードされたトークンをコピーします。
  5. Yellowfin URLの最後に、JWTトークンログインおよびクエリー文字列を追加します。
    JWTLogin.i4?jwtToken=
  6. クエリー文字列の最後に、エンコードされたトークンを貼り付けます。
    Image Removed
    Image Added

    JWT payloadで指定したユーザーが、自動的にログインします。

...

  1. お好みのJWT トークンクリエイターへ移動します（今回の例では、 https://jwt.io/を使用しています）
  2. 最低限として、右側のPayload項目にユーザー名、姓、名を追加します。
    Image Removed
    Image Added

    これは、それぞれ対応するYellowfinの項目に追加した内容と一致しなくてはいけません。



  3. JWT検証キー項目で検証キーを使用している場合は、右下のsignature項目内のテキスト項目に同じキーを入力します。
    Image Removed
    Image Added

    参考として、左側のカラーコーディングは、JWTトークンがどのように作成されるかを示しています。
  4. 左側のエンコードされたトークンをコピーします。
  5. Yellowfin URLの最後に、JWTトークンログインおよびクエリー文字列を追加します。
    JWTLogin.i4?jwtToken=
  6. クエリー文字列の最後に、エンコードされたトークンを貼り付けます。
    Image Removed
    Image Added

JWT payloadで指定した新規ユーザーが、自動的にログインします。クライアント組織が複数設定されている場合は、所属する組織を選択するように促されます。

...

  1. JWT設定項目を展開し、JWTトークンの配信方法でCookieを選択します。


    新しい項目として、JWT Cookie名が表示されます。
  2. JWT Cookie名項目に、Cookie名を入力します。



  3. ブラウザで開発者ツールコンソールを開き、ツールを使用して既存のCookieを表示します。
    Image Removed
    Image Added

  4. ブラウザの開発者ツールを使用して、新しいCookieを追加します。以下を確認してください。
    ・YellowfinのJWT Cookie名項目と名前が一致していること
    ・トークン作成に使用したツールからエンコードされたJWTトークンをコピーし、新しいCookieの値カラム（列）に貼り付けます。
    Image RemovedImage Added

  5. Yellowfinのインスタンスにアクセスするために、JWT ログインURLを入力します（例： http://localhost:8080/JWTLogin.i4）

...