Коды ошибок синхронизации каталога (mpbx-dirsync, mpbx-api-directory::config::directory_sync)
Возвращаются маршрутами синхронизации каталога под /api/v1/directory/sources (W7-INT-02b). Сообщения
никогда не содержат пароль привязки, секрет клиента или токен. Руководство: синхронизация каталога.
| Код | HTTP | Значение | Что делать |
|---|---|---|---|
MPBX-DIRSYNC-NOT-FOUND | 404 | В этой компании нет источника каталога с таким идентификатором (источник другой компании не виден). | Проверьте идентификатор. |
MPBX-DIRSYNC-TOO-MANY | 409 | В компании уже 20 источников каталога. | Сначала удалите один. |
MPBX-DIRSYNC-NAME-TAKEN | 409 | Другой источник компании имеет это имя. | Выберите другое имя. |
MPBX-DIRSYNC-DISABLED | 409 | Источник выключен (enabled: false); синхронизировать его нельзя. | Сначала включите его. |
MPBX-DIRSYNC-CONNECT | 503 | До каталога не удалось достучаться, рукопожатие TLS не прошло (сертификат не действителен для имени хоста или не доверенный), Microsoft или сервер ответили ошибкой, либо ответ пришёл слишком долго. Неудачный запуск записывается. | Проверьте адрес и сеть; для частного CA укажите ldap.ca_certificate. |
MPBX-DIRSYNC-AUTH | 400 | Каталог отклонил учётные данные: привязка LDAP отклонена (неверный DN или пароль, заблокированная учётная запись), Microsoft отклонил учётные данные клиента либо Graph требует разрешение приложения User.Read.All с согласием администратора. | Исправьте учётную запись привязки или регистрацию приложения, затем синхронизируйте снова. |
MPBX-DIRSYNC-PROTOCOL | 503 | Каталог ответил неожиданно (не LDAP, не JSON, nextLink на другой хост, сообщение больше 4 МиБ). | Проверьте, что адрес — это порт LDAPS каталога. |
MPBX-DIRSYNC-SEARCH | 503 | Поиск не удался на стороне каталога: базового DN не существует, достигнут лимит размера на сервере или совпало более 100000 записей. | Исправьте базовый DN или сузьте фильтр. |
MPBX-DIRSYNC-BLOCKED | 400 | Адрес каталога — loopback, link-local (метаданные облака), многоадресный или неопределённый. Частные сетевые адреса разрешены. | Используйте настоящий адрес каталога. |
MPBX-DIRSYNC-CONFIG | 400 | Настройки непригодны (неверный фильтр, некорректный PEM CA, провайдер Microsoft без секрета клиента). | Исправьте источник. |
Проверка тела запроса (неверный URL ldaps://, фильтр, не соответствующий RFC 4515, отсутствующий пароль
привязки при смене адреса сервера) — это обычная проблема 400 с указанием поля.
Конфликты при запуске
Конфликт — не ошибка: запуск завершается со статусом conflicts и перечисляет записи, которые он оставил
без изменений (kind, external_id каталога, адрес электронной почты, учётная запись).
| Тип | Значение | Решение |
|---|---|---|
invalid_email | У записи нет пригодного адреса электронной почты. | Укажите адрес в каталоге. |
duplicate_email | Два элемента каталога имеют одинаковый адрес; ни один не синхронизируется. | Сделайте адреса в каталоге уникальными. |
email_exists | Учётная запись с этим адресом существует и не связана с записью. | Включите adopt_existing или переименуйте либо удалите учётную запись. |
linked_elsewhere | Адрес принадлежит учётной записи, связанной с другим источником. | Решите, какой источник владеет учётной записью. |
email_taken | Новый адрес записи занят другой учётной записью; связанная учётная запись сохраняет старый адрес. | Освободите адрес или исправьте каталог. |
protected_account | Учётная запись — Владелец (или учётная запись, от которой работает синхронизация); синхронизация её никогда не меняет. | Управляйте этой учётной записью вручную. |
empty_directory | Каталог вернул пустой список, но учётные записи связаны; никто не был отключён. | Проверьте фильтр, базовый DN или отдел. |