Visualizzazione di un dominio personalizzato durante l'accesso

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

Informazioni sul gestore autenticazione predefinito

Quando attivi Identity Platform per il tuo progetto, viene creato automaticamente un sottodominio unico basato su Firebase Hosting. Il dominio ha il formato 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:

  • 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

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

Personalizza il gestore autenticazione

Per sostituire il gestore predefinito con il tuo gestore personalizzato:

  1. Dalla console Firebase, collega il progetto a un dominio personalizzato.

  2. Nella console Google Cloud , vai alla pagina Identity Platform > Provider di identità.
    Vai a Provider di identità

  3. Seleziona il tuo provider di identità.

  4. Nel riquadro laterale Impostazioni progetto, fai clic su Aggiungi dominio e aggiungi il tuo dominio personalizzato.

  5. Fai clic su Salva.

  6. Nella configurazione dell'app, aggiorna l'URL di callback con il tuo dominio personalizzato anziché con quello predefinito. Ad esempio, modifica https://myproject.firebaseapp.com/__/auth/handler in https://auth.mycustomdomain.com/__/auth/handler.

Aggiorna la configurazione dell'SDK client

Web

Puoi copiare il codice di inizializzazione per l'SDK client dalla consoleGoogle Cloud . Se personalizzi il gestore di autenticazione, dovrai aggiornare il campo authDomain con il 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);
auth_init_custom_domain.js

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]'
});
index.js

Android e iOS

Per personalizzare il gestore di autenticazione, utilizza il seguente codice:

Java 

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

Kotlin+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]");