Яндекс Администрирование
| Интеграция работает только с корпоративными аккаунтами Яндекс. |
Доступные операции
-
Получить сотрудника выбранной организации Яндекс 360 по ID каталога.
-
Показать или найти сотрудников в выбранной доверенным запросом организации.
-
Получить отдел выбранной организации Яндекс 360 по ID каталога.
-
Показать или найти отделы в выбранной доверенным запросом организации.
-
Получить группу выбранной организации Яндекс 360 по ID каталога.
-
Показать или найти группы в выбранной доверенным запросом организации.
-
Показать сотрудников, отделы, группы, контакты и ящики в одной группе.
-
Показать организации Яндекс 360, доступные авторизованному администратору.
-
Показать состояние конфигурации без раскрытия токенов и секретов клиентов.
-
Показать доступные интеграции с сервисами Яндекса и их ограничения.
Подготовка и добавление из витрины
| Подготовка выполняется администратором GigaCowork. |
Для работы требуется созданное OAuth-приложение яндекса.
-
Перейдите по адресу https://oauth.yandex.ru и авторизуйтесь в учетной записи Яндекс.
-
Выберите Ваши приложения → Создать и выберите Для авторизации пользователей.
-
Если аккаунт не верифицирован на Госуслугах, будет предложено его верифицировать. Шаг опциональный.
-
Укажите название для сервиса, почту и иконку приложения.
-
Выберите Веб-сервисы и вставьте Redirect URl.
Где взять Redirect URl:
-
В разделе
Администрирование →
Интеграции нажмите Добавить интеграцию. -
В витрине интеграций откройте подключаемую интеграцию.
-
Нажмите Далее и скопируйте значение в поле Callback URL.
-
-
Предоставьте доступ к данным: Доступ к адресу электронной почты и Доступ к логину, имени и фамилии, полу. Также выберите дополнительные доступы для администрирования, которые будут разрешены в интеграции:
directory:
-
directory:read_users — Чтение данных о сотрудниках.
-
directory:write_users — Управление сотрудниками.
-
directory:read_departments — Чтение данных о подразделениях.
-
directory:write_departments — Управление подразделениями.
-
directory:read_groups — Чтение данных о группах.
-
directory:write_groups — Управление группами.
-
directory:read_domains — Чтение данных о доменах организации.
-
directory:write_domains — Управление доменами организации.
-
directory:read_offices — Чтение офисов.
-
directory:write_offices — Управление офисами.
-
directory:read_rooms — Чтение переговорок.
-
directory:write_rooms — Управление переговорками.
-
directory:read_organization — Чтение данных об организациях пользователя.
-
directory:write_organization — Редактирование организации.
-
directory:manage_dns — Управление DNS-записями.
ya360_security:
-
ya360_security:read_auditlog — Чтение событий аудитлога.
-
ya360_security:audit_log_mail — Чтение событий аудит лога Почты.
-
ya360_security:audit_log_disk — Чтение событий аудит лога Диска.
-
ya360_security:domain_2fa_write — Управление обязательной 2FA для пользователей.
-
ya360_security:domain_passwords_read — Чтение информации о настройках паролей пользователей.
-
ya360_security:domain_passwords_write — Управление настройками паролей пользователей.
-
ya360_security:domain_sessions_read — Чтение информации о настройках сессий пользователей.
-
ya360_security:domain_sessions_write — Управление настройками и авторизационными сессиями пользователей.
-
ya360_security:domain_settings_read — Чтение информации о настройках безопасности организации.
-
ya360_security:domain_settings_write — Управление настройками безопасности организации.
-
ya360_security:service_applications_read — Чтение списка сервисных приложений.
-
ya360_security:service_applications_write — Управление списком сервисных приложений.
ya360_admin:
-
ya360_admin:mail_read_mail_list_permissions — Просмотр разрешений на рассылку.
-
ya360_admin:mail_write_mail_list_permissions — Изменение разрешений на рассылку.
-
ya360_admin:mail_read_user_settings — Чтение настроек почты пользователя.
-
ya360_admin:mail_write_user_settings — Управление настройками почты пользователя.
-
ya360_admin:mail_read_organization_settings — Чтение настроек почты организации.
-
ya360_admin:mail_write_organization_settings — Управление настройками почты организации.
-
ya360_admin:mail_read_domain_routes — Чтение правил маршрутизации организации.
-
ya360_admin:mail_write_domain_routes — Управление правилами маршрутизации организации.
-
ya360_admin:mail_read_routing_rules — Чтение правил обработки почты для домена.
-
ya360_admin:mail_write_routing_rules — Управление правилами обработки почты для домена.
-
ya360_admin:mail_read_shared_mailbox_inventory — Чтение Реестра Общих Ящиков.
-
ya360_admin:mail_write_shared_mailbox_inventory — Редактирование Реестра Общих Ящиков.
-
ya360_admin:mail_read_antispam_settings — Чтение настроек Антиспама для организации.
-
ya360_admin:mail_write_antispam_settings — Управление настройками Антиспама для организации.
-
-
Убедитесь, что все данные указаны верно и нажмите Создать приложение.
-
Активируйте функцию сервисных приложений с помощью запроса:
POST https://api360.yandex.net/security/v1/org/<org_id>/service_applications/activate.
Где org_id — ID организации, который можно взять на странице организации, в нижней части меню.
-
Скопируйте в созданном приложении ClientID и Client secret.
-
Вставьте полученные ClientID и Client secret в поля ClientID OAuth-приложения и Client secret OAuth-приложения соответственно, в окне добавления интеграции из витрины.
-
Нажмите Далее, а затем укажите ID организации Яндекс 360 — ID организации, который можно взять на странице организации, в нижней части меню.
Авторизация в интеграции
-
Проверьте, что интеграция находится в разделе
Каталоги →
Интеграции. Если ее нет, попросите администратора GigaCowork ее включить. -
Откройте интеграцию и нажмите Войти в аккаунт. Интеграция уже может быть авторизована администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с ней уже можно работать.
-
Укажите учетные данные вашего аккаунта Яндекс и предоставьте необходимые разрешения.