İçeriğe geç
Aurabase Logosu
aura tabanı

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.

Nasıl yapılır kılavuzu6 dk. okuSeviye orta düzey25 Eki 2026 tarihinde revize edildi

Bu çeviriden bu yana İngilizce kaynak değişti. Bazı bilgiler güncelliğini kaybetmiş olabilir.
Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

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ğin https://my-app-x1y2z3.aurabase.cloud/v1/auth),
  • aud: proje tanımlayıcısı,
  • sub: kullanıcı kimliği artı role, email, app_metadata ve user_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)#

verify.tstypescript
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)#

verify.pypython
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#

verify.gogo
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.

Bilgi

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.