> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Быстрый старт аутентификации: первый вход за 10 минут

> Включите аутентификацию Didit в песочнице, войдите пользователя через размещённую страницу и проверьте access token на сервере.

Это руководство поможет настроить Didit Authentication от начала до конца примерно за 10 минут.
Вы зарегистрируете URL обратного вызова в приложении в песочнице, включите один из методов входа, выполните вход пользователя через размещённую страницу входа, проверите токен доступа на своём сервере и увидите вход в консоли.

## Предварительные требования

* Аккаунт Didit с приложением Sandbox. Создание аккаунта бесплатно, и у каждого приложения Sandbox включена функция аутентификации.
* Node.js 20 или новее и веб-приложение, которое можно запустить на `http://localhost:3000`.

## Шаги

**1. Откройте ваше приложение Sandbox**

В [Business Console](https://business.didit.me) переключите приложение с помощью переключателя приложений, выберите приложение **Sandbox**, затем откройте **Authentication**.

Приложение Sandbox принимает URL обратного вызова `http://localhost` и тестовые учётные данные Didit для входа через соцсети, и оно никогда не тарифицируется.
Приложение Live включает Authentication на странице **Products**: см. [подготовка приложения](https://docs.didit.me/ru/authentication/overview.md#подготовка-приложения).

**2. Зарегистрируйте callback и origin**

Откройте **Authentication > Security and sessions > Redirect URLs and allowed origins** и добавьте:

| Параметр | Значение |
| - | - |
| Redirect URL | `http://localhost:3000/auth/callback` |
| Allowed origin | `http://localhost:3000` |

Didit перенаправляет пользователя только на зарегистрированный вами URL обратного вызова, который должен полностью совпадать с ним посимвольно.
Разрешённый origin позволяет браузеру обменяться кодом с origin Didit вашего приложения.

![Карточка Redirect URLs and allowed origins в Didit Business Console, рядом с allowlist и blocklist и URL входа](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-redirect-urls.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=8bf9cdacf97580097f4e8c6bd242af6f)

Redirect URLs and allowed origins, в разделе Authentication > Security and sessions.

**3. Включите метод входа**

Откройте **Authentication > Sign-in methods** и включите **Email code**.
В новом приложении все методы по умолчанию выключены, а размещённая страница предлагает только те методы, которые вы включили.

При желании добавьте **Passkeys** или метод входа через соцсеть с **тестовыми учётными данными Didit**, которые работают в Sandbox без собственного приложения.
Каждый метод описан в разделе [методы входа](https://docs.didit.me/ru/authentication/sign-in-methods.md).

![Страница Sign-in methods в Didit Business Console, с карточкой размещённой страницы входа, методами входа без пароля и с паролем и живым предпросмотром размещённой страницы](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

Authentication > Sign-in methods, с предпросмотром размещённой страницы в реальном времени.

**4. Скопируйте публичный ключ**

Откройте **Authentication > Developers** и скопируйте **Publishable key**.
В приложении Sandbox он начинается с `pk_test_`.

Публичный ключ является общедоступным и обозначает origin входа вашего приложения в Didit.
Никогда не помещайте **Secret key** в код для браузера или мобильного приложения.

**5. Установите SDK и войдите**

```bash theme={null}
npm install @didit-protocol/auth
```

```ts auth.ts theme={null}
import { createDiditAuth } from "@didit-protocol/auth";

export const auth = createDiditAuth({
  publishableKey: "pk_test_...",
  redirectUri: "http://localhost:3000/auth/callback",
});

// Your sign-in button
export async function onSignInClick() {
  await auth.signIn({ returnTo: "/dashboard" });
}

// Run once on http://localhost:3000/auth/callback
export async function onCallbackPage() {
  const { session, returnTo } = await auth.handleRedirectCallback();
  console.log(session.email, session.vendorData);
  window.location.replace(returnTo ?? "/");
}
```

Нажмите кнопку: размещённая страница запросит адрес электронной почты и отправит шестизначный код.
Введите код, и Didit вернёт вас на ваш callback, который обменивает одноразовый код на токены сессии.
При первом входе с адресом, для которого нет учётной записи, она будет создана, поскольку политика регистрации по умолчанию разрешает регистрироваться всем.

![Размещённая страница входа на телефоне, с кнопкой passkey и полями электронной почты и пароля](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-phone.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=842077ff63a6dcffc50b0f0542ab07e4)

Размещённая страница входа на телефоне. Она показывает только методы, которые вы включили.

**6. Проверьте токен на вашем сервере**

Отправьте токен доступа из `auth.getToken()` на ваш бэкенд в заголовке `Authorization` и проверяйте его там при каждом защищённом запросе:

```ts server.ts theme={null}
import { verifyToken } from "@didit-protocol/auth/server";

export async function authenticate(request: Request) {
  const header = request.headers.get("authorization") ?? "";
  const token = header.startsWith("Bearer ") ? header.slice(7) : "";
  try {
    const claims = await verifyToken(token, { publishableKey: process.env.DIDIT_PUBLISHABLE_KEY });
    return { personId: claims.sub, vendorData: claims.vendor_data };
  } catch {
    return null;
  }
}
```

`verifyToken` проверяет подпись ES256 по опубликованным ключам вашего издателя, а также проверяет издателя и срок действия токена.
Токен доступа действует не более 5 минут, а `auth.getToken()` обновляет его за вас.
На других языках можно проверить тот же токен с помощью [серверных SDK](https://docs.didit.me/ru/integration/server-sdks/overview.md) или любой JWT-библиотеки, как показано в разделе [токены и JWKS](https://docs.didit.me/ru/authentication/tokens-and-jwks.md#проверка-токена-на-вашем-сервере).

**7. Просмотрите сведения о входе в консоли**

Откройте **Authentication > Sign-ins**.
Ваш вход отображается с результатом, методом, устройством, местоположением и риском, рядом с примерами входов, которые есть в каждой песочнице с самого начала.
Пользователь появляется в разделе **Users**.

![Страница Sign-ins в Didit Business Console, со списком попыток входа с их состоянием, пользователем, методом, устройством, местоположением, риском и временем](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

Authentication > Sign-ins: все попытки входа, с фильтрами по состоянию, методу и риску.

Чтобы получать события входа на своём сервере, настройте [адрес назначения webhook](https://docs.didit.me/ru/integration/webhooks.md) для событий `auth.signup` и `auth.login`. См. [события и webhook](https://docs.didit.me/ru/authentication/events-and-webhooks.md).

## Перед запуском в продакшн

1. Включите Authentication для вашего Live-приложения на странице **Products**.
2. Зарегистрируйте продакшн-URL перенаправления и источники с протоколом `https://`: Live-приложение принимает только `https://`.
3. Замените тестовые учетные данные Didit для входа через социальные сети на идентификатор клиента и секрет клиента вашего приложения.
4. Скопируйте публичный ключ Live (`pk_live_`) в конфигурацию продакшн-среды.
5. Пройдите [чек-лист перед запуском в продакшн](https://docs.didit.me/ru/authentication/integration-guide.md#чек-лист-перед-запуском-в-продакшн).

## Следующие шаги

> [card] [Руководство по интеграции](https://docs.didit.me/ru/authentication/integration-guide.md)
>
> Размещённые или собственные экраны, хранение токенов, сессии, повышение уровня аутентификации и устранение неполадок.

> [card] [React и Next.js](https://docs.didit.me/ru/authentication/quickstarts/nextjs.md)
>
> Компоненты, хуки, HttpOnly-куки и `auth()` на сервере.

> [card] [iOS, Android, React Native и Flutter](https://docs.didit.me/ru/authentication/quickstarts/ios.md)
>
> Нативный вход через системный браузер, ключи доступа и защищённое хранилище.

> [card] [Защита от ботов](https://docs.didit.me/ru/authentication/bot-protection.md)
>
> Включите политики, которые блокируют ботов и захват аккаунтов.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.