Bei der Anmeldung eine benutzerdefinierte Domain anzeigen
In diesem Dokument wird beschrieben, wie Sie den Identity Platform-Authentifizierungs-Handler anpassen können, damit Nutzer Ihre Domain bei der Anmeldung sehen.
Informationen zum Standard-Authentifizierungs-Handler
Wenn Sie Identity Platform für Ihr Projekt aktivieren, wird automatisch eine eindeutige, von Firebase Hosting bereitgestellte Subdomain erstellt.
Die Domain hat die Form https://[PROJECT-ID].firebaseapp.com
.
Standardmäßig verwendet Identity Platform diese Domain für die Verarbeitung aller OAuth-, OIDC- und SAML-Anmeldeweiterleitungen.
Die Verwendung der Standarddomain hat mehrere Vorteile:
Einfache Einrichtung
Mehrere Domains mit denselben föderierten Anbietern verwenden
Eine einzelne Rückruf-URL für verschiedene Dienste und Domains freigeben
Funktioniert mit Anbietern, die nur eine Rückruf-URL pro App unterstützen
Der Nachteil des Standard-Handlers ist, dass Nutzer direkt nach der Anmeldung kurz die https://[PROJECT-ID].firebaseapp.com
-URL sehen.
Authentifizierungs-Handler anpassen
So überschreiben Sie den Standard-Handler und geben Ihren eigenen an:
Projekt mit einer benutzerdefinierten Domain verbinden Sie müssen diese Schritte in der Firebase Console ausführen. Die Verwendung der Google Cloud CLI oder der Google Cloud Console wird nicht unterstützt.
Rufen Sie in der Google Cloud Console die Seite Identitätsanbieter auf und wählen Sie Ihren SAML-Anbieter aus. Zur Seite „Identitätsanbieter“
Fügen Sie die benutzerdefinierte Domain der Liste Autorisierte Domains hinzu.
Aktualisieren Sie die Callback URL (Callback-URL) mit Ihrem Identitätsanbieter, um Ihre benutzerdefinierte Domain anstelle der Standarddomain zu verwenden. Ändern Sie beispielsweise
https://myproject.firebaseapp.com/__/auth/handler
inhttps://auth.mycustomdomain.com/__/auth/handler
.Klicken Sie auf Speichern.
Client SDK-Konfiguration aktualisieren
Web
Normalerweise können Sie den Initialisierungscode für das Client SDK aus der Google Cloud Console kopieren. Wenn Sie den Authentifizierungs-Handler anpassen, müssen Sie das Feld authDomain
auf Ihre benutzerdefinierte Domain aktualisieren:
Webversion 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);
Webversion 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 und iOS
Verwenden Sie den folgenden Code, um den Authentifizierungs-Handler anzupassen:
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]");