# OneLogin

Steps not yet verified in the identity provider's current admin console.

Recommended protocol: SAML 2.0.

## SAML 2.0

### Conectar OneLogin con SAML 2.0

1. En el portal de administración de OneLogin, añada la aplicación SAML Custom Connector (Advanced). Asígnele un nombre para mostrar, un icono y una descripción (por ejemplo, KeenAuth) y guarde.
2. Vaya a Configuration. Introduzca el Entity ID de KeenAuth **SP entity ID** en Audience (EntityID). Si el proveedor de servicios lo valida, introduzca también en Recipient el endpoint que recibe la aserción (obligatorio en algunas configuraciones).
3. En ACS (Consumer) URL Validator (obligatorio) introduzca una expresión regular que coincida exactamente con la URL de ACS de KeenAuth **ACS URL** y que empiece por ^ y termine por $ (sin ambos anclajes, la comprobación puede eludirse; no utilice el comodín \* en producción). A continuación, introduzca **ACS URL** en ACS (Consumer) URL (obligatorio).
4. Opcional: introduzca **single logout URL** en Single Logout URL si utiliza el cierre de sesión único. En SAML initiator (obligatorio), seleccione OneLogin para un flujo iniciado por el proveedor de identidad, o Service Provider para un flujo iniciado por el proveedor de servicios; en este último caso, introduzca la URL de inicio de sesión del proveedor de servicios en Login URL.
5. Seleccione el formato SAML nameID (obligatorio): Unspecified, Persistent, Transient o Email (predeterminado), según el identificador que KeenAuth debe usar para el usuario. Elija SAML signature element (obligatorio) como Response o Assertion y, opcionalmente, seleccione Encrypt assertion y un método de cifrado SAML.
6. Configure SAML not valid before, SAML not valid on or after y SAML sessionNotOnOrAfter (todos obligatorios) en minutos, además de cualquier otra configuración SAML que necesite su aplicación; RelayState es opcional.
7. Asigne la aplicación a sus usuarios, copie en KeenAuth los valores del proveedor de identidad de OneLogin para esta aplicación (emisor, endpoint SAML y certificado o metadatos) y ejecute la prueba de conexión.

Values in bold are shown on the connection's page in the Admin Portal, where this guide has them filled in.