KB: SAML SSOログインが「ユーザー名とパスワードの組み合わせが無効です」というエラーで失敗する
解決方法の詳細
接続テストは成功するが、ログインに失敗する
SAML Connection Testが正常に完了し、次のようなメッセージが表示されるため、SAML設定は正しく機能しているように見える場合があります。
Connection Test Successful
You would have been signed in as username@domain.com
しかし、ユーザーがSSO経由でサインインしようとすると、次のようになります。
- IDプロバイダーでの認証は成功します。
- ユーザーはEnterprise Serverにリダイレクトされます。
- Enterprise Serverに次のエラーが表示されます。
"Our system hit a snag, please try again in a moment.
Invalid UserName/Password combination"
ユーザー名の完全一致が必要
Enterprise Serverは、IDプロバイダーから提供されたユーザー名を使用して、既存のEnterprise Serverアカウントを検索し、ユーザーをそのアカウントにマッピングします。
IdPから返されるユーザー名は、Enterprise Server内のユーザーのUsernameフィールドに設定されている値と完全に一致する必要があります。
たとえば、SAML接続テストで次の値が報告されても、
username@domain.com
Enterprise Serverアカウントが次のように設定されている場合、
username
または次のように設定されている場合、
Username@domain.com
値が完全に一致しないため、SSOログインに失敗する可能性があります。
Important:ユーザー名の比較ではcase-sensitive。次の値は異なるものとして扱われます。
username@domain.com
Username@domain.com
このユーザー名のマッピング動作は、ユーザーの認証タイプに関係なく、次の両方に適用されます。
- 組み込み認証
- Windows認証
IDプロバイダーから返されるユーザー名を確認する
- SAML Connection Testを実行して、IDプロバイダーから返されるユーザー名を確認します。
- 返されたユーザー名を、Enterprise Server内のユーザーのUsernameフィールドと比較します。
- スペル、メールアドレスの形式、大文字と小文字がすべて一致していることを確認します。
- 必要に応じてEnterprise Serverのユーザー名を更新します。
- 完全に一致していることを確認しても問題が解決しない場合は、UnifiedLoginログで詳細を確認してください。これらのログは次のパスにあります。
C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
ユーザー名のマッピングを検証して修正する
- Enterprise ServerのWebインターフェースを開きます。
- Admin » Settings » Authenticationに移動します。
- 設定済みのSAML認証プロバイダーを開きます。
- Connection Testを実行します。
- IDプロバイダーでの認証を完了します。
- テストで報告されたユーザー名を記録します。
- Admin » Usersに移動します。
- 該当するユーザーアカウントを開きます。
- Usernameフィールドの値が、大文字と小文字も含めて、SAML接続テストで返された値と完全に一致していることを確認します。
- 必要な変更を保存します。
- SSOログインを再試行します。
補足事項
- SSOユーザーのマッピングは、Enterprise ServerのUsernameフィールドを使用して行われます。
- この動作は、アカウントがBuilt-In認証とWindows認証のどちらを使用しているかに関係なく適用されます。
- ユーザー名の照合ではcase-sensitive。
- さらにトラブルシューティングが必要な場合は、次の場所にあるUnifiedLoginログを確認してください。
C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin - UnifiedLoginログでは、IdPから受信したID情報、ユーザーマッピング、認証処理エラーの詳細を確認できます。
- 期待される結果:Enterprise Serverのユーザー名がIDプロバイダーから提供されたユーザー名と完全に一致すると、ユーザーが既存のアカウントに正常にマッピングされ、SSO認証が正常に完了し、エラーが発生しなくなります。