Синхронизация SCIM (бета-тестирование)
Если в вашей компании развернута служба федерации Active Directory, вы можете настроить ее автоматическую синхронизацию с Яндекс 360 для бизнеса — для этого нужно установить и настроить специальную службу Windows.
Подключить и настроить
Шаг 1. Получите Client ID и OAuth-токен
- Перейдите на страницу создания приложения.
- Введите название сервиса и прикрепите его иконку.
- В блоке Платформы приложения выберите Веб-сервисы. В поле Redirect URI нажмите ссылку Подставить URL для отладки.
- В блоке Доступ к данным в начале строки введите название доступа Управление федерациями.
- Укажите почту для связи. Внизу страницы нажмите Создать приложение.
Отправьте POST-запрос, чтобы получить OAuth-токен. Например, через cURL это можно сделать при помощи следующей команды:
curl -X POST https://oauth.yandex.ru/token -d "grant_type=client_credentials&client_id=значение1&client_secret=значение2"
Скопировано(значение параметра
client_id
— это ID созданного приложения, аclient_secret
— его Пароль)- Сохраните полученные ID и OAuth-токен. Они пригодятся на следующих шагах.
Шаг 2. Укажите Client ID в Яндекс 360 и получите Domain ID
- Откройте Яндекс 360 для бизнеса.
- Перейдите на вкладку Единый вход (SSO).
- Нажмите Настроить.
- В блоке Синхронизация SCIM вставьте ID вашего приложения, полученный на шаге 1.
- Скопируйте ваш Domain ID, он пригодится на следующем шаге.
- Сохраните изменения.
Шаг 3. Установите и настройте службу Windows для синхронизации
- Скачайте и установите службу YandexADSCIM.
- Найдите и откройте в любом текстовом редакторе конфигурационный файл —
%ProgramData%\Yandex\YandexADSCIM\AD_Users.config
. Настройте его:- Проверьте, верно ли указан путь для подключения к Active Directory в значении параметра LDAP. Если нет, исправьте его.
- В значении параметра BearerToken укажите OAuth-токен, полученный на шаге 1.
- В значении параметра DomainID укажите ID домена, полученный на шаге 2.
- Поменяйте значение параметра DryRun на
false
, если хотите запустить синхронизацию SCIM уже сейчас. Со значениемtrue
служба будет работать в тестовом режиме, фиксируя запросы в логах, но не синхронизируя сотрудников.
- Остановите службу и запустите снова, чтобы применить изменения из конфигурационного файла. Для этого в командной строке (
cmd.exe
) введитеsc stop yandexadscim
, а затем —sc start yandexadscim
. Также вы можете сделать это в диспетчере задач на вкладке Службы.
Изменить настройки
Если вы хотите изменить настройки, внесите изменения в конфигурационный файл, а затем перезагрузите службу YandexADSCIM через командную строку или диспетчер задач.
Просмотреть логи
Все логи службы сохраняются в папке %ProgramData%\Yandex\YandexADSCIM
.
Остановить службу
YandexADSCIM — это служба Windows, поэтому исполняется автоматически при запуске системы и не зависит от статуса пользователя. Но вы можете отключить ее вручную — для этого в командной строке введите sc stop yandexadscim
или в диспетчере задач нажмите Остановить.
Если же вы хотите удалить службу насовсем, используйте команду sc delete yandexadscim
.