Arka uçta bir kullanıcının JWT değerini doğrulayın
Kendi arka ucunuz, yalnızca proje URL'sini kullanarak herhangi bir JOSE kitaplığıyla oturum açmış bir kullanıcıdan bir isteğin gelip gelmediğini kontrol edebilir.
Jetonlar nasıl imzalanır?#
Her projenin kendi kendi ES256 (ECDSA P-256) anahtarı vardır. Erişim belirteci başlığı bu anahtarın kid değerini taşır ve talepler şunları taşır:
iss:<project URL>/v1/auth(örneğinhttps://my-app-x1y2z3.aurabase.cloud/v1/auth),aud: proje tanımlayıcısı,sub: kullanıcı kimliği artırole,email,app_metadataveuser_metadata.
Genel anahtarlar herhangi bir API anahtarı olmadan <project URL>/.well-known/jwks.json konumunda sunulur. Arka ucunuzla hiçbir sır paylaşılmaz ve bir projenin jetonu diğerinin anahtarları tarafından reddedilir.
Studio › Ayarlar › API, JWKS URL'sini, vereni ve geçerli kid öğesini gösterir.
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 anahtarları önbelleğe alır ve bilinmeyen bir çocukla karşılaştığında yeniden getirir (döndürme).
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 kullanıcı kimliğidir
}
Python (PyJWT)#
import os
import jwt # pip kurulumu "pyjwt[kripto]"
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,
)
Git#
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
}
Anahtar rotasyonu#
Anahtarın Studio'da döndürülmesi (veya POST /v1/auth/admin/signing-keys/rotate ve service_role anahtarıyla), her yeni belirtecin yeni bir anahtarla imzalanmasını sağlar. Önceki anahtar 24 saat boyunca JWKS'de kalır, bu nedenle rotasyondan önce imzalanan jetonlar doğrulanmaya devam eder; sızdırılan bir anahtar, artık aktif anahtar olmadığında DELETE /v1/auth/admin/signing-keys/<kid> ile iptal edilebilir ve daha sonra JWKS'den kaldırılıp reddedilebilir.
JavaScript SDK'sında aura.auth.getClaims() oturum belirtecini bu JWKS ile yerel olarak zaten doğruluyor ve gerçek taleplerini döndürüyor.