Verifica JWT di un utente nel tuo backend
Il tuo backend può verificare che una richiesta provenga da un utente che ha effettuato l'accesso, con qualsiasi libreria JOSE, utilizzando solo l'URL del progetto.
Come vengono firmati i token#
Ogni progetto ha la propria chiave ES256 (ECDSA P-256). L'intestazione del token di accesso contiene kid di quella chiave e le attestazioni contengono:
iss:<project URL>/v1/auth(ad esempiohttps://my-app-x1y2z3.aurabase.cloud/v1/auth),aud: l'identificatore del progetto,sub: l'ID utente, piùrole,email,app_metadataeuser_metadata.
Le chiavi pubbliche vengono servite, senza alcuna chiave API, su <project URL>/.well-known/jwks.json. Nessun segreto è condiviso con il tuo backend e un token di un progetto viene rifiutato dalle chiavi di un altro.
Studio › Impostazioni › L'API mostra l'URL JWKS, l'emittente e l'attuale kid.
Node.js (jose)#
import { createRemoteJWKSet, jwtVerify } from 'jose'
const projectUrl = process.env.AURABASE_URL! // https://<slug>.aurabase.cloud
const PROJECT_ID = process.env.AURABASE_PROJECT_ID!
// Jose memorizza nella cache le chiavi e le recupera quando incontra un bambino sconosciuto (rotazione).
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 è l'ID utente
}
Python (PyJWT)#
import os
import jwt # pip installa "pyjwt[cripto]"
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,
)
Vai#
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
}
Rotazione della chiave#
Ruotando la chiave in Studio (o con POST /v1/auth/admin/signing-keys/rotate e la chiave service_role) viene creata una nuova chiave per firmare ogni nuovo token. La chiave precedente rimane nel JWKS per 24 ore, quindi i token firmati prima della rotazione continuano a verificare; una chiave trapelata può essere revocata con DELETE /v1/auth/admin/signing-keys/<kid> una volta che non è più quella attiva, quindi viene rimossa dal JWKS e rifiutata.
Nell'SDK JavaScript, aura.auth.getClaims() verifica già il token di sessione localmente con questo JWKS e restituisce le sue affermazioni reali.