Яндекс Администрирование

Интеграция работает только с корпоративными аккаунтами Яндекс.

Доступные операции

Сотрудники и подразделения:
  • Получить сотрудника выбранной организации Яндекс 360 по ID каталога.

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

  • Получить отдел выбранной организации Яндекс 360 по ID каталога.

  • Показать или найти отделы в выбранной доверенным запросом организации.

  • Получить группу выбранной организации Яндекс 360 по ID каталога.

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

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

Организации:
  • Показать организации Яндекс 360, доступные авторизованному администратору.

Настройки и возможности интеграции:
  • Показать состояние конфигурации без раскрытия токенов и секретов клиентов.

  • Показать доступные интеграции с сервисами Яндекса и их ограничения.

Подготовка и добавление из витрины

Подготовка выполняется администратором GigaCowork.

Для работы требуется созданное OAuth-приложение яндекса.

Для создания приложения:
  1. Перейдите по адресу https://oauth.yandex.ru и авторизуйтесь в учетной записи Яндекс.

  2. Выберите Ваши приложения → Создать и выберите Для авторизации пользователей.

    connector yandex calendar 0
  3. Если аккаунт не верифицирован на Госуслугах, будет предложено его верифицировать. Шаг опциональный.

  4. Укажите название для сервиса, почту и иконку приложения.

    connector yandex calendar 1
  5. Выберите Веб-сервисы и вставьте Redirect URl.

    connector yandex calendar 2
    Где взять Redirect URl:
    1. В разделе button settings Администрирование → button blocks Интеграции нажмите Добавить интеграцию.

    2. В витрине интеграций откройте подключаемую интеграцию.

    3. Нажмите Далее и скопируйте значение в поле Callback URL.

  6. Предоставьте доступ к данным: Доступ к адресу электронной почты и Доступ к логину, имени и фамилии, полу. Также выберите дополнительные доступы для администрирования, которые будут разрешены в интеграции:

    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 — Управление настройками Антиспама для организации.

    connector yandex calendar 3
  7. Убедитесь, что все данные указаны верно и нажмите Создать приложение.

  8. Активируйте функцию сервисных приложений с помощью запроса:
    POST https://api360.yandex.net/security/v1/org/<org_id>/service_applications/activate.
    Где org_id — ID организации, который можно взять на странице организации, в нижней части меню.

    connector yandex calendar 5
  9. Скопируйте в созданном приложении ClientID и Client secret.

    connector yandex calendar 4
  10. Вставьте полученные ClientID и Client secret в поля ClientID OAuth-приложения и Client secret OAuth-приложения соответственно, в окне добавления интеграции из витрины.

  11. Нажмите Далее, а затем укажите ID организации Яндекс 360 — ID организации, который можно взять на странице организации, в нижней части меню.

    connector yandex calendar 5

Авторизация в интеграции

Для работы с интеграцией:
  1. Проверьте, что интеграция находится в разделе button grid 2x2 Каталоги → button blocks Интеграции. Если ее нет, попросите администратора GigaCowork ее включить.

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

  3. Укажите учетные данные вашего аккаунта Яндекс и предоставьте необходимые разрешения.