Перейти к содержимому
Логотип Аурабаза
аурабаза

Проверьте JWT пользователя в своем серверном интерфейсе.

Ваш собственный бэкэнд может проверить, поступает ли запрос от вошедшего в систему пользователя с помощью любой библиотеки JOSE, используя только URL-адрес проекта.

Практическое руководство6 мин читатьУровень среднийПересмотрено 25 окт. 2026 г.

Английский источник изменился после этого перевода. Некоторая информация может быть устаревшей.
Эта страница была переведена автоматически. Английская версия является авторитетной.

Как подписываются токены#

Каждый проект имеет свой собственный ключ ES256 (ECDSA P-256). Заголовок токена доступа содержит kid этого ключа, а утверждения содержат:

  • iss: <project URL>/v1/auth (например https://my-app-x1y2z3.aurabase.cloud/v1/auth),
  • aud: идентификатор проекта,
  • sub: идентификатор пользователя плюс role, email, app_metadata и user_metadata.

Открытые ключи передаются без ключа API по адресу <project URL>/.well-known/jwks.json. Никакой секрет не передается вашему бэкэнду, а токен одного проекта отклоняется ключами другого.

Studio › Настройки › API показывает URL-адрес JWKS, эмитента и текущий kid.

Node.js (Хосе)#

verify.tstypescript
import { createRemoteJWKSet, jwtVerify } from 'jose'

const projectUrl = process.env.AURABASE_URL! // https://<слаг>.aurabase.cloud
const PROJECT_ID = process.env.AURABASE_PROJECT_ID!

// Хосе кэширует ключи и выполняет повторную выборку, когда встречает неизвестного ребенка (ротация).
const jwks = createRemoteJWKSet(new URL(`${projectUrl}/.well-known/jwks.json`))

export async function verifyAccessToken(token: string) {
  const { payload } = await jwtVerify(token, jwks, {
    issuer: `${projectUrl}/v1/auth`,
    audience: PROJECT_ID,
    algorithms: ['ES256'],
  })
  return payload // payload.sub — идентификатор пользователя
}

Питон (PyJWT)#

verify.pypython
import os
import jwt  # pip install "pyjwt[crypto]"

projectUrl = os.environ["AURABASE_URL"]
PROJECT_ID = os.environ["AURABASE_PROJECT_ID"]
jwks = jwt.PyJWKClient(f"{projectUrl}/.well-known/jwks.json")

def verify_access_token(token: str) -> dict:
    key = jwks.get_signing_key_from_jwt(token).key
    return jwt.decode(
        token,
        key,
        algorithms=["ES256"],
        issuer=f"{projectUrl}/v1/auth",
        audience=PROJECT_ID,
    )

Идти#

verify.gogo
package main

import (
	"fmt"
	"os"

	"github.com/MicahParks/keyfunc/v3"
	"github.com/golang-jwt/jwt/v5"
)

func verify(token string) (jwt.MapClaims, error) {
	projectURL := os.Getenv("AURABASE_URL")
	jwks, err := keyfunc.NewDefault([]string{projectURL + "/.well-known/jwks.json"})
	if err != nil {
		return nil, err
	}
	claims := jwt.MapClaims{}
	_, err = jwt.ParseWithClaims(token, claims, jwks.Keyfunc,
		jwt.WithValidMethods([]string{"ES256"}),
		jwt.WithIssuer(projectURL+"/v1/auth"),
		jwt.WithAudience(os.Getenv("AURABASE_PROJECT_ID")),
	)
	if err != nil {
		return nil, fmt.Errorf("invalid token: %w", err)
	}
	return claims, nil
}

Ключевое вращение#

Вращение ключа в Studio (или с помощью POST /v1/auth/admin/signing-keys/rotate и service_role) приводит к тому, что каждый новый токен подписывается новым ключом. Предыдущий ключ остается в JWKS в течение 24 часов, поэтому токены, подписанные до ротации, продолжают проверяться; Утечка ключа может быть отозвана с помощью DELETE /v1/auth/admin/signing-keys/<kid>, как только он перестанет быть активным, а затем будет удален из JWKS и отклонен.

Информация

В JavaScript SDK aura.auth.getClaims() уже проверяет токен сеанса локально с помощью этого JWKS и возвращает его реальные утверждения.