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

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

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

    Важно

    Чтобы не потерять доступ к приложению, используйте аккаунт, в который вы всегда сможете войти. Убедитесь, что вы сможете пройти процедуру верификации на этом аккаунте.

  2. Если ваш сервис не верифицирован, пройдите верификацию. Иначе ваши пользователи будут видеть предупреждение перед тем, как разрешить вам доступ к их данным. Это значительно снижает конверсию успешных авторизаций в вашем приложении.

    Совет

    Верификация особенно важна для этого типа приложений.

  3. Создайте приложение одним из способов:

    • Нажмите Создать приложение. Во всплывающем окне выберите Для авторизации пользователей.

    • Перейдите по ссылке: https://oauth.yandex.ru/client/new/id/.

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

    1. Заполните поле Название вашего сервиса и прикрепите иконку.

      Размер файла с иконкой не может превышать 1 Мб.

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

    2. Заполните поле Контактная почта. Убедитесь, что она актуальна, чтобы не пропустить важную информацию об изменениях в продукте.

    3. Нажмите Продолжить.

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

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

    • Веб-сервисы
    • iOS-приложение
    • Android-приложение
  2. Укажите параметры платформ, на которых работает ваше приложение:

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

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

    Если у вас экосистема приложений или вы используете разные окружения, добавьте дополнительные Redirect URI. Нужный адрес можно будет выбрать при получении OAuth-токена.

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

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

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

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

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

    Примечание

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

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

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

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

    Вы можете выбрать другие необходимые разрешения.

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

    Совет

    Выбирайте только те данные, которые будут использованы в вашем приложении.

  2. Нажмите Продолжить.

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

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

Дальнейшая настройка подключения к API Яндекс ID состоит из:

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