Создать IDВойти

Подключение к Mallaev ID

Вход через Mallaev ID на вашем сайте: приложение в кабинете, пакет из npm, три маршрута и кнопка.

OpenID ConnectPKCE S256npm @mallaev/idTypeScriptMIT
  1. Создайте приложение

    Название, иконка, адрес сайта и куда вернуть человека после входа — обычно /auth/callback. После подтверждения домена и проверки вы получите номер приложения и секрет.

    Создать приложение
    Свой продукт Mallaev?

    Свои продукты администратор подключает на сервере ID скриптом deploy/id-provider/add-product.sh — без приложения в кабинете и проверки домена. В коде добавьте account: true: придут номер аккаунта, логин и права. Стороннему сайту с этой строкой Mallaev ID откажет.

  2. Установите пакет

    Терминал
    npm install @mallaev/id

    Есть типы TypeScript. Работает в Node.js 20+, Bun, Deno и на edge.

  3. Добавьте ключи в окружение

    .env — не в коде и не в git
    MALLAEV_ID_CLIENT_ID=mid_…        # номер приложения из кабинета
    MALLAEV_ID_CLIENT_SECRET=…         # секрет — показывается один раз
    MALLAEV_ID_REDIRECT_URI=https://example.com/auth/callback
    MALLAEV_ID_SESSION_SECRET=…        # 32+ случайных знаков: openssl rand -base64 48

    Готовый .env с вашими значениями кабинет показывает, когда выдаёт секрет.

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

    lib/mallaev-id.ts
    import { createMallaevId, createAuthRoutes } from '@mallaev/id';
    
    const redirectUri = process.env.MALLAEV_ID_REDIRECT_URI!;
    
    export const mallaevId = createMallaevId({
      clientId: process.env.MALLAEV_ID_CLIENT_ID!,
      clientSecret: process.env.MALLAEV_ID_CLIENT_SECRET,
      redirectUri,
    });
    
    export const auth = createAuthRoutes({
      client: mallaevId,
      secret: process.env.MALLAEV_ID_SESSION_SECRET!,
      redirectUri,
    });
    Три маршрута
    // app/auth/login/route.ts
    import { auth } from '@/lib/mallaev-id';
    export const GET = auth.login;
    
    // app/auth/callback/route.ts
    import { auth } from '@/lib/mallaev-id';
    export const GET = auth.callback;
    
    // app/auth/logout/route.ts
    import { auth } from '@/lib/mallaev-id';
    export const POST = auth.logout;
    Кто вошёл — в серверном компоненте
    import { cookies } from 'next/headers';
    import { redirect } from 'next/navigation';
    import { auth } from '@/lib/mallaev-id';
    
    const session = await auth.getSession((await cookies()).get(auth.cookieNames.session)?.value);
    if (!session) redirect('/auth/login?returnTo=/orders');
    
    session.user.sub;   // номер человека для вашего сайта
    session.user.email; // почта, если человек согласился
  5. Поставьте кнопку

    React
    import { MallaevIdButton } from '@mallaev/id/button';
    
    <MallaevIdButton href="/auth/login" />

    Без React — mallaevIdButtonHtml({ href: '/auth/login' }) из @mallaev/id/button отдаёт ту же кнопку строкой HTML. Выход — обычная форма: <form action="/auth/logout" method="post">.

  6. Проверьте перед запуском

    • Вход. Кнопка → экран Mallaev ID → возврат на сайт уже вошедшим.
    • Возврат на нужную страницу. /auth/login?returnTo=/cart после входа открывает /cart.
    • Отказ. «Отказать» на экране согласия возвращает с ?mallaev_id_error=access_denied — покажите понятное сообщение.
    • Выход. Форма POST /auth/logout завершает сеанс на сайте.
    • Тот же человек. При повторном входе user.sub не меняется — по нему и храните аккаунт на своей стороне.

Что получит сайт

user.sub
Постоянный номер человека для вашего сайта. Другие сайты видят другой номер — по нему людей не сопоставить.
user.email
Подтверждённая почта — если приложение её просит и человек согласился на экране согласия.
user.mfa
Вход подтверждён вторым фактором или ключом доступа.
user.authTime
Когда человек последний раз подтвердил себя в Mallaev ID.

Пароль, коды и второй фактор сайт не видит никогда.

Безопасность

  • Пакет проверяет state, срок начатого входа, подпись ID-токена по ключам Mallaev ID, издателя, получателя и nonce.
  • Сеанс сайта — запечатанная cookie (AES-256-GCM), HttpOnly, SameSite=Lax, Secure. По умолчанию живёт сутки.
  • Секреты — только в окружении сервера. Новый секрет в кабинете сразу отменяет прежний.
  • returnTo принимается только как путь этого же сайта — чужой адрес подставить нельзя.
Без пакета: протокол по шагам
  1. Создайте на сервере случайные state, nonce и code_verifier и сохраните их в короткой сессии браузера.
  2. Отправьте браузер на /oidc/authorize: response_type=code, client_id, точный redirect_uri, scope=openid email, state, nonce, code_challenge=BASE64URL(SHA256(code_verifier)), code_challenge_method=S256.
  3. При возврате сверьте state и обработайте error. Обменяйте code на сервере: POST /oidc/token с code_verifier, аутентификация — client_secret_basic.
  4. Проверьте ID-токен: подпись по JWKS (RS256), issuer, audience, exp, nonce. Почта — в /oidc/userinfo.
  5. Связывайте человека по паре issuer + sub, не по почте.
  6. Access-токен действует 5 минут. Refresh-токен одноразовый: новую пару сохраняйте сразу, повторное использование старого отзывает весь вход. При выходе отзовите токен через /oidc/revoke.