Categories: Active DirectoryAzureWindows Server 2016

IDFix: проверка on-prem Active Directory перед синхронизацией с Azure AD

Если вы планируете настроить синхронизацию вашей локальной (on-prem) Active Directory в Office 365/Azure Active Directory с помощью Azure AD Connector (AADConnect), то перед его установкой вам нужно проверить атрибуты объектов в вашей локальной ADDS на совместимость с Azure AD.

В Microsoft разработали специальную утилиту Microsoft Office 365 IdFix (Directory Synchronization Error Remediation Tool) для проверки on-premises Active Directory. Утилита IdFix позволяет просканировать вашу ADDS и найти пользователей, контакты или группы, которые не смогут по каким-то причинам синхронизироваться с Azure AD.

IdFix выявляет наиболее частые ошибки в атрибутах объектов Active Directory:

Недопустимые символы в именах объектов AD (в том числе начальные и конечные пробелы);
Дубликаты;
Недопустимые SMTP адреса, ошибки в MailNickName;
Объекты со значениями атрибутов, превышающими лимиты;
Наличие корректных маршрутизируемых UPN суффиксов (userPrincipalName) .

Как отмечает Microsoft, больше половины проблем, с которыми обращаются заказчики при обработке ошибок синхронизации с AAD связаны с неправильно заполненными атрибутами proxyAddresses и userPrincipalName, и дубликатами.

Утилита IdFix хранится на GitHub ( https://github.com/microsoft/idfix ) и вы можете скачать установочный файл setup.exe с помощью прямой ссылки. IdFix это ClickOnce приложение, поэтому для установки ему понадобится доступ в интернет, иначе появится ошибка:

An error occurred attempting to install IdFix_x000D_Error: An error occurred trying to download 'https://raw.githubusercontent.com/Microsoft/idfix/master/publish/IdFix.application'.

Кроме, того эта же ошибка появляется при попытке установить IdFix в Windows Server 2016/2019. Чтобы исправить ошибку, нужно временно включить SSL кэширование в реестре:

[HKEY_CURRENT_USERSoftwareMicrosoftWindowsCurrentVersionInternet Settings]_x000D_"DisableCachingOfSSLPages"=dword:00000000

Воспользуйтесь командой:
reg add "HKEY_CURRENT_USERSoftwareMicrosoftWindowsCurrentVersionInternet Settings" /v DisableCachingOfSSLPages /t reg_dword /d 00000000 /f
После этого установка IDFix запустится нормально.

После окончания работы с IdFix установите значение DisableCachingOfSSLPages равное 1.

Вы можете установить утилиту IdFix на любом компьютере домена. Запустите утилиту и нажмите кнопку Query.

Для запуска IdFix потребуется версия Microsoft .NET Framework 4.5.2 или выше

Утилита IdFix подключится к вашему локальному домену Active Directory и выведет список объектов, которые нужно исправить перед синхронизацией в Azure.

В нашем примере IdFix нашла несколько некорректных объектов в AD с ошибками трех типов:

Пустой атрибут displayName у одного аккаунта ( displayName = Blank );
Одинаковые значения атрибута mail у нескольких пользователей ( mail= Duplicate );
Немаршрутизируемый userPrincipalName (из домена .loc) у трех пользователей ( userPrincipalName= TopLevelDomain ).

Также возможны следующие ошибки:

Character – некорректные символы в атрибуте;
Format – некорректный формат значений атрибутов (например, SMTP адреса в неверном формате);
Length – превышена длина атрибута.

Если вы планируете синхронизировать найденных пользователей в Azure AD, нужно исправить эти ошибки. В поле Action вы можете выбрать действие, которое вы хотите выполнить с найденными атрибутами объектов AD (Edit, Remove, Complete). Если вы выбрали Edit, можно указать новое значение атрибута в поле Update.

Чтобы применить изменения, нажмите кнопку Accept -> Apply. Изменения применятся только к записям, для которых заданы значения в поле Action.

Также вы можете выгрузить найденный список объектов и ошибок в CSV файл. Можете проанализировать найденные проблемы в Excel , а затем внести изменения в AD с помощью стандартных командлетов PowerShell для работы с объектами Active Directory : Set-ADUser , Set-ADGroup , Set-ADComputer и т.д.

Если вы планируете синхронизировать в Azure только часть вашего каталога Active Directory, вы можете с помощью Settings указать критерии выборки объектов AD для анализа (с помощью LDAP фильтра). С помощью Search Base можно указать OU для анализа.

Утилита IDFix позволяет найти и исправить большое количество проблем, которые могут препятствовать синхронизации пользователей, контактов и групп из on-premises Active Directory в Azure Ad (Microsoft 365). Обязательно проверяйте свою наземную Active Directory перед настройкой синхронизации через Azure AD Connect.

admin