1C-Bitrix

With the official Yandex ID module for 1C-Bitrix, users can log in to your website via their Yandex accounts.

To set up Yandex ID on your website:

1. Upload the module to 1C-Bitrix:

   1. Log in to 1C-Bitrix as an administrator.

   2. Go to Marketplace → Каталог решений (Solutions). Enter "Официальный модуль Яндекс ID" in the search bar.

   3. Install the module: click Установить (Install), enter the address of your website or portal, and follow the instructions on the screen.

   Note

   You can also download an archive with the official Yandex ID module.

2. Configure the uploaded component:

   1. In the left menu, select Настройки (Settings) → Настройки модулей (Module settings) → Официальный модуль Яндекс ID (Official Yandex ID module).

   2. Check the Включить модуль (Enable module) box to activate the module and enable Yandex ID authorization on your website.

   3. Edit the main Yandex ID settings:

      • App name is the name that the user will see when logging in via Yandex ID.
      • Authorization component determines which element will be used for granting access: a login button or an instant login widget.
      • Group assigned when creating a user determines which user group a new user is assigned to.

   4. Set the Запрашиваемые данные пользователя (Requested user data). Yandex ID lets you populate a 1C-Bitrix user's details with the account information. Select relevant options to import data. If nothing is selected, only the user's email address value will be imported.

   5. If you select a login button as your authorization component, edit the Настройки внешнего вида для кнопки авторизации (Login button appearance settings):

      • Button type — Select a button type matching your website's design from the list. You'll see what the button looks like in the settings section.
      • Value of the button container's id attribute — Enter the ID of the container where the login button will be placed. The default value is yandex-id-container.
      • Button border radius — The button's border radius in pixels for rounded corners. When the value is 0, the button is rectangular.
      • Button theme — Should match the theme of the webpage where the button is placed so that it doesn't blend into the background.
      • Button size — Determines the default height, minimum width, and switching to the minimized appearance.
      • Icon type — Determines the language of the logo on the button.
      • Background color — Icon button's background color. Only applicable to the icon button with an outline.
      • Hover background color — Icon button's background color on hover. Only applicable to the icon button with an outline.
      • Outline color — Icon button's outline color. Only applicable to the icon button with an outline.
      • Hover outline color — Icon button's outline color on hover. Only applicable to the icon button with an outline.
      • Outline width — Icon button's outline width. Only applicable to the icon button with an outline.

      Note

      The color parameters accept HEX color values. For example, black is #000000. To find the HEX code of a specific color, you can use a color table like https://colorscheme.ru/html-colors.html.

After you install and configure the Yandex ID module, an OAuth token will be generated for the current website. The token is generated for all the domains of the website. To see the domain list, go to Настройки (Settings) → Сайты (Websites) → Список сайтов (Website list).

If you use a multisite, you need to enable the Yandex ID module for each website included in it. To do this, log in to the admin panel of each website and save the Yandex ID module settings there.