Skip to content
Last updated

SAML 2.0 Identity Provider の SSO 設定

Treasure AI のシングルサインオン(SSO)は SAML 2.0 プロトコルを使用するため、SAML 2.0 をサポートする Identity Provider(IdP)を Treasure アカウントに接続できます。IdP を接続すると、ユーザーは会社で管理している認証情報を使って Treasure コンソール にサインインでき、IdP で設定したサインインポリシーがそのユーザーにも適用されます。IdP に専用のセットアップガイドがない場合は、このページを使用してください。Okta、Microsoft Entra ID、PingFederate、PingOne など専用ガイドがある IdP の場合は、シングルサインオンに記載されているプロバイダーのガイドに従ってください。

始める前に

開始する前に、次の項目を確認してください。

  • SSO が Treasure アカウントで有効になっていること。有効化するには、Customer Success の担当者に連絡してください。担当者からアカウント名と Entity ID が提供されます。
  • Treasure コンソール で Owner または管理者の権限があること。
  • IdP で管理者の権限があり、SAML アプリケーションを作成してユーザーを割り当てられること。
  • Identity Provider Name のリストにない IdP の場合は、Treasure AI の API キーが必要です。API キーは、Treasure コンソール の My Settings から取得します。
  • IdP から、サインインエンドポイント URL と、.pem 形式の署名証明書またはメタデータ XML ファイルを取得できること。サインアウトエンドポイント URL は任意です。

制限事項

SSO を設定する前に、次の制限事項を確認してください。

  • Treasure AI は SP 起点のサインインのみをサポートします。 ユーザーは、Treasure のサインイン URL からサインインを開始する必要があります。このURL は、後述の「Treasure AI の値を取得する」セクションで説明しています。IdP のダッシュボードにあるアプリケーションのタイルからサインインを開始する方法(IdP 起点のサインイン)はサポートされていません。
  • SSO を有効にすると、そのアカウントのユーザーは Google SSO でのサインインが無効になります。
  • Treasure AI は IdP からユーザーを取り込みません。 Control Panel > Users でユーザーを 1 人ずつ追加し、そのサインイン方法を IdP に設定してください。
  • SSO 用に追加したユーザーには、招待メールは届きません。
  • 1 つのアカウントで複数の IdP を使用するには、Customer Success の担当者に有効化を依頼する必要があります。

Treasure AI の値を取得する

Customer Success の担当者が、Treasure アカウントのアカウント名を提供します。Entity ID は、Treasure コンソール の Sign-in Settings に表示されます。Entity ID の形式は次のとおりです。

urn:treasuredata:sso:<SITE>:<ACCOUNT_NAME>

<SITE> は、Treasure アカウントのサイトに置き換えます。aws、aws-tokyo、eu01、ap02 のいずれかです。<ACCOUNT_NAME> は、アカウント名に置き換えます。

ユーザーは次の URL からサインインを開始します。リージョンに応じたサインイン URL として使用してください。

  • US: https://console.us01.treasuredata.com/users/initiate_sso?account_name=<ACCOUNT_NAME>
  • Japan: https://console.treasuredata.co.jp/users/initiate_sso?account_name=<ACCOUNT_NAME>
  • Europe: https://console.eu01.treasuredata.com/users/initiate_sso?account_name=<ACCOUNT_NAME>

その他のリージョンの場合は、Customer Success の担当者から提供されるサインイン URL を使用してください。

IdP に Treasure AI を登録する

IdP の管理者が、Treasure AI を SAML 2.0 アプリケーションとして登録します。メニュー名は IdP によって異なるため、各値について IdP に表示されている用語を使用してください。

  1. Treasure AI 用の新しい SAML 2.0 アプリケーションを作成します。ユーザーが認識しやすい名前を付けてください。
  2. Assertion Consumer Service(ACS)URL を設定します。IdP によっては、Single Sign-On URL、Reply URL、Recipient URL と呼ばれます。値は https://sso.treasuredata.com/login/callback です。この値は、すべてのサイトとリージョンで共通です。
  3. Audience URI(SP Entity ID)に、前述の「Treasure AI の値を取得する」で確認した Entity ID を設定します。
  4. NameID 形式を unspecified または emailAddress に設定します。各ユーザーを識別する属性(メールアドレスやカスタム識別子など)を選択してください。IdP が送信する値は、Treasure コンソール でユーザーに設定した識別子と一致させる必要があります。詳細は、後述の「ユーザーを追加し、識別子を設定する」を参照してください。
  5. IdP からサインインエンドポイント URL を取得します。必要に応じて、サインアウトエンドポイント URL も取得します。
  6. .pem 形式の署名証明書をダウンロードします。IdP がメタデータ XML ファイルを提供している場合は、そのファイルをダウンロードします。

ACS フィールドに Treasure のサインイン URL を入力しないでください。ACS URL は https://sso.treasuredata.com/login/callback です。サインイン URL は、ユーザーがサインインを開始するアドレスです。

Treasure コンソール で Sign-in Settings を設定する

IdP が Identity Provider Name のリストに表示される場合は、このセクションの手順に従って Treasure コンソール で Sign-in Settings を設定します。リストに表示されない場合は、コンソールには表示されないため、代わりに REST API で設定します。詳細は、後述の「REST API で Sign-in Settings を設定する」を参照してください。

Sign-in Settings を変更する前に、再認証が求められる場合があります。

  1. Treasure コンソール を開き、Control Panel を選択します。
  2. Sign-in Settings を選択します。Account Name と Entity ID は、あらかじめ入力されています。
  3. 編集ツールを選択します。
  4. Identity Provider Name のリストから、使用する IdP を選択します。
  5. Sign-in Endpoint URL に、IdP がサインインに使用する URL を入力します。
  6. 任意で、Sign-out Endpoint URL を入力します。
  7. Certificate File に、.pem 形式の証明書をアップロードします。IdP がメタデータ XML ファイルを提供している場合は、手順 5 から 7 で値を入力する代わりに、そのファイルをアップロードできます。
  8. Save を選択します。

REST API で Sign-in Settings を設定する

IdP が Identity Provider Name のリストにない場合は、REST API を使用します。このリクエストで、Treasure アカウントの SSO 設定が作成されます。すべてのリクエストパラメーターについては、Identity Federation の REST API を参照してください。

  1. IdP から、サインインエンドポイント URL と X.509 証明書を取得します。IdP が提供している場合は、サインアウトエンドポイント URL も取得します。
  2. 証明書を 1 行に変換します。-----BEGIN CERTIFICATE----- と -----END CERTIFICATE----- の行は残し、各 base64 の行は \r\n で区切ります。
  3. 次の内容で sso_setting.json という名前のファイルを作成します。各プレースホルダーを実際の値に置き換えてください。setting_name には、スペースを含まない一意の値を設定します。IdP にサインアウトエンドポイントがない場合は、sign_out_endpoint に null を設定します。
{
  "sso_setting": {
    "strategy": "samlp",
    "identity_provider_name": "<IDP_DISPLAY_NAME>",
    "setting_name": "<UNIQUE_SETTING_NAME>",
    "sign_in_endpoint": "<SIGN_IN_ENDPOINT_URL>",
    "sign_out_endpoint": "<SIGN_OUT_ENDPOINT_URL>",
    "cert": "-----BEGIN CERTIFICATE-----\r\n<CERTIFICATE_LINES>\r\n-----END CERTIFICATE-----"
  }
}
  1. <API_BASE_URL> をアカウントのリージョンに対応する Treasure API のベース URL に、<YOUR_API_KEY> を Treasure コンソールの My Settings で取得した API キーに置き換えます。POST と GET には同じベース URL を使用します。リージョン別のエンドポイントの詳細は、Treasure API のベース URL 一覧を参照してください。

    アカウントのリージョンTreasure API のベース URL
    米国(US01)https://api.treasuredata.com
    日本(AP01)https://api.treasuredata.co.jp
    欧州(EU01)https://api.eu01.treasuredata.com
    韓国(AP02)https://api.ap02.treasuredata.com
    API_BASE_URL='<API_BASE_URL>'
    curl -X POST "${API_BASE_URL}/v3/account/sso_setting" \
      -H "Authorization: TD1 <YOUR_API_KEY>" \
      -H "Content-Type: application/json" \
      -d @sso_setting.json

    成功すると、保存された sso_setting とともに 200 OK が返されます。

  2. 同じシェルで GET リクエストを送信し、保存された設定を確認します。<YOUR_API_KEY> は手順 4 と同じ API キーに置き換えます。

    curl --request GET \
      --url "${API_BASE_URL}/v3/account/sso_setting" \
      --header 'Authorization: TD1 <YOUR_API_KEY>'

ユーザーを追加し、識別子を設定する

Treasure AI は、IdP から送信された識別子を、Treasure コンソール の各ユーザーの Unique Identifier と照合します。デフォルトの識別子はユーザーのメールアドレスです。IdP がその値を送信する場合は、社員 ID などのカスタム識別子を使用することもできます。

ユーザーを追加するには、次の手順に従います。

  1. Treasure コンソール で Control Panel > Users を選択します。
  2. Add User を選択します。ユーザーのメールアドレスを入力し、Sign-in Method のリストから IdP を選択して、Unique Identifier として Same as email address を選択します。
  3. Add を選択します。
  4. IdP で、そのユーザーを Treasure AI のアプリケーションに割り当てます。割り当てられていないユーザーは、サインインを完了できません。

既存のユーザーを SSO に変更するには、ユーザーを選択し、Details の下の編集ペンシルを選択します。Personal Info ダイアログで Sign-in Method のリストから IdP を選択し、Save を選択します。

サインインをテストする

IdP で割り当て済みのユーザーを使用して、接続をテストします。

  1. Sign-in Settings で Copy Console Sign-in URL を選択し、その URL をブラウザで開きます。
  2. IdP のサインインページに表示されるとおりにメールアドレスまたは ID を入力し、認証を完了します。
  3. Treasure コンソール が表示されることを確認します。My Settings でサインイン方法を確認することもできます。

日常的なサインインの動作については、SSO ユーザーとしてのサインインを参照してください。

トラブルシューティング

サインイン後に Treasure コンソール のデフォルトのサインインページに戻る

IdP の ACS URL が https://sso.treasuredata.com/login/callback 以外に設定されているか、Treasure のサインイン URL が ACS URL として入力されている可能性があります。IdP の ACS URL を https://sso.treasuredata.com/login/callback に設定し、Treasure コンソール のサインインエンドポイントが IdP の URL であることを確認してください。

SAML レスポンスを確認するには、ブラウザの SAML トレーシングツールでサインインの通信を取得します。レスポンスの Destination 属性と SubjectConfirmationData の Recipient 属性が、どちらも https://sso.treasuredata.com/login/callback になっている必要があります。取得したデータには認証情報が含まれるため、機密情報として扱ってください。

サインイン時に「Oops, something went wrong」と表示される

次のいずれかが原因である場合が多くあります。

  • IdP のダッシュボードからサインインを開始した。代わりに Treasure のサインイン URL からサインインを開始してください。
  • ユーザーの Unique Identifier が、IdP から送信される識別子と一致していない。ユーザーの Personal Info ダイアログで、識別子が一致するように設定してください。
  • NameID 形式が認識されていない。IdP の NameID 形式を unspecified または emailAddress に設定してください。

IdP の認証は成功するが、サインインに失敗する

ユーザーが IdP で Treasure AI のアプリケーションに割り当てられているか、また Treasure コンソール でそのユーザーの Sign-in Method が IdP に設定されているかを確認してください。

REST API のリクエストが失敗する

次の点を確認してください。

  • 証明書の各行の間に \r\n があり、BEGIN と END の行が含まれていること。
  • setting_name が、アカウント内の SSO 設定ごとに一意であること。
  • API キーに SSO を設定する権限があること。

次のステップ