KB: SAML SSOログインが「ユーザー名とパスワードの組み合わせが無効です」というエラーで失敗する

Altium On-Prem Enterprise Server Altium On-Prem Enterprise Server
Altium On-Prem Enterprise Server(AES)で SAML シングルサインオン(SSO)を使用している場合、SAML 接続テストは正常に完了しても、実際の SSO 認証は次のエラーで失敗することがあります。 「システムで問題が発生しました。しばらくしてからもう一度お試しください。 ユーザー名とパスワードの組み合わせが正しくありません。」 これは、ID プロバイダー(IdP)から返されるユーザー名が、対応する Enterprise Server ユーザーアカウントの[Username]フィールドと完全に一致しない場合に発生します。 ユーザー名の照合では大文字と小文字が区別されるため、スペル、メールアドレスの形式、大文字と小文字の違いにより、AES が認証済みの ID を既存のアカウントに対応付けられなくなることがあります。ほとんどの場合、IdP から返されるユーザー名が AES のユーザー名と完全に一致していることを確認することで、この問題を解決できます。

解決方法の詳細

接続テストは成功するが、ログインに失敗する

SAML Connection Testが正常に完了し、次のようなメッセージが表示されるため、SAML設定は正しく機能しているように見える場合があります。

Connection Test Successful
You would have been signed in as username@domain.com

しかし、ユーザーがSSO経由でサインインしようとすると、次のようになります。

  1. IDプロバイダーでの認証は成功します。
  2. ユーザーはEnterprise Serverにリダイレクトされます。
  3. 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

ユーザー名のマッピングを検証して修正する

  1. Enterprise ServerのWebインターフェースを開きます。
  2. Admin » Settings » Authenticationに移動します。
  3. 設定済みのSAML認証プロバイダーを開きます。
  4. Connection Testを実行します。
  5. IDプロバイダーでの認証を完了します。
  6. テストで報告されたユーザー名を記録します。
  7. Admin » Usersに移動します。
  8. 該当するユーザーアカウントを開きます。
  9. Usernameフィールドの値が、大文字と小文字も含めて、SAML接続テストで返された値と完全に一致していることを確認します。
  10. 必要な変更を保存します。
  11. SSOログインを再試行します。

補足事項

  • SSOユーザーのマッピングは、Enterprise ServerのUsernameフィールドを使用して行われます。
  • この動作は、アカウントがBuilt-In認証とWindows認証のどちらを使用しているかに関係なく適用されます。
  • ユーザー名の照合ではcase-sensitive。
  • さらにトラブルシューティングが必要な場合は、次の場所にあるUnifiedLoginログを確認してください。
    C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
  • UnifiedLoginログでは、IdPから受信したID情報、ユーザーマッピング、認証処理エラーの詳細を確認できます。
  • 期待される結果:Enterprise Serverのユーザー名がIDプロバイダーから提供されたユーザー名と完全に一致すると、ユーザーが既存のアカウントに正常にマッピングされ、SSO認証が正常に完了し、エラーが発生しなくなります。

参考資料

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。