---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/id/doc/en/register-auth.md
  - https://yandex.ru/dev/id/doc/ru/register-auth.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/id/doc/ru/llms.txt

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

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

1. Авторизуйтесь в сервисе [Яндекс OAuth](https://oauth.yandex.ru/) через ваш аккаунт на Яндексе, с помощью которого вы планируете продолжать разработку.

   {% note warning %}

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

   {% endnote %}

1. Если ваш сервис не верифицирован, пройдите [верификацию](https://yandex.ru/dev/id/doc/ru/confirm-account.md). Иначе ваши пользователи будут видеть предупреждение перед тем, как разрешить вам доступ к их данным. Это значительно снижает конверсию успешных авторизаций в вашем приложении.

   {% note tip %}

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

   {% endnote %}

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

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

      * Перейдите по ссылке: [https://oauth.yandex.ru/client/new/id/](https://oauth.yandex.ru/client/new/id/).

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

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

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

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

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

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

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

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

   * **Веб-сервисы**
   * **iOS-приложение**
   * **Android-приложение**

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

    {% list tabs %}

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

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

         При использовании [технологии мгновенной авторизации](https://yandex.ru/dev/id/doc/ru/suggest-description.md) (рекомендуется для веб-сервисов) укажите в поле URL, по которому вы создаете вспомогательную страницу для приема токена.

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

         **Redirect URI**, который указан в OAuth-приложении, может не полностью совпадать с тем, который будет в запросе. Совпадать должны следующие участки адреса:
         * схема;
         * хост;
         * порт (если есть);
         * путь (`path`).
         
         Могут не совпадать:
         * запрос (`query`);
         * фрагмент (`fragment`).

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

      * **iOS AppId**. Точный идентификатор iOS-приложения, например `A1B2C3D4E5.com.domain.application`. Состоит из Prefix и Bundle ID. Подробнее про идентификаторы iOS-приложений читайте в [документации Apple](https://www.google.com/url?q=https://developer.apple.com/library/content/documentation/General/Conceptual/DevPedia-CocoaCore/AppID.html&sa=D&source=docs&ust=1747637795082304&usg=AOvVaw1WD8iSfwTtgbDQDFbb-5WT).

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

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

      * **Android package name**. Название пакета приложения — поле `applicationId` в файле `build.gradle` вашего модуля. Подробнее про идентификаторы Android-приложений читайте в [документации Android](https://developer.android.com/studio/build/application-id.html).

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

      * **SHA256 Fingerprints**. Отпечаток сертификата вашего приложения. О том, как сгенерировать такой отпечаток, читайте в [документации Android](https://developers.google.com/android/guides/client-auth#using_gradles_signing_report).

    {% endlist %}

   {% note info %}

   Если вы разрабатываете приложение для iOS или Android, используйте [LoginSDK](https://yandex.ru/dev/id/doc/ru/mobileauthsdk/about.md) для получения OAuth-токена.

   {% endnote %}

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

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

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

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

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

   {% note tip %}

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

   {% endnote %}

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

### Завершение регистрации {#finish}

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

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

* запроса [OAuth-токена](https://yandex.ru/dev/id/doc/ru/access.md);
* ввода [информации о пользователе](https://yandex.ru/dev/id/doc/ru/user-information.md).

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