KB: Falha no login via SAML SSO com a mensagem "Combinação de nome de usuário e senha inválida"

Altium On-Prem Enterprise Server Altium On-Prem Enterprise Server
Ao usar o logon único (SSO) SAML com o Altium On-Prem Enterprise Server (AES), o teste de conexão SAML pode ser concluído com sucesso, enquanto a autenticação SSO propriamente dita falha com o erro: "Nosso sistema encontrou um problema. Tente novamente em instantes. Combinação de nome de usuário/senha inválida." Isso ocorre quando o nome de usuário retornado pelo provedor de identidade (IdP) não corresponde exatamente ao campo Nome de usuário da conta de usuário correspondente no Enterprise Server. A correspondência de nomes de usuário diferencia maiúsculas de minúsculas, e diferenças na grafia, no formato do e-mail ou no uso de maiúsculas e minúsculas podem impedir que o AES associe a identidade autenticada a uma conta existente. Garantir que o nome de usuário retornado pelo IdP corresponda exatamente ao nome de usuário no AES resolve o problema na maioria dos casos.

Detalhes da solução

O teste de conexão é bem-sucedido, mas o login falha

A configuração SAML pode parecer estar funcionando corretamente porque o SAML Connection Test é concluído com sucesso e exibe uma mensagem semelhante a:

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

No entanto, quando o usuário tenta entrar por SSO:

  1. A autenticação no provedor de identidade é bem-sucedida.
  2. O usuário é redirecionado de volta ao Enterprise Server.
  3. O Enterprise Server exibe o seguinte erro:

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

 

É necessária uma correspondência exata do nome de usuário

O Enterprise Server usa o nome de usuário fornecido pelo provedor de identidade para localizar e associar o usuário a uma conta existente no Enterprise Server.

O nome de usuário retornado pelo IdP deve corresponder exatamente ao valor configurado no campo Username do usuário no Enterprise Server.

 

Por exemplo, se o teste de conexão SAML informar:

username@domain.com

mas a conta do Enterprise Server estiver configurada como:

username

ou:

Username@domain.com

o login por SSO poderá falhar porque os valores não correspondem exatamente.

Important: A comparação de nomes de usuário é case-sensitive. Os seguintes valores são considerados diferentes:

username@domain.com
Username@domain.com

Esse comportamento de mapeamento de nomes de usuário independe do tipo de autenticação do usuário e se aplica a ambos:

  • Autenticação integrada
  • Autenticação do Windows

Confirme o nome de usuário retornado pelo provedor de identidade

  • Execute o SAML Connection Test para determinar o nome de usuário retornado pelo provedor de identidade.
  • Compare o nome de usuário retornado com o campo Username do usuário no Enterprise Server.
  • Verifique se a grafia, o formato do e-mail e o uso de maiúsculas e minúsculas são idênticos.
  • Atualize o nome de usuário no Enterprise Server, se necessário.
  • Se o problema persistir após a confirmação de uma correspondência exata, consulte os logs do UnifiedLogin para obter mais detalhes. Esses logs estão localizados no seguinte caminho:
    C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin

Valide e corrija o mapeamento do nome de usuário

  1. Abra a interface web do Enterprise Server.
  2. Acesse Admin » Settings » Authentication.
  3. Abra o provedor de autenticação SAML configurado.
  4. Execute o Connection Test.
  5. Conclua a autenticação no provedor de identidade.
  6. Anote o nome de usuário informado pelo teste.
  7. Acesse Admin » Users.
  8. Abra a conta de usuário correspondente.
  9. Verifique se o campo Username corresponde exatamente ao valor retornado pelo teste de conexão SAML, incluindo o uso de maiúsculas e minúsculas.
  10. Salve as alterações necessárias.
  11. Tente fazer login por SSO novamente.

Observações adicionais

  • O mapeamento de usuários de SSO é realizado usando o campo Username do Enterprise Server.
  • Esse comportamento se aplica independentemente de a conta usar autenticação Built-In ou Windows.
  • A correspondência de nomes de usuário é case-sensitive.
  • Se for necessário investigar o problema mais a fundo, consulte os logs do UnifiedLogin localizados em:
    C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
  • Os logs do UnifiedLogin podem fornecer detalhes sobre as informações de identidade recebidas do IdP, o mapeamento de usuários e os erros de processamento da autenticação.
  • Resultado esperado: depois que o nome de usuário no Enterprise Server corresponder exatamente ao nome de usuário fornecido pelo provedor de identidade, o usuário será associado corretamente à conta existente, a autenticação por SSO será concluída com sucesso e o erro não ocorrerá mais.

Referências

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.