Регистрация приложения

Чтобы получать OAuth-токены для работы с данными пользователей Яндекса, разработчик должен зарегистрировать приложение в сервисе Яндекс OAuth. После регистрации приложение будет доступно для редактирования в личном кабинете Яндекс OAuth.

Шаг 1. Создание приложения

1. Авторизуйтесь в сервисе Яндекс OAuth через ваш аккаунт на Яндексе, с помощью которого вы планируете продолжать разработку.

2. Нажмите кнопку Создать приложение или перейдите по ссылке: https://oauth.yandex.ru/client/new/id/.

   Внимание

   Чтобы создать приложение для работы с данными других сервисов Яндекса (например, Yandex Tracker или Яндекс Метрика), перейдите по ссылке: https://oauth.yandex.ru/client/new/.

   В этом случае в разделе Доступ к данным необходимо указать названия доступов того сервиса Яндекса, для работы с которым вы создаете приложение.

3. Укажите сведения о приложении:

   1. Введите Название вашего сервиса.
      Пользователь увидит название на странице авторизации и в списке приложений, которые получили доступ к его аккаунту.

   2. Если у вашего сервиса есть логотип, нажмите Прикрепить иконку и выберите изображение размером не более 1 Мб.
      Пользователь увидит иконку на странице авторизации и в списке приложений, которые получили доступ к его аккаунту.

   3. В разделе Для каких платформ нужно приложение выберите одну или несколько платформ, на которых работает ваше приложение:

      • Веб-сервисы для настройки авторизации на сайте;
      • IOS-приложение для настройки авторизации в приложениях для устройств IOS;
      • Android-приложение для настройки авторизации в приложениях для устройств Android.

      Параметры платформ можно будет указать далее.

4. Нажмите Сохранить и продолжить.

Шаг 2. Доступ к данным

1. Выберите данные пользователя, доступ к которым необходимо предоставить приложению:

   • Логин, имя и фамилия, пол.
   • Портрет пользователя.
   • Адрес электронной почты.
   • Номер телефона.
   • Дата рождения.

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

2. Нажмите Сохранить и продолжить.

Шаг 3. Платформы приложения

1. Укажите параметры платформ, на которых работает ваше приложение:

   • Веб-сервисы:

     • Redirect URI. Адрес URL, на который пользователь будет перенаправлен после того, как он разрешил приложению доступ. Адрес соответствует параметру redirect_uri протокола OAuth.

       Заполните это поле в зависимости от метода, который вы выберете для получения OAuth-токена. Например, при использовании технологии мгновенной авторизации (рекомендована для веб-сервисов) укажите в поле URL, по которому вы создадите вспомогательную страницу для приема токена. При разработке и отладке приложения с использованием отладочных токенов нажмите Подставить URL для отладки во всплывающем окне подсказки — в поле будет подставлен адрес, который позволит получать отладочные токены.

       Примечание

       Не используйте в поле Redirect URI локальные адреса.

     • Нажмите кнопку , чтобы указать несколько адресов. Разные адреса могут быть использованы, если сайт позволяет выполнять авторизацию при помощи разных сценариев. Например, при необходимости настройки нескольких видов окружения. Нужный адрес можно будет выбрать при получении OAuth-токена.

   • iOS-приложение:

     • iOS Appid. Точный идентификатор iOS-приложения, например A1B2C3D4E5.com.domain.application. Состоит из Prefix и Bundle ID. Подробнее про идентификаторы iOS-приложений читайте в документации Apple.

     • iOS AppStore URL. Ссылка на приложение в AppStore.

   • Android-приложение:

     • Android package name. Название пакета приложения — поле applicationId в файле build.gradle вашего модуля. Подробнее про идентификаторы Android-приложений читайте в документации Android.

     • Android Google Play URL. Ссылка на приложение в Google Play.

     • SHA256 Fingerprints. Отпечаток сертификата вашего приложения. О том, как сгенерировать такой отпечаток, читайте в документации Android.

   Примечание

   Если вы разрабатываете приложение для iOS или Android, используйте LoginSDK для получения OAuth-токена.

2. Нажмите Сохранить и продолжить.

Шаг 4. Почта для связи

1. Укажите email, на который вам будет удобно получать информацию об изменениях в Яндекс ID или обновлениях параметров внешней авторизации.

2. Нажмите кнопку Сохранить.

Завершение регистрации

После настройки всех параметров приложения в Яндекс OAuth отобразится окно, которое увидят пользователи, когда войдут в ваше приложение с помощью Яндекс ID. Чтобы подтвердить сохранение, нажмите Всё верно.

Для дальнейшей настройки подключения к API Яндекс ID — запроса OAuth-токена и информации о пользователе — используйте параметры, указанные на странице приложения в личном кабинете Яндекс OAuth.