Verificar el JWT de un usuario en su backend
Su propio backend puede comprobar que una solicitud proviene de un usuario que ha iniciado sesión, con cualquier biblioteca JOSE, utilizando únicamente la URL del proyecto.
Cómo se firman los tokens#
Cada proyecto tiene su propia clave ES256 (ECDSA P-256). El encabezado del token de acceso lleva el kid de esa clave y los reclamos llevan:
iss:<project URL>/v1/auth(por ejemplohttps://my-app-x1y2z3.aurabase.cloud/v1/auth),aud: el identificador del proyecto,sub: la identificación del usuario, másrole,email,app_metadatayuser_metadata.
Las claves públicas se entregan, sin ninguna clave API, en <project URL>/.well-known/jwks.json. No se comparte ningún secreto con su backend y las claves de otro rechazan un token de un proyecto.
Studio › Configuración › API muestra la URL de JWKS, el emisor y el kid actual.
Node.js (josé)#
import { createRemoteJWKSet, jwtVerify } from 'jose'
const projectUrl = process.env.AURABASE_URL! // https://<babosa>.aurabase.cloud
const PROJECT_ID = process.env.AURABASE_PROJECT_ID!
// José guarda las llaves en caché y las vuelve a buscar cuando se encuentra con un niño desconocido (rotación).
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 es la identificación del usuario
}
Python (PyJWT)#
import os
import jwt # instalación de pip "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,
)
ir#
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
}
Rotación de claves#
Al girar la clave en Studio (o con POST /v1/auth/admin/signing-keys/rotate y la clave service_role) se crea una nueva clave para cada nuevo token. La clave anterior permanece en el JWKS durante 24 horas, por lo que los tokens firmados antes de la rotación se siguen verificando; una clave que se filtró se puede revocar con DELETE /v1/auth/admin/signing-keys/<kid> una vez que ya no es la activa, y luego se elimina del JWKS y se rechaza.
En el SDK de JavaScript, aura.auth.getClaims() ya verifica el token de sesión localmente con este JWKS y devuelve sus afirmaciones reales.