Публикация навыка с авторизацией

После того как вы создали связку аккаунтов:

  1. Протестируйте работу навыка.
  2. Отправьте черновик навыка на модерацию.

После прохождения модерации вы сможете опубликовать навык.

Тестирование навыка

Перед тем как отправлять навык на модерацию, протестируйте его работу и убедитесь, что авторизация работает корректно. Для этого откройте консоль разработчика, зайдите на страницу навыка и откройте вкладку «Тестирование».

Проверьте, что:
  1. Навык отвечает карточкой авторизации, когда это необходимо.
  2. Связка аккаунтов успешно создается, если нажать кнопку Авторизоваться.

Если связка аккаунтов будет успешно создана, появится соответствующее уведомление (надпись Вы авторизованы).

Чтобы проверить сценарий, когда пользователь выходит из аккаунта, нажмите Выход из навыка:

Отладка ошибок

При попытке связать аккаунты могут возникнуть ошибки:
  • Ошибки в настройках, которые были заданы в консоли разработчика. Такие ошибки отладить достаточно просто — сравните параметры, которые вы указывали при создании связки аккаунтов, с настройками рабочего окружения. Возможно, вы некорректно указали URL или другие параметры.
  • Ошибки на стороне авторизационного сервера. Распространенная причина — разработчик реализует свой авторизационный сервер, который не соответствует спецификации OAuth 2.0.

Ошибки, которые возникли на стороне авторизационного сервера, отладить труднее. Если у вас есть доступ к логам авторизационного сервера, вы можете выполнить детальную трассировку HTTP-запросов. Используя HTTP-метод TRACE, можно проверить заголовки, параметры и тело запросов, которые Диалоги передают на авторизационный сервер.

Если доступа к логам нет (например, вы используете сторонний сервер авторизации), вам следует реализовать HTTP-прокси — для перехвата трафика между Диалогами и сервером авторизации. Прокси будет регистрировать все запросы, и вам необходимо будет проанализировать логи — проверить URL, заголовки и параметры запросов, которыми обменивались между собой Диалоги и сервер авторизации.

Для установки HTTP-прокси потребуется настроить инфраструктуру: сетевой сервер, окружение для развертывания вашего кода и т. д. Решение этой задачи выходит за рамки данного руководства.

Отправка навыка на модерацию

Перед тем как публиковать навык, его необходимо отправить на модерацию.

Модерацию должны проходить как публичные, так и приватные навыки. Для публичных навыков проверяются все компоненты: название, описание, категория, иконка, а также содержимое ответов навыка. Для приватных навыков проверяются только активационные имена и иконка.

Для навыков с авторизацией модераторы также проверят сценарий работы авторизации.

Перед отправкой навыка на модерацию обязательно заполните поле «Заметки для модератора». Подробно опишите, по какому сценарию будет осуществляться авторизация в навыке. Также укажите авторизационные данные (логин и пароль) для проверки сценария. Ниже показан пример, как заполнить поле «Заметки для модератора»:

Для запроса авторизации нужно сказать «Запросить баланс».
Логин: test@test.ru.
Пароль: password.
После успешной авторизации навык должен сообщить баланс.
Навык может общаться с пользователем и без авторизации — рассказывать про тарифы
или сообщать адрес отделений.