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 の担当者に有効化を依頼する必要があります。
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 を SAML 2.0 アプリケーションとして登録します。メニュー名は IdP によって異なるため、各値について IdP に表示されている用語を使用してください。
- Treasure AI 用の新しい SAML 2.0 アプリケーションを作成します。ユーザーが認識しやすい名前を付けてください。
- Assertion Consumer Service(ACS)URL を設定します。IdP によっては、Single Sign-On URL、Reply URL、Recipient URL と呼ばれます。値は
https://sso.treasuredata.com/login/callbackです。この値は、すべてのサイトとリージョンで共通です。 - Audience URI(SP Entity ID)に、前述の「Treasure AI の値を取得する」で確認した Entity ID を設定します。
- NameID 形式を
unspecifiedまたはemailAddressに設定します。各ユーザーを識別する属性(メールアドレスやカスタム識別子など)を選択してください。IdP が送信する値は、Treasure コンソール でユーザーに設定した識別子と一致させる必要があります。詳細は、後述の「ユーザーを追加し、識別子を設定する」を参照してください。 - IdP からサインインエンドポイント URL を取得します。必要に応じて、サインアウトエンドポイント URL も取得します。
.pem形式の署名証明書をダウンロードします。IdP がメタデータ XML ファイルを提供している場合は、そのファイルをダウンロードします。
ACS フィールドに Treasure のサインイン URL を入力しないでください。ACS URL は https://sso.treasuredata.com/login/callback です。サインイン URL は、ユーザーがサインインを開始するアドレスです。
IdP が Identity Provider Name のリストに表示される場合は、このセクションの手順に従って Treasure コンソール で Sign-in Settings を設定します。リストに表示されない場合は、コンソールには表示されないため、代わりに REST API で設定します。詳細は、後述の「REST API で Sign-in Settings を設定する」を参照してください。
Sign-in Settings を変更する前に、再認証が求められる場合があります。
- Treasure コンソール を開き、Control Panel を選択します。
- Sign-in Settings を選択します。Account Name と Entity ID は、あらかじめ入力されています。
- 編集ツールを選択します。
- Identity Provider Name のリストから、使用する IdP を選択します。
- Sign-in Endpoint URL に、IdP がサインインに使用する URL を入力します。
- 任意で、Sign-out Endpoint URL を入力します。
- Certificate File に、
.pem形式の証明書をアップロードします。IdP がメタデータ XML ファイルを提供している場合は、手順 5 から 7 で値を入力する代わりに、そのファイルをアップロードできます。 - Save を選択します。
IdP が Identity Provider Name のリストにない場合は、REST API を使用します。このリクエストで、Treasure アカウントの SSO 設定が作成されます。すべてのリクエストパラメーターについては、Identity Federation の REST API を参照してください。
- IdP から、サインインエンドポイント URL と X.509 証明書を取得します。IdP が提供している場合は、サインアウトエンドポイント URL も取得します。
- 証明書を 1 行に変換します。
-----BEGIN CERTIFICATE-----と-----END CERTIFICATE-----の行は残し、各 base64 の行は\r\nで区切ります。 - 次の内容で
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-----"
}
}<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.comAPI_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が返されます。同じシェルで 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 などのカスタム識別子を使用することもできます。
ユーザーを追加するには、次の手順に従います。
- Treasure コンソール で Control Panel > Users を選択します。
- Add User を選択します。ユーザーのメールアドレスを入力し、Sign-in Method のリストから IdP を選択して、Unique Identifier として Same as email address を選択します。
- Add を選択します。
- IdP で、そのユーザーを Treasure AI のアプリケーションに割り当てます。割り当てられていないユーザーは、サインインを完了できません。
既存のユーザーを SSO に変更するには、ユーザーを選択し、Details の下の編集ペンシルを選択します。Personal Info ダイアログで Sign-in Method のリストから IdP を選択し、Save を選択します。
IdP で割り当て済みのユーザーを使用して、接続をテストします。
- Sign-in Settings で Copy Console Sign-in URL を選択し、その URL をブラウザで開きます。
- IdP のサインインページに表示されるとおりにメールアドレスまたは ID を入力し、認証を完了します。
- Treasure コンソール が表示されることを確認します。My Settings でサインイン方法を確認することもできます。
日常的なサインインの動作については、SSO ユーザーとしてのサインインを参照してください。
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 になっている必要があります。取得したデータには認証情報が含まれるため、機密情報として扱ってください。
次のいずれかが原因である場合が多くあります。
- IdP のダッシュボードからサインインを開始した。代わりに Treasure のサインイン URL からサインインを開始してください。
- ユーザーの Unique Identifier が、IdP から送信される識別子と一致していない。ユーザーの Personal Info ダイアログで、識別子が一致するように設定してください。
- NameID 形式が認識されていない。IdP の NameID 形式を
unspecifiedまたはemailAddressに設定してください。
ユーザーが IdP で Treasure AI のアプリケーションに割り当てられているか、また Treasure コンソール でそのユーザーの Sign-in Method が IdP に設定されているかを確認してください。
次の点を確認してください。
- 証明書の各行の間に
\r\nがあり、BEGINとENDの行が含まれていること。 setting_nameが、アカウント内の SSO 設定ごとに一意であること。- API キーに SSO を設定する権限があること。