Solución de problemas de la API SCIM de Microsoft Entra ID

Este artículo ayuda a solucionar problemas comunes encontrados al usar las API SCIM de Microsoft Entra ID para la gestión de usuarios y grupos.

Error: 401: token de autenticación no válido

Síntomas

Las solicitudes de API de SCIM devuelven:

HTTP 401 Unauthorized

Causa

La solicitud no incluye un token de acceso válido en el encabezado HTTP Authorization .

Resolution

1. Confirme que la solicitud incluye un token de portador en el encabezado HTTP Authorization .
2. Validación del token de acceso mediante https://jwt.ms/
3. Compruebe las siguientes reclamaciones del token:
   • iat
   • exp
4. Si el problema persiste:
   • Recopilar detalles de la llamada a la API fallida
   • Crear un ticket de soporte

Error: 403 – Prohibido

Síntomas

Las solicitudes de API de SCIM devuelven:

HTTP 403 Forbidden

Causa

El registro de aplicaciones usado por el cliente de LA API de SCIM no tiene los permisos de API necesarios o no tiene concedido el consentimiento del administrador.

Resolution

1. Revisa el registro de la aplicación usado por el cliente de la API SCIM.
2. Confirme que se asignan los permisos de la API de Microsoft Graph como se documenta en la referencia de la API SCIM de Microsoft Entra ID :
3. Confirme que se ha concedido el consentimiento del administrador para todos los permisos asignados.
4. Si el problema persiste:
   • Recopilación de detalles de la solicitud de API
   • Crear un ticket de soporte

Error: 404: recurso no encontrado

Síntomas

Las siguientes llamadas API devuelven:

HTTP 404 Not Found

• GET /users/{id}
• GET /groups/{id}

Causa

El valor {id} de la solicitud no se resuelve en un objeto de usuario o grupo válido en el tenant de Microsoft Entra ID.

Resolution

1. Confirme que el valor {id} existe en el cliente de Microsoft Entra ID.
2. Si el problema persiste:
   • Recopilación de detalles de la solicitud de API
   • Crear un ticket de soporte

Error: 400 : solicitud incorrecta

Síntomas

Las solicitudes de API de SCIM devuelven:

HTTP 400 Bad Request

Este error puede producirse durante:

• Operaciones de creación o actualización de usuarios
  (POST /Users o PATCH /Users)
• Operaciones de creación o actualización de grupos
  (POST /Groups o PATCH /Groups)
• Consultas de filtro de usuario o grupo
  (GET)

Causa

La carga de solicitud o los parámetros de consulta no cumplen las restricciones definidas para la API sciM o hacen referencia a atributos de esquema SCIM no válidos.

Resolution

1. Para POST operaciones:
   • Asegúrese de que todos los atributos necesarios se incluyen en la carga de la solicitud.
2. Para operaciones de PATCH:
   • Asegúrese de que la solicitud cumple con las restricciones de LA API de SCIM.
3. Para las operaciones GET:
   • Confirme que solo se usan filtros de API admitidos.
4. Asegúrese de que los atributos de solicitud se asignan a atributos de esquema de Microsoft Entra SCIM válidos.
5. Vuelva a enviar la solicitud con correcciones.
6. Si el problema persiste:
   • Recopilación de detalles de la solicitud de API
   • Crear un ticket de soporte

Error: 400: característica de API de aprovisionamiento de SCIM no habilitada

Síntomas

Las solicitudes de API de SCIM devuelven:

HTTP 400 Bad Request

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:Error"
  ],
  "detail": "No 'scimapiconsumptions' resource found for TenantId: <tenant-id>. Please ensure 'SCIM Provisioning API' feature is enabled and only one 'scimapiconsumptions' resource exists.",
  "status": "400"
}

Causa

La característica API de aprovisionamiento SCIM no está habilitada en el Centro de administración de Microsoft Entra, o la suscripción de facturación necesaria para esta característica no se ha vinculado. El recurso de Azure se crea cuando un administrador activa la característica y vincula una suscripción de Azure para la facturación. Sin este recurso, el servicio SCIM rechaza todas las llamadas API.

Resolution

1. Inicie sesión en el Centro de administración de Microsoft Entra.
2. Dirígete a ID Governance>Dashboard.
3. En el icono de LA API de aprovisionamiento de SCIM , seleccione Introducción (o Editar si se configuró previamente).
4. Vincule una suscripción de Azure, seleccione un grupo de recursos y seleccione Activar.
5. Una vez habilitada la característica, vuelva a intentar la solicitud de API de SCIM.

Para obtener pasos detallados, consulte Habilitación de la API de aprovisionamiento de SCIM.

Error: 500: error interno del servidor

Síntomas

Las solicitudes de API de SCIM devuelven:

HTTP 500 Internal Server Error

Causa

Se produjo un error inesperado en el lado servidor al procesar la solicitud de API de SCIM.

Resolution

1. Recopile detalles de la llamada API fallida.
2. Cree un ticket de soporte técnico.

Error: 504 – Tiempo de espera de la pasarela

Síntomas

Las solicitudes de API de SCIM devuelven:

HTTP 504 Gateway Timeout

Causa

El servicio SCIM puede devolver respuestas 504 intermitentes.

Resolution

1. Recopile detalles de las llamadas API con errores y el período de tiempo de los errores.
2. Cree un ticket de soporte si el problema persiste.

Referencia del código de error de API de SCIM

En la tabla siguiente se enumeran todos los códigos de error que pueden devolver las API SCIM de Id. de Microsoft Entra. Use esta tabla para identificar el error y su causa al solucionar problemas de solicitudes de API de SCIM.