Compartir a través de

Tutorial: Integración del inicio de sesión único Microsoft Entra con Cognidox

  • Artículo

En este tutorial, aprenderá a integrar Cognidox con Microsoft Entra ID. Al integrar Cognidox con Microsoft Entra ID, puede:

  • Controlar en Microsoft Entra ID quién tiene acceso a Cognidox.
  • Permitir que los usuarios puedan iniciar sesión automáticamente en Cognidox 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.
  • Una suscripción habilitada para el inicio de sesión único (SSO) en Cognidox.

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.

  • Cognidox admite el inicio de sesión único iniciado por SP e IDP.
  • Cognidox admite el aprovisionamiento de usuarios Just-In-Time.

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

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>Nueva aplicación.
  3. En la sección Agregar desde la galería, escriba Cognidox en el cuadro de búsqueda.
  4. Seleccione Cognidox en el panel de resultados y 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 Cognidox

Configure y pruebe el inicio de sesión único de Microsoft Entra con Cognidox 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 en Cognidox.

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

  1. Configure el 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.
  2. Configuración del inicio de sesión único en Cognidox : para configurar los valores de inicio de sesión único en la aplicación.
    1. Creación de un usuario de prueba de Cognidox, para tener un homólogo de B.Simon en Cognidox que esté vinculado a la representación del usuario en Microsoft Entra.
  3. 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.

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.

  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>página Integración de aplicaciones de Cognidox, busque la sección Gestionar y seleccione Inicio de sesión único.

  3. En la página Seleccione un método de inicio de sesión único, seleccione SAML.

  4. 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.

    Edit Basic SAML Configuration

  5. En la sección Configuración básica de SAML, si desea configurar la aplicación en modo iniciado por IDP, realice los siguientes pasos:

    a. En el cuadro de texto Identificador, escriba un valor con el siguiente patrón: urn:net.cdox.<YOURCOMPANY>

    b. En el cuadro de texto URL de respuesta, escriba una dirección URL con el siguiente patrón: https://<YOURCOMPANY>.cdox.net/auth/postResponse

  6. Haga clic en Establecer direcciones URL adicionales y siga este paso si desea configurar la aplicación en el modo iniciado por SP:

    En el cuadro de texto URL de inicio de sesión, escriba una dirección URL con el siguiente patrón: https://<YOURCOMPANY>.cdox.net/

    Nota:

    Estos valores no son reales. Actualice estos valores con los valores reales de Identificador, URL de respuesta y URL de inicio de sesión. Póngase en contacto con el equipo de atención al cliente de Cognidox para obtener estos valores. También puede consultar los patrones que se muestran en la sección Configuración básica de SAML.

  7. La aplicación Cognidox espera las aserciones de SAML en un formato específico, lo que requiere que se agreguen asignaciones de atributos personalizados a la configuración de los atributos del token SAML. La siguiente captura de muestra la lista de atributos predeterminados. Haga clic en el icono Editar para abrir el cuadro de diálogo Atributos de usuario.

    image

  8. Además de lo anterior, la aplicación Cognidox espera que se usen algunos atributos más en la respuesta SAML. En la sección Notificaciones del usuario del cuadro de diálogo Atributos de usuario, haga lo siguiente para agregar el atributo Token SAML como se muestra en la tabla siguiente:

    Nombre Espacio de nombres Transformación Parámetro 1
    wanshort http://appinux.com/windowsaccountname2 ExtractMailPrefix() user.userprincipalname

    a. Haga clic en Agregar nueva notificación para abrir el cuadro de diálogo Administrar las notificaciones del usuario.

    b. En el cuadro de texto Nombre, escriba el nombre que se muestra para la fila.

    c. En el cuadro de texto Espacio de nombres, escriba el espacio de nombres que se muestra para esa fila.

    d. Seleccione Transformación como origen.

    e. En la lista Transformación, escriba el valor que se muestra para esa fila.

    f. En la lista Parámetro 1, escriba el valor que se muestra para esa fila.

    g. Haga clic en Save(Guardar).

  9. 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.

    The Certificate download link

  10. En la sección Configurar Cognidox, copie las direcciones URL adecuadas según sus necesidades.

    Copy configuration URLs

Cree un usuario de prueba de Microsoft Entra

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

  1. Inicie sesión en el Centro de administración de Microsoft Entra al menos como Administrador de usuario.
  2. Vaya aIdentidad>Usuarios>Todos los usuarios.
  3. Seleccione Nuevo usuario>Crear nuevo usuario, en la parte superior de la pantalla.
  4. 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.
  5. Seleccione Crear.

Asignación del usuario de prueba de Microsoft Entra

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

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>Cognidox.
  3. En la página de información general de la aplicación, busque la sección Administrar y seleccione Usuarios y grupos.
  4. Seleccione Agregar usuario. A continuación, en el cuadro de diálogo Agregar asignación, seleccione Usuarios y grupos.
  5. 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.
  6. Si espera que haya un valor de rol en la aserción de SAML, en el cuadro de diálogo Seleccionar rol, seleccione en la lista el rol adecuado para el usuario y haga clic en el botón Seleccionar en la parte inferior de la pantalla.
  7. En el cuadro de diálogo Agregar asignación, haga clic en el botón Asignar.

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

Para configurar el inicio de sesión único en Cognidox, es preciso enviar el XML de metadatos de federación descargado y las direcciones URL correspondientes copiadas de la configuración de la aplicación al equipo de soporte técnico de Cognidox. 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 Cognidox

En esta sección se crea un usuario llamado B.Simon en Cognidox. Cognidox 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 el usuario no existe en Cognidox, se crea uno 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.

Iniciado por SP:

  • Haga clic en Probar esta aplicación; esto le redirigirá a la dirección URL de inicio de sesión de Cognidox, desde donde puede poner en marcha el flujo de inicio de sesión.

  • Vaya directamente a la dirección URL de inicio de sesión de Cognidox e inicie el flujo de inicio de sesión desde allí.

Iniciado por IDP:

  • Haga clic en Probar esta aplicación; debería iniciar sesión automáticamente en la instancia de Cognidox para la que ha configurado el SSO.

También puede usar Aplicaciones de Microsoft para probar la aplicación en cualquier modo. Al hacer clic en el icono de Cognidox en Aplicaciones, si ha realizado la configuración en modo SP, se le redirigirá a la página de inicio de sesión de la aplicación para comenzar el flujo de inicio de sesión. Si ha realizado la configuración en modo IDP, debería iniciar sesión automáticamente en la instancia de Cognidox para la que ha configurado el inicio de sesión único. Para más información, vea Aplicaciones en Microsoft Entra.

Pasos siguientes

Una vez configurada la aplicación Cognidox, podrá aplicar el control de sesión, que protege a la organización en tiempo real frente a la filtración e infiltración de información confidencial. 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.