Controleer de JWT van een gebruiker in uw backend
Uw eigen backend kan controleren of een verzoek afkomstig is van een aangemelde gebruiker, met elke JOSE-bibliotheek, met alleen de project-URL.
Hoe tokens worden ondertekend#
Elk project heeft zijn eigen ES256 (ECDSA P-256) sleutel. De header van het toegangstoken bevat de kid van die sleutel, en de claims bevatten:
iss:<project URL>/v1/auth(bijvoorbeeldhttps://my-app-x1y2z3.aurabase.cloud/v1/auth),aud: de project-ID,sub: het gebruikers-ID, plusrole,email,app_metadataenuser_metadata.
De publieke sleutels worden, zonder enige API-sleutel, aangeboden op <project URL>/.well-known/jwks.json. Er wordt geen geheim gedeeld met uw backend, en een token van het ene project wordt afgewezen door de sleutels van een ander project.
Studio › Instellingen › API toont de JWKS-URL, de uitgever en de huidige kid.
Knooppunt.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 bewaart de sleutels in het cachegeheugen en haalt deze opnieuw op wanneer hij een onbekend kind tegenkomt (rotatie).
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 is het gebruikers-ID
}
Python (PyJWT)#
import os
import jwt # pip installeer "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,
)
Ga#
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
}
Sleutelrotatie#
Door de sleutel in Studio te draaien (of met POST /v1/auth/admin/signing-keys/rotate en de service_role sleutel) wordt voor elk nieuw token een nieuw sleutelteken gemaakt. De vorige sleutel blijft 24 uur in de JWKS, dus tokens die vóór de rotatie zijn ondertekend, blijven verifiëren; een gelekte sleutel kan worden ingetrokken met DELETE /v1/auth/admin/signing-keys/<kid> zodra deze niet langer de actieve is, en wordt vervolgens uit de JWKS verwijderd en geweigerd.
In de JavaScript SDK verifieert aura.auth.getClaims() het sessietoken al lokaal met deze JWKS en retourneert de echte claims.