KB : échec de la connexion SSO SAML avec le message « Combinaison nom d’utilisateur/mot de passe non valide »

Altium On-Prem Enterprise Server Altium On-Prem Enterprise Server
Lors de l’utilisation de l’authentification unique (SSO) SAML avec Altium On-Prem Enterprise Server (AES), le test de connexion SAML peut réussir alors que l’authentification SSO échoue avec l’erreur suivante : « Notre système a rencontré un problème. Veuillez réessayer dans un instant. Combinaison nom d’utilisateur/mot de passe non valide. » Ce problème survient lorsque le nom d’utilisateur renvoyé par le fournisseur d’identité (IdP) ne correspond pas exactement au champ Nom d’utilisateur du compte utilisateur Enterprise Server correspondant. La correspondance des noms d’utilisateur est sensible à la casse. Toute différence d’orthographe, de format d’adresse e-mail ou de casse peut empêcher AES d’associer l’identité authentifiée à un compte existant. Vérifier que le nom d’utilisateur renvoyé par l’IdP correspond exactement au nom d’utilisateur dans AES permet de résoudre le problème dans la plupart des cas.

Détails de la solution

Le test de connexion réussit, mais la connexion échoue

La configuration SAML peut sembler fonctionner correctement, car le SAML Connection Test s’exécute avec succès et affiche un message similaire à celui-ci :

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

Cependant, lorsque l’utilisateur tente de se connecter via SSO :

  1. L’authentification auprès du fournisseur d’identité réussit.
  2. L’utilisateur est redirigé vers Enterprise Server.
  3. Enterprise Server affiche l’erreur suivante :

"Our system hit a snag, please try again in a moment.
Invalid UserName/Password combination"

 

Une correspondance exacte du nom d’utilisateur est requise

Enterprise Server utilise le nom d’utilisateur fourni par le fournisseur d’identité pour rechercher l’utilisateur et l’associer à un compte Enterprise Server existant.

Le nom d’utilisateur renvoyé par l’IdP doit correspondre exactement à la valeur configurée dans le champ Username de l’utilisateur dans Enterprise Server.

 

Par exemple, si le test de connexion SAML indique :

username@domain.com

mais que le compte Enterprise Server est configuré comme suit :

username

ou :

Username@domain.com

la connexion SSO peut échouer, car les valeurs ne correspondent pas exactement.

Important: La comparaison des noms d’utilisateur est case-sensitive. Les valeurs suivantes sont considérées comme différentes :

username@domain.com
Username@domain.com

Ce comportement d’association des noms d’utilisateur est indépendant du type d’authentification de l’utilisateur et s’applique aux deux types suivants :

  • Authentification intégrée
  • Authentification Windows

Vérifier le nom d’utilisateur renvoyé par le fournisseur d’identité

  • Exécutez le SAML Connection Test pour déterminer le nom d’utilisateur renvoyé par le fournisseur d’identité.
  • Comparez le nom d’utilisateur renvoyé avec le champ Username de l’utilisateur dans Enterprise Server.
  • Vérifiez que l’orthographe, le format de l’adresse e-mail et la casse sont identiques.
  • Modifiez le nom d’utilisateur dans Enterprise Server si nécessaire.
  • Si le problème persiste après avoir confirmé une correspondance exacte, consultez les journaux UnifiedLogin pour obtenir des informations supplémentaires. Ces journaux se trouvent à l’emplacement suivant :
    C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin

Vérifier et corriger l’association du nom d’utilisateur

  1. Ouvrez l’interface Web d’Enterprise Server.
  2. Accédez à Admin » Settings » Authentication.
  3. Ouvrez le fournisseur d’authentification SAML configuré.
  4. Exécutez le Connection Test.
  5. Effectuez l’authentification auprès du fournisseur d’identité.
  6. Notez le nom d’utilisateur indiqué par le test.
  7. Accédez à Admin » Users.
  8. Ouvrez le compte utilisateur correspondant.
  9. Vérifiez que le champ Username correspond exactement à la valeur renvoyée par le test de connexion SAML, y compris la casse.
  10. Enregistrez les modifications nécessaires.
  11. Réessayez de vous connecter via SSO.

Remarques supplémentaires

  • L’association des utilisateurs SSO s’effectue à l’aide du champ Username d’Enterprise Server.
  • Ce comportement s’applique que le compte utilise l’authentification Built-In ou Windows.
  • La correspondance des noms d’utilisateur est case-sensitive.
  • Si un dépannage supplémentaire est nécessaire, consultez les journaux UnifiedLogin situés à l’emplacement suivant :
    C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
  • Les journaux UnifiedLogin peuvent fournir des détails sur les informations d’identité reçues de l’IdP, l’association des utilisateurs et les erreurs de traitement de l’authentification.
  • Résultat attendu : une fois que le nom d’utilisateur dans Enterprise Server correspond exactement à celui fourni par le fournisseur d’identité, l’utilisateur est correctement associé au compte existant, l’authentification SSO aboutit et l’erreur ne se produit plus.

Références

AI-LocalizedLocalisé par IA
Si vous trouvez un problème, sélectionnez le texte/l’image et appuyez surCtrl + Enterpour nous envoyer vos commentaires.