Документация для разработчиков

Подключите вход через MeerID

Один стандартный протокол (OpenID Connect) — вход на сайте, в мобильном и десктоп-приложении. Готовый SDK для веба и стандартные библиотеки для нативных платформ.

Блок входа в три строки

Вставьте на страницу входа — список способов, окно авторизации и обработка ответа уже внутри.

<div id="meerid-login"></div>
<script src="https://meerid.ru/meerid.js"></script>
<script>
  MeerID.mount({
    container: '#meerid-login',
    issuer: 'https://meerid.ru',
    clientId: 'meer_xxxxxxxxxxxxxxxxxxxx',
    onResult: (r) => fetch('/api/auth/meerid', {
      method: 'POST',
      headers: { 'content-type': 'application/json' },
      body: JSON.stringify(r),
    }).then(() => location.reload()),
  })
</script>
  • · Способы входа приходят из MeerID по вашему client_id — на экране появится ровно то, что включил оператор.
  • · Ни одной переменной окружения на вашей стороне: адрес и client_id заданы прямо в вызове.
  • · Тёмная и светлая темы, русский и английский, состояния загрузки и ошибки — из коробки.

Кнопки под ваш дизайн

Виджет изолирован в Shadow DOM, но не навязывает свой вид: настраивается тремя уровнями, а полностью своя вёрстка остаётся доступной.

1

Переменные

Палитра, радиус, шрифт и высота кнопок — CSS-переменными --meerid-* на контейнере. Тема даёт только значения по умолчанию.

#meerid-login {
  --meerid-accent: #ff5a1f;
  --meerid-radius: 4px;
  --meerid-control-height: 52px;
}
2

::part()

Точечные правила по частям: button, badge, label, list, message, skeleton, retry. У кнопки и значка есть именные части — button-google, badge-yandex.

#meerid-login::part(button) {
  text-transform: uppercase;
}
#meerid-login::part(badge-google) {
  border-radius: 50%;
}
3

Своя вёрстка

Нужен полный контроль — mount() не обязателен: getLoginMethods() отдаёт список методов по client_id, signIn() выполняет вход. Кнопки рисуете сами.

const methods = await MeerID
  .getLoginMethods({ issuer, clientId })

// свои кнопки, свой signIn:
MeerID.signIn({ issuer, clientId,
  idpHint: 'google' })

Список методов в любом случае приходит от MeerID по client_id — то, что включено сервису в панели, и появится на экране входа.

Способы интеграции

Выберите подходящий вашему продукту.

Веб-сайт

Браузерный SDK @meerid/browser: вход без ухода со страницы (нативный диалог браузера → всплывающее окно → переход).

Мобильные и десктоп

iOS, Android, Windows, Linux, macOS — через системный браузер и стандартные OIDC-библиотеки. Без проприетарного SDK.

Бэкенд

Любой OIDC-клиент по discovery-документу: обмен кода на токены и проверка подписи на вашем сервере.

Быстрый старт

Три шага до рабочего входа.

1

Зарегистрируйте приложение

Получите client_id и список разрешённых адресов возврата у оператора MeerID.

2

Подключите вход

Добавьте SDK на сайт или стандартную OIDC-библиотеку в приложение.

3

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

Обменяйте код на токены и выдайте свою сессию — безопасно, на вашем бэкенде.

Поддерживаемые платформы

Один аккаунт — везде.

WebiOSAndroidWindowsLinuxmacOSBackend

Ресурсы

Всё, что нужно для интеграции.

Браузерный SDK

Пакет @meerid/browser: вход для веб-приложений.

OIDC Discovery

Метаданные провайдера для автонастройки любого OIDC-клиента.

Открыть
MeerID для разработчиков — единый вход в ваш продукт · MeerID