Tutorial: Integración de Appraisd con Microsoft Entra ID

  • Artículo

En este tutorial, aprenderá a cómo integrar Appraisd con Microsoft Entra ID. Al integrar Appraisd con Microsoft Entra ID, puede hacer lo siguiente:

  • Controlar en Microsoft Entra ID quién tiene acceso a Appraisd.
  • Permitir que los usuarios puedan iniciar sesión automáticamente en Appraisd 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 de Appraisd.

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.

  • Appraisd admite el inicio de sesión único iniciado por SP e IDP.

Para configurar la integración de Appraisd en Microsoft Entra ID, será preciso que agregue Appraisd 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 Appraisd en el cuadro de búsqueda.
  4. Seleccione Appraisd 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 Appraisd

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

Para configurar y probar el inicio de sesión único de Microsoft Entra con Appraisd, complete los siguientes 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. Configuración del inicio de sesión único en Appraisd : para configurar los valores de inicio de sesión único en la aplicación.
    1. Creación de un usuario de prueba de Appraisd: para tener un homólogo de B.Simon en Appraisd que esté vinculado a la representación del usuario en Microsoft.
  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 de integración de aplicaciones de Appraisd, busque la sección Administrar 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, la aplicación está preconfigurada y las direcciones URL necesarias ya se han rellenado previamente con Azure. Para guardar la configuración, el usuario debe hacer clic en el botón Guardar y realizar los pasos siguientes:

    a. Haga clic en Establecer direcciones URL adicionales.

    b. En el cuadro de texto Estado de la retransmisión, escriba el valor: <TENANTCODE>

    c. Si quiere configurar la aplicación en modo iniciado por SP, en el cuadro de texto URL de inicio de sesión, escriba una dirección URL siguiendo este patrón: https://app.appraisd.com/saml/<TENANTCODE>

    Nota:

    La URL de inicio de sesión y el valor del estado de retransmisión se obtienen en la página de configuración de SSO de Appraisd, que se explica más adelante en el tutorial.

  6. La aplicación Appraisd 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 pantalla muestra la lista de atributos predeterminados, donde nameidentifier se asigna con user.userprincipalname. La aplicación Appraisd espera que nameidentifier se asigne con user.mail, por lo que debe editar la asignación de atributos haciendo clic en el icono Editar y cambiar esa asignación.

    Screenshot shows the User Attributes pane with the edit icon highlighted.

  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.

    The Certificate download link

  8. En la sección Set up Appraisd (Configurar Appraisd), 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, habilitará a B. Simon para que use el inicio de sesión único de Azure concediendo acceso a Appraisd.

  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>Appraisd.
  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 en la lista de usuarios y haga clic en el botón Seleccionar en 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 Appraisd

  1. En otra ventana del explorador web, inicie sesión en el sitio de Appraisd de la compañía como administrador

  2. En la parte superior derecha de la página, haga clic en el icono Configuración y, después, vaya a Configuración.

    Screenshot shows the Configuration link called out.

  3. En el lado izquierdo del menú, haga clic en el inicio de sesión único SAML.

    Screenshot shows the Configuration options with the SAML single sign-on option highlighted.

  4. En la página Configuración de inicio de sesión único de SAML 2.0, siga estos pasos:

    Screenshot shows the SAML 2.0 Single Sign-On configuration page where you can edit the Default Relay State and Service-initiated login U R L.

    a. Copie el valor Default Relay State (Estado retransmisión predeterminado) y péguelo en el cuadro de texto Estado de la retransmisión de Basic SAML Configuration (Configuración básica de SAML) en Azure Portal.

    b. Copie el valor Service-initiated login URL (URL de inicio de sesión iniciado por el servicio) y péguelo en el cuadro de texto URL de inicio de sesión de Basic SAML Configuration (Configuración básica de SAML) en Azure Portal.

  5. En la página Identificación de usuarios, desplácese hacia abajo y realice los pasos siguientes:

    Screenshot shows Identifying users where you can enter values from this step.

    a. En el cuadro de texto Dirección URL del inicio de sesión único del proveedor de identidades, pegue el valor de la dirección URL de inicio de sesión que copió y haga clic en Guardar.

    b. En el cuadro de texto Identity Provider Issuer URL (Dirección URL del emisor del proveedor de identidades), pegue el valor del identificador de Microsoft Entra que copió y haga clic en Guardar.

    c. En el Bloc de notas, abra el certificado codificado en Base 64 que descargó, copie el contenido, péguelo en el cuadro de texto Certificado X.509 y haga clic en Guardar.

Creación de un usuario de prueba de Appraisd

Para permitir que los usuarios de Microsoft Entra inicien sesión en Appraisd, deben aprovisionarse en Appraisd. En Appraisd, el aprovisionamiento es una tarea manual.

Para aprovisionar una cuenta de usuario, realice estos pasos:

  1. Inicie sesión en Appraisd como administrador de seguridad.

  2. En la parte superior derecha de la página, haga clic en el icono Settings (Configuración) y, después, vaya a Administration center (Centro de administración).

    Screenshot shows the Settings options where you can select Administration center.

  3. En la barra de herramientas situada en la parte superior de la página, haga clic en Personas y, después, vaya a Agregar un nuevo usuario.

    Screenshot shows the Appraisd page with People and Add a new user called out.

  4. En la página Agregar nuevo usuario, realice los pasos siguientes:

    Screenshot shows the Add a new user page.

    a. En el cuadro de texto First Name (Nombre), escriba el nombre del usuario, en este caso Britta.

    b. En el cuadro de texto Last Name (Apellidos), escriba los apellidos del usuario, en este caso Simon.

    c. En el cuadro de texto E-mail (Correo electrónico), escriba el correo electrónico del usuario, por ejemplo, B. Simon@contoso.com.

    d. Haga clic en Agregar usuario.

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 redirigirá a la dirección URL de Appraisd 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 Appraisd y comience el flujo de inicio de sesión desde allí.

Iniciado por IDP:

  • Haga clic en Probar esta aplicación, y debería iniciar sesión automáticamente en la instancia de HubSpot 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 Appraisd en Aplicaciones, si se ha configurado en modo SP, se le redirige a la página de inicio de sesión de la aplicación para iniciar el flujo de inicio de sesión; si se ha configurado en modo IDP, se debería iniciar sesión automáticamente en la instancia de Appraisd para la que ha configurado el inicio de sesión único. 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 configurado Appraisd, 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.