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 entrante controlada por API.
- Ha configurado una entidad de servicio y tiene acceso a la API de aprovisionamiento de entrada. Anote los
ClientIdyClientSecretde 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 el client_secret de la entidad de servicio que tiene acceso a la API de aprovisionamiento entrante.
- Use 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 generadocurl -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 el esquema de usuario de empresa de SCIM y guarde el contenido en un archivo llamado
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" - Después de una carga correcta, recibirá el código de respuesta HTTP 202 aceptada.
- 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 elCentro de administración de Microsoft Entra como Administrador de aplicaciones.
Vaya a Microsoft Entra ID -> Aplicaciones -> 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.
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 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.
- 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.
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 estándar de Usuario Básico y Usuario Empresarial de SCIM.
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
}