Регистрация приложения для авторизации
Шаг 1. Создание приложения
-
Авторизуйтесь в сервисе Яндекс OAuth через ваш аккаунт на Яндексе, с помощью которого вы планируете продолжать разработку.
Важно
Чтобы не потерять доступ к приложению, используйте аккаунт, в который вы всегда сможете войти. Убедитесь, что вы сможете пройти процедуру верификации на этом аккаунте.
-
Если ваш сервис не верифицирован, пройдите верификацию. Иначе ваши пользователи будут видеть предупреждение перед тем, как разрешить вам доступ к их данным. Это значительно снижает конверсию успешных авторизаций в вашем приложении.
Совет
Верификация особенно важна для этого типа приложений.
-
Создайте приложение одним из способов:
-
Нажмите Создать приложение. Во всплывающем окне выберите Для авторизации пользователей.
-
Перейдите по ссылке: https://oauth.yandex.ru/client/new/id/.
-
-
Укажите сведения о приложении:
-
Заполните поле Название вашего сервиса и прикрепите иконку.
Размер файла с иконкой не может превышать 1 Мб.
Пользователь увидит название и иконку на странице авторизации и в списке приложений, которые получили доступ к его аккаунту.
-
Заполните поле Контактная почта. Убедитесь, что она актуальна, чтобы не пропустить важную информацию об изменениях в продукте.
-
Нажмите Продолжить.
-
Шаг 2. Платформы приложения
-
Выберите, для каких платформах вы настраиваете авторизацию:
- Веб-сервисы
- iOS-приложение
- Android-приложение
-
Укажите параметры платформ, на которых работает ваше приложение:
Веб-сервисыiOS-приложениеAndroid-приложение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. Доступ к данным
-
Выберите данные пользователя, доступ к которым нужно получить приложению. Обычно требуются:
- Логин, имя и фамилия, пол;
- Портрет пользователя;
- Адрес электронной почты;
- Номер телефона;
- Дата рождения.
Вы можете выбрать другие необходимые разрешения.
Список необходимых данных отобразится на странице авторизации пользователя и в списке приложений, которые получили доступ к его аккаунту.
Совет
Выбирайте только те данные, которые будут использованы в вашем приложении.
-
Нажмите Продолжить.
Завершение регистрации
После настройки всех параметров приложения в Яндекс OAuth отобразится окно, которое увидят пользователи, когда войдут в ваше приложение с помощью Яндекс ID. Чтобы подтвердить сохранение, нажмите Всё верно.
Дальнейшая настройка подключения к API Яндекс ID состоит из:
- запроса OAuth-токена;
- ввода информации о пользователе.
Для настройки используйте параметры, указанные на странице приложения в личном кабинете Яндекс OAuth.