ご自身やチームメンバーがSAML SSOでAI Studiosにログインできない場合、原因は通常、IDプロバイダー (IdP) の設定ミスです。このガイドでは、よくある原因とその解決方法を説明します。
SAML SSOを使用していることを確認する
AI StudiosはSAML 2.0ベースのSSOに対応しています。OAuthやOpenIDなど、その他のプロトコルには対応していません。
SSOを使うには、会社に次のものが必要です:
SAMLに対応したIDプロバイダー (例: Okta、Microsoft Entra ID / Azure AD)
正しく設定されたSAMLアプリケーション
ワークスペースでSSOを使っているかわからない場合は、IT部門またはワークスペース管理者にお問い合わせください。
よくある問題と解決方法
1. IdPのログインアカウントとAI Studiosのログインメールが完全に一致していない (大文字と小文字を区別)
• MS Entra IDでログインすると、Unique User Identifierの値がAI Studiosに渡されます • この値は、AI Studiosのログインメールと (大文字・小文字も含めて) 完全に一致している必要があります
解決方法
ケース1. Unique User Identifierに指定する値を変更する
Unique User Identifierをuser.displaynameに変更します
各ユーザーのDisplay nameを、AI Studiosのログインメールと (大文字・小文字も含めて) 完全に一致させます
Microsoft Entra IDでUnique User Identifierを変更する手順
Microsoft Entra IDでUnique User Identifierを変更する手順
ステップ1：Microsoft Entra IDで、AI StudiosアプリのAttributes & Claimsに移動します。
Unique User Identifierの行を探し、Editをクリックします。
ステップ2：編集ページで、もう一度Unique User Identifierの項目を探します。
その行の右側にある3点メニューをクリックします。
ステップ3：Manage Claimメニューで、Source attributeのテキストボックスを探します。
デフォルトではuser.userprincipalnameに設定されている場合が多いです。この値を次のように変更します:
user.displayname
ステップ5：Saveをクリックします。
ステップ6：すべてのユーザーで、AI Studiosのログインメールが表示名 (Display name) に設定されていることを確認します。
ケース2. Unique User Identifierを小文字で渡すように設定する !! 前提条件 !!
この方法は、User principal nameがAI Studiosのログインメールと大文字・小文字の違いを除いて完全に一致している場合にのみ使えます
TransformationをToLowercase(user.userprincipalname)に設定します
Microsoft Entra IDでTransformationを管理する手順
Microsoft Entra IDでTransformationを管理する手順
ステップ1：Microsoft Entra IDで、AI StudiosアプリのAttributes & Claimsに移動します。
Unique User Identifierの行を探し、Editをクリックします。
ステップ2：編集ページで、もう一度Unique User Identifierの項目を探します。
その行の右側にある3点メニューをクリックします。
ステップ3：Sourceの設定をTransformationに変更します。デフォルトではAttributeに設定されています。
ステップ4：Manage Transformationメニューで、TransformationをToLowercase() に設定します。
ステップ5：Parameter 1をattributeに設定します。次に、Attribute Nameメニューでuser.userprincipalnameを選択します。
ステップ6：Saveし、このTransformationがUnique User Identifierの下に正しく保存されていることを再確認します。ToLowercase (user.userprincipalname) と表示されていれば正しく設定されています
2. ワークスペースの設定が完了していない
SSOのログインリンクが機能しない場合、ワークスペースのSSO設定が未完了または無効になっている可能性があります。
解決方法
ワークスペース管理者は次の操作を行ってください:
プロフィール画像をクリックし、Settingを選択して、左メニューのSAML SSOをクリックします
IdPの項目がすべて入力されていることを確認します
SSOのトグルがオンになっていることを確認します
ACS URLとEntity IDがIdPに正しくコピーされていることを確認します
3. IdPの情報または証明書が正しくない
次のいずれかが正しくない場合、SSOが失敗することがあります:
SSO Login URL
IdP Issuer
X.509証明書
証明書の有効期限
解決方法
IDプロバイダーの設定を、AI Studiosに表示される項目と照らし合わせて再確認してください:
ACS URL / Callback URL
Audience URI / SP Entity ID
X.509 Certificate
それでも解決しない場合
上記をすべて確認してもSSOが機能しない場合:
IdPのSAML設定のスクリーンショットを撮ります
ログイン時に使ったメールアドレスを控えます
これらの情報を添えて、担当のアカウントマネージャーにご連絡ください
そこからトラブルシューティングをお手伝いします。