Inicio rápido: Introducción al aprovisionamiento de entrada controlado por API mediante cURL

Introducción

cURL es una herramienta popular, gratuita, de código abierto y de línea de comandos que usan los desarrolladores de API y está disponible de forma predeterminada en Windows 10/11. En este tutorial se describe cómo probar rápidamente el aprovisionamiento de entrada controlado por API con cURL.

Requisitos previos

Ha configurado la aplicación de aprovisionamiento de entrada controlada por API.
Usted configuró un principal de servicio y tiene acceso a la API de aprovisionamiento de entrada. Anote los ClientId y ClientSecret de su aplicación principal de servicio para utilizarlos en este tutorial.

Carga de datos de usuario en la API de aprovisionamiento de entrada

Recupere el client_id y client_secret de la entidad de servicio que tiene acceso a la API de aprovisionamiento de entrada.
Utiliza el flujo de concesión de client_credentials de OAuth para obtener un token de acceso. Reemplace las variables [yourClientId], [yourClientSecret] y [yourTenantId] por los valores aplicables a la configuración y ejecute el siguiente comando cURL. Copia del valor del token de acceso generado
```
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=[yourClientId]&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default&client_secret=[yourClientSecret]&grant_type=client_credentials" "https://login.microsoftonline.com/[yourTenantId]/oauth2/v2.0/token"
```
Copie la solicitud masiva con SCIM Enterprise User Schema y guarde el contenido en un archivo denominado scim-bulk-upload-users.json.
Reemplace la variable [InboundProvisioningAPIEndpoint] por el punto de conexión de API de aprovisionamiento asociado a la aplicación de aprovisionamiento. Use el valor [AccessToken] del paso anterior y ejecute el siguiente comando curl para cargar la solicitud masiva en el punto de conexión de la API de aprovisionamiento.
```
curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
```
Tras una carga exitosa, recibirá el código de respuesta HTTP 202: Aceptado.
El servicio de aprovisionamiento comienza a procesar la carga de solicitud masiva inmediatamente y puede ver los detalles de aprovisionamiento accediendo a los registros de aprovisionamiento de la aplicación de aprovisionamiento entrante.

Comprobación del procesamiento de la carga de la solicitud masiva

Inicie sesión en el Centro de administración de Microsoft Entra como al menos un administrador de aplicaciones.
Vaya a Entra ID>Aplicaciones empresariales.
En todas las aplicaciones, use el cuadro de texto de filtro de búsqueda para buscar y abrir la aplicación de aprovisionamiento controlado por API.
Abra la hoja Aprovisionamiento. La página de inicio muestra el estado de la última ejecución.
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.
Seleccione cualquier registro de los registros de aprovisionamiento para ver más detalles de procesamiento.
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 paso de procesamiento final y los cambios que se aplican a la cuenta del usuario.
- Use la pestaña Propiedades modificadas para ver las actualizaciones de atributos.

Apéndice

Vea esta sección para obtener información sobre la petición en masa con el esquema de usuario empresarial de SCIM.

Solicitud en masa con el esquema de usuario empresarial de SCIM

La solicitud masiva que se muestra a continuación utiliza el esquema de Usuario Central estándar de SCIM y de 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

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-04-30