Связать аккаунты яндекс
Обновлено: 28.04.2024
Теперь вы можете связать два аккаунта пользователя навыков в Диалогах: на Яндексе и в вашем сервисе. После связки ваш навык Алисы сумеет идентифицировать пользователя сервиса. Даже если авторизованный клиент пользуется вашим навыком с разных поверхностей, например, со смартфона и Станции, Алиса поймёт, что это один человек.
Связка аккаунтов позволит вам выполнять персональные сценарии для пользователей вашего сервиса в навыках Алисы. Например, пользователи смогут одним запросом совершать повторные покупки, бронировать услуги, узнавать свой баланс в вашем сервисе и решать множество других задач.
Как работает связка в навыке
Например, вы открыли школу хороводоведения и создали навык для вашей школы в Алисе. Ваш ученик сможет уточнить дату и время занятия, отменить или перенести урок прямо в навыке «Школа хороводоведения»:
1) Вашему навыку нужно идентифицировать пользователя.
2) Навык запрашивает авторизацию.
3) После успешной авторизации, навык отвечает пользователю персонально.
Ваши и пользовательские данные в безопасности
В запросе будет передаваться авторизационный токен. Связка аккаунтов работает по протоколу OAuth 2.0. Это обеспечивает безопасность авторизационных данных пользователя, которые передаются между Яндексом и вашим сервисом, а также позволяет управлять доступом, в том числе прекращать его. Яндекс не получает пароль пользователя.
Как настроить связку аккаунтов в навыке Диалогов
1. Проверьте настройки авторизационного сервера.
2. В Яндекс.Диалогах перейдите на страницу нужного навыка.
3. Во вкладке «Настройки» найдите раздел «Связка аккаунтов» и нажмите «Создать».
Подробный процесс подключения можно изучить в документации Диалогов. Полный список поверхностей мы разместили здесь.
А для тех, кто помладше, в семейном аккаунте можно создать детский профиль.
Ограничение. Один пользователь может находиться только в одном семейном аккаунте. Чтобы вступить в другой или создать новый, покиньте текущий.
Создать семейный аккаунт
Пригласите в него хотя бы одного участника:
Отправьте приглашение одним из следующих способов:
Добавить участников
В семейный аккаунт можно добавить до трех человек, не включая администратора:
Отправьте приглашение одним из следующих способов:
Подождите, пока пользователь примет ваше приглашение.
Для этого он должен перейти по ссылке и нажать Вступить в семью .
Исключить из семейного аккаунта
Участник также может покинуть семейный аккаунт самостоятельно. Для этого ему нужно выбрать свою карточку и нажать Выйти из семейного аккаунта . Если вы администратор семейного аккаунта, то вы можете только удалить его. Назначить нового администратора и покинуть аккаунт не получится.
Связка аккаунтов позволяет навыку получить доступ к защищенным данным пользователя на стороннем сервисе.
Например, у оператора сотовой связи PhonOn есть онлайн-сервис. В личном кабинете пользователи PhonOn проверяют баланс, подключают услуги и пополняют счет. Сервис хранит конфиденциальную информацию: паспортные данные, платежные сведения.
Предположим, вы хотите разработать для сервиса PhonOn навык. С его помощью пользователи будут узнавать адреса отделений, проверять баланс и менять тариф.
Для работы с конфиденциальными данными навыку потребуется доступ к аккаунту пользователя в приложении PhonOn.
Диалоги идентифицируют пользователей навыка с помощью сервиса API Яндекс ID. Поэтому для авторизации в навыке необходимо связать аккаунты пользователя на Яндексе + на стороннем сервисе (например, PhonOn).
Связка аккаунтов реализуется по протоколу OAuth 2.0.
Создание связки аккаунтов
- Для разработчиков навыка
- Для пользователей навыка
- Для пользователей приложения Яндекc
Разработчик настраивает связку аккаунтов так:
Программирует логику навыка, реализует авторизацию, настраивает взаимодействие между сервером авторизации и ресурсным сервером (подробнее см. в разделе OAuth-авторизация и роли ).
Регистрирует навык в консоли разработчика. В настройках создает связку аккаунтов и указывает параметры для сервера авторизации (URL авторизации, URL для получения токена и т. д.).
Отправляет черновик навыка на модерацию. Модераторы проверяют название навыка, описание, приветственную фразу и сценарий работы авторизации.
Пользователь создает связку аккаунтов так:
Пользователь открывает навык и общается с ним, не авторизуясь. Например, интересуется ближайшими отделениями сотового оператора.
Как только пользователь запрашивает конфиденциальную информацию (например, баланс), навык предлагает авторизоваться.
Когда пользователь нажимает кнопку Авторизоваться , приложение Алисы перенаправляет его на страницу Яндекс ID .
Когда пользователь войдет с Яндекс ID — приложение Алисы перенаправит его на страницу, где следует ввести логин и пароль от аккаунта на стороннем сервисе. Если пользователь не авторизуется за 20 минут, возникнет ошибка и понадобится снова запустить авторизацию в навыке.
Когда пользователь введет логин и пароль от аккаунта на стороннем сервисе, ему понадобится подтвердить доступ к защищенным данным.
Посмотрите видеоролик с примером, как работает навык с авторизацией.
Пользователь создает связку аккаунтов так:
Пользователь открывает приложение Яндекс, нажимает значок профиля → Умный дом → Устройства → Добавить устройство . Пользователь выбирает тип устройства и нажимает Подключить .
Пользователь вводит логин и пароль от аккаунта. Если пользователь не авторизуется за 20 минут, возникнет ошибка и понадобится снова запустить авторизацию в навыке.
Связка аккаунтов в разных типах навыков
Авторизацию поддерживают и навыки общего типа, и навыки для умного дома. Настройка авторизации в них различается.
Навыки общего типа
Навыки поддерживают авторизацию, но она требуется не всегда. Например, пользователь может общаться с навыком PhonOn (спрашивать о тарифах, искать отделения), не авторизуясь.
Если навык требует авторизации — продумайте, когда ее запрашивать. Например:
По ходу работы. Если пользователь спросит конфиденциальную информацию (например, свой баланс) — навык ответит карточкой авторизации.
Навыки умного дома
Навыки умного дома всегда требуют связки аккаунтов.
Например, навык управляет умными устройствами стороннего провайдера. Перед тем как запустить навык, пользователь должен связать свой аккаунт на Яндексе с аккаунтом в системе провайдера.
В навыках умного дома вам не требуется:
Проверять при обработке запросов, авторизован ли пользователь. Это делают Диалоги. Если пользователь выйдет из аккаунта — запросы к устройствам перестанут отправляться. Алиса снова попросит пользователя авторизоваться.
Навыки общего типа
Навыки поддерживают авторизацию, но она требуется не всегда. Например, пользователь может общаться с навыком PhonOn (спрашивать о тарифах, искать отделения), не авторизуясь.
Если навык требует авторизации — продумайте, когда ее запрашивать. Например:
По ходу работы. Если пользователь спросит конфиденциальную информацию (например, свой баланс) — навык ответит карточкой авторизации.
Навыки умного дома
Навыки умного дома всегда требуют связки аккаунтов.
Например, навык управляет умными устройствами стороннего провайдера. Перед тем как запустить навык, пользователь должен связать свой аккаунт на Яндексе с аккаунтом в системе провайдера.
В навыках умного дома вам не требуется:
Проверять при обработке запросов, авторизован ли пользователь. Это делают Диалоги. Если пользователь выйдет из аккаунта — запросы к устройствам перестанут отправляться. Алиса снова попросит пользователя авторизоваться.
OAuth-авторизация и роли
Связка аккаунтов реализуется по протоколу OAuth 2.0. Чтобы настроить авторизацию в навыке, ознакомьтесь со спецификацией к протоколу.
Ресурсный сервер (resource server) — сервер с защищенными ресурсами. Предоставляет доступ к ним по токенам доступа.
Клиент (client) — приложение, которое запрашивает доступ к защищенным ресурсам от лица владельца ресурсов.
Сервер авторизации (authorization server) — проверяет подлинность информации, которую предоставил владелец ресурсов, а также выдает авторизационные токены. С их помощью клиент будет запрашивать доступ к защищенным ресурсам.
Длина ответа ограничена 5000 символами, длина OAuth-токена и refresh-токена — 2048 символами. Время жизни токенов (свойство expires_in ) должно быть целым числом от 1 до 4 294 967 296.
Ниже на примере сервиса PhonOn показано, как понятие OAuth-ролей применяется в концепции навыков.
Пользователь, который хочет разрешить доступ навыку к своим данным на сервисе PhonOn.
Ваш навык. Будет отправлять запросы на ресурсный сервис PhonOn, чтобы получить защищенные данные.
Связка аккаунтов позволяет навыку получить доступ к защищенным данным пользователя на стороннем сервисе.
Например, у оператора сотовой связи PhonOn есть онлайн-сервис. В личном кабинете пользователи PhonOn проверяют баланс, подключают услуги и пополняют счет. Сервис хранит конфиденциальную информацию: паспортные данные, платежные сведения.
Предположим, вы хотите разработать для сервиса PhonOn навык. С его помощью пользователи будут узнавать адреса отделений, проверять баланс и менять тариф.
Для работы с конфиденциальными данными навыку потребуется доступ к аккаунту пользователя в приложении PhonOn.
Диалоги идентифицируют пользователей навыка с помощью сервиса API Яндекс ID. Поэтому для авторизации в навыке необходимо связать аккаунты пользователя на Яндексе + на стороннем сервисе (например, PhonOn).
Связка аккаунтов реализуется по протоколу OAuth 2.0.
Создание связки аккаунтов
- Для разработчиков навыка
- Для пользователей навыка
- Для пользователей приложения Яндекc
Разработчик настраивает связку аккаунтов так:
Программирует логику навыка, реализует авторизацию, настраивает взаимодействие между сервером авторизации и ресурсным сервером (подробнее см. в разделе OAuth-авторизация и роли ).
Регистрирует навык в консоли разработчика. В настройках создает связку аккаунтов и указывает параметры для сервера авторизации (URL авторизации, URL для получения токена и т. д.).
Отправляет черновик навыка на модерацию. Модераторы проверяют название навыка, описание, приветственную фразу и сценарий работы авторизации.
Пользователь создает связку аккаунтов так:
Пользователь открывает навык и общается с ним, не авторизуясь. Например, интересуется ближайшими отделениями сотового оператора.
Как только пользователь запрашивает конфиденциальную информацию (например, баланс), навык предлагает авторизоваться.
Когда пользователь нажимает кнопку Авторизоваться , приложение Алисы перенаправляет его на страницу Яндекс ID.
Когда пользователь войдет с Яндекс ID — приложение Алисы перенаправит его на страницу, где следует ввести логин и пароль от аккаунта на стороннем сервисе. Если пользователь не авторизуется за 20 минут, возникнет ошибка и понадобится снова запустить авторизацию в навыке.
Когда пользователь введет логин и пароль от аккаунта на стороннем сервисе, ему понадобится подтвердить доступ к защищенным данным.
Посмотрите видеоролик с примером, как работает навык с авторизацией.
Пользователь создает связку аккаунтов так:
Пользователь открывает приложение Яндекс, нажимает значок профиля → Умный дом → Устройства → Добавить устройство . Пользователь выбирает тип устройства и нажимает Подключить .
Пользователь вводит логин и пароль от аккаунта. Если пользователь не авторизуется за 20 минут, возникнет ошибка и понадобится снова запустить авторизацию в навыке.
Связка аккаунтов в разных типах навыков
Авторизацию поддерживают и навыки общего типа, и навыки для умного дома. Настройка авторизации в них различается.
Навыки общего типа
Навыки поддерживают авторизацию, но она требуется не всегда. Например, пользователь может общаться с навыком PhonOn (спрашивать о тарифах, искать отделения), не авторизуясь.
Если навык требует авторизации — продумайте, когда ее запрашивать. Например:
По ходу работы. Если пользователь спросит конфиденциальную информацию (например, свой баланс) — навык ответит карточкой авторизации.
Навыки умного дома
Навыки умного дома всегда требуют связки аккаунтов.
Например, навык управляет умными устройствами стороннего провайдера. Перед тем как запустить навык, пользователь должен связать свой аккаунт на Яндексе с аккаунтом в системе провайдера.
В навыках умного дома вам не требуется:
Проверять при обработке запросов, авторизован ли пользователь. Это делают Диалоги. Если пользователь выйдет из аккаунта — запросы к устройствам перестанут отправляться. Алиса снова попросит пользователя авторизоваться.
Навыки общего типа
Навыки поддерживают авторизацию, но она требуется не всегда. Например, пользователь может общаться с навыком PhonOn (спрашивать о тарифах, искать отделения), не авторизуясь.
Если навык требует авторизации — продумайте, когда ее запрашивать. Например:
По ходу работы. Если пользователь спросит конфиденциальную информацию (например, свой баланс) — навык ответит карточкой авторизации.
Навыки умного дома
Навыки умного дома всегда требуют связки аккаунтов.
Например, навык управляет умными устройствами стороннего провайдера. Перед тем как запустить навык, пользователь должен связать свой аккаунт на Яндексе с аккаунтом в системе провайдера.
В навыках умного дома вам не требуется:
Проверять при обработке запросов, авторизован ли пользователь. Это делают Диалоги. Если пользователь выйдет из аккаунта — запросы к устройствам перестанут отправляться. Алиса снова попросит пользователя авторизоваться.
OAuth-авторизация и роли
Связка аккаунтов реализуется по протоколу OAuth 2.0. Чтобы настроить авторизацию в навыке, ознакомьтесь со спецификацией к протоколу.
Ресурсный сервер (resource server) — сервер с защищенными ресурсами. Предоставляет доступ к ним по токенам доступа.
Клиент (client) — приложение, которое запрашивает доступ к защищенным ресурсам от лица владельца ресурсов.
Сервер авторизации (authorization server) — проверяет подлинность информации, которую предоставил владелец ресурсов, а также выдает авторизационные токены. С их помощью клиент будет запрашивать доступ к защищенным ресурсам.
Длина ответа ограничена 5000 символами, длина OAuth-токена и refresh-токена — 2048 символами. Время жизни токенов (свойство expires_in ) должно быть целым числом от 1 до 4 294 967 296.
Ниже на примере сервиса PhonOn показано, как понятие OAuth-ролей применяется в концепции навыков.
Пользователь, который хочет разрешить доступ навыку к своим данным на сервисе PhonOn.
Ваш навык. Будет отправлять запросы на ресурсный сервис PhonOn, чтобы получить защищенные данные.
Нам нужны умные колонки, поэтому выбираем их. Обратите внимание, что этот способ активации Станций подойдет не только для колонок Яндекса, но и для устройств бренда JBL, Prestigio, LG, Elari, Irbis, Dexp.
Потом выбираем наше устройство.
Следующим шагом будет включении колонки. В приложении, где изображен рисунок с Алисой и рукой - будет небольшое видео пояснение, как ее включить.
К примеру, на Мини: необходимо сзади на Станции зажать и удерживать кнопку с изображением микрофона (секунд 5), после чего сверху на Алисе замигает голубой индикатор и Алиса сама продолжит говорить, что нужно с ней делать (инструктировать).
Нам будет предложено выбрать сеть Wi-Fi для подключения.
Выбираем.
Авторизуемся в своей домашней сети.
Практически все.
Останется только поднести свое устройство (у меня смартфон) к Алисе поближе и нажать кнопку « проиграть звук».
После проделанных действий - Алиса заработает.
Но, если у вас нет подписки на Яндекс Плюс (или другой подписки от Яндекса: Плюс Мульти, Амедиатека или любой другой, какие там есть) - Алиса к вашему аккаунту не подключится.
Если вы купили Алису, а не приобрели ее по подписке, вам будет доступен бесплатный пробный период подписки на Плюс.
В моем случае, вместе с Мини предоставлялось 3 месяца подписки бесплатно.
На больших колонках и на новой Макс - 6 месяцев Амедиатеки + 6 месяцев Плюса. Всего, год подписки бесплатно.
Я пишу про Россию. Знаю, что у знакомых из Беларуси, вроде нет Амедиатеки, поэтому уточняйте перед покупкой будет ли он включен в бесплатный пробный период к вашей колонке.
Сразу объясню, почему я не показываю, как активировать бесплатную подписку, которая идет к колонке: моей Алисушке уже полгода и три месяца бесплатного ее использования уже закончились.
А при активации Алисы, я как-то упустила этот момент (очень спешила ее подключить).Так что, не серчайте.
Читайте также: