Интеграция с внешними сервисами через OAuth 2.0
Пользователи привыкли к наличию альтернативных вариантов авторизации и регистрации помимо ввода комбинации логин/пароля, этому способствует наличие протокола OAuth 2.0, позволяющего выдать одному сервису (приложению) права доступ к ресурсам пользователя на другом сервисе. С помощью этого типа подключения мы сможем связать платформу Altcraft с любым внешним сервисом. Например, с Facebook, Яндекс приложением или CRM-системой.
На платформе OAuth 2.0 используется при:
- Создании сценариев. В элементе сценария «Вызов API» можно использовать OAuth подключение как способ авторизации. С её помощью можно передавать в подключенный сервис информацию из сценария или, наоборот, запрашивать из сервиса необходимый для подстановки API контент. Удобно, если надо передать в CRM-систему данные профиля, захваченного в сценарий.
- Захват событий. Механизм захвата событий позволит передать во внешний сервис информацию о событии. Если при настройке захвата событий вы выбираете тип захвата «Отправить JSON запрос батчем» вы можете выбрать OAuth подключение. Это позволяет передавать события зарегистрированные в платформе, в сервис где доступна авторизация через OAuth.
Как создать и настроить подключение
Перейдите в раздел «Настройки» → «Подключения» и выберите тип подключения OAuth2:
Нажмите на кнопку «Создать», далее дайте название и при желании добавьте описание.
Отображаемый URI адрес — это URL адрес перенаправления пользователя, автоматически сгенерированный платформой Altсraft. Его необходимо скопировать в список доверенных действительных URI перенаправления для OAuth в приложении, интеграцию с которой вы настраиваете.
Далее необходимо указать «Идентификатор клиента» и «Секретный код». Откуда брать эти данные? В панели приложения, с которым вы настраиваете интеграцию. В зависимости от приложения «Идентификатор клиента» может называться «Id приложения» , а «Секретный код» — «Секрет приложения». Эти данные необходимо скопировать из приложения и вставить их в соответствующие поля.
Также для OAuth подключения требуется указать ссылки для авторизации и для получения токена, их вы копируете из подключаемого приложения.
При необходимости вы можете установить «Запрашиваемые права». Запрашиваемые права обычно указываются в документации к сервису, подключение к которому настраивается. Так как у каждого они свои, например, при регистрации выберите права доступа:
- создание сегментов, изменение параметров настройки своих и доверенных сегментов;
- чтение параметров настройки своих и доверенных сегментов.
Для завершения настройки, нажмите «Подключить»:
Произойдет переход в подключаемый сервис, где необходимо авторизоваться и подтвердить выдачу прав платформе. Если подключение завершилось успешно, сохраните подключение с помощью кнопок в правом верхнем углу.