Compartir por

Integración del SSO de Microsoft Entra con Onyxia

  • Artigo

En este tutorial, aprenderá a integrar Onyxia con Microsoft Entra ID. La integración de Onyxia con Microsoft Entra ID le permitirá:

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

Requisitos previos

Para integrar Microsoft Entra ID con Onyxia, necesita:

  • 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 Onyxia.

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.

  • Onyxia admite el SSO iniciado por SP e IDP.
  • Onyxia admite el aprovisionamiento de usuarios Just-In-Time.

Nota:

El identificador de esta aplicación es un valor de cadena fijo, por lo que solo se puede configurar una instancia en un inquilino.

Para configurar la integración de Onyxia en Microsoft Entra ID, debe agregar Onyxia 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 Onyxia en el cuadro de búsqueda.
  4. Seleccione Onyxia 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, asignar roles y recorrer la configuración de inicio de sesión único. Obtenga más información sobre los asistentes de Microsoft 365.

Configuración y prueba del SSO de Microsoft Entra para Onyxia

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

Para configurar y probar el SSO de Microsoft Entra con Onyxia, siga estos pasos:

  1. Configure el inicio de sesión único de Microsoft Entra, para que los usuarios puedan usar 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. Configure el SSO en Onyxia: para configurar los valores de SSO en la aplicación.
    1. Cree un usuario de prueba de Onyxia: para tener un homólogo de B.Simon en Onyxia que esté vinculado a la representación del usuario en Microsoft Entra ID.
  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 inicio de sesión único de Microsoft Entra en el centro de administración 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>Onyxia>Inicio de sesión único.

  3. En la página Seleccione un método de inicio de sesión único, elija 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.

    Captura de pantalla que muestra cómo editar una configuración básica de SAML.

  5. En la sección Configuración de SAML Básico, la aplicación está preconfigurada y las direcciones URL necesarias ya están rellenadas previamente con Microsoft Entra. El usuario debe guardar la configuración, para lo que debe hacer clic en el botón Guardar.

  6. Si quiere configurar la aplicación en modo iniciado por SP, realice el siguiente paso:

    En el cuadro de texto Dirección URL de inicio de sesión, escriba la dirección URL: https://auth.onyxia.io/auth/saml/callback

  7. En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, busque Certificado (Base64) y seleccione Descargar para descargarlo y guardarlo en el equipo.

    Captura de pantalla del vínculo de descarga del certificado.

  8. En la sección Configuración de Onyxia, copie las direcciones URL adecuadas según sus requisitos.

    Captura de pantalla que muestra la copia de las URL de configuración.

Cree un usuario de prueba de Microsoft Entra

En esta sección, creará un usuario de prueba en el centro de administración de Microsoft Entra 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 Onyxia mediante el inicio de sesión único 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>Onyxia.
  3. En la página de información general de la aplicación, seleccione Usuarios y grupos.
  4. 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 SSO en Onyxia

  1. Inicie sesión en el sitio empresarial de Onyxia como administrador.

  2. Vaya a Configuración y haga clic en Configuración de la cuenta.

    Captura de pantalla que muestra la navegación a la configuración.

  3. Vaya a la sección SSO y haga clic en + Agregar nueva conexión.

    Captura de pantalla que muestra cómo agregar una nueva conexión.

  4. En la sección de configuración de SSO, realice los siguientes pasos:

    Captura de pantalla que muestra la configuración.

    1. En el cuadro de texto nombre de dominio, escriba un nombre de dominio válido.

    2. En el cuadro de texto dirección URL de SSO, pegue la dirección URL de inicio de sesión que copió del Centro de administración de Microsoft Entra.

    3. Abra el certificado (Base64) descargado en el Bloc de notas y pegue el contenido en el cuadro de texto Certificado público.

    4. Copia la Dirección URL de ACS y pégala en el cuadro de texto Dirección URL de respuesta de la sección Configuración básica de SAML en el Centro de administración Microsoft Entra.

    5. Copie el valor de id. de entidad del PS y péguelo en el cuadro de texto Identificador (id. de entidad) de la sección Configuración básica de SAML en el Centro de administración de Microsoft Entra.

    6. Haz clic en + Crear.

Creación de un usuario de prueba en Onyxia

En esta sección, se crea un usuario llamado Britta Simon en Onyxia. Onyxia 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 aún no existe un usuario en Onyxia, 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 en el centro de administración de Microsoft Entra. De este modo, se le redirigirá a la dirección URL de inicio de sesión de Onyxia, donde podrá comenzar el flujo de inicio de sesión.

  • Vaya directamente a la dirección URL de inicio de sesión de Onyxia y comience desde allí el flujo de inicio de sesión.

Iniciado por IDP:

  • Haga clic en Probar esta aplicación en el Centro de administración de Microsoft Entra y debería iniciar sesión automáticamente en la instancia de Onyxia 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 Onyxia en Aplicaciones, si está configurado en modo SP, se le redirigirá a la página de inicio de sesión de la aplicación para iniciar el flujo de inicio de sesión y, si está configurado en modo IDP, debería iniciar sesión automáticamente en la instancia de Onyxia para la que ha configurado el SSO. Para más información acerca de Aplicaciones, consulte Inicio de sesión e inicio de aplicaciones desde el portal Aplicaciones.

Pasos siguientes

Una vez que haya configurado Onyxia, puede aplicar el control de sesión, que protege a su 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.