Сопоставление атрибутов — Active Directory с идентификатором Microsoft Entra

Функцию сопоставления атрибутов облачной синхронизации можно использовать для сопоставления атрибутов между локальными объектами пользователя или группы и объектами в идентификаторе Microsoft Entra.

В следующем документе описывается ограничение атрибутов с помощью Microsoft Entra Cloud Sync для провизирования из Active Directory в Microsoft Entra ID. Если вы ищете сведения о сопоставлении атрибутов из Microsoft Entra ID в AD, см. статью Сопоставление атрибутов — Microsoft Entra ID с Active Directory.

Сопоставление атрибутов по умолчанию можно настроить (изменить, удалить или создать) в соответствии с потребностями вашего бизнеса. Список атрибутов, синхронизированных, см. в разделе "Атрибуты", синхронизированные с идентификатором Microsoft Entra.

Примечание.

В этой статье описывается, как использовать Центр администрирования Microsoft Entra для сопоставления атрибутов. Сведения об использовании Microsoft Graph см. в разделе Преобразования.

Общие сведения о типах сопоставления атрибутов

С помощью сопоставления атрибутов вы управляете заполнением атрибутов в идентификаторе Microsoft Entra. Идентификатор Microsoft Entra поддерживает четыре типа сопоставления:

Тип сопоставления	Описание
Direct	Целевой атрибут заполняется значением атрибута связанного объекта в Active Directory.
Константа	Целевой атрибут заполняется определенной указанной вами строкой.
Выражение	Целевой атрибут заполняется на основе результата выражения, похожего на скрипт. Дополнительные сведения см. в Построителе выражений и написании выражений для сопоставлений атрибутов в Microsoft Entra ID.
Не допускается	Целевой атрибут остается без изменений. Тем не менее, если целевой атрибут пуст, он заполняется указанным вами значением по умолчанию.

Кроме этих четырех основных типов, в сопоставлениях настраиваемых атрибутов также поддерживается назначение значений по умолчанию. Назначение значений по умолчанию гарантирует, что целевой атрибут заполняется значением, если идентификатор Microsoft Entra или целевой объект не имеет значения. В наиболее распространенной конфигурации это поле остается пустым.

Обновления схемы и сопоставления

Облачная синхронизация иногда обновляет схему и список атрибутов по умолчанию, которые синхронизируются. Эти сопоставления атрибутов по умолчанию доступны для новых установок, но не будут автоматически добавлены в существующие установки. Чтобы добавить эти сопоставления, выполните указанные ниже действия.

1. Щелкните Добавить сопоставление атрибутов.
2. Выберите в раскрывающемся списке атрибут "Target".
3. Вы должны увидеть новые атрибуты, доступные здесь.

Список добавленных новых сопоставлений.

Добавленный атрибут	Тип сопоставления	Добавлен в версии агента
предпочтительное местоположение данных	Напрямую	1.1.359.0
НомерСотрудника	Напрямую	1.1.359.0
Тип пользователя	Напрямую	1.1.359.0

Дополнительные сведения о сопоставлении UserType см. в статье Сопоставление UserType при использовании облачной синхронизации.

Общие сведения о свойствах сопоставления атрибутов

Наряду со свойством типа, сопоставления атрибутов поддерживают определенные атрибуты. Эти атрибуты зависят от выбранного типа сопоставления. В следующих разделах описываются поддерживаемые сопоставления атрибутов для каждого из отдельных типов. Доступен следующий тип сопоставления атрибутов.

• Напрямую
• Константа
• Выражение

Атрибуты с прямым сопоставлением

Ниже приведены атрибуты, поддерживаемых прямым сопоставлением.

• Атрибут источника — атрибут пользователя из исходной системы (например, Active Directory).
• Целевой атрибут: атрибут пользователя в целевой системе (например, идентификатор Microsoft Entra).
• Значение по умолчанию, если значение NULL (необязательно): значение, передаваемое целевой системе, если исходный атрибут имеет значение NULL. Это значение подготавливается только при создании пользователя. Она не будет развернута при обновлении существующего пользователя.
• Примените это сопоставление:
  • Всегда — применять это сопоставление как при создании, так и при обновлении пользователей.
  • Только при создании — применять это сопоставление только для действий по созданию пользователя.

Атрибуты с константным сопоставлением

Ниже приведены атрибуты, поддерживаемые константным отображением.

• Постоянное значение — значение, которое необходимо применить к целевому атрибуту.
• Целевой атрибут: атрибут пользователя в целевой системе (например, идентификатор Microsoft Entra).
• Примените это сопоставление:
  • Всегда: применять это сопоставление как при создании, так и при обновлении.
  • Только при создании — применять это сопоставление только на действиях создания пользователя.

Атрибуты для сопоставления выражений

Ниже приведены атрибуты, поддерживаемые сопоставлением выражений.

• Выражение: это выражение, которое будет применяться к целевому атрибуту. Дополнительные сведения см. в Построителе выражений и написании выражений для сопоставлений атрибутов в Microsoft Entra ID.

• Значение по умолчанию, если значение NULL (необязательно): значение, передаваемое целевой системе, если исходный атрибут имеет значение NULL. Это значение подготавливается только при создании пользователя. Это не будет предоставлено при обновлении существующего пользователя.

• Целевой атрибут: атрибут пользователя в целевой системе (например, идентификатор Microsoft Entra).

• Применить это сопоставление:

  • Всегда: применять это сопоставление как при действиях создания, так и обновления.
  • Только при создании — применять это сопоставление только при создании пользователя.

Добавьте сопоставление атрибутов - AD в Microsoft Entra ID

Выполните следующие действия для настройки сопоставления атрибутов с конфигурацией AD в Microsoft Entra.

1. Войдите в центр администрирования Microsoft Entra как минимум в качестве администратора гибридных удостоверений .

2. Перейдите к Identity>гибридное управление>Microsoft Entra Connect>синхронизация с облаком.

   

3. В разделе Конфигурация выберите свою конфигурацию.
4. Слева выберите сопоставление атрибутов.
5. В верхней части убедитесь, что выбран правильный тип объекта. То есть пользователь, группа или контакт.
6. Щелкните Добавить сопоставление атрибутов.

7. Выберите тип сопоставления. Может иметь одно из следующих значений.

   • Прямое — целевой атрибут заполняется значением атрибута связанного объекта в Active Directory.
   • Постоянное — целевой атрибут заполняется определенной указанной вами строкой.
   • Выражение — целевой атрибут заполняется на основе результата выражения, похожего на сценарий.
   • Нет — целевой атрибут остается без изменений.

8. В зависимости от того, что вы выбрали на предыдущем шаге, для заполнения доступны различные параметры.

9. Выберите, когда применять это сопоставление, и нажмите кнопку Применить.

10. Вернитесь на экран Сопоставления атрибутов, где вы увидите новое сопоставление атрибутов.

11. Выберите Сохранить схему. Вы получите уведомление о том, что после сохранения схемы происходит синхронизация. Щелкните OK.

12. После успешного сохранения вы увидите уведомление справа.

Добавить сопоставление атрибутов — Microsoft Entra ID в Active Directory

Чтобы настроить сопоставление атрибутов с идентификатором Microsoft Entra с конфигурацией Active Directory, выполните следующие действия.

1. Войдите в центр администрирования Microsoft Entra как минимум в качестве администратора гибридных удостоверений .

2. Перейдите к Identity>гибридное управление>Microsoft Entra Connect>синхронизация с облаком.

   

3. В разделе "Конфигурация" выберите Microsoft Entra ID для конфигурации Active Directory.
4. Слева выберите сопоставление атрибутов.
5. В верхней части убедитесь, что выбран правильный тип объекта. То есть пользователь, группа или контакт.
6. Щелкните Добавить сопоставление атрибутов.

7. Выберите тип сопоставления. Тип сопоставления может быть одним из следующих типов:

   • Прямое — целевой атрибут заполняется значением атрибута связанного объекта в Active Directory.
   • Постоянное — целевой атрибут заполняется определенной указанной вами строкой.
   • Выражение — целевой атрибут заполняется на основе результата выражения, похожего на сценарий.
   • Нет — целевой атрибут остается без изменений.

8. В зависимости от того, что вы выбрали на предыдущем шаге, для заполнения доступны различные параметры.

9. Выберите, когда применять это сопоставление, и нажмите кнопку Применить.

10. Вернитесь на экран Сопоставления атрибутов, где вы увидите новое сопоставление атрибутов.

11. Выберите Сохранить схему. Вы получите уведомление о том, что после сохранения схемы происходит синхронизация. Щелкните OK.

12. После успешного сохранения вы увидите уведомление справа.

Тестирование сопоставления атрибутов

Чтобы протестировать сопоставление атрибутов, можно использовать подготовку по требованию:

1. Войдите в центр администрирования Microsoft Entra как минимум в качестве администратора гибридных удостоверений .

2. Перейдите к Identity>гибридное управление>Microsoft Entra Connect>синхронизация с облаком.

   

3. В разделе Конфигурация выберите свою конфигурацию.
4. Слева выберите "Подготовка по запросу".
5. Введите уникальное имя пользователя и нажмите кнопку Проведение.

6. Откроется экран успешного выполнения с четырьмя зелеными флажками. Все ошибки отображаются слева.

Следующие шаги

• Microsoft Entra Cloud Sync?
• Выражения для сопоставлений атрибутов
• Построитель выражений с облачной синхронизацией
• Атрибуты, синхронизированные с идентификатором Microsoft Entra