Inicio rápido del aprovisionamiento de entrada controlado por API con 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.
- 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.
Cargar datos de usuario en la API de aprovisionamiento entrante
- Recupere el client_id y client_secret de la entidad de servicio que tiene acceso a la API de aprovisionamiento de entrada.
- 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. Copie el 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 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 la solicitud masiva inmediatamente y, para ver los detalles de aprovisionamiento, puede acceder a los registros de aprovisionamiento de la aplicación de aprovisionamiento de entrada.
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 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.
Apéndice
Consulte esta sección para obtener información sobre la solicitud masiva con el esquema de usuario empresarial de SCIM.
Solicitud masiva con el esquema de usuario empresarial de SCIM
La solicitud masiva que se muestra a continuación usa el esquema de usuario principal 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": "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
}