Tutorial: integración del SSO de Microsoft Entra con VIDA

Artigo
03/25/2024

En este tutorial, obtendrá información sobre cómo integrar VIDA con Microsoft Entra ID. Al integrar VIDA con Microsoft Entra ID, puede hacer lo siguiente:

Controlar en Microsoft Entra ID quién tiene acceso a VIDA.
Permitir que los usuarios puedan iniciar sesión automáticamente en VIDA con sus cuentas de Microsoft Entra.
Administre sus cuentas en una ubicación central.

Requisitos previos

Para empezar, necesita los siguientes elementos:

Una suscripción a Microsoft Entra. Si no tiene una suscripción, puede obtener una cuenta gratuita.
Suscripción habilitada para el inicio de sesión único (SSO) en VIDA.

Descripción del escenario

En este tutorial va a configurar y probar el inicio de sesión único de Microsoft Entra en un entorno de prueba.

VIDA admite el inicio de sesión único iniciado por SP.
VIDA admite el aprovisionamiento de usuarios Just-In-Time.

Adición de VIDA desde la galería

Para configurar la integración de VIDA en Microsoft Entra ID, deberá agregar VIDA desde la galería a la lista de aplicaciones SaaS administradas.

Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>Nueva aplicación.
En la sección Agregar desde la galería, escriba VIDA en el cuadro de búsqueda.
Seleccione VIDA en el panel de resultados y, a continuación, agregue la aplicación. Espere unos segundos mientras la aplicación se agrega al inquilino.

Si lo desea, puede usar también el asistente para la configuración de aplicaciones empresariales. En este asistente puede agregar una aplicación al inquilino, agregar usuarios o grupos a la aplicación y asignar roles, así como recorrer la configuración de SSO. Obtenga más información sobre los asistentes de Microsoft 365.

Configuración y prueba del inicio de sesión único de Microsoft Entra para VIDA

Configure y pruebe el inicio de sesión único de Microsoft Entra con VIDA mediante un usuario de prueba llamado B.Simon. Para que el inicio de sesión único funcione, es necesario establecer una relación de vínculo entre un usuario de Microsoft Entra y el usuario relacionado de VIDA.

Para configurar y probar el inicio de sesión único de Microsoft Entra con VIDA, complete los siguientes pasos:

Configuración del inicio de sesión único de Microsoft Entra, para que los usuarios puedan utilizar esta característica.
1. Cree un usuario de prueba de Microsoft Entra para probar el inicio de sesión único de Microsoft Entra con B.Simon.
2. Asigne el usuario de prueba de Microsoft Entra, para permitir que B.Simon use el inicio de sesión único de Microsoft Entra.
Configuración del inicio de sesión único en VIDA , para configurar los valores de Inicio de sesión único en la aplicación.
1. Creación de un usuario de prueba de VIDA, para tener un homólogo de B.Simon en Coda que esté vinculado a la representación del usuario en Microsoft Entra.
Prueba del inicio de sesión único : para comprobar si la configuración funciona.

Configuración del inicio de sesión único de Microsoft Entra

Siga estos pasos para habilitar el SSO de Microsoft Entra.

Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>VIDA>Inicio de sesión único.
En la página Seleccione un método de inicio de sesión único, elija SAML.
En la página Configuración del inicio de sesión único con SAML, haga clic en el icono de lápiz de Configuración básica de SAML para editar la configuración.
En la sección Configuración básica de SAML, especifique los valores de los siguientes campos:

a. En el cuadro de texto Identificador (id. de entidad) , escriba el valor: urn:amazon:cognito:sp:eu-west-2_IDmTxjGr6

b. En el cuadro de texto URL de respuesta, escriba la dirección URL: https://vitruevida.auth.eu-west-2.amazoncognito.com/saml2/idpresponse

c. En el cuadro de texto Dirección URL de inicio de sesión, escriba una dirección URL con el siguiente patrón:

https://vitruevida.com/?teamid=<ID>&idp=<IDP_NAME>

Nota:

El valor de la dirección URL de inicio de sesión no es real. Actualícelo con la dirección URL de inicio de sesión real. Póngase en contacto con el equipo de soporte técnico al cliente de VIDA para obtener el valor. También puede consultar los patrones que se muestran en la sección Configuración básica de SAML.
La aplicación VIDA espera las aserciones de SAML en un formato específico, que requiere que se agreguen asignaciones de atributos personalizados a la configuración de los atributos del token de SAML. La siguiente captura de muestra la lista de atributos predeterminados.
Además de lo anterior, la aplicación VIDA espera que se devuelvan algunos atributos más, que se muestran a continuación, en la respuesta de SAML. Estos atributos también se rellenan previamente, pero puede revisarlos según sus requisitos.

Nombre Atributo de origen

assignedroles user.assignedroles
En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, busque XML de metadatos de federación y seleccione Descargar para descargar el certificado y guardarlo en su equipo.
En la sección Configurar VIDA, copie las direcciones URL adecuadas según sus necesidades.

Nombre	Atributo de origen
assignedroles	user.assignedroles

Cree un usuario de prueba de Microsoft Entra

En esta sección, se crea un usuario llamado B.Simon.

Inicie sesión en el Centro de administración de Microsoft Entra al menos como Administrador de usuario.
Vaya aIdentidad>Usuarios>Todos los usuarios.
Seleccione Nuevo usuario>Crear nuevo usuario, en la parte superior de la pantalla.
En las propiedades del usuario, siga estos pasos:
1. En el campo Nombre para mostrar, escriba B.Simon.
2. En el campo Nombre principal de usuario, escriba username@companydomain.extension. Por ejemplo, B.Simon@contoso.com.
3. Active la casilla Show password (Mostrar contraseña) y, después, anote el valor que se muestra en el cuadro Contraseña.
4. Seleccione Revisar + crear.
Seleccione Crear.

Asignación del usuario de prueba de Microsoft Entra

En esta sección va a permitir que B.Simon acceda a VIDA mediante el inicio de sesión único.

Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>VIDA.
En la página de información general de la aplicación, seleccione Usuarios y grupos.
Seleccione Agregar usuario o grupo. A continuación, en el cuadro de diálogo Agregar asignación, seleccione Usuarios y grupos.
1. En el cuadro de diálogo Usuarios y grupos, seleccione B.Simon de la lista de usuarios y haga clic en el botón Seleccionar de la parte inferior de la pantalla.
2. Si espera que se asigne un rol a los usuarios, puede seleccionarlo en la lista desplegable Seleccionar un rol. Si no se ha configurado ningún rol para esta aplicación, verá seleccionado el rol "Acceso predeterminado".
3. En el cuadro de diálogo Agregar asignación, haga clic en el botón Asignar.

Configuración del inicio de sesión único basado en roles de VIDA

Para asociar un rol VIDA al usuario de Microsoft Entra, debe crear un rol en Microsoft Entra ID siguiendo estos pasos:

a. Inicie sesión en el explorador de Microsoft Graph.

b. Haga clic en Modificar permisos para obtener los permisos necesarios para crear un rol.

c. Seleccione los permisos siguientes en la lista y haga clic en Modificar permisos, como se muestra en la ilustración siguiente.

Nota:

Una vez concedidos los permisos, inicie sesión en el Explorador de Graph de nuevo.

d. En la página del Explorador de Graph, seleccione GET en la primera lista desplegable y beta en la segunda. A continuación, escriba https://graph.microsoft.com/beta/servicePrincipals en el campo situado junto a las listas desplegables y haga clic en Ejecutar consulta.

Nota:

Si usa varios directorios, puede escribir https://graph.microsoft.com/beta/contoso.com/servicePrincipals en el campo de la consulta.

e. En la sección Response Preview (Vista previa de la respuesta), extraiga la propiedad appRoles de "Entidad de servicio" para su uso posterior.

Nota:

Puede encontrar la propiedad appRoles escribiendo https://graph.microsoft.com/beta/servicePrincipals/<objectID> en el campo de la consulta. Tenga en cuenta que objectID es el identificador del objeto que ha copiado de la página de propiedades de Microsoft Entra ID.

f. Vuelva al Explorador de Graph, cambie el método de GET a PATCH, pegue el siguiente contenido en la sección Cuerpo de la solicitud y haga clic en Ejecutar consulta:
```
{ 
"appRoles": [
    {
        "allowedMemberTypes": [
        "User"
        ],
        "description": "User",
        "displayName": "User",
        "id": "18d14569-c3bd-439b-9a66-3a2aee01****",
        "isEnabled": true,
        "origin": "Application",
        "value": null
    },
    {
        "allowedMemberTypes": [
        "User"
        ],
        "description": "msiam_access",
        "displayName": "msiam_access",
        "id": "b9632174-c057-4f7e-951b-be3adc52****",
        "isEnabled": true,
        "origin": "Application",
        "value": null
    },
    {
    "allowedMemberTypes": [
        "User"
    ],
    "description": "VIDACompanyAdmin",
    "displayName": "VIDACompanyAdmin",
    "id": "293414bb-2215-48b4-9864-64520937d437",
    "isEnabled": true,
    "origin": "ServicePrincipal",
    "value": "VIDACompanyAdmin"
    },
    {
    "allowedMemberTypes": [
        "User"
    ],
    "description": "VIDATeamAdmin",
    "displayName": "VIDATeamAdmin",
    "id": "2884f1ae-5c0d-4afd-bf28-d7d11a3d7b2c",
    "isEnabled": true,
    "origin": "ServicePrincipal",
    "value": "VIDATeamAdmin"
    },
    {
    "allowedMemberTypes": [
        "User"
    ],
    "description": "VIDAUser",
    "displayName": "VIDAUser",
    "id": "37b3218c-0c06-484f-90e6-4390ce5a8787",
    "isEnabled": true,
    "origin": "ServicePrincipal",
    "value": "VIDAUser"
    }
]
}
```
Nota:

Microsoft Entra ID enviará el valor de estos roles como valor de notificación en la respuesta de SAML. Sin embargo, solo puede agregar nuevos roles después del elemento msiam_access para la operación de revisión. Para facilitar el proceso de creación, se recomienda que use un generador de identificadores, como GUID Generator, para generar identificadores en tiempo real.

ej. Una vez que haya revisado la entidad de servicio con el rol necesario, asocie el rol con el usuario de Microsoft Entra (B.Simon) siguiendo los pasos de la sección Asignación del usuario de prueba de Microsoft Entra del tutorial.

Configuración del inicio de sesión único de VIDA

Para configurar el inicio de sesión único en VIDA, es preciso enviar el XML de metadatos de federación descargado y las direcciones URL apropiadas copiadas de la configuración de la aplicación al equipo de soporte técnico de VIDA. Dicho equipo lo configura para establecer la conexión de SSO de SAML correctamente en ambos lados.

Creación de un usuario de prueba de VIDA

En esta sección, se crea el usuario B.Simon en VIDA. VIDA admite el aprovisionamiento de usuarios Just-In-Time, que está habilitado de forma predeterminada. No hay ningún elemento de acción para usted en esta sección. Si un usuario no existe aún en VIDA, se crea uno nuevo después de la autenticación.

Prueba de SSO

En esta sección va a probar la configuración de inicio de sesión único de Microsoft Entra con las siguientes opciones.

Haga clic en Probar esta aplicación, esto redirigirá a la dirección URL de VIDA de inicio de sesión donde se puede poner en marcha el flujo de inicio de sesión.
Vaya directamente a la dirección URL de inicio de sesión de VIDA e inicie el flujo de inicio de sesión desde allí.
Puede usar Mis aplicaciones de Microsoft. Al hacer clic en el icono de VIDA en Aplicaciones, se le redirigirá a la URL de inicio de sesión de la aplicación. Para más información, vea Aplicaciones en Microsoft Entra.

Pasos siguientes

Una vez configurado VIDA, puede aplicar el control de sesión, que protege la filtración y la infiltración de la información confidencial de la organización en tiempo real. El control de sesión procede del acceso condicional. Aprenda a aplicar el control de sesión con Microsoft Defender para aplicaciones en la nube.

Compartir por