firebase-admin.auth package

Autenticazione Firebase.

Funzioni

Funzione Descrizione
getAuth(app) Ottiene il servizio di autenticazione per l'app predefinita o per una determinata app. getAuth() può essere chiamato senza argomenti per accedere al servizio di autenticazione dell'app predefinita o come getAuth(app) per accedere al servizio di autenticazione associato a un'app specifica.

Classi

Classe Descrizione
Aut Servizio di autenticazione associato all'app fornita. Un'istanza di autenticazione può avere più tenant.
Aut. base Interfaccia principale comune per le API Auth e TenantAwareAuth .
MultiFactorInfo Interfaccia che rappresenta le proprietà comuni di un secondo fattore registrato dall'utente.
Impostazioni MultiFactor Le impostazioni utente relative a più fattori.
TelefonoMultiFactorInfo Interfaccia che rappresenta un secondo fattore registrato dall'utente specifico del telefono.
ProgettoConfig Rappresenta una configurazione di progetto.
ProjectConfigManager Gestisce (ottiene e aggiorna) la configurazione del progetto corrente.
Inquilino Rappresenta una configurazione tenant. Il supporto multi-tenancy richiede la piattaforma Identity di Google Cloud (GCIP). Per ulteriori informazioni su GCIP, inclusi prezzi e funzionalità, consulta la documentazione GCIP . Prima di poter utilizzare la multi-tenancy su un progetto Google Cloud Identity Platform, è necessario consentire l'utilizzo dei tenant su tale progetto tramite l'interfaccia utente di Cloud Console. Una configurazione del tenant fornisce informazioni quali il nome visualizzato, l'identificatore del tenant e la configurazione dell'autenticazione della posta elettronica. Per la gestione della configurazione del provider OIDC/SAML, è necessario utilizzare le istanze TenantAwareAuth anziché un Tenant per recuperare l'elenco degli IdP configurati su un tenant. Quando si configurano questi provider, tenere presente che i tenant erediteranno i domini autorizzati e gli URI di reindirizzamento autenticati del progetto principale. Verranno ereditate anche tutte le altre impostazioni di un tenant. Questi dovranno essere gestiti dall'interfaccia utente di Cloud Console.
TenantAwareAuth Interfaccia Auth tenant-aware utilizzata per la gestione degli utenti, la configurazione dei provider SAML/OIDC, la generazione di collegamenti e-mail per la reimpostazione della password, la verifica dell'e-mail, ecc. per tenant specifici. Il supporto multi-tenancy richiede la piattaforma Identity di Google Cloud (GCIP). Per ulteriori informazioni su GCIP, inclusi prezzi e funzionalità, consulta la documentazione GCIP . Ogni tenant contiene i propri provider di identità, impostazioni e set di utenti. Utilizzando TenantAwareAuth è inoltre possibile gestire gli utenti per un tenant specifico e le corrispondenti configurazioni OIDC/SAML, verificare i token ID per gli utenti che hanno effettuato l'accesso a un tenant specifico e generare collegamenti alle azioni e-mail per gli utenti appartenenti al tenant. Le istanze TenantAwareAuth per un tenantId specifico possono essere istanziate chiamando TenantManager.authForTenant() .
TenantManager Definisce il gestore tenant utilizzato per facilitare la gestione delle operazioni relative ai tenant. Ciò comprende:
  • La possibilità di creare, aggiornare, elencare, ottenere ed eliminare tenant per il progetto sottostante.
  • Ottenere un'istanza TenantAwareAuth per eseguire operazioni correlate all'autenticazione (gestione degli utenti, gestione della configurazione del provider, verifica dei token, generazione di collegamenti e-mail, ecc.) nel contesto di un tenant specificato.
Informazioni utente Rappresenta le informazioni di un utente da un provider di identità di terze parti come Google o Facebook.
Metadatiutente Rappresenta i metadati di un utente.
Record utente Rappresenta un utente.

Interfacce

Interfaccia Descrizione
ImpostazioniCodiceAzione Questa è l'interfaccia che definisce l'URL di continuazione/stato richiesto con identificatori di bundle Android e iOS facoltativi.
ConsentiByDefault Definisce una politica che consente ogni regione per impostazione predefinita e aggiunge le regioni non consentite a un elenco di quelle non consentite.
ConsentiByDefaultWrap Configurazione della regione SMS reciprocamente esclusiva dell'interfaccia EnableByDefault
Solo lista consentita Definisce una politica che consente solo le regioni aggiungendole esplicitamente a una lista consentita.
ConsentiSoloWrap Configurazione della regione SMS che si esclude a vicenda dell'interfaccia OnlylistOnly
AuthProviderConfigFilter L'interfaccia del filtro utilizzata per elencare le configurazioni del provider. Viene utilizzato quando si specifica come elencare i provider di identità configurati tramite BaseAuth.listProviderConfigs() .
BaseAuthProviderConfig L'interfaccia di configurazione del provider di autenticazione di base.
BaseCreateMultiFactorInfoRequest Interfaccia che rappresenta le proprietà di base di un secondo fattore registrato dall'utente per un CreateRequest .
BaseUpdateMultiFactorInfoRequest Interfaccia che rappresenta le proprietà comuni di un secondo fattore registrato dall'utente per un UpdateRequest .
CreaPhoneMultiFactorInfoRequest Interfaccia che rappresenta un secondo fattore registrato dall'utente specifico del telefono per un CreateRequest .
Crea richiesta Interfaccia che rappresenta le proprietà da impostare su un nuovo record utente da creare.
CustomStrengthOptionsConfig Vincoli da applicare alla password policy
TokenIddecodificato Interfaccia che rappresenta un token ID Firebase decodificato, restituito dal metodo BaseAuth.verifyIdToken() . I token ID Firebase sono token Web JSON (JWT) conformi alle specifiche OpenID Connect. Consulta la [sezione Token ID delle specifiche OpenID Connect](http://openid.net/specs/openid-connect-core-1_0.html#IDToken) per ulteriori informazioni sulle proprietà specifiche di seguito.
Elimina utenti risultato Rappresenta il risultato di BaseAuth.deleteUsers() . API.
Identificatore di posta elettronica Utilizzato per cercare un account tramite e-mail. Vedi BaseAuth.getUsers() .
EmailPrivacyConfig La configurazione della privacy della posta elettronica di un progetto o tenant.
EmailSignInProviderConfig L'e-mail accede alla configurazione del provider.
Ottieni risultati utenti Rappresenta il risultato dell'API BaseAuth.getUsers() .
ListProviderConfigResults L'interfaccia di risposta per elencare le configurazioni del provider. Questo è disponibile solo quando si elencano tutte le configurazioni dei provider di identità tramite BaseAuth.listProviderConfigs() .
Elenco inquiliniRisultato Interfaccia che rappresenta l'oggetto restituito da un'operazione TenantManager.listTenants() . Contiene l'elenco dei tenant per il batch corrente e il token della pagina successiva, se disponibile.
RisultatoElencoUtenti Interfaccia che rappresenta l'oggetto restituito da un'operazione BaseAuth.listUsers() . Contiene l'elenco degli utenti per il batch corrente e il token della pagina successiva, se disponibile.
MultiFactorConfig Interfaccia che rappresenta una configurazione a più fattori. Può essere utilizzato per definire se l'autenticazione a più fattori è abilitata o disabilitata e l'elenco delle sfide del secondo fattore supportate.
MultiFactorCreateSettings Le impostazioni utente relative a più fattori per le operazioni di creazione.
MultiFactorProviderConfig Interfaccia che rappresenta una configurazione del provider di autenticazione a più fattori. Questa interfaccia viene utilizzata per i provider di autenticazione di secondo fattore diversi da SMS. Attualmente è supportato solo TOTP.
Impostazioni MultiFactorUpdate Le impostazioni utente relative a più fattori per le operazioni di aggiornamento.
OAuthResponseType L'interfaccia che rappresenta l'oggetto di risposta del provider OIDC per il flusso di autorizzazione OAuth. È richiesta una delle seguenti impostazioni:
  • Imposta code su true per il flusso di codice.
  • Imposta idToken su true per il flusso del token ID.
OIDCAuthProviderConfig L'interfaccia di configurazione del provider di autenticazione [OIDC](https://openid.net/specs/openid-connect-core-1_0-final.html). Un provider OIDC può essere creato tramite BaseAuth.createProviderConfig() .
OIDCUpdateAuthProviderRequest L'interfaccia di richiesta per l'aggiornamento di un provider di autenticazione OIDC. Viene utilizzato durante l'aggiornamento della configurazione di un provider OIDC tramite BaseAuth.updateProviderConfig() .
PasswordPolicyConfig Una configurazione dei criteri password per un progetto o un tenant
Identificatore del telefono Utilizzato per cercare un account tramite numero di telefono. Vedi BaseAuth.getUsers() .
ProviderIdentifier Utilizzato per cercare un account tramite provider federato. Vedi BaseAuth.getUsers() .
RecaptchaConfig L'interfaccia di richiesta per l'aggiornamento di una configurazione reCAPTCHA. Abilitando l'integrazione reCAPTCHA Enterprise, accetti i Termini di servizio di reCAPTCHA Enterprise .
RecaptchaKey La configurazione della chiave reCAPTCHA.
RecaptchaManagedRule La configurazione per una regola di azione reCAPTCHA.
SAMLAuthProviderConfig L'interfaccia di configurazione del provider di autenticazione [SAML](http://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html). Un provider SAML può essere creato tramite BaseAuth.createProviderConfig() .
SAMLUpdateAuthProviderRequest L'interfaccia di richiesta per l'aggiornamento di un provider di autenticazione SAML. Viene utilizzato durante l'aggiornamento della configurazione di un provider SAML tramite BaseAuth.updateProviderConfig() .
SessionCookieOptions Interfaccia che rappresenta le opzioni del cookie di sessione necessarie per il metodo BaseAuth.createSessionCookie() .
TotpMultiFactorProviderConfig Interfaccia che rappresenta le impostazioni di configurazione per l'autenticazione a secondo fattore TOTP.
UidIdentifier Utilizzato per cercare un account tramite uid. Vedi BaseAuth.getUsers() .
UpdatePhoneMultiFactorInfoRequest Interfaccia che rappresenta un secondo fattore registrato dall'utente specifico del telefono per un UpdateRequest .
UpdateProjectConfigRequest Interfaccia che rappresenta le proprietà da aggiornare sulla configurazione del progetto fornita.
Richiesta di aggiornamento Interfaccia che rappresenta le proprietà da aggiornare sull'utente fornito.
UpdateTenantRequest Interfaccia che rappresenta le proprietà da aggiornare sul tenant fornito.
Opzioni di importazione utente Interfaccia che rappresenta le opzioni di importazione degli utenti necessarie per il metodo BaseAuth.importUsers() . Viene utilizzato per fornire informazioni sull'algoritmo di hashing della password.
Record di importazione utente Interfaccia che rappresenta un utente da importare in Firebase Auth tramite il metodo BaseAuth.importUsers() .
Risultato importazione utente Interfaccia che rappresenta la risposta del metodo BaseAuth.importUsers() per l'importazione batch di utenti in Firebase Auth.
Richiesta metadatiutente Metadati utente da includere durante l'importazione di un utente.
UserProvider Rappresenta un provider di identità utente che può essere associato a un utente Firebase.
UserProviderRequest Dati del provider utente da includere durante l'importazione di un utente.

Digitare Alias

Digita Alias Descrizione
AuthFactorType Identifica un secondo tipo di fattore.
AuthProviderConfig Il tipo di configurazione del provider di autenticazione. BaseAuth.createProviderConfig() .
CreaMultiFactorInfoRequest Tipo che rappresenta le proprietà di un secondo fattore registrato dall'utente per CreateRequest .
Crea richiesta tenant Interfaccia che rappresenta le proprietà da impostare su un nuovo tenant.
HashAlgorithmType
MultiFactorConfigState Identifica uno stato di configurazione a più fattori.
PasswordPolicyEnforcementState Lo stato di applicazione di una policy password.
RecaptchaAzione Le azioni da intraprendere per le richieste protette da reCAPTCHA. - 'BLOCCO': la richiesta protetta da reCAPTCHA verrà bloccata.
RecaptchaKeyClientType Il tipo di piattaforma della chiave.
RecaptchaProviderEnforcementState Stato di applicazione della protezione reCAPTCHA. - 'OFF': non applicato. - "AUDIT": crea una valutazione ma non applica il risultato. - 'ENFORCE': crea una valutazione e applica il risultato.
SmsRegionConfig L'interfaccia di richiesta per l'aggiornamento di una configurazione della regione SMS. Configura le regioni in cui gli utenti possono inviare SMS di verifica. Questo si basa sul codice chiamante del numero di telefono di destinazione.
UpdateAuthProviderRequest
UpdateMultiFactorInfoRequest Tipo che rappresenta le proprietà di un secondo fattore registrato dall'utente per un UpdateRequest .
Identificatore utente Identifica un utente da cercare.

getAuth()

Ottiene il servizio di autenticazione per l'app predefinita o per una determinata app.

getAuth() può essere chiamato senza argomenti per accedere al servizio di autenticazione dell'app predefinita o come getAuth(app) per accedere al servizio di autenticazione associato a un'app specifica.

Firma:

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

Parametri

Parametro Tipo Descrizione
app App

Ritorna:

Aut

Esempio 1

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

Esempio 2

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

AuthFactorType

Identifica un secondo tipo di fattore.

Firma:

export type AuthFactorType = 'phone';

AuthProviderConfig

Il tipo di configurazione del provider di autenticazione. BaseAuth.createProviderConfig() .

Firma:

export type AuthProviderConfig = SAMLAuthProviderConfig | OIDCAuthProviderConfig;

CreaMultiFactorInfoRequest

Tipo che rappresenta le proprietà di un secondo fattore registrato dall'utente per una CreateRequest .

Firma:

export type CreateMultiFactorInfoRequest = CreatePhoneMultiFactorInfoRequest;

Crea richiesta tenant

Interfaccia che rappresenta le proprietà da impostare su un nuovo tenant.

Firma:

export type CreateTenantRequest = UpdateTenantRequest;

HashAlgorithmType

Firma:

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

MultiFactorConfigState

Identifica uno stato di configurazione a più fattori.

Firma:

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

PasswordPolicyEnforcementState

Lo stato di applicazione di una policy password.

Firma:

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

RecaptchaAzione

Le azioni da intraprendere per le richieste protette da reCAPTCHA. - 'BLOCCO': la richiesta protetta da reCAPTCHA verrà bloccata.

Firma:

export type RecaptchaAction = 'BLOCK';

RecaptchaKeyClientType

Il tipo di piattaforma della chiave.

Firma:

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

RecaptchaProviderEnforcementState

Stato di applicazione della protezione reCAPTCHA. - 'OFF': non applicato. - "AUDIT": crea una valutazione ma non applica il risultato. - 'ENFORCE': crea una valutazione e applica il risultato.

Firma:

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

SmsRegionConfig

L'interfaccia di richiesta per l'aggiornamento di una configurazione della regione SMS. Configura le regioni in cui gli utenti possono inviare SMS di verifica. Questo si basa sul codice chiamante del numero di telefono di destinazione.

Firma:

export type SmsRegionConfig = AllowByDefaultWrap | AllowlistOnlyWrap;

UpdateAuthProviderRequest

Firma:

export type UpdateAuthProviderRequest = SAMLUpdateAuthProviderRequest | OIDCUpdateAuthProviderRequest;

UpdateMultiFactorInfoRequest

Tipo che rappresenta le proprietà di un secondo fattore registrato dall'utente per una UpdateRequest .

Firma:

export type UpdateMultiFactorInfoRequest = UpdatePhoneMultiFactorInfoRequest;

Identificatore utente

Identifica un utente da cercare.

Firma:

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