Configuración de Harness para el aprovisionamiento automático de usuarios con Microsoft Entra ID

En este artículo se explica cómo configurar Microsoft Entra ID para aprovisionar y desaprovisionar automáticamente usuarios o grupos en Harness. El aprovisionamiento automático elimina la gestión manual de usuarios al sincronizar en Harness los cambios en el ciclo de vida de los usuarios desde tu proveedor de identidad.

Nota:

En este artículo se describe un conector que se basa en el servicio de aprovisionamiento de usuarios de Microsoft Entra. Para obtener información sobre este servicio, consulte Automatización del aprovisionamiento y desaprovisionamiento de usuarios en aplicaciones SaaS con Microsoft Entra ID.

Requisitos previos

En el escenario descrito en este artículo se supone que tiene los siguientes requisitos previos:

Asignación de usuarios a Harness

Antes de configurar el aprovisionamiento, debe asignar usuarios o grupos a la aplicación Harness en Microsoft Entra ID. Microsoft Entra ID usa asignaciones para determinar qué usuarios deben recibir acceso a las aplicaciones seleccionadas. En el contexto del aprovisionamiento automático de usuarios, solo se sincronizan los usuarios o grupos que se han asignado a una aplicación en el Id. de Microsoft Entra ID.

Antes de configurar y habilitar el aprovisionamiento automático de usuarios, decida qué usuarios o grupos de Microsoft Entra ID necesitan acceder a Harness. A continuación, puede asignar estos usuarios o grupos a Harness siguiendo las instrucciones de Asignación de un usuario o grupo a una aplicación empresarial.

Recomendaciones para la asignación de usuarios

Comience con un grupo de pruebas pequeño antes de implementar el aprovisionamiento en toda la organización. Asigne un único usuario de Microsoft Entra a Harness para probar la configuración de aprovisionamiento automático de usuarios. Después de comprobar que el aprovisionamiento funciona correctamente, puede asignar usuarios o grupos adicionales.

Al asignar un usuario a Harness, debe seleccionar un rol válido específico de la aplicación (si está disponible) en el cuadro de diálogo Asignación . Los usuarios con el rol acceso predeterminado se excluyen del aprovisionamiento.

Si actualmente tiene una configuración de Harness App Integration en Microsoft Entra ID y ahora intenta configurar una para Harness, asegúrese de que la información del usuario también se incluye en App Integration antes de intentar iniciar sesión en Harness a través de SSO.

Configuración de Harness para el aprovisionamiento

Debe generar un token de API de SCIM en Harness antes de poder configurar el aprovisionamiento en Microsoft Entra ID. Este token permite a Microsoft Entra ID conectarse de forma segura al extremo SCIM de Harness y aprovisionar usuarios.

  1. Inicie sesión en la consola de administración de Harness, seleccione el perfil en la esquina inferior izquierda de la página y vaya a Información general del perfil.

    Captura de pantalla de la consola de administración de Harness con el menú de perfil que se usa para abrir Información general del perfil.

  2. En Mis claves de API, seleccione +Clave de API. Se abre la ventana para crear una clave de API.

    Captura de pantalla de la página Información general del perfil de Harness que muestra el botón +Clave de API en Mis claves de API.

  3. Especifique un nombre y seleccione Guardar. Harness crea una clave de API para su cuenta.

    Captura de pantalla del cuadro de diálogo Nueva clave de API de Harness con el cuadro Nombre y el botón Guardar.

  4. Para crear un token para la clave de API, seleccione +Token en la clave de API recién creada.

    a) Proporcione un nombre y seleccione Generar token.

    b. Copie el valor del token en una ubicación segura. Necesitará este token para configurar la conexión en Microsoft Entra ID.

    c. Seleccione Cerrar.

    Captura de pantalla del cuadro de diálogo de token de Harness que muestra los botones Generate token y Close.

Debe agregar la aplicación Harness desde la galería de aplicaciones de Microsoft Entra para poder configurar el aprovisionamiento automático de usuarios. Esto registra Harness como una aplicación SaaS administrada en el inquilino de Microsoft Entra.

  1. Inicie sesión en el Centro de administración de Microsoft Entra como al menos un administrador de aplicaciones en la nube.

  2. Vaya a Entra ID>Aplicaciones empresariales.

    Vínculo

  3. Para agregar una nueva aplicación, seleccione el botón Nueva aplicación en la parte superior del panel.

    El botón

  4. En el cuadro de búsqueda, escriba Harness, seleccione Harness en la lista de resultados y, a continuación, seleccione el botón Agregar para agregar la aplicación.

    Captura de pantalla de los resultados de búsqueda de la galería de Microsoft Entra con Harness seleccionado y el botón Agregar visible.

Configuración del aprovisionamiento automático de usuarios en Harness

Después de agregar Harness desde la galería y generar un token SCIM, puede configurar la conexión de aprovisionamiento. En esta sección se describen los pasos para configurar el servicio de aprovisionamiento de Microsoft Entra para crear, actualizar y deshabilitar usuarios o grupos en Harness en función de las asignaciones de usuarios o grupos en Microsoft Entra ID.

Sugerencia

También tiene la opción de habilitar el inicio de sesión único basado en SAML para Harness, siguiendo las instrucciones del artículo sobre el inicio de sesión único de Harness. El inicio de sesión único puede configurarse independientemente del aprovisionamiento automático de usuarios, aunque las dos características se complementan entre sí.

Nota:

Para obtener más información sobre el punto de conexión SCIM de Harness, consulte el artículo Claves de API de Harness.

Para configurar el aprovisionamiento automático de usuarios para Harness en Azure AD, haga lo siguiente:

  1. Inicie sesión en el Centro de administración de Microsoft Entra como al menos un administrador de aplicaciones en la nube.

  2. Vaya a Entra ID>Aplicaciones empresariales.

    Hoja de aplicaciones empresariales

  3. En la lista de aplicaciones, seleccione Harness.

    Vínculo a Harness en la lista de aplicaciones

  4. Seleccione la pestaña Aprovisionamiento.

    Pestaña Aprovisionamiento

  5. Seleccione + Nueva configuración.

    Captura de pantalla de la pestaña Aprovisionamiento automática.

  6. En Credenciales de administrador, haga lo siguiente:

    URL de inquilino + Token

    • En el cuadro Url del inquilino , escriba https://app.harness.io/gateway/api/scim/account/<your_harness_account_ID>. Puede obtener el identificador de cuenta de Harness desde la dirección URL del explorador cuando haya iniciado sesión en Harness.

    • En el cuadro Token secreto, escriba el valor del token de autenticación SCIM que guardó en el paso 3 de la sección "Configuración de Harness para el aprovisionamiento".

    • Seleccione Probar conexión para asegurarse de que Microsoft Entra ID puede conectarse a Harness. Si se produce un error en la conexión, asegúrese de que la cuenta de Harness tiene permisos de administrador y vuelva a intentarlo.

      Captura de pantalla de la conexión de prueba de provisionamiento.

  7. Seleccione Crear para crear la configuración.

  8. Seleccione Propiedades en la página Información general .

  9. Seleccione el lápiz para editar las propiedades. Habilite los correos electrónicos de notificación y proporcione un correo electrónico para recibir correos electrónicos de cuarentena. Habilitación de la prevención de eliminaciones accidentales. Seleccione Aplicar para guardar los cambios.

    Captura de pantalla de las propiedades de aprovisionamiento.

  10. Seleccione Asignación de atributos en el panel izquierdo y seleccione usuarios.

  11. Revise los atributos de usuario que se sincronizan entre Microsoft Entra ID y Harness en la sección Asignación de atributos . Los atributos seleccionados como propiedades de Coincidencia se usan para buscar coincidencias con las cuentas de usuario de Harness con el objetivo de realizar operaciones de actualización. Seleccione el botón Guardar para confirmar los cambios.

    Panel

  12. En Asignaciones, seleccione Sincronizar Microsoft Entra usuarios con Harness.

  13. Revise los atributos de grupo que se sincronizan entre Microsoft Entra ID y Harness en la sección Asignación de atributos. Los atributos seleccionados como propiedades de emparejamiento se utilizan para emparejar los grupos en Harness durante las operaciones de actualización. Seleccione el botón Guardar para confirmar los cambios.

    Panel

  14. Para configurar los filtros de ámbito, consulte las instrucciones siguientes que se proporcionan en el artículo sobre filtros de ámbito.

  15. Use el aprovisionamiento a petición para validar la sincronización con un pequeño número de usuarios antes de implementar más ampliamente en su organización.

  16. Cuando esté listo para aprovisionar, seleccione Iniciar aprovisionamiento en la página Información general .

Monitorea tu implementación

Después de iniciar el aprovisionamiento, supervise los registros de aprovisionamiento para comprobar que los usuarios y grupos se sincronizan correctamente entre Microsoft Entra ID y Harness.

Una vez configurado el aprovisionamiento, use los recursos siguientes para supervisar la implementación:

  1. Use los registros de aprovisionamiento de para determinar qué usuarios se aprovisionan correctamente o sin éxito
  2. Compruebe la barra de progreso para ver el estado del ciclo de aprovisionamiento y cómo se acerca a la finalización.
  3. Si la configuración de aprovisionamiento parece estar en un estado no saludable, la aplicación entra en cuarentena. Obtenga más información sobre los estados de cuarentena en el artículo estado de cuarentena de aprovisionamiento de aplicaciones .