Aprovisionamiento de entrada basado en API de inicio rápido con Graph Explorer
Este tutorial describe cómo puede probar rápidamente el aprovisionamiento entrante controlado por API con Microsoft Graph Explorer.
Requisitos previos
- Ha configurado la aplicación de aprovisionamiento de entrada controlada por API.
Nota
Esta API de aprovisionamiento está pensada principalmente para su uso dentro de una aplicación o servicio. Los administradores de inquilinos pueden configurar una entidad de servicio o una identidad administrada para conceder permiso para realizar la carga. No hay ningún rol de directorio integrado de Microsoft Entra asignado por el usuario independiente para esta API. Fuera de las aplicaciones que han adquirido el permiso SynchronizationData-User.Upload con el consentimiento del administrador, solo los usuarios administradores con la función de administrador global pueden invocar la API. En este tutorial se muestra cómo probar la API con un rol de administrador global en la configuración de prueba.
Cargar datos de usuario en la API de aprovisionamiento entrante
Abra una nueva pestaña o ventana del navegador.
Inicie la URL https://aka.ms/ge para acceder a Microsoft Graph Explorer.
Haga clic en el icono de perfil de usuario para iniciar sesión.
Complete el proceso de inicio de sesión con una cuenta de usuario que tenga la función de administrador global.
Después de iniciar sesión correctamente, la información del inquilino muestra el nombre del inquilino.
Ya está listo para invocar la API.
En el panel solicitud de API, establezca el tipo de solicitud HTTP en POST.
Copie y pegue el punto de conexión de la API de aprovisionamiento recuperado de la página de información general de la aplicación de aprovisionamiento.
En el panel Encabezados de solicitud, agregue un nuevo par clave-valor de Content-Type = application/scim+json.
En el panel Cuerpo de la solicitud, copie y pegue la solicitud masiva con el esquema de usuario de SCIM Enterprise
Haga clic en el botón Ejecutar consulta para enviar la solicitud al punto de conexión de la API de aprovisionamiento.
Si la solicitud se envía correctamente, obtendrá una
Accepted 202respuesta del punto de conexión de la API.Abra el panel Encabezados de respuesta y copie el valor de dirección URL del atributo de localización. Esto apunta al punto de conexión de la API de registros de aprovisionamiento que puede consultar para comprobar el estado de aprovisionamiento de los usuarios presentes en la solicitud masiva.
Verificar el procesamiento de la carga útil de la solicitud masiva
Puede comprobar el procesamiento desde el centro de administración de Microsoft Entra o mediante Graph Explorer.
Verificar el procesamiento desde el centro de administración de Microsoft Entra
Inicie sesión en el Centro de administración de Microsoft Entra con al menos credenciales de inicio de sesión de Administrador de aplicaciones.
Vaya a Microsoft Entra ID: > Aplicaciones -> Aplicaciones empresariales.
En todas las aplicaciones, use el cuadro de texto del filtro de búsqueda para buscar y abrir la aplicación de aprovisionamiento controlado por API.
Abra la hoja Aprovisionamiento. La página de aterrizaje muestra el estado de la última ejecución.
Haga clic en Ver registros de aprovisionamiento para abrir la hoja de registros de aprovisionamiento. Como alternativa, puede hacer clic en la opción de menú Supervisión -> Aprovisionamiento de registros.
Haga clic en cualquier registro de los registros de aprovisionamiento para ver detalles de procesamiento adicionales.
La pantalla de detalles del registro de aprovisionamiento muestra todos los pasos ejecutados para un usuario específico.
- En el paso Importar desde la API, consulte los detalles de los datos de usuario extraídos de la solicitud masiva.
- En el paso Coincidencia de usuario se muestran los detalles de cualquier coincidencia de usuario en función del identificador correspondiente. Si se produce una coincidencia de usuario, el servicio de aprovisionamiento realiza una operación de actualización. Si no hay ninguna coincidencia de usuario, el servicio de aprovisionamiento realiza una operación de creación.
- En el paso Determinar si el usuario está en el ámbito se muestran los detalles de la evaluación del filtro de ámbito. De forma predeterminada, se procesan todos los usuarios. Si ha establecido un filtro de ámbito (por ejemplo, procesar solo los usuarios que pertenecen al departamento de ventas), los detalles de evaluación del filtro de ámbito se muestran en este paso.
- El paso Aprovisionar usuario llama al paso de procesamiento final y los cambios aplicados a la cuenta de usuario.
- Use la pestaña Propiedades modificadas para ver las actualizaciones de atributos.
Comprobación del procesamiento mediante la API de registros de aprovisionamiento en el Probador de Graph
Puede inspeccionar el procesamiento mediante la dirección URL de api de registros de aprovisionamiento devuelta como parte del encabezado de respuesta de ubicación en la llamada API de aprovisionamiento.
- En el Explorador de Graph, en el cuadro de texto Solicitar URL, copie y pegue la URL de ubicación devuelta por el extremo de la API de aprovisionamiento o puede construirla usando el formato:
https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>'donde puede recuperarjobIdde la página de descripción general de la aplicación de aprovisionamiento. - Use el método GET y haga clic en Ejecutar consulta para recuperar los registros de aprovisionamiento. De forma predeterminada, la respuesta devuelta contiene todas las entradas de registro.
- Puede establecer más filtros para recuperar solo los datos después de un período de tiempo determinado o con un valor de estado específico.
https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34ZTambién puede comprobar el estado del usuario por el valor usado en elexternalIdsistema de origen que se usa como la propiedad delimitador o combinación de origen.https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'
Apéndice
Solicitud masiva con el esquema de usuario empresarial de SCIM
La solicitud masiva que se muestra a continuación utiliza los esquemas estándar de usuario principal y de usuario de empresa de SCIM.
Cuerpo de la solicitud
{
"schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
"Operations": [
{
"method": "POST",
"bulkId": "897401c2-2de4-4b87-a97f-c02de3bcfc61",
"path": "/Users",
"data": {
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
"externalId": "701984",
"userName": "bjensen@example.com",
"name": {
"formatted": "Ms. Barbara J Jensen, III",
"familyName": "Jensen",
"givenName": "Barbara",
"middleName": "Jane",
"honorificPrefix": "Ms.",
"honorificSuffix": "III"
},
"displayName": "Babs Jensen",
"nickName": "Babs",
"emails": [
{
"value": "bjensen@example.com",
"type": "work",
"primary": true
}
],
"addresses": [
{
"type": "work",
"streetAddress": "100 Universal City Plaza",
"locality": "Hollywood",
"region": "CA",
"postalCode": "91608",
"country": "USA",
"formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA",
"primary": true
}
],
"phoneNumbers": [
{
"value": "555-555-5555",
"type": "work"
}
],
"userType": "Employee",
"title": "Tour Guide",
"preferredLanguage": "en-US",
"locale": "en-US",
"timezone": "America/Los_Angeles",
"active":true,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "701984",
"costCenter": "4130",
"organization": "Universal Studios",
"division": "Theme Park",
"department": "Tour Operations",
"manager": {
"value": "89607",
"displayName": "John Smith"
}
}
}
},
{
"method": "POST",
"bulkId": "897401c2-2de4-4b87-a97f-c02de3bcfc61",
"path": "/Users",
"data": {
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
"externalId": "701985",
"userName": "Kjensen@example.com",
"name": {
"formatted": "Ms. Kathy J Jensen, III",
"familyName": "Jensen",
"givenName": "Kathy",
"middleName": "Jane",
"honorificPrefix": "Ms.",
"honorificSuffix": "III"
},
"displayName": "Kathy Jensen",
"nickName": "Kathy",
"emails": [
{
"value": "kjensen@example.com",
"type": "work",
"primary": true
}
],
"addresses": [
{
"type": "work",
"streetAddress": "100 Oracle City Plaza",
"locality": "Hollywood",
"region": "CA",
"postalCode": "91618",
"country": "USA",
"formatted": "100 Oracle City Plaza\nHollywood, CA 91618 USA",
"primary": true
}
],
"phoneNumbers": [
{
"value": "555-555-5545",
"type": "work"
}
],
"userType": "Employee",
"title": "Tour Lead",
"preferredLanguage": "en-US",
"locale": "en-US",
"timezone": "America/Los_Angeles",
"active":true,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "701985",
"costCenter": "4130",
"organization": "Universal Studios",
"division": "Theme Park",
"department": "Tour Operations",
"manager": {
"value": "701984",
"displayName": "Barbara Jensen"
}
}
}
}
],
"failOnErrors": null
}