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:

  1. Projekt mit einer benutzerdefinierten Domain verbinden Sie müssen diese Schritte mit der Firebase Console ausführen. Die Verwendung der Google Cloud CLI oder der Google Cloud Console wird nicht unterstützt.

  2. Rufen Sie in der Google Cloud Console die Seite Identity Providers (Identitätsanbieter) auf und wählen Sie Ihren SAML-Anbieter aus. Zur Seite „Identitätsanbieter“

  3. Fügen Sie die benutzerdefinierte Domain der Liste Autorisierte Domains hinzu.

  4. 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 in https://auth.mycustomdomain.com/__/auth/handler.

  5. 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:

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 und iOS

Verwenden Sie den folgenden Code, um den Authentifizierungs-Handler anzupassen:

Java 

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

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