Проверьте JWT пользователя в своем серверном интерфейсе.
Ваш собственный бэкэнд может проверить, поступает ли запрос от вошедшего в систему пользователя с помощью любой библиотеки JOSE, используя только URL-адрес проекта.
Как подписываются токены#
Каждый проект имеет свой собственный ключ 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 (Хосе)#
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)#
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,
)
Идти#
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 и возвращает его реальные утверждения.