KB: Logowanie jednokrotne SAML kończy się błędem „Nieprawidłowa kombinacja nazwy użytkownika i hasła”

Szczegóły rozwiązania

Test połączenia kończy się powodzeniem, ale logowanie nie działa

Konfiguracja SAML może sprawiać wrażenie poprawnej, ponieważ SAML Connection Test kończy się powodzeniem i wyświetla komunikat podobny do poniższego:

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

Jednak gdy użytkownik próbuje zalogować się przez SSO:

1. Uwierzytelnianie u dostawcy tożsamości kończy się powodzeniem.
2. Użytkownik zostaje przekierowany z powrotem do Enterprise Server.
3. Enterprise Server wyświetla następujący błąd:

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

Wymagana jest dokładna zgodność nazw użytkownika

Enterprise Server używa nazwy użytkownika przekazanej przez dostawcę tożsamości, aby odnaleźć istniejące konto Enterprise Server i powiązać z nim użytkownika.

Nazwa użytkownika zwrócona przez dostawcę tożsamości (IdP) musi dokładnie odpowiadać wartości ustawionej w polu Username użytkownika w Enterprise Server.

Jeśli na przykład test połączenia SAML zwraca:

username@domain.com

ale konto w Enterprise Server jest skonfigurowane jako:

username

lub:

Username@domain.com

logowanie SSO może się nie powieść, ponieważ wartości nie są identyczne.

Important: Porównywanie nazw użytkownika case-sensitive. Następujące wartości są traktowane jako różne:

username@domain.com
Username@domain.com

Ten mechanizm mapowania użytkowników jest niezależny od typu uwierzytelniania użytkownika i dotyczy zarówno:

• Uwierzytelniania wbudowanego
• Uwierzytelniania Windows

Sprawdź nazwę użytkownika zwracaną przez dostawcę tożsamości

• Uruchom SAML Connection Test, aby ustalić nazwę użytkownika zwracaną przez dostawcę tożsamości.
• Porównaj zwróconą nazwę użytkownika z wartością w polu Username użytkownika w Enterprise Server.
• Sprawdź, czy pisownia, format adresu e-mail i wielkość liter są identyczne.
• W razie potrzeby zaktualizuj nazwę użytkownika w Enterprise Server.
• Jeśli problem nadal występuje mimo potwierdzenia dokładnej zgodności, sprawdź dzienniki UnifiedLogin, aby uzyskać dodatkowe informacje. Dzienniki te znajdują się w następującej lokalizacji:
  C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin

Sprawdź i popraw mapowanie nazw użytkownika

1. Otwórz interfejs internetowy Enterprise Server.
2. Przejdź do Admin » Settings » Authentication.
3. Otwórz skonfigurowanego dostawcę uwierzytelniania SAML.
4. Uruchom Connection Test.
5. Przeprowadź uwierzytelnianie u dostawcy tożsamości.
6. Zanotuj nazwę użytkownika zwróconą przez test.
7. Przejdź do Admin » Users.
8. Otwórz odpowiednie konto użytkownika.
9. Sprawdź, czy wartość w polu Username dokładnie odpowiada wartości zwróconej przez test połączenia SAML, z uwzględnieniem wielkości liter.
10. Zapisz wszelkie wymagane zmiany.
11. Ponownie spróbuj zalogować się przez SSO.

Dodatkowe uwagi

• Mapowanie użytkowników SSO odbywa się na podstawie pola Username w Enterprise Server.
• Ten mechanizm działa niezależnie od tego, czy konto korzysta z uwierzytelniania Built-In, czy Windows.
• Dopasowywanie nazw użytkownika case-sensitive.
• Jeśli konieczna jest dalsza diagnostyka, sprawdź dzienniki UnifiedLogin znajdujące się w lokalizacji:
  C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
• Dzienniki UnifiedLogin mogą zawierać szczegółowe informacje dotyczące danych tożsamości otrzymanych od dostawcy IdP, mapowania użytkowników oraz błędów przetwarzania uwierzytelniania.
• Oczekiwany rezultat: gdy nazwa użytkownika w Enterprise Server jest dokładnie zgodna z nazwą przekazaną przez dostawcę tożsamości, użytkownik zostaje poprawnie powiązany z istniejącym kontem, uwierzytelnianie SSO kończy się powodzeniem, a błąd przestaje występować.

Materiały referencyjne

• Konfigurowanie uwierzytelniania jednokrotnego (SSO)