Esta guía se aplica a computadoras Mac
Acerca de Passport con OneLogin
Passport con OneLogin permite a los usuarios iniciar sesión en computadoras Mac con sus credenciales de OneLogin. Esta integración proporciona una autenticación segura mediante el sistema de identidad de OneLogin de tu organización y admite la autenticación estándar y multifactor.Cómo funciona
Passport se integra con tu instancia de OneLogin mediante OpenID Connect (OIDC) para autenticar a los usuarios en la pantalla de inicio de sesión de macOS. El hecho de que necesites MFA para el inicio de sesión de Passport determina cuántas aplicaciones OIDC creas en OneLogin y si estableces Modo de autenticación en Inicio de sesión web o Inicio de sesión de Mac en el Library Item de Passport.- OneLogin
- Iru Endpoint
Requisitos previos
- Para agregar apps en OneLogin, usa una cuenta que sea Super User o Account Owner.
Configurar una app OIDC
Si no necesitas MFA para el inicio de sesión de Passport, establece Modo de autenticación en Inicio de sesión de Mac en el Library Item de Passport y sigue solo la sección Inicio de sesión de Mac (omite Inicio de sesión web).Si necesitas MFA al iniciar sesión, establece Modo de autenticación en Inicio de sesión web. Debes crear dos apps OIDC en OneLogin: primero Inicio de sesión de Mac (inicio de sesión y sincronización de contraseñas con la Mac) y luego Inicio de sesión web (MFA en la vista web integrada). Sigue la sección Inicio de sesión de Mac y luego la sección Inicio de sesión web, en ese orden.Inicio de sesión de Mac
Crea la aplicación OIDC de Inicio de sesión de Mac en OneLogin. Este artículo usa el nombre visible Iru Passport Inicio de sesión de Mac.Todas las implementaciones usan esta app. Con Inicio de sesión de Mac como modo de autenticación, es la única app OIDC de OneLogin que agregas en esta guía. Con Inicio de sesión web (MFA), agrega primero esta app y luego continúa con Inicio de sesión web.1
Iniciar sesión en OneLogin
Inicia sesión en OneLogin como Account owner o Super user.
2
Ir a Applications
En tu consola de administración de OneLogin, ve a la página Aplicaciones.
3
Agregar una nueva app
En la esquina superior derecha, selecciona Add App.
4
Buscar OIDC
En el campo de búsqueda de la esquina superior izquierda, introduce OIDC.
5
Seleccionar OpenID Connect
Selecciona OpenID Connect (OIDC).
6
Configurar los detalles de la app
En el campo Display Name, introduce un nombre descriptivo como Iru Passport Inicio de sesión de Mac.
7
Establecer la visibilidad
Coloca el interruptor Visible in portal en la posición Off; no es necesario que esta app sea visible para que Passport funcione, y podría resultar confuso para un usuario ver esta app en su portal de OneLogin.
8
Guardar la app
Selecciona Guardar.
9
Acceder a Configuration
En la barra lateral izquierda, selecciona Configuración.
10
Introducir el URI de redirección
En el campo Redirect URIs, introduce lo siguiente:
Passport no requiere este valor, pero no puedes guardar la configuración de la app sin algún valor en el campo Redirect URIs.
11
Acceder a la configuración de SSO
En la barra lateral izquierda, selecciona SSO.
12
Establecer el Application Type
Selecciona el menú Application Type y luego Native.
13
Establecer el Token Endpoint
Selecciona el menú Token Endpoint y luego None (PKCE).
14
Guardar la configuración de SSO
Selecciona Guardar.
Recopilar los detalles de configuración para Inicio de sesión de Mac
1
Preparar un documento seguro
Esta app OIDC mantiene la contraseña de la Mac sincronizada con OneLogin. Abre un documento de texto seguro que puedas usar para almacenar los valores de esta app OIDC. Necesitarás el Client ID y la Issuer URL cuando configures el Library Item de Passport (no necesitas el secreto de cliente).
2
Copiar el Client ID
A la derecha del campo Client ID, selecciona el botón Copy to Clipboard (tiene forma de portapapeles).
3
Guardar el Client ID
Pega el Client ID en el documento de texto seguro.
4
Copiar la Issuer URL
Haz clic con el botón derecho (o Control-clic) en el enlace Well-known Configuration y copia su valor. La Issuer URL es tu endpoint de configuración well-known de OIDC y sigue este patrón:
5
Guardar la Issuer URL
Pega la Issuer URL en el documento de texto seguro.
6
Guardar el documento
Guarda el documento de texto seguro.
7
Asignar la app a los usuarios
En OneLogin, asigna la app a los usuarios o grupos que usarán Passport para iniciar sesión en sus computadoras Mac.
Si no usas Inicio de sesión web (sin MFA), omite la sección Inicio de sesión web que aparece a continuación, continúa con Configurar un tipo de cuenta de usuario por grupo de proveedor de identidad en OneLogin si necesitas tipos de cuenta basados en roles y luego abre la pestaña Iru Endpoint.
Inicio de sesión web
Usa esta sección solo cuando Modo de autenticación sea Inicio de sesión web (MFA). Después de completar Inicio de sesión de Mac, crea aquí la segunda app OIDC. Este artículo usa el nombre visible Iru Passport Inicio de sesión web.1
Ir a Applications
En tu consola de administración de OneLogin, ve a la página Aplicaciones.
2
Agregar una nueva app
En la esquina superior derecha, selecciona Add App.
Si no aparece el botón Add App, es posible que hayas seleccionado anteriormente See the new apps list. Para que OneLogin muestre el botón Add App, elimina la cadena /admin2 de la URL. Por ejemplo, en lugar de https://accuhive.onelogin.com/admin2/apps, usa https://accuhive.onelogin.com/apps.
3
Buscar OIDC
En el campo de búsqueda de la esquina superior izquierda, introduce OIDC.
4
Seleccionar OpenID Connect
Selecciona OpenID Connect (OIDC).
5
Configurar los detalles de la app
En el campo Display Name, introduce un nombre descriptivo como Iru Passport Inicio de sesión web.
6
Establecer la visibilidad
Coloca el interruptor Visible in portal en la posición Off; no es necesario que esta app sea visible para que Passport funcione, y podría resultar confuso para un usuario ver esta app en su portal de OneLogin.
7
Guardar la app
Selecciona Guardar.
8
Acceder a Configuration
En la barra lateral izquierda, selecciona Configuración.
9
Introducir el URI de redirección
En el campo Redirect URIs, introduce lo siguiente:
10
Acceder a la configuración de SSO
En la barra lateral izquierda, selecciona SSO.
11
Establecer el Application Type
Selecciona el menú Application Type y luego Native.
12
Establecer el Authentication Method
En la sección Token Endpoint, selecciona el menú Authentication Method y elige POST. POST es necesario para que los usuarios puedan completar la MFA en la vista web al iniciar sesión en la Mac.
13
Guardar la configuración de SSO
Selecciona Guardar.
Recopilar los detalles de configuración para Inicio de sesión web
1
Preparar un documento seguro
Esta app OIDC proporciona los campos de Inicio de sesión web para el Library Item de Passport. Abre un documento de texto seguro que puedas usar para almacenar los valores de esta app OIDC. Necesitarás el Client ID y el Client Secret de esta app POST cuando configures el Library Item de Passport. Si ya tienes un documento seguro de la app OIDC de Inicio de sesión de Mac, agrega una nota que indique que los nuevos valores corresponden a la app OIDC de Inicio de sesión web.
2
Copiar el Client ID
Copia el contenido del campo Client ID.
3
Guardar el Client ID
Pega el Client ID en el documento de texto seguro.
4
Mostrar el secreto de cliente
Selecciona Show client secret.
5
Copiar el secreto de cliente
Copia el secreto de cliente.
6
Guardar el secreto de cliente
Pega el secreto de cliente en el documento de texto seguro.
7
Guardar el documento
Guarda el documento seguro.
8
Asignar la app a los usuarios
En OneLogin, asigna la app a los usuarios o grupos que iniciarán sesión con Inicio de sesión web (MFA).
Configurar un tipo de cuenta de usuario por grupo de proveedor de identidad en OneLogin
Usa esta sección cuando asignes roles de OneLogin a cuentas de Mac estándar o de administrador en Passport. Se aplica tanto a Inicio de sesión de Mac (sin MFA) como a Inicio de sesión web (MFA).Para configurar si un usuario será un usuario estándar o un usuario administrador, sigue los pasos siguientes.1
Acceder a Roles
Inicia sesión en tu OneLogin Console. Selecciona Users > Roles.
2
Crear un nuevo rol
Selecciona New Role en la parte superior derecha de la pantalla y asigna un nombre a tu rol. (Asegúrate de que el nombre del rol coincida con el nombre del grupo del IdP que usas en tu configuración de Iru Passport). En este ejemplo, el rol se llama Passport Admin Users. Por último, selecciona la app Iru Passport que creaste en OneLogin y selecciona Guardar en la parte superior derecha de la pantalla.
3
Configurar los parámetros de la app
A continuación, ve a la app Iru Passport que creaste en OneLogin. Selecciona el enlace parameters y selecciona el campo Grupos.
4
Establecer el valor predeterminado
En la sección “Default if no value selected”, selecciona User Roles en la lista desplegable y asegúrate de que Semicolon Delimited Input esté seleccionado. Selecciona Guardar.
5
Asignar usuarios al rol
Por último, asegúrate de que tus usuarios formen parte del rol que estás creando y de que sean miembros de la aplicación Iru Passport en OneLogin. Para agregar un usuario a un rol, selecciona Users > Roles > el nombre de tu rol (por ejemplo, Passport Admin Users), selecciona el enlace Usuarios, busca el usuario, selecciona la casilla azul, selecciona el enlace Add to Role y luego selecciona Guardar en la parte superior derecha de la página.
Cuando las apps OIDC y los roles de OneLogin se ajusten a lo que necesitas, abre la pestaña Iru Endpoint para introducir los valores en el Library Item de Passport. En esa pestaña, Aprovisionamiento de usuarios incluye un ejemplo de cuando un rol de OneLogin proporciona el nombre del grupo de administradores.
