Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

Halaman ini diterjemahkan oleh Cloud Translation API.

firebase-admin.auth package

dengan Firebase Authentication.

Functions

Fungsi	Deskripsi
getAuth(aplikasi)	Mendapatkan layanan Auth untuk aplikasi default atau aplikasi tertentu.`getAuth()` dapat dipanggil tanpa argumen untuk mengakses layanan Auth aplikasi default atau sebagai `getAuth(app)` untuk mengakses layanan Auth yang terkait dengan aplikasi tertentu.

Kelas

Class	Deskripsi
Autentikasi	Layanan Auth yang terikat ke aplikasi yang disediakan. Satu instance Auth dapat memiliki beberapa tenant.
AuthClientErrorCode	Kode error klien Auth dan pesan defaultnya.
BaseAuth	Antarmuka induk umum untuk API `Auth` dan `TenantAwareAuth`.
FirebaseAuthError	Struktur kode error Firebase Auth. Tindakan ini akan memperluas PrefixedFirebaseError.
Info MultiFaktor	Antarmuka yang mewakili properti umum dari faktor kedua yang didaftarkan pengguna.
Setelan MultiFaktor	Setelan pengguna terkait multi-faktor.
PhoneMultiFactorInfo	Antarmuka yang mewakili faktor kedua khusus ponsel yang didaftarkan pengguna.
ProjectConfig	Merepresentasikan konfigurasi project.
ProjectConfigManager	Mengelola (mendapatkan dan memperbarui) konfigurasi project saat ini.
Penyewa	Mewakili konfigurasi tenant.Dukungan multi-tenancy memerlukan Identity Platform (GCIP) Google Cloud. Untuk mempelajari GCIP lebih lanjut, termasuk harga dan fitur, lihat dokumentasi GCIP.Sebelum multi-tenancy dapat digunakan di project Google Cloud Identity Platform, tenant harus diizinkan di project tersebut melalui UI Konsol Cloud.Konfigurasi tenant memberikan informasi seperti nama tampilan, ID tenant, dan konfigurasi autentikasi email. Untuk pengelolaan konfigurasi penyedia OIDC/SAML, instance `TenantAwareAuth` harus digunakan sebagai pengganti `Tenant` untuk mengambil daftar IdP yang dikonfigurasi pada tenant. Saat mengonfigurasi penyedia ini, perhatikan bahwa tenant akan mewarisi domain yang diizinkan dan URI pengalihan yang diautentikasi dari project induknya.Semua setelan tenant lainnya juga akan diwarisi. Keduanya harus dikelola dari UI Cloud Console.
TenantAwareAuth	Antarmuka `Auth` berbasis tenant digunakan untuk mengelola pengguna, mengonfigurasi penyedia SAML/OIDC, membuat link email untuk reset sandi, verifikasi email, dll. untuk tenant tertentu.Dukungan multi-tenancy memerlukan Identity Platform (GCIP) Google Cloud. Untuk mempelajari GCIP lebih lanjut, termasuk harga dan fitur, lihat dokumentasi GCIP.Setiap tenant berisi penyedia identitas, setelan, dan kumpulan penggunanya sendiri. Dengan menggunakan `TenantAwareAuth`, pengguna untuk tenant tertentu dan konfigurasi OIDC/SAML terkait juga dapat dikelola, token ID untuk pengguna yang login ke tenant tertentu dapat diverifikasi, dan link tindakan email juga dapat dibuat untuk pengguna yang termasuk dalam tenant.Instance `TenantAwareAuth` untuk `tenantId` tertentu dapat dibuat instance-nya dengan memanggil TenantManager.authForTenant().
TenantManager	Menentukan tenant manager yang digunakan untuk membantu mengelola operasi terkait penyewa. Ini mencakup: Kemampuan untuk membuat, memperbarui, mencantumkan, mendapatkan, dan menghapus tenant untuk project pokok. Mendapatkan instance `TenantAwareAuth` untuk menjalankan operasi terkait Auth (pengelolaan pengguna, pengelolaan konfigurasi penyedia, verifikasi token, pembuatan link email, dll.) dalam konteks tenant tertentu.
Info Pengguna	Mewakili info pengguna dari penyedia identitas pihak ketiga, seperti Google atau Facebook.
UserMetadata	Mewakili metadata pengguna.
UserRecord	Mewakili pengguna.

Antarmuka

Antarmuka	Deskripsi
SetelanKodeTindakan	Ini adalah antarmuka yang menentukan URL lanjutkan/status yang diperlukan dengan ID paket Android dan iOS opsional.
Izinkan Secara Default	Menentukan kebijakan untuk mengizinkan setiap wilayah secara default dan menambahkan wilayah yang tidak diizinkan ke daftar larangan.
AllowByDefaultWrap	Konfigurasi Region SMS khusus antarmuka AllowByDefault
Hanya Daftar yang Diizinkan	Menentukan kebijakan untuk hanya mengizinkan wilayah dengan menambahkannya secara eksplisit ke daftar yang diizinkan.
Izinkan HanyaWrap	Konfigurasi Region SMS khusus antarmuka AllowlistOnly
AuthProviderConfigFilter	Antarmuka filter yang digunakan untuk konfigurasi penyedia listingan. Atribut ini digunakan saat menentukan cara mencantumkan penyedia identitas yang dikonfigurasi melalui BaseAuth.listProviderConfigs().
BaseAuthProviderConfig	Antarmuka konfigurasi penyedia Auth dasar.
BaseCreateMultiFactorInfoRequest	Antarmuka yang mewakili properti dasar faktor kedua yang didaftarkan pengguna untuk `CreateRequest`.
BaseUpdateMultiFactorInfoRequest	Antarmuka yang mewakili properti umum dari faktor kedua yang didaftarkan pengguna untuk `UpdateRequest`.
CreatePhoneMultiFactorInfoRequest	Antarmuka yang merepresentasikan faktor kedua khusus ponsel yang didaftarkan pengguna untuk `CreateRequest`.
Buat Permintaan	Antarmuka yang mewakili properti yang akan ditetapkan pada kumpulan data pengguna baru yang akan dibuat.
CustomStrengthOptionsConfig	Batasan yang akan diterapkan pada kebijakan sandi
DecodeAuthBlockingToken
DecodeIdToken	Antarmuka yang mewakili token ID Firebase yang didekode, yang ditampilkan dari metode BaseAuth.verifyIdToken().Token Firebase ID adalah Token Web JSON (JWT) yang sesuai dengan spesifikasi OpenID Connect. Lihat [bagian Token ID mengenai spesifikasi OpenID Connect](http://openid.net/specs/openid-connect-core-1_0.html#IDToken) untuk informasi selengkapnya tentang properti khusus di bawah ini.
DeleteUsersResult	Merepresentasikan hasil BaseAuth.deleteUsers(). Compute Engine API.
EmailIdentifier	Digunakan untuk mencari akun melalui email.Lihat BaseAuth.getUsers().
EmailPrivacyConfig	Konfigurasi privasi email project atau tenant.
EmailSignInProviderConfig	Konfigurasi penyedia login email.
GetUsersResult	Merepresentasikan hasil API BaseAuth.getUsers().
ListProviderConfigResults	Antarmuka respons untuk mencantumkan konfigurasi penyedia. Ini hanya tersedia saat menampilkan daftar semua penyedia identitas konfigurasi melalui BaseAuth.listProviderConfigs().
ListTenantsResult	Antarmuka yang mewakili objek yang ditampilkan dari operasi TenantManager.listTenants(). Berisi daftar tenant untuk batch saat ini dan token halaman berikutnya jika tersedia.
ListUsersResult	Antarmuka yang mewakili objek yang ditampilkan dari operasi BaseAuth.listUsers(). Berisi daftar pengguna untuk batch saat ini dan token halaman berikutnya jika tersedia.
MultiFactorConfig	Antarmuka yang mewakili konfigurasi multi-faktor. Kunci ini dapat digunakan untuk menentukan apakah autentikasi multi-faktor diaktifkan atau dinonaktifkan, dan daftar tantangan faktor kedua yang didukung.
MultiFactorCreateSettings	Setelan pengguna terkait multi-faktor untuk operasi pembuatan.
MultiFactorProviderConfig	Antarmuka yang mewakili konfigurasi penyedia autentikasi multi-faktor. Antarmuka ini digunakan untuk penyedia otentikasi faktor kedua selain SMS. Saat ini, hanya TOTP yang didukung.
MultiFactorUpdateSettings	Setelan pengguna terkait multi-faktor untuk operasi update.
OAuthResponseType	Antarmuka yang mewakili objek respons penyedia OIDC untuk alur otorisasi OAuth. Salah satu setelan berikut diperlukan: Tetapkan `code` ke `true` untuk alur kode. Tetapkan `idToken` ke `true` untuk alur token ID.
OIDCAuthProviderConfig	Antarmuka konfigurasi penyedia Auth [OIDC](https://openid.net/specs/openid-connect-core-1_0-final.html). Penyedia OIDC dapat dibuat melalui BaseAuth.createProviderConfig().
OIDCUpdateAuthProviderRequest	Antarmuka permintaan untuk mengupdate penyedia Auth OIDC. Fungsi ini digunakan saat memperbarui konfigurasi penyedia OIDC melalui BaseAuth.updateProviderConfig().
PasswordPolicyConfig	Konfigurasi kebijakan sandi untuk project atau tenant
Nomor Telepon	Digunakan untuk mencari akun berdasarkan nomor telepon.Lihat BaseAuth.getUsers().
ProviderIdentifier	Digunakan untuk mencari akun oleh penyedia gabungan.Lihat BaseAuth.getUsers().
RecaptchaConfig	Antarmuka permintaan untuk memperbarui Konfigurasi reCAPTCHA. Dengan mengaktifkan Integrasi reCAPTCHA Enterprise, Anda menyetujui Persyaratan Layanan reCAPTCHA Enterprise.
RecaptchaKey	Konfigurasi kunci reCAPTCHA.
RecaptchaManagedRule	Konfigurasi untuk aturan tindakan reCAPTCHA.
SAMLAuthProviderConfig	Antarmuka konfigurasi penyedia Auth [SAML](http://docs.oasis-open.org/security/SAML/Post2.0/sstc- SAML-tech-overview-2.0.html). Penyedia SAML dapat dibuat melalui BaseAuth.createProviderConfig().
SAMLUpdateAuthProviderRequest	Antarmuka permintaan untuk memperbarui penyedia Autentikasi SAML. Kunci ini digunakan saat memperbarui konfigurasi penyedia SAML melalui BaseAuth.updateProviderConfig().
SessionCookieOptions	Antarmuka yang menampilkan opsi cookie sesi yang diperlukan untuk metode BaseAuth.createSessionCookie().
TotpMultiFactorProviderConfig	Antarmuka yang mewakili setelan konfigurasi untuk autentikasi faktor kedua TOTP.
UidIdentifier	Digunakan untuk mencari akun oleh uid.Lihat BaseAuth.getUsers().
UpdatePhoneMultiFactorInfoRequest	Antarmuka yang merepresentasikan faktor kedua khusus ponsel yang didaftarkan pengguna untuk `UpdateRequest`.
MengupdateProjectConfigRequest	Antarmuka yang mewakili properti yang akan diperbarui berdasarkan konfigurasi project yang disediakan.
UpdateRequest	Antarmuka yang mewakili properti yang akan diperbarui pada pengguna yang disediakan.
UpdateTenantRequest	Antarmuka yang mewakili properti yang akan diperbarui pada tenant yang disediakan.
UserImportOptions	Antarmuka yang menampilkan opsi impor pengguna yang diperlukan untuk metode BaseAuth.importUsers(). Ini digunakan untuk memberikan informasi algoritma {i>hashing <i}dari {i>password<i}.
UserImportRecord	Antarmuka yang mewakili pengguna untuk diimpor ke Firebase Auth melalui metode BaseAuth.importUsers().
UserImportResult	Antarmuka yang mewakili respons dari metode BaseAuth.importUsers() untuk mengimpor pengguna secara batch ke Firebase Auth.
UserMetadataRequest	Metadata pengguna yang akan disertakan saat mengimpor pengguna.
UserProvider	Mewakili penyedia identitas pengguna yang dapat dikaitkan dengan pengguna Firebase.
UserProviderRequest	Data penyedia pengguna yang akan disertakan saat mengimpor pengguna.

Ketik Alias

Ketik Alias	Deskripsi
AuthFactorType	Mengidentifikasi jenis faktor kedua.
AuthProviderConfig	Jenis konfigurasi penyedia Auth. BaseAuth.createProviderConfig().
CreateMultiFactorInfoRequest	Jenis yang mewakili properti faktor kedua yang didaftarkan pengguna untuk `CreateRequest`.
CreateTenantRequest	Antarmuka yang mewakili properti yang akan ditetapkan pada tenant baru.
HashAlgorithmType
MultiFactorConfigState	Mengidentifikasi status konfigurasi multi-faktor.
PasswordPolicyEnforcementState	Status penerapan kebijakan sandi.
RekaptchaAction	Tindakan yang harus diambil untuk permintaan yang dilindungi reCAPTCHA. - 'BLOKIR': Permintaan yang dilindungi reCAPTCHA akan diblokir.
RecaptchaKeyClientType	Jenis platform kunci.
RecaptchaProviderEnforcementState	Status penerapan perlindungan reCAPTCHA. - 'NONAKTIF': Tidak diterapkan. - 'AUDIT': Membuat penilaian tetapi tidak menerapkan hasilnya. - 'BERHENTI': Membuat penilaian dan menerapkan hasilnya.
SmsRegionConfig	Antarmuka permintaan untuk memperbarui Konfigurasi Region SMS. Mengonfigurasi wilayah tempat pengguna diizinkan untuk mengirim SMS verifikasi. Hal ini didasarkan pada kode panggilan dari nomor telepon tujuan.
UpdateAuthProviderRequest
UpdateMultiFactorInfoRequest	Jenis yang mewakili properti faktor kedua yang didaftarkan pengguna untuk `UpdateRequest`.
UserIdentifier	Mengidentifikasi pengguna untuk dicari.

getAuth(aplikasi)

Mendapatkan layanan Auth untuk aplikasi default atau aplikasi tertentu.

getAuth() dapat dipanggil tanpa argumen untuk mengakses layanan Auth aplikasi default atau sebagai getAuth(app) untuk mengakses layanan Auth yang terkait dengan aplikasi tertentu.

Tanda Tangan:

export declare function getAuth(app?: App): Auth;

Parameter

Parameter	Jenis	Deskripsi
aplikasi	Aplikasi

Hasil:

Autentikasi

Contoh 1

// Get the Auth service for the default app
const defaultAuth = getAuth();

Contoh 2

// Get the Auth service for a given app
const otherAuth = getAuth(otherApp);

AuthFactorType

Mengidentifikasi jenis faktor kedua.

Tanda Tangan:

export type AuthFactorType = 'phone';

AuthProviderConfig

Jenis konfigurasi penyedia Auth. BaseAuth.createProviderConfig().

Tanda Tangan:

export type AuthProviderConfig = SAMLAuthProviderConfig | OIDCAuthProviderConfig;

CreateMultiFactorInfoRequest

Jenis yang mewakili properti faktor kedua yang didaftarkan pengguna untuk CreateRequest.

Tanda Tangan:

export type CreateMultiFactorInfoRequest = CreatePhoneMultiFactorInfoRequest;

CreateTenantRequest

Antarmuka yang mewakili properti yang akan ditetapkan pada tenant baru.

Tanda Tangan:

export type CreateTenantRequest = UpdateTenantRequest;

{i>HashAlgorithmType<i}

Tanda Tangan:

export type HashAlgorithmType = 'SCRYPT' | 'STANDARD_SCRYPT' | 'HMAC_SHA512' | 'HMAC_SHA256' | 'HMAC_SHA1' | 'HMAC_MD5' | 'MD5' | 'PBKDF_SHA1' | 'BCRYPT' | 'PBKDF2_SHA256' | 'SHA512' | 'SHA256' | 'SHA1';

MultiFaktorConfigState

Mengidentifikasi status konfigurasi multi-faktor.

Tanda Tangan:

export type MultiFactorConfigState = 'ENABLED' | 'DISABLED';

PasswordPolicyEnforcementState

Status penerapan kebijakan sandi.

Tanda Tangan:

export type PasswordPolicyEnforcementState = 'ENFORCE' | 'OFF';

RecaptchaAction

Tindakan yang harus diambil untuk permintaan yang dilindungi reCAPTCHA. - 'BLOKIR': Permintaan yang dilindungi reCAPTCHA akan diblokir.

Tanda Tangan:

export type RecaptchaAction = 'BLOCK';

RecaptchaKeyClientType

Jenis platform kunci.

Tanda Tangan:

export type RecaptchaKeyClientType = 'WEB' | 'IOS' | 'ANDROID';

RecaptchaProviderEnforcementState

Status penerapan perlindungan reCAPTCHA. - 'NONAKTIF': Tidak diterapkan. - 'AUDIT': Membuat penilaian tetapi tidak menerapkan hasilnya. - 'BERHENTI': Membuat penilaian dan menerapkan hasilnya.

Tanda Tangan:

export type RecaptchaProviderEnforcementState = 'OFF' | 'AUDIT' | 'ENFORCE';

{i>SmsRegionConfig

Antarmuka permintaan untuk memperbarui Konfigurasi Region SMS. Mengonfigurasi wilayah tempat pengguna diizinkan untuk mengirim SMS verifikasi. Hal ini didasarkan pada kode panggilan dari nomor telepon tujuan.

Tanda Tangan:

export type SmsRegionConfig = AllowByDefaultWrap | AllowlistOnlyWrap;

UpdateAuthProviderRequest

Tanda Tangan:

export type UpdateAuthProviderRequest = SAMLUpdateAuthProviderRequest | OIDCUpdateAuthProviderRequest;

UpdateMultiFactorInfoRequest

Jenis yang mewakili properti faktor kedua yang didaftarkan pengguna untuk UpdateRequest.

Tanda Tangan:

export type UpdateMultiFactorInfoRequest = UpdatePhoneMultiFactorInfoRequest;

IDPengguna

Mengidentifikasi pengguna untuk dicari.

Tanda Tangan:

export type UserIdentifier = UidIdentifier | EmailIdentifier | PhoneIdentifier | ProviderIdentifier;