@vkid/sdk

VK ID SDK — это библиотека для безопасной и удобной авторизации пользователей в вашем сервисе через VK ID.

---

VK ID SDK сейчас находится в бета-тестировании. О проблемах вы можете сообщить с помощью issues репозитория.

---

Установка

NPM:

npm i @vkid/sdk

YARN:

yarn add @vkid/sdk

PNPM:

pnpm add @vkid/sdk

CDN:

<script src="https://unpkg.com/@vkid/sdk@latest/dist-sdk/umd/index.js"></script>

Обратите внимание: Для работы авторизации нужен APP_ID. Вы получите его, когда создадите приложение в кабинете подключения VK ID.

Пример

Базовая авторизация

import * as VKID from '@vkid/sdk';

VKID.Config.set({
  app: APP_ID,
  redirectUrl: 'https://example.com'
});


const authButton = document.createElement('button');
authButton.onclick = () => {
  VKID.Auth.login(); // После авторизации будет редирект на адрес, указанный в параметре redirect_uri
};

document.getElementById('container').appendChild(authButton);

OneTap

import * as VKID from '@vkid/sdk';

VKID.Config.set({
  app: APP_ID,
  redirectUrl: 'https://example.com'
});

const oneTap = new VKID.OneTap();

const container = document.getElementById('VkIdSdkOneTap');

if (container) {
  oneTap.render({ container });
}

Документация

• Что такое VK ID
• Создание приложения
• Требования к дизайну
• Спецификация

Contributing

Проект VK ID SDK имеет открытый исходный код на GitHub, и вы можете присоединиться к его доработке — мы будем благодарны за внесение улучшений и исправление возможных ошибок.

Code of Conduct

Если вы собираетесь вносить изменения в проект VK ID SDK, следуйте правилам разработки. Они помогут понять, какие действия возможны, а какие недопустимы.

Contributing Guide

В руководстве вы можете подробно ознакомиться с процессом разработки и узнать, как предлагать улучшения и исправления, а ещё — как добавлять и тестировать свои изменения в VK ID SDK. Также рекомендуем ознакомиться с общими правилами оформления кода в проекте.

Changelog

1.1.0

Новое

• Добавлена возможность открытия авторизации в новой вкладке для всех модулей.

Исправления

• Исправлен конфликт css tokens, который приводил к некорректному отображению стилей.