Compartir a través de


Aprovisionamiento de entrada basado en API de inicio rápido con Graph Explorer

En este tutorial se describe cómo probar rápidamente el aprovisionamiento de entrada controlado por API con el Explorador de Microsoft Graph.

Requisitos previos

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 asignable por el usuario para esta API. Fuera de las aplicaciones que adquirieron SynchronizationData-User.Upload permiso con el consentimiento del administrador, los usuarios administradores con el rol de Administrador de Usuarios pueden invocar la API. En este tutorial se muestra cómo puede probar la API con un rol de administrador de usuarios en la configuración de prueba.

Cargar datos de usuario en la API de aprovisionamiento entrante

  1. Abra una nueva pestaña o ventana del navegador.

  2. Inicie la URL https://aka.ms/ge para acceder a Microsoft Graph Explorer.

  3. Seleccione el icono de perfil de usuario para iniciar sesión.

    Imagen que muestra el icono de perfil de usuario.

  4. Complete el proceso de inicio de sesión con una cuenta de usuario que tenga acceso al rol Administrador de usuarios.

  5. Después de iniciar sesión correctamente, la información del inquilino muestra el nombre del inquilino.

    Captura de pantalla del nombre del inquilino.

    Ya está listo para invocar la API.

  6. En el panel solicitud de API, establezca el tipo de solicitud HTTP en POST.

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

  8. En el panel Encabezados de solicitud, agregue un nuevo par de valores clave de Content-Type = application/scim+json. Captura de pantalla del panel de encabezado de solicitud.

  9. En el panel Cuerpo de la solicitud, copie y pegue la solicitud masiva con el Esquema de Usuario Empresarial de SCIM.

  10. Seleccione en el botón Ejecutar consulta para enviar la solicitud al punto de conexión de la API de aprovisionamiento.

  11. Si la solicitud se envía correctamente, obtendrá una Accepted 202 respuesta del punto de conexión de la API.

  12. Abra el panel Encabezados de respuesta y copie el valor de dirección URL del atributo location. 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

Cuerpo de la solicitud

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "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": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "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
}
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

  1. Inicie sesión en el Centro de administración de Microsoft Entra con al menos credenciales de inicio de sesión del administrador de aplicaciones.

  2. Navegue a Entra ID>Aplicaciones empresariales.

  3. 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.

  4. Abra la hoja Aprovisionamiento. La página de aterrizaje muestra el estado de la última ejecución.

  5. Seleccione Ver registros de aprovisionamiento para abrir la hoja registros de aprovisionamiento. Como alternativa, puede seleccionar la opción de menú Supervisar>registros de aprovisionamiento.

    Captura de pantalla de los registros de aprovisionamiento en el menú.

  6. Seleccione cualquier registro de los registros de aprovisionamiento para ver detalles de procesamiento adicionales.

  7. 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.
    • El paso Coincidir usuario muestra los detalles de cualquier coincidencia de usuario en función del identificador coincidente. 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.
    • El paso Determinar si el usuario está en el ámbito muestra los detalles de la evaluación del filtro de ámbito. De forma predeterminada, se procesan todos los usuarios. Si establece un filtro de ámbito (por ejemplo, procesa 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 destaca el 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.

  1. En el Explorador de Graph, en el cuadro de texto URL de solicitud, copie y pegue la dirección URL devuelta por el punto de conexión de la API de aprovisionamiento, o puede construirla usando el formato: https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>', donde puede recuperar la jobId de la página de información general de la aplicación de aprovisionamiento.
  2. Use el método GET y seleccione Ejecutar consulta para recuperar los registros de aprovisionamiento. De forma predeterminada, la respuesta devuelta contiene todas las entradas de registro.
  3. 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:34Z También puede comprobar el estado del usuario por el valor usado en el externalId sistema 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 sigue usa el esquema de usuario principal estándar de SCIM y usuario empresarial.

Cuerpo de la solicitud

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "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": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "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
}

Pasos siguientes