Afficher un domaine personnalisé lors de la connexion

Ce document explique comment personnaliser le gestionnaire d'authentification Identity Platform afin que les utilisateurs puissent voir votre domaine lorsqu'ils se connectent.

Comprendre le gestionnaire d'authentification par défaut

Lorsque vous activez Identity Platform pour votre projet, un sous-domaine unique fourni par Firebase Hosting est créé automatiquement. Le domaine est au format https://[PROJECT-ID].firebaseapp.com. Par défaut, Identity Platform utilise ce domaine pour gérer toutes les redirections d'authentification OAuth, OIDC et SAML.

L'utilisation du domaine par défaut présente plusieurs avantages :

• Utiliser plusieurs domaines avec les mêmes fournisseurs fédérés

• Partager une URL de rappel unique dans plusieurs services et domaines

• Fonctionne avec les fournisseurs qui n'acceptent qu'une seule URL de rappel par application

L'inconvénient du gestionnaire par défaut est que les utilisateurs verront brièvement l'URL https://[PROJECT-ID].firebaseapp.com lorsqu'ils se connecteront.

Personnaliser le gestionnaire d'authentification

Pour remplacer le gestionnaire par défaut par votre gestionnaire personnalisé, procédez comme suit :

1. Dans la console Firebase, associez votre projet à un domaine personnalisé.

2. Dans la Google Cloud console, accédez à la page Identity Platform > Fournisseurs d'identité.
   Accéder aux fournisseurs d'identité
   

3. Sélectionnez votre fournisseur d'identité.

4. Dans le volet latéral Project settings (Paramètres du projet), cliquez sur Add Domain (Ajouter un domaine), puis ajoutez votre domaine personnalisé.

5. Cliquez sur Enregistrer.

6. Dans la configuration de votre application, remplacez l'URL de rappel par votre domaine personnalisé au lieu du domaine par défaut. Par exemple, remplacez https://myproject.firebaseapp.com/__/auth/handler par https://auth.mycustomdomain.com/__/auth/handler.

Mettre à jour la configuration de votre SDK client

Web

Vous pouvez copier le code d'initialisation du SDK client depuis la Google Cloud console. Si vous personnalisez le gestionnaire d'authentification, vous devez mettre à jour le champ authDomain en fonction de votre domaine personnalisé :

Web version 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

Web version 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 et iOS

Pour personnaliser le gestionnaire d'authentification, utilisez le code suivant :

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