KB: l'accesso SSO SAML non riesce con l'errore "Combinazione di nome utente e password non valida"

Dettagli della soluzione

Il test di connessione riesce, ma l'accesso non va a buon fine

La configurazione SAML può sembrare correttamente funzionante perché il SAML Connection Test viene completato correttamente e mostra un messaggio simile al seguente:

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

Tuttavia, quando l'utente tenta di accedere tramite SSO:

1. L'autenticazione presso il provider di identità riesce.
2. L'utente viene reindirizzato a Enterprise Server.
3. Enterprise Server mostra il seguente errore:

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

È richiesta una corrispondenza esatta del nome utente

Enterprise Server utilizza il nome utente fornito dal provider di identità per individuare e associare l'utente a un account Enterprise Server esistente.

Il nome utente restituito dall'IdP deve corrispondere esattamente al valore configurato nel campo Username dell'utente in Enterprise Server.

Ad esempio, se il test di connessione SAML riporta:

username@domain.com

ma l'account Enterprise Server è configurato come:

username

oppure:

Username@domain.com

l'accesso SSO può non riuscire perché i valori non corrispondono esattamente.

Important: Il confronto dei nomi utente è case-sensitive. I seguenti valori sono considerati diversi:

username@domain.com
Username@domain.com

Questo comportamento di associazione del nome utente è indipendente dal tipo di autenticazione dell'utente e si applica a entrambi i seguenti tipi:

• Autenticazione integrata
• Autenticazione Windows

Verificare il nome utente restituito dal provider di identità

• Eseguire il SAML Connection Test per determinare il nome utente restituito dal provider di identità.
• Confrontare il nome utente restituito con il campo Username dell'utente in Enterprise Server.
• Verificare che l'ortografia, il formato dell'indirizzo e-mail e l'uso di maiuscole e minuscole siano identici.
• Aggiornare il nome utente in Enterprise Server, se necessario.
• Se il problema persiste dopo aver confermato la corrispondenza esatta, consultare i log di UnifiedLogin per ulteriori dettagli. Questi log si trovano nel seguente percorso:
  C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin

Verificare e correggere l'associazione del nome utente

1. Aprire l'interfaccia web di Enterprise Server.
2. Accedere a Admin » Settings » Authentication.
3. Aprire il provider di autenticazione SAML configurato.
4. Eseguire il Connection Test.
5. Completare l'autenticazione presso il provider di identità.
6. Annotare il nome utente riportato dal test.
7. Accedere a Admin » Users.
8. Aprire l'account utente corrispondente.
9. Verificare che il campo Username corrisponda esattamente al valore restituito dal test di connessione SAML, incluso l'uso di maiuscole e minuscole.
10. Salvare le eventuali modifiche necessarie.
11. Tentare nuovamente l'accesso SSO.

Note aggiuntive

• L'associazione degli utenti SSO viene eseguita utilizzando il campo Username di Enterprise Server.
• Questo comportamento si applica indipendentemente dal fatto che l'account utilizzi l'autenticazione Built-In o Windows.
• La corrispondenza dei nomi utente è case-sensitive.
• Se sono necessarie ulteriori verifiche per la risoluzione del problema, consultare i log di UnifiedLogin disponibili nel seguente percorso:
  C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
• I log di UnifiedLogin possono fornire dettagli sulle informazioni di identità ricevute dall'IdP, sull'associazione degli utenti e sugli errori di elaborazione dell'autenticazione.
• Risultato previsto: quando il nome utente in Enterprise Server corrisponde esattamente al nome utente fornito dal provider di identità, l'utente viene associato correttamente all'account esistente, l'autenticazione SSO viene completata correttamente e l'errore non si verifica più.

Riferimenti

• Configurazione dell'autenticazione Single Sign-On