Códigos de error de sincronización de directorio (mpbx-dirsync, mpbx-api-directory::config::directory_sync)
Los genera las rutas de sincronización de directorio bajo /api/v1/directory/sources (W7-INT-02b). Los mensajes nunca
contienen una contraseña de enlace, un secreto de cliente ni un token. Guía: Sincronización de directorio.
| Código | HTTP | Significado | Qué hacer |
|---|---|---|---|
MPBX-DIRSYNC-NOT-FOUND | 404 | No existe una fuente de directorio con este id en esta empresa (la fuente de otra empresa no es visible). | Verifique el id. |
MPBX-DIRSYNC-TOO-MANY | 409 | La empresa ya tiene 20 fuentes de directorio. | Elimine primero una. |
MPBX-DIRSYNC-NAME-TAKEN | 409 | Otra fuente de la empresa tiene este nombre. | Elija otro nombre. |
MPBX-DIRSYNC-DISABLED | 409 | La fuente está desactivada (enabled: false); no se puede sincronizar. | Actívela primero. |
MPBX-DIRSYNC-CONNECT | 503 | No se pudo contactar al directorio, falló el protocolo TLS (certificado no válido para el nombre de host o no confiable), Microsoft o el servidor respondió con un error, o tardó demasiado. La ejecución fallida queda registrada. | Revise la dirección y la red; para una CA privada, indique ldap.ca_certificate. |
MPBX-DIRSYNC-AUTH | 400 | El directorio rechazó las credenciales: el enlace LDAP fue rechazado (DN o contraseña incorrectos, cuenta bloqueada), Microsoft rechazó las credenciales de cliente, o Graph necesita el permiso de aplicación User.Read.All con consentimiento de administrador. | Corrija la cuenta de enlace o el registro de la aplicación, y luego sincronice de nuevo. |
MPBX-DIRSYNC-PROTOCOL | 503 | El directorio respondió algo inesperado (no es LDAP, no es JSON, un nextLink a otro host, un mensaje de más de 4 MiB). | Verifique que la dirección sea el puerto LDAPS del directorio. |
MPBX-DIRSYNC-SEARCH | 503 | La búsqueda falló del lado del directorio: el DN base no existe, se alcanzó el límite de tamaño del servidor, o coincidieron más de 100000 entradas. | Corrija el DN base o reduzca el filtro. |
MPBX-DIRSYNC-BLOCKED | 400 | La dirección del directorio es de loopback, link-local (metadatos de la nube), multicast o no especificada. Las direcciones de red privada están permitidas. | Use la dirección real del directorio. |
MPBX-DIRSYNC-CONFIG | 400 | La configuración no es utilizable (filtro incorrecto, PEM de CA incorrecto, un proveedor Microsoft sin secreto de cliente). | Corrija la fuente. |
La validación del cuerpo de una solicitud (URL ldaps:// incorrecta, un filtro que no cumple RFC 4515, una contraseña de enlace
faltante al cambiar la dirección del servidor) es el problema 400 habitual con el campo que causa el error.
Conflictos en una ejecución
Un conflicto no es un error: la ejecución termina con el estado conflicts y enumera las entradas que dejó sin cambios
(kind, el external_id del directorio, la dirección de correo electrónico, la cuenta involucrada).
| Tipo | Significado | Resolución |
|---|---|---|
invalid_email | La entrada no tiene una dirección de correo electrónico utilizable. | Complete la dirección en el directorio. |
duplicate_email | Dos entradas del directorio tienen la misma dirección; no se sincroniza ninguna. | Haga que las direcciones sean únicas en el directorio. |
email_exists | Existe una cuenta con esta dirección y no está vinculada a la entrada. | Active adopt_existing, o renombre o elimine la cuenta. |
linked_elsewhere | La dirección pertenece a una cuenta vinculada a otra fuente. | Decida qué fuente es dueña de la cuenta. |
email_taken | La nueva dirección de la entrada la tiene otra cuenta; la cuenta vinculada conserva su dirección anterior. | Libere la dirección o corrija el directorio. |
protected_account | La cuenta es un Propietario (o es la cuenta que ejecuta la sincronización); una sincronización nunca la cambia. | Administre esa cuenta manualmente. |
empty_directory | El directorio no devolvió entradas, pero hay cuentas vinculadas; no se desactivó a nadie. | Revise el filtro, el DN base o el departamento. |