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

En este artículo se describen los pasos que debe realizar en Postman y Microsoft Entra ID para configurar el aprovisionamiento automático de usuarios. Cuando se configura, Microsoft Entra ID aprovisiona y desaprovisiona automáticamente usuarios y grupos en Postman mediante el servicio de aprovisionamiento de Microsoft Entra. Para obtener detalles importantes sobre lo que hace este servicio, cómo funciona y las preguntas más frecuentes, consulte Automatización del aprovisionamiento y desaprovisionamiento de usuarios en aplicaciones SaaS con El identificador entra de Microsoft.

Capacidades compatibles

Prerrequisitos

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

• Un inquilino de Microsoft Entra.
• Uno de los siguientes roles: Administrador de aplicaciones, Administrador de aplicaciones en la nube o Propietario de la aplicación.
• Un cliente de Postman en el plan Enterprise.
• Una cuenta de usuario de Postman con permisos de administrador.

Paso 1: Planifica tu despliegue de aprovisionamiento

1. Obtenga información sobre cómo funciona el servicio de aprovisionamiento.
2. Determine quién está en el ámbito para el aprovisionamiento.
3. Determine qué datos quiere asignar entre Microsoft Entra ID y Postman.

Paso 2: Configurar Postman para admitir el aprovisionamiento con Microsoft Entra ID

Antes de empezar a configurar Postman para que soporte el aprovisionamiento con Microsoft Entra ID, deberá generar un token de API de SCIM dentro de la consola de administración Postman.

1. Vaya a la consola de administración de Postman iniciando sesión en la cuenta de Postman.

2. Una vez que haya iniciado sesión, seleccione Equipo en el lado derecho y seleccione Configuración del equipo.

3. Seleccione Autenticación en la barra lateral y luego active el interruptor de aprovisionamiento SCIM.

   

4. Recibirá un mensaje emergente en el que se pregunta si desea activar el aprovisionamiento SCIM, seleccione Activar para habilitar el aprovisionamiento de SCIM.

   

5. Para generar la clave de API de SCIM, realice los pasos siguientes:

   1. Seleccione Generate SCIM API Key (Generar clave de API de SCIM ) en la sección de aprovisionamiento de SCIM .

      

   2. Escriba el nombre de la clave y seleccione Generar.

   3. Copie la nueva clave de API para su uso posterior y seleccione Listo.

   Nota:

   Puede volver a visitar esta página para administrar las claves de API de SCIM. Si vuelve a generar una clave de API existente, tiene la opción de mantener activa la primera clave mientras cambia.

   Nota:

   Para seguir habilitando el aprovisionamiento de SCIM, consulte Configuración de SCIM con el identificador de Entra de Microsoft. Para obtener más información o ayudar a configurar SCIM, póngase en contacto con el soporte técnico de Postman.

Paso 3: Agregar Postman desde la galería de aplicaciones de Microsoft Entra

Agregue Postman desde la galería de aplicaciones de Microsoft Entra para empezar a administrar el aprovisionamiento en Postman. Si ha configurado antes Postman para el inicio de sesión único, puede usar la misma aplicación. Sin embargo, se recomienda crear una aplicación independiente al probar la integración inicialmente. Obtenga más información sobre cómo agregar una aplicación desde la galería aquí.

Paso 4: Definir quién está en el ámbito de aprovisionamiento

El servicio de aprovisionamiento de Microsoft Entra permite definir el ámbito de quién se aprovisiona en función de la asignación a la aplicación o en función de los atributos del usuario o grupo. Si decide delimitar quién se aprovisiona en su aplicación según la asignación, puede usar los pasos para asignar usuarios y grupos a la aplicación. Si decide definir el ámbito del aprovisionamiento únicamente en función de los atributos del usuario o grupo, puede usar un filtro de delimitación.

• Comience pequeño. Pruebe con un pequeño conjunto de usuarios y grupos antes de implementarlo en todos. Cuando el ámbito de aprovisionamiento se establece en usuarios y grupos asignados, puede controlarlo asignando uno o dos usuarios o grupos a la aplicación. Cuando el ámbito se establece en todos los usuarios y grupos, puede especificar un filtro de ámbito basado en atributos.

• Si necesita roles adicionales, puede actualizar el manifiesto de aplicación para agregar nuevos roles.

Paso 5: Configurar el aprovisionamiento automático de usuarios en Postman

Esta sección le guía por los pasos necesarios para configurar el servicio de aprovisionamiento de Microsoft Entra para crear, actualizar y deshabilitar usuarios o grupos en TestApp en función de las asignaciones de usuarios o grupos de Microsoft Entra ID.

Para configurar el aprovisionamiento automático de usuarios para Postman en Microsoft Entra ID:

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.

   

3. En la lista de aplicaciones, seleccione Postman.

   

4. Seleccione la pestaña Aprovisionamiento .

   

5. Seleccione + Nueva configuración.

   

6. En el campo URL del inquilino, introduzca la URL del inquilino de Postman y el token secreto. Seleccione Probar conexión para asegurarse de que Microsoft Entra ID puede conectarse a Postman. Si se produce un error en la conexión, asegúrese de que la cuenta de Postman tiene los permisos de administrador necesarios e inténtelo de nuevo.

   

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.

   

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 Postman en la sección Asignación de atributos. Los atributos seleccionados como propiedades de Coincidencia se utilizan para emparejar las cuentas de usuario en Postman durante las operaciones de actualización. Si decide cambiar el atributo de destino coincidente, debe asegurarse de que la API de Postman admite el filtrado de usuarios en función de ese atributo. Seleccione el botón Guardar para confirmar los cambios.

    Atributo	Tipo	Compatible con el filtrado	Requerido por Postman
    nombre de usuario	Cuerda	✓	✓
    activo	Boolean		✓
    name.givenName	Cuerda		✓
    name.familyName	Cuerda		✓

12. Seleccione Asignación de atributos en el panel izquierdo y seleccione grupo.

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

    Atributo	Tipo	Compatible con el filtrado	Requerido por Postman
    displayName	Cuerda	✓	✓
    Miembros	Referencia

14. Para configurar 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 .

Paso 6: Supervisión de la implementación

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 .

Más recursos

• Administración del aprovisionamiento de cuentas de usuario para Aplicaciones empresariales.
• ¿Qué es el acceso a la aplicación y el inicio de sesión único con Microsoft Entra ID?.

Contenido relacionado

• Obtenga información sobre cómo revisar los registros y obtener informes sobre la actividad de aprovisionamiento.