Microsoft Entra ID

Microsoft Entra ID — это облачное решение для управления удостоверениями и доступом, которое расширяет локальные каталоги в облаке и предоставляет единый вход тысячам облачных приложений (SaaS) и доступа к веб-приложениям, которые выполняются локально.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate
Логические приложения Стандарт Все регионы Logic Apps
Power Apps Стандарт Все регионы Power Apps
Power Automate Стандарт Все регионы Power Automate
Контакт
Имя Microsoft
URL https://support.microsoft.com
Метаданные соединителя
Publisher Microsoft
Политика конфиденциальности https://privacy.microsoft.com/privacystatement
Веб-сайт https://azure.microsoft.com/services/active-directory
Категории ИТ-операции; Безопасность

Чтобы использовать эту интеграцию, вам потребуется доступ к учетной записи Microsoft Entra ID с достаточными привилегиями. Чтобы сделать подключение, нажмите кнопку "Войти". Вам будет предложено указать сведения о учетной записи, следуйте остальным экранам, чтобы создать подключение.

Чтобы использовать соединитель Microsoft Entra ID, учетная запись должна иметь следующие разрешения администратора:

  • Group.ReadWrite.All
  • User.ReadWrite.All
  • Directory.ReadWrite.All

Дополнительные сведения о разрешениях Graph и их настройке см. здесь.

Теперь вы готовы начать использовать эту интеграцию.

Известные проблемы и ограничения

  1. Соединитель не возвращает настраиваемые атрибуты сущностей Microsoft Entra ID.
  2. Соединитель не поддерживает группы безопасности Mail-Enabled.
  3. Microsoft Entra ID группу с атрибутом IsAssignableToRole пока не поддерживается.
  4. Если вы развернули Azure условный доступ (Microsoft Entra ID MFA), соединитель не будет работать должным образом. Чтобы устранить эту проблему, ознакомьтесь с этим решением.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 200 60 секунд

Действия

Вывод группы

Получение сведений о группе.
Добавление пользователя в группу

Добавьте пользователя в группу в этом клиенте Microsoft Entra ID.
Маркеры обновления

Отмена всех маркеров обновления для пользователя
Назначение руководителя

Назначьте диспетчер для пользователя.
Обновление пользователя

Обновите сведения для пользователя.
Получение групп пользователя (версия 2)

Получение групп, в которые входит пользователь.
Получение групп пользователя [DEPRECATED]

Это действие устарело. Вместо этого используйте группы Get пользователя (V2).

Получение групп, в которые входит пользователь.
Получение пользователя

Получение сведений о пользователе.
Получение участников группы

Получите пользователей, являющихся членами группы. Вы можете запрашивать до 1000 элементов с помощью верхнего параметра. Если необходимо получить более 1000 значений, включите функцию settings-Pagination> и предоставьте пороговое значение.
Проверка членства в группах (версия 2)

Если пользователь является членом данной группы, результат будет содержать указанный идентификатор. В противном случае результат будет пустым.
Проверка членства в группе [DEPRECATED]

Это действие устарело. Вместо этого используйте проверку членства в группах (V2).

Если пользователь является членом данной группы, результат будет содержать указанный идентификатор. В противном случае результат будет пустым.
Создание группы

Создайте группу в клиенте Microsoft Entra ID.
Создание группы Office 365

Создайте группу Office 365 в клиенте Microsoft Entra ID.
Создание группы безопасности

Создайте группу безопасности в клиенте Microsoft Entra ID.
Создание пользователя

Создайте пользователя в клиенте Microsoft Entra ID.
Удаление участника из группы

Удаление участника из группы

Вывод группы

Идентификатор операции:
GetGroup

Получение сведений о группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 id True string

Уникальный идентификатор группы (Ex. 40639f36-46a6-73a6-91e2-9584b7913429').

Возвращаемое значение

Тело
GetGroup_Response

Добавление пользователя в группу

Идентификатор операции:
AddUserToGroup

Добавьте пользователя в группу в этом клиенте Microsoft Entra ID.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 id True string

Уникальный идентификатор группы (Ex. 40639f36-46a6-73a6-91e2-9584b7913429').
Идентификатор пользователя
 @odata.id True string

Уникальный идентификатор пользователя (Ex. 5e6cf5c7-b511-4842-6aae-3f6b8ae5e95b).

Маркеры обновления

Идентификатор операции:
RefreshTokens

Отмена всех маркеров обновления для пользователя

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя или имя участника
 id True string

Уникальный идентификатор пользователя (ex. 'user@tennant.onmicrosoft.com' или '5f6ce5c7-b521-4842-9bbe-3f6d5aa5e35b').

Назначение руководителя

Идентификатор операции:
AssignManager

Назначьте диспетчер для пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя или имя участника
 id True string

Уникальный идентификатор пользователя (ex. 'user@tennant.onmicrosoft.com' или '5f6ce5c7-b521-4842-9bbe-3f6d5aa5e35b').
Идентификатор пользователя диспетчера
 @odata.id True string

Уникальный идентификатор руководителя (Ex. 5f6cf5c7-a561-4842-9aae-3e6d8ce5e95b).

Обновление пользователя

Идентификатор операции:
UpdateUser

Обновите сведения для пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя или имя участника
 id True string

Уникальный идентификатор пользователя (ex. 'user@tennant.onmicrosoft.com' или '5f6ce5c7-b521-4842-9bbe-3f6d5aa5e35b').
Основное имя пользователя
 userPrincipalName string

Учетное имя (UPN) пользователя.
Отображаемое имя
 displayName string

Имя пользователя, отображаемое в адресной книге.
Прозвище почты
 mailNickname string

Почтовый псевдоним для пользователя.
Заданное имя
 givenName string

Простое имя пользователя.
Surname
 surname string

Фамилия пользователя.
Включена учетная запись
 accountEnabled boolean

Значение True, если новая учетная запись должна быть включена.
Должность
 jobTitle string

Должность пользователя.
Отдел
 department string

Имя отдела, в котором работает пользователь.
Мобильный телефон
 mobilePhone string

Номер мобильного телефона для пользователя в любом формате, например "1 (234) 567-8910".
Расположение Office
 officeLocation string

Расположение офиса на месте работы пользователя.
Предпочтительный язык
 preferredLanguage string

Предпочитаемый язык для пользователя. Должен соответствовать коду ISO 639-1; например,en-US'.
businessPhones
 businessPhones array of string
otherMails
 otherMails array of string
Дополнительные свойства
 customProperties object

Имя и значение свойства бесплатной формы для этого пользователя.
Первый настраиваемый атрибут расширения
 extensionAttribute1 string

Первый настраиваемый атрибут расширения.
Второй настраиваемый атрибут расширения
 extensionAttribute2 string

Второй настраиваемый атрибут расширения.
Третий настраиваемый атрибут расширения
 extensionAttribute3 string

Третий настраиваемый атрибут расширения.
Четвертый настраиваемый атрибут расширения
 extensionAttribute4 string

Четвертый настраиваемый атрибут расширения.
Пятый настраиваемый атрибут расширения
 extensionAttribute5 string

Пятый настраиваемый атрибут расширения.
Шестой настраиваемый атрибут расширения
 extensionAttribute6 string

Шестой настраиваемый атрибут расширения.
Седьмой настраиваемый атрибут расширения
 extensionAttribute7 string

Седьмой настраиваемый атрибут расширения.
Восьмой настраиваемый атрибут расширения
 extensionAttribute8 string

Восьмой настраиваемый атрибут расширения.
Девятый настраиваемый атрибут расширения
 extensionAttribute9 string

Девятый настраиваемый атрибут расширения.
Десятый настраиваемый атрибут расширения
 extensionAttribute10 string

Десятый настраиваемый атрибут расширения.
Одиннадцатый настраиваемый атрибут расширения
 extensionAttribute11 string

Одиннадцатый настраиваемый атрибут расширения.
Двенадцатый настраиваемый атрибут расширения
 extensionAttribute12 string

Двенадцатый настраиваемый атрибут расширения.
Тринадцатый настраиваемый атрибут расширения
 extensionAttribute13 string

Тринадцатый настраиваемый атрибут расширения.
Четырнадцатый настраиваемый атрибут расширения
 extensionAttribute14 string

10-й настраиваемый атрибут расширения.
Пятнадцатый настраиваемый атрибут расширения
 extensionAttribute15 string

Пятнадцатый настраиваемый атрибут расширения.

Получение групп пользователя (версия 2)

Идентификатор операции:
GetMemberGroupsV2

Получение групп, в которые входит пользователь.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя или имя участника
 id True string

Уникальный идентификатор пользователя (ex. 'user@tennant.onmicrosoft.com' или '5f6ce5c7-b521-4842-9bbe-3f6d5aa5e35b').
Только для обеспечения безопасности
 securityEnabledOnly True boolean

Определяет, следует ли получить только группы с поддержкой безопасности.

Возвращаемое значение

Тело
GetMemberGroups_Response_V2

Получение групп пользователя [DEPRECATED]

Идентификатор операции:
GetMemberGroups

Это действие устарело. Вместо этого используйте группы Get пользователя (V2).

Получение групп, в которые входит пользователь.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя или имя участника
 id True string

Уникальный идентификатор пользователя (ex. 'user@tennant.onmicrosoft.com' или '5f6ce5c7-b521-4842-9bbe-3f6d5aa5e35b').
Только для обеспечения безопасности
 securityEnabledOnly True boolean

Определяет, следует ли получить только группы с поддержкой безопасности.

Возвращаемое значение

Товары
GetMemberGroups_Response

Получение пользователя

Идентификатор операции:
GetUser

Получение сведений о пользователе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя или имя участника
 id True string

Уникальный идентификатор пользователя (ex. 'user@tennant.onmicrosoft.com' или '5f6ce5c7-b521-4842-9bbe-3f6d5aa5e35b').

Возвращаемое значение

Тело
GetUser_Response

Получение участников группы

Идентификатор операции:
GetGroupMembers

Получите пользователей, являющихся членами группы. Вы можете запрашивать до 1000 элементов с помощью верхнего параметра. Если необходимо получить более 1000 значений, включите функцию settings-Pagination> и предоставьте пороговое значение.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 id True string

Уникальный идентификатор группы (Ex. 40639f36-46a6-73a6-91e2-9584b7913429').
Верх
 $top integer

Ограничение на количество возвращаемых результатов (от 1 до 999 по умолчанию — 100).

Возвращаемое значение

Тело
GetGroupMembers_Response

Проверка членства в группах (версия 2)

Идентификатор операции:
CheckMemberGroupsV2

Если пользователь является членом данной группы, результат будет содержать указанный идентификатор. В противном случае результат будет пустым.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя или имя участника
 id True string

Уникальный идентификатор пользователя (ex. 'user@tennant.onmicrosoft.com' или '5f6ce5c7-b521-4842-9bbe-3f6d5aa5e35b').
идентификаторы групп
 groupIds True array of string

Возвращаемое значение

Тело
GetMemberGroups_Response_V2

Проверка членства в группе [DEPRECATED]

Идентификатор операции:
CheckMemberGroups

Это действие устарело. Вместо этого используйте проверку членства в группах (V2).

Если пользователь является членом данной группы, результат будет содержать указанный идентификатор. В противном случае результат будет пустым.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя или имя участника
 id True string

Уникальный идентификатор пользователя (ex. 'user@tennant.onmicrosoft.com' или '5f6ce5c7-b521-4842-9bbe-3f6d5aa5e35b').
идентификаторы групп
 groupIds True array of string

Возвращаемое значение

Товары
GetMemberGroups_Response

Создание группы

Идентификатор операции:
CreateGroup

Создайте группу в клиенте Microsoft Entra ID.

Параметры

Имя Ключ Обязательно Тип Описание
Отображаемое имя
 displayName True string

Отображаемое имя новой группы.
Description
 description True string

Описание новой группы.
Прозвище почты
 mailNickname True string

Псевдоним почты новой группы.
groupTypes
 groupTypes True array of string

Выберите "Унифицированный" для группы O365. Выберите "Нет" для группы безопасности.
Включена безопасность
 securityEnabled True boolean

Значение true, если новая группа является группой безопасности.
Почта включена
 mailEnabled True boolean

Значение True, если новая группа — это группа рассылки.

Возвращаемое значение

Тело
CreateGroup_Response

Создание группы Office 365

Идентификатор операции:
CreateOffice365Group

Создайте группу Office 365 в клиенте Microsoft Entra ID.

Параметры

Имя Ключ Обязательно Тип Описание
Отображаемое имя
 displayName True string

Отображаемое имя новой группы.
Description
 description True string

Описание новой группы.
Прозвище почты
 mailNickname True string

Псевдоним почты новой группы.
groupTypes
 groupTypes True array of string

Для Office 365 тип группы имеет значение Unified.
Включена безопасность
 securityEnabled True boolean

Значение true, если новая группа является группой безопасности.
Почта включена
 mailEnabled True boolean

Значение True, если новая группа — это группа рассылки.

Возвращаемое значение

Тело
CreateGroup_Response

Создание группы безопасности

Идентификатор операции:
CreateSecurityGroup

Создайте группу безопасности в клиенте Microsoft Entra ID.

Параметры

Имя Ключ Обязательно Тип Описание
Отображаемое имя
 displayName True string

Отображаемое имя новой группы.
Description
 description True string

Описание новой группы.
Прозвище почты
 mailNickname True string

Псевдоним почты новой группы.
Включена безопасность
 securityEnabled True boolean

Значение true, если новая группа является группой безопасности.
Почта включена
 mailEnabled True boolean

Значение True, если новая группа — это группа рассылки.

Возвращаемое значение

Тело
CreateGroup_Response

Создание пользователя

Идентификатор операции:
CreateUser

Создайте пользователя в клиенте Microsoft Entra ID.

Параметры

Имя Ключ Обязательно Тип Описание
Включена учетная запись
 accountEnabled True boolean

Значение True, если новая учетная запись должна быть включена при ее создании.
Отображаемое имя
 displayName True string

Имя пользователя, отображаемое в адресной книге.
Прозвище почты
 mailNickname True string

Почтовый псевдоним для пользователя.
Пароль
 password True string

Пароль пользователя. Пользователю потребуется изменить пароль для следующего входа.
Основное имя пользователя
 userPrincipalName True string

Учетное имя (UPN) пользователя.
Заданное имя
 givenName string

Заданное имя пользователя (имя).
Surname
 surname string

Фамилия пользователя.
businessPhones
 businessPhones array of string
Отдел
 department string

Имя отдела, в котором работает пользователь.
Должность
 jobTitle string

Должность пользователя.
Мобильный телефон
 mobilePhone string

Номер мобильного телефона для пользователя в любом формате, например "1 (234) 567-8910".
Расположение Office
 officeLocation string

Расположение офиса на месте работы пользователя.
Предпочтительный язык
 preferredLanguage string

Предпочитаемый язык для пользователя. Должен соответствовать коду ISO 639-1; например,en-US'.

Возвращаемое значение

Тело
GetUser_Response

Удаление участника из группы

Идентификатор операции:
RemoveMemberFromGroup

Удаление участника из группы

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Идентификатор группы.
Идентификатор участника
 memberId True string

Идентификатор члена.

Определения

CreateGroup_Response

Имя Путь Тип Описание
@odata.context
 @odata.context string

@odata.context
id
 id string

id
deletedDateTime
 deletedDateTime string

deletedDateTime
classification
 classification string

classification
createdDateTime
 createdDateTime date-time

createdDateTime
описание
 description string

описание
отображаемое имя
 displayName date-time

отображаемое имя
groupTypes
 groupTypes array of string

groupTypes
почта
 mail string

почта
mailEnabled
 mailEnabled boolean

mailEnabled
мейлНикнейм
 mailNickname date-time

мейлНикнейм
onPremisesLastSyncDateTime
 onPremisesLastSyncDateTime string

onPremisesLastSyncDateTime
Идентификатор безопасности на месте (onPremisesSecurityIdentifier)
 onPremisesSecurityIdentifier string

Идентификатор безопасности на месте (onPremisesSecurityIdentifier)
onPremisesSyncEnabled
 onPremisesSyncEnabled boolean

onPremisesSyncEnabled
прокси-адреса
 proxyAddresses array of string

прокси-адреса
renewedDateTime
 renewedDateTime date-time

renewedDateTime
securityEnabled
 securityEnabled boolean

securityEnabled
видимость
 visibility string

видимость

GetGroup_Response

Имя Путь Тип Описание
Идентификатор
 id string

Уникальный идентификатор группы.
Удаленное время даты
 deletedDateTime date-time

Дата удаления группы.
Время создания даты
 createdDateTime date-time

Дата создания группы.
Description
 description string

Необязательное описание группы.
Отображаемое имя
 displayName string

Отображаемое имя группы.
Mail
 mail string

SMTP-адрес группы.
Почта включена
 mailEnabled boolean

Значение True, если группа включена по почте.
Время последней синхронизации в локальной среде
 onPremisesLastSyncDateTime date-time

Дата, указывающее время последнего синхронизации группы с локальным каталогом.
Включена локальная синхронизация
 onPremisesSyncEnabled boolean

Значение true, если эта группа синхронизирована из локального каталога.
Включена безопасность
 securityEnabled boolean

Значение True, если группа является группой безопасности.
Видимость
 visibility string

Видимость группы (общедоступная или частная).

GetUser_Response

Имя Путь Тип Описание
Идентификатор
 id string

Уникальный идентификатор для пользователя.
Бизнес-телефоны
 businessPhones array of string
Отображаемое имя
 displayName string

Имя пользователя, отображаемое в адресной книге.
Заданное имя
 givenName string

Простое имя пользователя.
Должность
 jobTitle string

Должность пользователя.
Mail
 mail string

SMTP-адрес пользователя.
Мобильный телефон
 mobilePhone string

Основной сотовый телефон пользователя.
Расположение Office
 officeLocation string

Расположение офиса на месте работы пользователя.
Предпочтительный язык
 preferredLanguage string

Предпочитаемый язык для пользователя. Должен соответствовать коду ISO 639-1; например,en-US'.
Surname
 surname string

Фамилия пользователя.
Основное имя пользователя
 userPrincipalName string

Учетное имя (UPN) пользователя.

GetMemberGroups_Response

Имя Путь Тип Описание
Идентификатор группы участников
 string

Идентификатор группы, в который входит пользователь.

GetMemberGroups_Response_V2

Имя Путь Тип Описание
value
 value GetMemberGroups_Response

GetGroupMembers_Response

Имя Путь Тип Описание
Члены группы
 value array of GetUser_Response

Массив пользователей, являющихся членами группы.