Получение информации о группах безопасности AD
8 800 555-89-02
Войти
Документация
CTRL+K
Standalone2409
SaaS

Получение информации о группах безопасности AD с помощью GraphQL-запроса

В этой статье

Вы можете получить информацию о группах безопасности AD с помощью GraphQL-запроса в GraphiQL.

Важно

Перед тем, как выполнить GraphQL-запрос на получение информации о группах безопасности, необходимо настроить интеграцию AD на синхронизацию информации по группе.

Запрос для групп безопасности AD можно выполнить только от имени ключа API с назначенной привилегией «Пользователи и отделы» с операцией доступа R (чтение). Подробную информацию о том, как создать ключ API и назначить привилегии созданному ключу, вы можете найти в следующих разделах:

Настройте интеграцию AD с помощью следующего запроса:

mutation {
  app_config {
    active_directory {
      update_config(sync_employee_group_membership_enabled:true) {
        sync_employee_group_member_enabled
      }
    }
  }
}
Заметка

Синхронизация осуществляется по универсальной группе безопасности. Глобальная группа безопасности не поддерживается.

Варианты запроса для групп безопасности:

  1. Запрос без фильтра:
    {
      active_directory {
        ad_group {
          employee_ad_groups {
            employee_id
            canonical_names
            distinguished_names
            names
          }
        }
      }
    } 
    
  2. Запрос с фильтром по пользователям:
    {
      active_directory {
        ad_group {
          employee_ad_groups(ids:[<id_пользователя_1>, <id_пользователя_2>]) { 
            employee_id
            canonical_names
            distinguished_names
            names
          }
        }
      }
    }
    

Пример ответа:

{
  "data": {
    "active_directory": {
      "ad_group": {
        "employee_ad_groups": [
          {
            "employee_id": 11,
            "canonical_names": [
              "dmitry.local/root/users/Users"
            ],
            "distinguished_names": [
              "CN=Users,OU=users,OU=root,DC=dmitry,DC=local"
            ],
            "names": [
              "Users"
            ]
          }
        ]
      }
    }
  }
} 
ПолеОпределение
employee_ad_groupsПользователь с группами безопасности AD
employee_idИдентификатор пользователя
canonical_namesИмя пользователя в каноническом формате
distinguished_namesУникальное имя пользователя
namesНазвание группы безопасности

Запрос также можно выполнить через блок автоматизации «HTTP-запрос». Подробная информация о работе этого блока представлена в разделе Работа с сервисами.

Была ли статья полезна?

Да
Нет
Предыдущая
Синхронизируемые атрибуты между системой и AD
8 (800) 555-89-028 (495) 150-31-45team@infomaximum.com
Для бизнеса
© 20102024. ООО «Инфомаксимум»
Мы используем файлы cookies, чтобы сайт был лучше для вас.