अपने बैकएंड में उपयोगकर्ता का JWT सत्यापित करें
आपका स्वयं का बैकएंड केवल प्रोजेक्ट यूआरएल का उपयोग करके जांच कर सकता है कि किसी JOSE लाइब्रेरी के साथ साइन-इन किए गए उपयोगकर्ता से अनुरोध आया है।
टोकन पर हस्ताक्षर कैसे किये जाते हैं#
प्रत्येक प्रोजेक्ट की अपनी अपनी ES256 (ECDSA P-256) कुंजी होती है। एक्सेस टोकन हेडर में उस कुंजी का kid होता है, और दावे होते हैं:
iss:<project URL>/v1/auth(उदाहरण के लिएhttps://my-app-x1y2z3.aurabase.cloud/v1/auth),aud: प्रोजेक्ट पहचानकर्ता,sub: उपयोगकर्ता आईडी, प्लसrole,email,app_metadataऔरuser_metadata।
सार्वजनिक कुंजियाँ, बिना किसी एपीआई कुंजी के, <project URL>/.well-known/jwks.json पर परोसी जाती हैं। आपके बैकएंड के साथ कोई रहस्य साझा नहीं किया जाता है, और एक प्रोजेक्ट का टोकन दूसरे की कुंजी द्वारा अस्वीकार कर दिया जाता है।
स्टूडियो › सेटिंग्स › एपीआई JWKS URL, जारीकर्ता और वर्तमान kid दिखाता है।
Node.js (जोस)#
import { createRemoteJWKSet, jwtVerify } from 'jose'
const projectUrl = process.env.AURABASE_URL! // https://<slug>.aurabase.cloud
const PROJECT_ID = process.env.AURABASE_PROJECT_ID!
// जोस किसी अज्ञात बच्चे (रोटेशन) से मिलने पर चाबियाँ कैश करता है और पुनः प्राप्त करता है।
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 उपयोगकर्ता आईडी है
}
पायथन (PyJWT)#
import os
import jwt # पिप इंस्टाल "pyjwt[क्रिप्टो]"
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,
)
जाना#
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
}
कुंजी घुमाव#
स्टूडियो में कुंजी को घुमाने से (या POST /v1/auth/admin/signing-keys/rotate और service_role कुंजी के साथ) प्रत्येक नए टोकन पर एक नया कुंजी चिह्न बनता है। पिछली कुंजी 24 घंटे तक JWKS में रहती है, इसलिए रोटेशन से पहले हस्ताक्षरित टोकन सत्यापित होते रहते हैं; एक कुंजी जो लीक हो गई है उसे DELETE /v1/auth/admin/signing-keys/<kid> के साथ रद्द किया जा सकता है जब वह सक्रिय नहीं रह जाती है, और फिर उसे JWKS से हटा दिया जाता है और अस्वीकार कर दिया जाता है।
जावास्क्रिप्ट एसडीके में, aura.auth.getClaims() पहले से ही इस JWKS के साथ सत्र टोकन को स्थानीय रूप से सत्यापित करता है और इसके वास्तविक दावे लौटाता है।