KB: El inicio de sesión SSO con SAML falla con el mensaje «Combinación de nombre de usuario y contraseña no válida»
Altium On-Prem Enterprise Server
Detalles de la solución
La prueba de conexión se completa correctamente, pero el inicio de sesión falla
La configuración de SAML puede parecer correcta porque la SAML Connection Test se completa correctamente y muestra un mensaje similar a:
Connection Test Successful
You would have been signed in as username@domain.com
Sin embargo, cuando el usuario intenta iniciar sesión mediante SSO:
- La autenticación en el proveedor de identidad se completa correctamente.
- El usuario es redirigido de vuelta a Enterprise Server.
- Enterprise Server muestra el siguiente error:
"Our system hit a snag, please try again in a moment.
Invalid UserName/Password combination"
Se requiere una coincidencia exacta del nombre de usuario
Enterprise Server utiliza el nombre de usuario proporcionado por el proveedor de identidad para localizar al usuario y asociarlo a una cuenta existente de Enterprise Server.
El nombre de usuario devuelto por el IdP debe coincidir exactamente con el valor configurado en el campo Username del usuario en Enterprise Server.
Por ejemplo, si la prueba de conexión SAML indica:
username@domain.com
pero la cuenta de Enterprise Server está configurada como:
username
o:
Username@domain.com
el inicio de sesión mediante SSO puede fallar porque los valores no coinciden exactamente.
Important: La comparación de nombres de usuario es case-sensitive. Los siguientes valores se consideran diferentes:
username@domain.com
Username@domain.com
Este comportamiento de asociación de nombres de usuario es independiente del tipo de autenticación del usuario y se aplica tanto a:
- Autenticación integrada
- Autenticación de Windows
Confirmar el nombre de usuario devuelto por el proveedor de identidad
- Ejecute la SAML Connection Test para determinar el nombre de usuario devuelto por el proveedor de identidad.
- Compare el nombre de usuario devuelto con el campo Username del usuario en Enterprise Server.
- Compruebe que la escritura, el formato del correo electrónico y el uso de mayúsculas y minúsculas sean idénticos.
- Actualice el nombre de usuario de Enterprise Server si es necesario.
- Si el problema persiste después de confirmar una coincidencia exacta, revise los registros de UnifiedLogin para obtener más detalles. Estos registros se encuentran en la siguiente ruta:
C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
Validar y corregir la asociación del nombre de usuario
- Abra la interfaz web de Enterprise Server.
- Vaya a Admin » Settings » Authentication.
- Abra el proveedor de autenticación SAML configurado.
- Ejecute la Connection Test.
- Complete la autenticación con el proveedor de identidad.
- Anote el nombre de usuario indicado por la prueba.
- Vaya a Admin » Users.
- Abra la cuenta de usuario correspondiente.
- Compruebe que el campo Username coincida exactamente con el valor devuelto por la prueba de conexión SAML, incluido el uso de mayúsculas y minúsculas.
- Guarde los cambios necesarios.
- Intente iniciar sesión mediante SSO de nuevo.
Notas adicionales
- La asociación de usuarios de SSO se realiza mediante el campo Username de Enterprise Server.
- Este comportamiento se aplica independientemente de si la cuenta utiliza la autenticación Built-In o Windows.
- La coincidencia de nombres de usuario es case-sensitive.
- Si se requiere un diagnóstico adicional, revise los registros de UnifiedLogin ubicados en:
C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin - Los registros de UnifiedLogin pueden proporcionar detalles sobre la información de identidad recibida del IdP, la asociación de usuarios y los errores de procesamiento de la autenticación.
- Resultado esperado: una vez que el nombre de usuario de Enterprise Server coincide exactamente con el nombre de usuario proporcionado por el proveedor de identidad, el usuario se asocia correctamente a la cuenta existente, la autenticación mediante SSO se completa correctamente y el error deja de producirse.
Referencias
Localizado por IA