Поделиться через


Сопоставление атрибутов — 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>синхронизация с облаком.

    снимок экрана, на котором показана домашняя страница Microsoft Entra Connect Cloud Sync.

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

Снимок экрана: добавление сопоставления атрибутов.

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

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

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

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

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

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

Снимок экрана: успешное сохранение схемы.

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

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

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

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

    снимок экрана, на котором показана домашняя страница Microsoft Entra Connect Cloud Sync.

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

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

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

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

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

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

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

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

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

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

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

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

    снимок экрана, на котором показана домашняя страница Microsoft Entra Connect Cloud Sync.

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

Снимок экрана уникального имени пользователя.

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

Снимок экрана: успешное выполнение по запросу.

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