Visualizzazione di un dominio personalizzato durante l'accesso

Questo documento mostra come personalizzare il gestore di autenticazione Identity Platform in modo che gli utenti vedano il tuo dominio quando accedono.

Informazioni sul gestore di autenticazione predefinito

Quando abiliti Identity Platform per il tuo progetto, viene creato automaticamente un sottodominio univoco di Firebase Hosting. Il dominio ha la forma di https://[PROJECT-ID].firebaseapp.com. Per impostazione predefinita, Identity Platform utilizza questo dominio per gestire tutti i reindirizzamenti di accesso OAuth, OIDC e SAML.

L'utilizzo del dominio predefinito offre diversi vantaggi:

  • Configurazione più semplice

  • Utilizzare più domini con gli stessi provider federati

  • Condividere un singolo URL di callback tra diversi servizi e domini

  • Funziona con i fornitori che supportano un solo URL di callback per app.

L'aspetto negativo del gestore predefinito è che gli utenti vedranno brevemente l'URL https://[PROJECT-ID].firebaseapp.com quando accedono.

Personalizzazione del gestore dell'autenticazione

Per eseguire l'override del gestore predefinito e fornire il tuo gestore:

  1. Collega il progetto a un dominio personalizzato. Dovrai completare questi passaggi utilizzando la console Firebase. L'utilizzo di Google Cloud CLI o della console Google Cloud non è supportato.

  2. Vai alla pagina Identity Providers (Provider di identità) nella console Google Cloud e seleziona il tuo provider SAML. Vai alla pagina Provider di identità

  3. Aggiungi il dominio personalizzato all'elenco Domini autorizzati.

  4. Aggiorna l'URL di callback con il tuo provider di identità per utilizzare il tuo dominio personalizzato anziché il dominio predefinito. Ad esempio, cambia https://myproject.firebaseapp.com/__/auth/handler in https://auth.mycustomdomain.com/__/auth/handler.

  5. Fai clic su Salva.

Aggiornamento della configurazione dell'SDK client in corso...

Web

Normalmente, puoi copiare il codice di inizializzazione per l'SDK del client dalla console Google Cloud. Se personalizzi il gestore dell'autenticazione, devi aggiornare il campo authDomain nel tuo dominio personalizzato:

Versione web 9

import { initializeApp } from "firebase/app";

const firebaseConfig = {
  apiKey: "...",
  // By default, authDomain is '[YOUR_APP].firebaseapp.com'.
  // You may replace it with a custom domain.
  authDomain: '[YOUR_CUSTOM_DOMAIN]'
};
const firebaseApp = initializeApp(firebaseConfig);

Versione web 8

firebase.initializeApp({
  apiKey: '...',
  // By default, authDomain is '[YOUR_APP].firebaseapp.com'.
  // You may replace it with a custom domain.
  authDomain: '[YOUR_CUSTOM_DOMAIN]'
});

Android e iOS

Per personalizzare il gestore dell'autenticazione, utilizza il seguente codice:

Java

FirebaseAuth.getInstance().setCustomAuthDomain("[YOUR_CUSTOM_DOMAIN]");

Kotlin e KTX

Firebase.auth.setCustomAuthDomain("[YOUR_CUSTOM_DOMAIN]")

Swift

let auth = Auth.auth()
auth.customAuthDomain = "[YOUR_CUSTOM_DOMAIN]"

Objective-C

FIRAuth *auth = [FIRAuth auth];
auth.customAuthDomain("[YOUR_CUSTOM_DOMAIN]");