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

# Подключение мгновенной авторизации

1. Настройте страницу вашего сайта, на которой будет осуществляться авторизация пользователя с помощью кнопки или виджета.

   1. Подключите на страницу скрипт `sdk-suggest.js`:
      
      ```html
      <head>
         
      </head>
      ```
   
   1. Добавьте вызов скрипта. Вариант кода зависит от вида блока авторизации, который вы будете использовать для входа: для виджета не указывается группа параметров, которая отвечает за внешний вид кнопки.

      {% list tabs %}

      - Виджет "Мгновенный вход"

         ![](./_assets/has-cookie.png =400x)
      
         1. Скопируйте код:

            ```javascript
            YaAuthSuggest.init(
                  {
                     client_id: 'c46f0c53093440c39f12eff95a9f2f93',
                     response_type: 'token',
                     redirect_uri: 'https://examplesite.com/suggest/token'
                  },
                  'https://examplesite.com'
               )
               .then(({
                  handler
               }) => handler())
               .then(data => console.log('Сообщение с токеном', data))
               .catch(error => console.log('Обработка ошибки', error));
            ```

         1. Подставьте в код:

            * в параметр `client_id` — идентификатор  OAuth-приложения, зарегистрированного на [Этапе 1](https://yandex.ru/dev/id/doc/ru/register-client.md);
            * в параметр `redirect_uri` — URL вспомогательной страницы, который вы указали в [поле **Redirect URI**](https://yandex.ru/dev/id/doc/ru/register-client.md#platforms) для OAuth-приложения с данным `client_id` (если параметр не указан, то будет использовано первое из значений поля **Redirect URI**);
            * вместо `'https://examplesite.com'` — origin вспомогательной страницы, которая принимает токен.

      - Кнопка авторизации

         1. Настройте внешний вид кнопки с помощью конструктора кнопок.

            {% include notitle [_](./_mdx/button-constructor.mdx) %}

         1. Скопируйте готовый код из конструктора и вставьте его на страницу.

         1. Замените в коде:

            * `oauthQueryParams` — на блок
               
               ```javascript
               {
                  client_id: 'c46f0c53093440c39f12eff95a9f2f93',
                  response_type: 'token',
                  redirect_uri: 'https://examplesite.com/suggest/token'
               }
               ```

               В блоке подставьте нужные значения параметров:
               
               * в параметр `client_id` — идентификатор OAuth-приложения, зарегистрированного на [Этапе 1](https://yandex.ru/dev/id/doc/ru/register-client.md);
               * в параметр `redirect_uri` — URL вспомогательной страницы, который вы указали в [поле **Redirect URI**](https://yandex.ru/dev/id/doc/ru/register-client.md#platforms) для OAuth-приложения с данным `client_id` (если параметр не указан, то будет использовано первое из значений поля **Redirect URI**).

            * `tokenPageOrigin` — на origin вспомогательной страницы, которая принимает токен.

      {% endlist %}

      Подробнее о скрипте `sdk-suggest.js` читайте в разделе [Настройка скрипта sdk-suggest.js для страницы авторизации](https://yandex.ru/dev/id/doc/ru/suggest/script-sdk-suggest.md).

1. Подготовьте вспомогательную страницу, которая будет принимать OAuth-токен.

   1. Создайте пустую страницу по адресу, который вы указали в поле **Redirect URI** OAuth-приложения, зарегистрированного на [Этапе 1](https://yandex.ru/dev/id/doc/ru/register-client.md). Внешний вид вспомогательной страницы настраивать не обязательно. Она будет отображаться несколько миллисекунд, поэтому можно оставить белый экран.
   
   1. Подключите на страницу скрипт `sdk-suggest-token.js`:
   
      ```html
      <head>
         
      </head>
      ```
  
   1. Добавьте вызов скрипта.

      1. Скопируйте код:

         ```javascript
         YaSendSuggestToken(
            'https://examplesite.com', 
            {
               flag: true
            }
         )
         ```

      1. Замените в коде `'https://examplesite.com'` на origin страницы вашего сайта, на которой будет осуществляться авторизация пользователя при помощи кнопки или виджета.
      
   Подробнее о скрипте `sdk-suggest-token.js` читайте в разделе [Настройка скрипта sdk-suggest-token.js для вспомогательной страницы](https://yandex.ru/dev/id/doc/ru/suggest/script-sdk-suggest-token.md).
{% included (./_mdx/button-constructor.mdx) %}
<!-- markdownlint-disable -->

<div class="ypd-preview">
    <a href="https://autofill.yandex.ru/suggest/button/constructor" target="_blank">
        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24"><path fill="currentColor" d="M18 19H6c-.55 0-1-.45-1-1V6c0-.55.45-1 1-1h5c.55 0 1-.45 1-1s-.45-1-1-1H5c-1.11 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2v-6c0-.55-.45-1-1-1s-1 .45-1 1v5c0 .55-.45 1-1 1zM14 4c0 .55.45 1 1 1h2.59l-9.13 9.13c-.39.39-.39 1.02 0 1.41.39.39 1.02.39 1.41 0L19 6.41V9c0 .55.45 1 1 1s1-.45 1-1V3h-6c-.55 0-1 .45-1 1z"></path></svg>
    </a>
    <iframe src="https://autofill.yandex.ru/suggest/button/constructor" style="height: 500px"></iframe>
</div>

{% endincluded %}