Este artículo proporciona pasos para solucionar problemas para los proveedores de Google SSO, SAML 2.0 y OAuth 2.0, como Microsoft Entra ID y Okta. Si los usuarios no pueden iniciar sesión en una aplicación de terceros que se conecta a Personio, como una integración de Marketplace, se trata de un problema de integración, no un problema de SSO. Aprende a solucionar problemas con las integraciones y las API.
Antes de empezar
- Si aparece un mensaje de error al hacer clic en Probar (Test) en tu conexión SSO, ve a Solucionar mensajes de error al probar tu conexión SSO (Fix error messages when you test your SSO connection).
- Si utilizas SSO mediante OpenID Connect / OAuth 2.0:
- Si no puedes iniciar sesión, puede ser porque tu clave del cliente ha vencido. Si la clave del cliente ya ha vencido, Personio envía por correo electrónico al propietario de cuenta un enlace de recuperación e instrucciones. Antes de intentar más soluciones, pídele que revise su cuenta de correo electrónico. Tiene que seguir el enlace en el correo electrónico para autenticarse usando correo electrónico y contraseña. A continuación, puede acceder a Personio y actualizar la clave del cliente. El código vence después de tres días.
- Si no estás experimentando el problema anterior, prueba lo siguiente:
- Usa un navegador diferente.
- Borra la caché de tu navegador.
- Usa el modo de incógnito.
- Cierra sesión y asegúrate de iniciar sesión con las credenciales correctas.
- Crea otro perfil en tu navegador.
- Deshabilita las extensiones.
- Lee las preguntas frecuentes sobre SSO
- Si el SSO funciona en la versión de escritorio, pero no en la aplicación móvil, el problema suele estar relacionado con el dispositivo y no es un problema de configuración. Solucionar problemas de inicio de sesión en la aplicación móvil.
Problemas de Google SSO
No se ha encontrado al empleado para iniciar sesión con Google
Problema:
Recibes este mensaje de error: “No se ha encontrado al empleado para iniciar sesión con Google”.
Posible solución:
Prueba los siguientes pasos:
- Cierra sesión en Google.
- Inicia sesión en Personio. Cuando Google te pida que selecciones tu cuenta, asegúrate de seleccionar la correcta.
Tu empresa cambia su dominio de correo electrónico
Problema:
Tu empresa cambia su dominio de correo electrónico.
Posible solución:
Si tu empresa cambia su dominio de correo electrónico, Personio ya no reconocerá los correos electrónicos y los empleados no podrán iniciar sesión.
La integración funcionó en el pasado, pero los empleados no pueden iniciar sesión
Problema:
La integración funcionó en el pasado, pero ahora tus empleados no pueden iniciar sesión.
Posible solución:
Es posible que tu empresa haya cambiado su dominio de correo electrónico.
Problemas con OpenID Connect/OAuth 2.0 (incluidos Microsoft Entra ID y Okta)
Un empleado o grupo de empleados no puede iniciar sesión
Problema:
Un empleado (o grupo de empleados) no puede iniciar sesión.
Posible solución:
Prueba los siguientes pasos:
- Ve a la lista de personal y filtra por los afectados.
- Comprueba que las direcciones de correo electrónico de los empleados sean correctas.
- Si lo anterior no funciona, comprueba si los correos electrónicos en Personio y el proveedor de OAuth coinciden.
Los empleados no pueden iniciar sesión después de la configuración inicial
Problema:
Tus empleados no pueden iniciar sesión después de la configuración inicial.
Posible solución:
Prueba los siguientes pasos:
- Ve a Ajustes.
- En la sección Seguridad e integraciones, haz clic en Seguridad y autenticación.
- En la lista de métodos de inicio de sesión, ve a OpenID Connect (OIDC) y haz clic en Configurar.
- Comprueba los ajustes que tienes establecidos para el proveedor de identidad:
- Comprueba que Ámbitos (Scopes) esté establecido como “openid,email”. Es posible que se necesiten diferentes ámbitos según el proveedor de identidad. Verifica los ámbitos requeridos.
- Si tienes un proveedor de identidad personalizado, añádelo.
- Verifica el URI de autorización.
- Verifica el URI del código.
- Comprueba si el URI de devolución de llamada está configurado correctamente en el proveedor de identidad.
- Comprueba que el emisor y los conjuntos de claves web JSON (JWK) están establecidos.
- Comprueba la fecha de vencimiento de la clave del cliente. Si la clave del cliente vence, Personio enviará correos electrónicos al propietario de cuenta con los pasos para recuperar el acceso a Personio.
- En el campo Reclamación, confirma que el correo electrónico del empleado coincide con el correo electrónico almacenado en Personio.
- También te recomendamos que hagas lo siguiente:
- Comprueba que ya has invitado a los empleados a Personio. Cada uno de ellos tiene que activar la cuenta para poder iniciar sesión.
- Para los empleados que no pueden iniciar sesión, comprueba si son de un inquilino diferente o si son usuarios invitados que se sincronizan desde el inquilino y tienen un emisor diferente en el código. En este caso, es mejor usar la conexión Microsoft Entra ID.
- Si utilizas OAuth en conexión con Active Directory Federation Services (ADFS):
- Comprueba que has seleccionado la casilla de verificación Omitir la lectura de entidades desde el token de identificación en Userinfo URI.
- Comprueba si los correos electrónicos de los empleados afectados están en los campos “email” o “unique_name” en el proveedor de autenticación. Selecciona el valor apropiado “on” en la entrada “leer correo electrónico desde reclamación”.
- Comprueba si tienes que incluir credenciales en la cadena de consulta. Tienes que hacer esto para Microsoft Entra ID. Tienes que seleccionar la casilla de verificación Incluir las credenciales en la cadena de consulta en el campo URI del token.
- Prueba tu configuración presionando Realizar una prueba de configuración.
La integración funcionó en el pasado, pero los empleados no pueden iniciar sesión
Problema:
La integración funcionó en el pasado, pero ahora tus empleados no pueden iniciar sesión.
Posible solución:
Hay tres razones principales por las que esto puede suceder:
- Tu empresa ha cambiado su dominio de correo electrónico.
- La clave del cliente ha vencido.
- Tu empresa ha cambiado su nombre de host de Personio.
Tu empresa utiliza diferentes dominios de correo electrónico
Problema:
Tu empresa utiliza diferentes dominios de correo electrónico, como .com, .es o .de.
Posible solución:
Comprueba que el dominio que estás utilizando coincide exactamente con el que has introducido para el proveedor de OAuth.
Error AADSTS50146 de Microsoft Entra ID
Problema:
Recibes el error de Microsoft Entra ID: AADSTS50146 (configuración de URI del ID de aplicación).
Posible solución:
Aprende a solucionar el error: "AADSTS50146: Esta aplicación debe configurarse con una URI de ID de aplicación
Probar tu conexión SSO
Después de configurar o cambiar tus ajustes de SSO, prueba la conexión para comprobar que funciona. Aprende a configurar SSO con Microsoft Entra ID, Okta, SAML 2.0 y proveedores de identidad personalizados en nuestros artículos específicos. Si usas Okta, selecciona OpenID Connect como método de inicio de sesión.
Sigue estos pasos para probar tu conexión:
- Ve a Ajustes.
- En la sección Seguridad e integraciones, haz clic en Seguridad y autenticación.
- Junto a su método de inicio de sesión, haz clic en Configurar.
- Haz clic en Probar (Test).
- Si la prueba falla, busca el mensaje de error en la siguiente sección.
Solucionar mensajes de error al probar tu conexión SSO
Si haces clic en “Probar” (Test) en una conexión SSO y la prueba falla, Personio suele mostrar un mensaje de error en la esquina inferior izquierda de la pantalla. Esta sección explica la causa de cada mensaje y cómo solucionarlo. En la mayoría de las soluciones tendrás que actualizar los ajustes de la página de configuración que abriste para probar tu conexión.
En esta sección se explican los siguientes mensajes:
- No se ha encontrado el correo electrónico
- La cuenta no está vinculada a un usuario de Personio
- El acceso del usuario está pendiente
- El usuario no tiene permiso para iniciar sesión
- La dirección de redireccionamiento no está registrada
- La clave del cliente parece incorrecta
- La clave del cliente ha vencido
- El emisor no coincide
- El certificado de firma SAML no coincide
- La aplicación está configurada como de inquilino único
- Se ha cancelado el inicio de sesión antes de dar el consentimiento
- La conexión no está activada
- Personio no pudo verificar la conexión
No se ha encontrado el correo electrónico
Problema:
Ves este mensaje: “No se ha encontrado el correo electrónico”. Esto sucede cuando tu proveedor de identidad no envía una dirección de correo electrónico para el usuario de prueba. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
Asegúrate de que tu proveedor de identidad envíe la dirección de correo electrónico y de que Personio lea la reclamación correcta.
- Comprueba que tu proveedor de identidad envía una reclamación de correo electrónico. En SAML, se trata de un atributo. En OpenID Connect, se trata del ámbito o la reclamación de correo electrónico.
- Comprueba que el nombre del atributo o de la reclamación en Personio coincide exactamente con el que envía tu proveedor de identidad.
- Asegúrate de que el atributo de correo electrónico del usuario de prueba tenga un valor en tu proveedor de identidad.
- Haz clic en Probar (Test) de nuevo.
La cuenta no está vinculada a un usuario de Personio
Problema:
Ves este mensaje: “Esta cuenta aún no está vinculada a un usuario de Personio. Asegúrate de que el correo electrónico coincide con el de un empleado existente e inténtalo de nuevo”. Esto ocurre cuando ningún empleado de Personio tiene la misma dirección de correo electrónico que el usuario de prueba. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
Asegúrate de que la dirección de correo electrónico de tu proveedor de identidad coincida con un registro de empleado en Personio.
- Comprueba que la dirección de correo electrónico del usuario de prueba coincide exactamente con la de un registro de empleado existente en Personio, incluidos el dominio y las mayúsculas y minúsculas.
- Si falta el registro del empleado o la dirección de correo electrónico es incorrecta, crea el empleado o corrige la dirección.
- En tus ajustes de SSO de Personio, ve al campo Reclamación y confirma que apunta a la reclamación que contiene la dirección de correo electrónico del empleado.
- Haz clic en Probar (Test) de nuevo.
El acceso del usuario está pendiente
Problema:
Ves este mensaje: “El acceso de este usuario sigue pendiente. El usuario debe seguir las instrucciones del correo electrónico que se le ha enviado”. Esto ocurre cuando el empleado todavía no ha activado su cuenta de Personio desde el correo electrónico de invitación. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
El empleado debe activar su cuenta para que la prueba funcione.
- Pídele a la persona que está probando la conexión que abra su correo electrónico de invitación y haz clic en el enlace de activación.
- Pídele al empleado que termine de crear su cuenta. Su cuenta permanece pendiente hasta que lo hagan.
- Si no encuentra el correo electrónico, reenvía la invitación a Personio desde su perfil. También puede revisar la carpeta de spam o de correo no deseado.
- Cuando la cuenta esté activa, haz clic de nuevo en Probar (Test).
El usuario no tiene permiso para iniciar sesión
Problema:
Ves este mensaje: “Este usuario no tiene permiso para iniciar sesión en esta empresa”. Esto ocurre cuando el usuario no está asignado a la aplicación en tu proveedor de identidad o no pertenece a la empresa correcta en Personio. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
Revisa los datos del usuario tanto en tu proveedor de identidad como en Personio.
- En tu proveedor de identidad, comprueba que el usuario esté asignado a la aplicación. En Microsoft Entra ID, comprueba las asignaciones de usuarios o grupos de la aplicación empresarial.
- En Personio, comprueba que el usuario pertenece a la empresa correcta.
La dirección de redireccionamiento no está registrada
Problema:
Ves este mensaje: “La dirección de redireccionamiento de esta conexión aún no está registrada. Añade la URL de inicio de sesión de Personio a las URL de devolución de llamada permitidas en tu proveedor de identidad (o ponte en contacto con Ayuda)”. Esto sucede cuando tu proveedor de identidad no tiene la dirección de devolución de llamada de Personio en su lista de direcciones de redireccionamiento permitidas. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
En la página de configuración de tu método de inicio de sesión, copia la dirección de devolución de llamada:
- En los ajustes de la aplicación de tu proveedor de identidad, añade la dirección de devolución de llamada de Personio a la lista de direcciones de redireccionamiento permitidas.
- Comprueba que no haya errores tipográficos, barras finales de más o de menos, ni http en lugar de https.
- Guarda el cambio y haz clic de nuevo en Probar (Test).
- Si aparece un mensaje diferente, búscalo en la lista del principio de esta sección.
La clave del cliente parece incorrecta
Problema:
Ves este mensaje: “La clave del cliente parece incorrecta. Asegúrate de haber introducido el valor de la clave, no su ID, de tu registro de aplicación”. Esto ocurre cuando introduces el ID de la clave en lugar de su valor. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
Sustituye el valor de Personio por el valor de la clave de tu proveedor de identidad.
- En el registro de la aplicación de tu proveedor de identidad, copia el valor de la clave, no su ID. En Microsoft Entra ID, ve a Registros de aplicaciones (App registrations) > Certificados y secretos (Certificates & secrets).
- En los ajustes de SSO de Personio, introduce el valor de la clave y guarda los cambios.
- Haz clic en Probar (Test) de nuevo.
La clave del cliente ha vencido
Problema:
Ves este mensaje: “La clave del cliente de esta conexión ha vencido. Genera una nueva en los ajustes de la aplicación y actualízala aquí”. Esto ocurre cuando la clave del cliente de tu proveedor de identidad alcanza su fecha de vencimiento. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
Genera una clave nueva del cliente y actualízala en Personio.
- En el registro de la aplicación de tu proveedor de identidad, genera una clave nueva del cliente. En Microsoft Entra ID, ve a Registros de aplicaciones (App registrations) > Certificados y secretos (Certificates & secrets).
- En los ajustes de SSO de Personio, introduce el valor de la clave nueva y guarda los cambios.
- Haz clic en Probar (Test) de nuevo.
El emisor no coincide
Problema:
Ves este mensaje: “La URL del emisor del proveedor de identidad no coincide con la configurada para esta conexión. Vuelve a comprobar la URL del emisor o de la autoridad”. Esto ocurre cuando el emisor de Personio es distinto del que envía tu proveedor de identidad. Este mensaje solo aparece con conexiones de OpenID Connect.
Posible solución:
Copia en Personio el emisor del documento de detección de tu proveedor de identidad.
- Abre el documento de detección de tu proveedor de identidad. Su dirección termina en
/.well-known/openid-configuration. Busca el emisor en este documento. - En los ajustes de SSO de Personio, compara el Emisor / Issuer con el del documento de detección.
- Corrige las diferencias, como un ID de inquilino incorrecto, una barra final o http en lugar de https.
- Guarda el cambio y haz clic de nuevo en Probar (Test).
El certificado de firma SAML no coincide
Problema:
Ves este mensaje: “El certificado de firma SAML no coincide. Si tu proveedor de identidad ha rotado su certificado, sube aquí el nuevo”. Esto ocurre cuando el certificado de Personio es distinto del que usa tu proveedor de identidad para firmar. Este mensaje solo aparece con conexiones SAML 2.0.
Posible solución:
Sube el certificado de firma actual de tu proveedor de identidad.
- Descarga el certificado de firma actual de los metadatos SAML de tu proveedor de identidad.
- En los ajustes de SSO de Personio, sube el certificado.
- Asegúrate de que la fecha de rotación del certificado en tu proveedor de identidad coincida con el certificado que subiste.
- Haz clic en Probar (Test) de nuevo.
La aplicación está configurada como de inquilino único
Problema:
Ves este mensaje: “Esta aplicación de Microsoft Entra ID está configurada como de inquilino único. Cámbiala a multiinquilino en el registro de la aplicación para que los usuarios puedan iniciar sesión con Personio”. Esto ocurre cuando el registro de la aplicación solo admite cuentas de tu propio inquilino. Este mensaje solo aparece con conexiones de Microsoft Entra ID.
Posible solución:
Cambia los tipos de cuenta compatibles del registro de la aplicación.
- En Microsoft Entra ID, ve a Registros de aplicaciones (App registrations), selecciona tu aplicación y haz clic en Autenticación (Authentication).
- En Tipos de cuenta compatibles (Supported account types), selecciona una opción multiinquilino.
- Guarda el cambio y haz clic de nuevo en Probar (Test).
Se ha cancelado el inicio de sesión antes de dar el consentimiento
Problema:
Ves este mensaje: “Se ha cancelado el inicio de sesión antes de que se otorgara el consentimiento. Inténtalo de nuevo y acepta la solicitud de permisos”. Esto ocurre cuando el usuario cierra o deniega la solicitud de permisos de tu proveedor de identidad. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
Vuelve a hacer la prueba y acepta la solicitud de permisos.
- Haz clic de nuevo en Probar (Test) y acepta la solicitud de permisos de tu proveedor de identidad.
- Si una política de la organización bloquea la pantalla de consentimiento, pide al administrador de tu proveedor de identidad que otorgue el consentimiento a la aplicación.
La conexión no está activada
Problema:
Ves este mensaje: “Esta conexión aún no está activada para el botón de Prueba (Test). Proporciona una configuración válida y actívala antes de probar”. Esto ocurre cuando la conexión está deshabilitada o su configuración aún no es válida. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
Asegúrate de que la conexión esté activada y de que sus ajustes sean válidos.
- Recarga la página y comprueba que la conexión esté activada. Puede que otra pestaña del navegador la haya deshabilitado.
- Si la conexión sigue deshabilitada, consulta los pasos de configuración de tu proveedor de identidad para asegurarte de que los ajustes sean válidos.
- Si los ajustes son válidos y la conexión sigue deshabilitada, ponte en contacto con Ayuda y comparte el nombre de la conexión y el nombre de host de Personio de tu empresa. Así, el equipo de Ayuda podrá activarla por ti.
Personio no pudo verificar la conexión
Problema:
Ves este mensaje: “No hemos podido verificar esta conexión. Revisa tu configuración o ponte en contacto con Ayuda si el problema continúa”. Personio muestra este mensaje cuando el error no coincide con ninguno de los mensajes anteriores. Este mensaje aparece para todas las configuraciones de SSO.
Posible solución:
Revisa cada ajuste de la conexión y vuelve a probar.
- Revisa todos los ajustes de la conexión: dirección de devolución de llamada, ID de cliente, clave del cliente, emisor y certificado.
- Haz clic en Probar (Test) de nuevo.
- Si el error continúa, ponte en contacto con Ayuda y comparte el mensaje de error exacto y la hora a la que apareció.