Aurabase Logosu
aura tabanıdokümanlar
dokümanlar›JavaScript SDK reference›Auth reference

JavaScript SDK'sı: kimlik doğrulama referansı

İmzasıyla birlikte her kimlik doğrulama ve kullanıcı yönetimi yöntemi.

6 dk. oku·Seviye referans·12 Eki 2026 tarihinde revize edildi
Bu İngilizce metin, Fransızca orijinalinden otomatik olarak oluşturulmuştur ve henüz incelenmemiştir.
Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.
#
Fonksiyonlar

Dışa aktarılan işlevler

İşlevAçıklama
function isMfaChallenge(v: unknown): v is MfaChallengeAyırıcı türü koruması LoginResponse = TokenPair | MfaChallenge.
#
Sınıf

Kimlik Doğrulama Hizmeti

YöntemAçıklama
dispose(): voidProaktif yaşam döngüsünü ortadan kaldırır: kayan yazı, görünürlük, BroadcastChannel, dinleyiciler.
onAuthStateChange(callback: AuthStateCallback): { unsubscribe: () => void; data: { subscription: { unsubscribe: () => void; }; }; }Oturum durumu değişikliklerini dinler (SIGNED_IN, SIGNED_OUT, TOKEN_REFRESHED, USER_UPDATED, MFA_CHALLENGE…).
signUp(req: SignUpRequest): Promise<AuraResponse<LoginResponse>>E-posta ve şifreyle bir hesap oluşturun.
signInWithPassword(req: SignInRequest): Promise<AuraResponse<LoginResponse>>Bir kullanıcının e-posta ve şifreyle oturum açmasını sağlar.
signInWithOAuth(provider: string, options?: OAuthSignInOptions): Promise<AuraResponse<{ url: string; }>>Bir OAuth akışı başlatır: her zaman { url } değerini döndürür (ve ayrıca bir window varsa tarayıcıyı yeniden yönlendirir).
signInWithMagicLink(req: MagicLinkRequest): Promise<AuraResponse<{ message: string; }>>E-posta yoluyla bir bağlantı bağlantısı gönderir (“sihirli bağlantı”).
signInAnonymously(): Promise<AuraResponse<TokenPair>>SIGNED_IN tarafından kaydedilen ve raporlanan anonim bir oturum (e-postası olmayan kullanıcı) oluşturur.
signOut(): Promise<AuraResponse<null>>Bağlantıyı Kes: varsa sunucu tarafı yenileme belirtecini iptal eder, yerel oturumu temizler ve SIGNED_OUT verir.
refreshSession(): Promise<AuraResponse<TokenPair>>Oturumu yenileme belirteciyle yeniler ve TOKEN_REFRESHED değerini verir.
getSession(): Promise<{ data: { session: Session | null; }; error: null; accessToken: string | null; access_token: string | null; user: User | null; }>Geçerli oturum mağazadan okunur (uygulamada eşzamanlıdır, ağ çağrısı yoktur).
setSession(accessToken: string, refreshToken: string): Promise<AuraResponse<User>>Mevcut bir erişim belirtecinden ve yenileme belirtecinden (örneğin bir sunucudan alınan) bir oturum yükler.
exchangeCodeForSession(authCode: string, codeVerifier?: string): Promise<AuraResponse<LoginResponse>>Bir oturum için PKCE yetkilendirme kodunu değiştirir.
listSessions(): Promise<AuraResponse<SessionInfo[]>>Oturum açmış kullanıcının oturumlarını listeler (cihaz, IP adresi, tarihler); is_current geçerli oturumu bulur.
revokeSession(sessionId: string): Promise<AuraResponse<null>>Tanımlayıcısıyla bağlanan kullanıcının oturumunu iptal eder.
revokeAllSessions(): Promise<AuraResponse<{ message: string; }>>Kullanıcının her yerde oturumunu kapatır: tüm oturumlarını iptal eder, yerel oturumu temizler ve SIGNED_OUT değerini verir.
getUser(jwt?: string): Promise<AuraResponse<User>>Sunucu tarafında doğrulanmış kullanıcıyı alır.
getClaims(jwt?: string, options?: { allowExpired?: boolean; issuer?: string; audience?: string; }): Promise<AuraResponse<GetClaimsResult>>JWT taleplerini doğrular ve kodunu çözer.
deleteUser(password: string): Promise<AuraResponse<null>>Bağlı kullanıcının hesabını, parolasıyla onaylandıktan sonra siler ve ardından yerel oturumu temizler.
updateUser(req: UpdateUserRequest): Promise<AuraResponse<User>>Oturum açmış kullanıcıyı (meta veriler, parola vb.) günceller ve USER_UPDATED değerini verir.
resetPasswordForEmail(req: PasswordResetRequest): Promise<AuraResponse<{ message: string; }>>Parola sıfırlama e-postası gönderir.
updatePassword(newPassword: string, currentPassword?: string): Promise<AuraResponse<User>>Oturum açan kullanıcının şifresini değiştirir.
mfaEnroll(): Promise<AuraResponse<MfaEnrollResponse>>MFA: TOTP kaydını başlatır ve QR kodu olarak görüntülenecek secret ile otpauth_url URL'sini döndürür.
mfaVerifySetup(code: string): Promise<AuraResponse<{ recovery_codes: string[]; }>>MFA: kaydı ilk kodla onaylar ve kurtarma kodlarını döndürür.
mfaVerify(req: MfaVerifyRequest): Promise<AuraResponse<TokenPair>>MFA: sınama döndüren bağlantıyı sonlandırır (mfa_token ve TOTP kodu).
mfaUnenroll(password: string): Promise<AuraResponse<{ message: string; }>>MFA: şifreyle onaylandıktan sonra MFA devre dışı bırakır.
verifyOtp(params: VerifyEmailChangeOtpParams): Promise<AuraResponse<User>>
verifyOtp(params: Exclude<VerifyOtpParams, VerifyEmailChangeOtpParams>): Promise<AuraResponse<TokenPair>>		OTP doğrulamasının TEK giriş noktası (eşlik verifyOtp / @supabase/auth-js).
resendVerificationEmail(email?: string): Promise<AuraResponse<{ message: string; }>>Doğrulama e-postasını email adresine veya oturum açmış kullanıcının adresine yeniden gönderir.
signInWithEmailOtp(email: string): Promise<AuraResponse<{ message: string; }>>Tek kullanımlık kodu e-postayla gönderir; verifyOtp({ type: 'email' }) tarafından onaylanacak.
signInWithSmsOtp(phone: string): Promise<AuraResponse<{ message: string; }>>SMS ile tek seferlik bir kod gönderir; verifyOtp({ type: 'sms' }) tarafından onaylanacak.
listIdentities(): Promise<AuraResponse<IdentityInfo[]>>Oturum açmış kullanıcıya bağlı kimlikleri (sağlayıcıları) listeler.
linkIdentity(provider: string): Promise<AuraResponse<{ url: string; provider: string; }>>Bağlı hesaba OAuth sağlayıcısını bağlamayı başlatır ve açılacak yetkilendirme URL'sini döndürür.
unlinkIdentity(identityId: string): Promise<AuraResponse<{ message: string; }>>Bir kimliği, tanımlayıcısıyla bağlanan hesaptan ayırır.
regenerateRecoveryCodes(code: string): Promise<AuraResponse<{ recovery_codes: string[]; }>>MFA: TOTP koduyla onaylandıktan sonra kurtarma kodlarını yeniden oluşturur.
signInWithIdToken(provider: string, idToken: string, accessToken?: string): Promise<AuraResponse<LoginResponse>>Bir oturum için sağlayıcı jeton kimliğini (Google/Apple, yerel mobil) değiştirir.
getSettings(): Promise<AuraResponse<{ disable_signup: boolean; external: Record<string, boolean>; mailer_autoconfirm: boolean; mfa_enabled: boolean; }>>GoTrue eşlik: GET /settings — genel proje yapılandırması (kimlik doğrulama gerekmez).
getAnonKey(): Promise<AuraResponse<{ anon_key: string; }>>Projenin yayınlanabilir anahtarı (anon anahtarı) — GET /anon-key (genel, Supabase modeli gibi).
resetPassword(token: string, newPassword: string): Promise<AuraResponse<TokenPair>>Parola kurtarma belirtecini tüketir ve yeni parolayı uygular.
promoteAnonymous(credentials: { email: string; password: string; }): Promise<AuraResponse<TokenPair>>Geçerli anonim kullanıcıyı (JWT gereklidir) normal bir e-posta+şifre hesabına dönüştürür.
verifyMagicLink(token: string): Promise<AuraResponse<TokenPair>>Sihirli bağlantı belirtecini tüketir ve bir TokenPair döndürür.
#
Sınıf

AuthAdminService

YöntemAçıklama
listUsers(params?: { limit?: number; offset?: number; search?: string; }): Promise<AuraResponse<AdminUser[]>>Arama (search) ve sayfalandırma (limit, offset) ile proje kullanıcılarını listeler.
getUser(userId: string): Promise<AuraResponse<AdminUser>>Bir kullanıcıyı kimliğine göre okur.
createUser(data: AdminCreateUserRequest): Promise<AuraResponse<AdminUser>>Genel kayda (e-posta, şifre, meta veriler, rol) geçmeden bir kullanıcı oluşturur.
updateUser(userId: string, data: AdminUpdateUserRequest): Promise<AuraResponse<AdminUser>>Bir kullanıcıyı günceller: yalnızca sağlanan alanlar değişir.
deleteUser(userId: string): Promise<AuraResponse<null>>Bir kullanıcıyı silin.
banUser(userId: string): Promise<AuraResponse<null>>Bir kullanıcıyı yasaklar: Artık oturum açamaz.
unbanUser(userId: string): Promise<AuraResponse<null>>Bir kullanıcının yasağını kaldırın.
generateLink(userId: string, type: GenerateLinkType): Promise<AuraResponse<GenerateLinkResult>>Bir kullanıcı için tek seferlik bir bağlantı oluşturur ('magic', 'recovery' veya 'invite') ve { link, token } değerini döndürür.
getUserStats(): Promise<AuraResponse<UserStats>>Kullanıcı istatistikleri: toplam, doğrulanmış, yasaklanmış, MFA ve 7 gün boyunca yeni.
listUserIdentities(userId: string): Promise<AuraResponse<IdentityInfo[]>>Bir kullanıcıya bağlı kimlikleri listeler (OAuth sağlayıcılar, e-posta).
listSessions(params?: { userId?: string; limit?: number; offset?: number; }): Promise<AuraResponse<AdminSessionInfo[]>>Tüm kullanıcıların aktif oturumlarını, sayfalandırmayla birlikte userId ile filtrelenebilir şekilde listeler.
revokeSession(sessionId: string): Promise<AuraResponse<null>>Bir oturumu tanımlayıcısına göre iptal eder.
getAuditLog(params?: { userId?: string; limit?: number; offset?: number; }): Promise<AuraResponse<AuditLogEntry[]>>Sayfalama ile userId tarafından filtrelenebilen denetim günlüğünü (eylem, IP adresi, kullanıcı aracısı, tarih) okur.
getSettings(): Promise<AuraResponse<AuthSettings>>Projenin kimlik doğrulama ayarlarını okur.
updateSettings(data: AuthSettingsUpdate): Promise<AuraResponse<AuthSettings>>Projenin kimlik doğrulama ayarlarını günceller (kısmi birleştirme: yalnızca sağlanan alanlar yazılır, arka uç tarafında COALESCE).
listEmailTemplates(): Promise<AuraResponse<Record<string, unknown>[]>>Proje kimlik doğrulama e-posta şablonlarını listeler.
getEmailTemplate(type: string): Promise<AuraResponse<Record<string, unknown>>>Belirli bir türdeki e-posta şablonunu okur (ör. onay, kurtarma).
updateEmailTemplate(type: string, data: EmailTemplateUpdate): Promise<AuraResponse<Record<string, unknown>>>Belirli bir türdeki e-posta şablonu içeriğini değiştirir.
deleteEmailTemplate(type: string): Promise<AuraResponse<{ message: string; }>>Özel şablonu bir e-posta türünden kaldırır.
testEmailTemplate(type: string, body: { to_email: string; }): Promise<AuraResponse<null>>to_email adresine bir türün şablonunu içeren bir test e-postası gönderir.
Oluşturulan sayfa

Bu sayfa, SDK'nın tür bildirimlerinden ve yorumlarından oluşturulduğundan, yayınlanan koddan sapamaz. Çalışılan örnekler için kılavuzları okuyun.