Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 :
Configuration simplifiée
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 l'URL https://[PROJECT-ID].firebaseapp.com s'affiche brièvement lorsque les utilisateurs se connectent.
Personnaliser le gestionnaire d'authentification
Pour remplacer le gestionnaire par défaut et fournir le vôtre :
Ajoutez le domaine personnalisé à la liste des Domaines autorisés.
Mettez à jour l'URL de rappel auprès de votre fournisseur d'identité pour utiliser 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.
Cliquez sur Enregistrer.
Mettre à jour la configuration de votre SDK client
Web
Normalement, vous pouvez copier le code d'initialisation du SDK client depuis la consoleGoogle Cloud . Si vous personnalisez le gestionnaire d'authentification, vous devez mettre à jour le champ authDomain en fonction de votre domaine personnalisé:
Version Web 9
import{initializeApp}from"firebase/app";constfirebaseConfig={apiKey:"...",// By default, authDomain is '[YOUR_APP].firebaseapp.com'.// You may replace it with a custom domain.authDomain:'[YOUR_CUSTOM_DOMAIN]'};constfirebaseApp=initializeApp(firebaseConfig);
firebase.initializeApp({apiKey:'...',// By default, authDomain is '[YOUR_APP].firebaseapp.com'.// You may replace it with a custom domain.authDomain:'[YOUR_CUSTOM_DOMAIN]'});
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThis guide explains how to customize the Identity Platform authentication handler to display your own domain during sign-in instead of the default \u003ccode\u003e[PROJECT-ID].firebaseapp.com\u003c/code\u003e domain.\u003c/p\u003e\n"],["\u003cp\u003eUsing the default domain provides benefits like easier setup and compatibility with providers that only allow one callback URL per app, but it briefly shows the \u003ccode\u003efirebaseapp.com\u003c/code\u003e URL to users.\u003c/p\u003e\n"],["\u003cp\u003eTo customize the handler, you must connect your project to a custom domain, add the custom domain to the list of Authorized Domains, and update the Callback URL with your identity provider to use the new custom domain.\u003c/p\u003e\n"],["\u003cp\u003eAfter customizing the handler, update the \u003ccode\u003eauthDomain\u003c/code\u003e field in your client SDK configuration (Web, Android, iOS) to your custom domain to ensure proper functionality.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring your custom authentication handler is only available through the Firebase Console, and not through Google Cloud CLI or the Google Cloud console.\u003c/p\u003e\n"]]],[],null,["# Showing a custom domain during sign in\n======================================\n\nThis document shows you how to customize the Identity Platform authentication\nhandler so users see your domain when signing in.\n\nUnderstanding the default authentication handler\n------------------------------------------------\n\nWhen you enable Identity Platform for your project, a unique subdomain\npowered by Firebase Hosting is created automatically.\nThe domain takes the form of `https://[PROJECT-ID].firebaseapp.com`.\nBy default, Identity Platform uses this domain to handle all OAuth, OIDC,\nand SAML sign-in redirects.\n\nUsing the default domain has several benefits:\n\n- Easier setup\n\n- Use multiple domains with the same federated providers\n\n- Share a single callback URL across different services and domains\n\n- Works with providers that only support one callback URL per app\n\nThe downside of the default handler is users will briefly see the\n`https://[PROJECT-ID].firebaseapp.com` URL when signing in.\n\nCustomizing the authentication handler\n--------------------------------------\n\nTo override the default handler and provide your own:\n\n1. [Connect your project to a custom domain](https://firebase.google.com/docs/hosting/custom-domain).\n You'll need to complete these steps using the Firebase Console; using\n the Google Cloud CLI or the Google Cloud console is not\n supported.\n\n2. Go to the **Identity Providers** page in the Google Cloud console, and\n select your SAML provider.\n [Go to the Identity Providers page](https://console.cloud.google.com/customer-identity/providers) \n\n3. Add the custom domain to the list of **Authorized Domains**.\n\n4. Update the **Callback URL** with your identity provider to use your custom\n domain instead of the default domain. For example, change\n `https://myproject.firebaseapp.com/__/auth/handler` to\n `https://auth.mycustomdomain.com/__/auth/handler`.\n\n5. Click **Save**.\n\nUpdating your client SDK configuration\n--------------------------------------\n\n### Web\n\nNormally, you can copy the initialization code for the client SDK from the\nGoogle Cloud console. If you customize the authentication handler, you'll\nneed to update the `authDomain` field to your custom domain: \n\n### Web version 9\n\n```javascript\nimport { initializeApp } from \"firebase/app\";\n\nconst firebaseConfig = {\n apiKey: \"...\",\n // By default, authDomain is '[YOUR_APP].firebaseapp.com'.\n // You may replace it with a custom domain.\n authDomain: '[YOUR_CUSTOM_DOMAIN]'\n};\nconst firebaseApp = initializeApp(firebaseConfig);https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/snippets/auth-next/index/auth_init_custom_domain.js#L8-L16\n```\n\n### Web version 8\n\n```javascript\nfirebase.initializeApp({\n apiKey: '...',\n // By default, authDomain is '[YOUR_APP].firebaseapp.com'.\n // You may replace it with a custom domain.\n authDomain: '[YOUR_CUSTOM_DOMAIN]'\n});https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/auth/index.js#L107-L112\n```\n\n### Android and iOS\n\nTo customize the authentication handler, use the following code: \n\n### Java\n\n FirebaseAuth.getInstance().setCustomAuthDomain(\"[YOUR_CUSTOM_DOMAIN]\");\n\n### Kotlin+KTX\n\n Firebase.auth.setCustomAuthDomain(\"[YOUR_CUSTOM_DOMAIN]\")\n\n### Swift\n\n let auth = Auth.auth()\n auth.customAuthDomain = \"[YOUR_CUSTOM_DOMAIN]\"\n\n### Objective-C\n\n FIRAuth *auth = [FIRAuth auth];\n auth.customAuthDomain(\"[YOUR_CUSTOM_DOMAIN]\");"]]
