Mostrar un dominio personalizado durante el acceso

En este documento, se muestra cómo personalizar el controlador de autenticación de Identity Platform para que los usuarios vean tu dominio cuando accedan.

Comprende el controlador de autenticación predeterminado

Cuando habilitas Identity Platform para tu proyecto, se crea un subdominio único con la tecnología de Firebase Hosting. El dominio tiene la forma https://[PROJECT-ID].firebaseapp.com. Según la configuración predeterminada, Identity Platform usa este dominio para controlar todos los redireccionamientos de OAuth, OIDC y SAML.

Usar el dominio predeterminado tiene varios beneficios:

  • Configuración más fácil

  • Usar varios dominios con los mismos proveedores federados

  • Compartir una única URL de devolución de llamada entre diferentes servicios y dominios

  • Funciona con proveedores que solo admiten una URL de devolución de llamada por app.

La desventaja del controlador predeterminado es que los usuarios vean brevemente la URL https://[PROJECT-ID].firebaseapp.com cuando accedan.

Personaliza el controlador de autenticación

Para anular el controlador predeterminado y proporcionar uno propio:

  1. Conecta tu proyecto a un dominio personalizado. Deberás completar estos pasos con Firebase console. No se admite el uso de la herramienta de línea de comandos de gcloud o Cloud Console.

  2. Ve a la página Proveedores de identidad en Cloud Console y selecciona tu proveedor de SAML. Ir a la página Proveedores de identidad

  3. Agrega el dominio personalizado a la lista de dominios autorizados.

  4. Actualiza la URL de devolución de llamada con el proveedor de identidad para usar tu dominio personalizado en lugar del dominio predeterminado. Por ejemplo, cambia https://myproject.firebaseapp.com/__/auth/handler por https://auth.mycustomdomain.com/__/auth/handler.

  5. Haga clic en Save.

Actualiza la configuración del SDK de cliente

Normalmente, puedes copiar el código de inicialización para el SDK de cliente desde Cloud Console. Si personalizas el controlador de autenticación, deberás actualizar el campo authDomain a tu dominio personalizado:

firebase.initializeApp({
  apiKey: '...',
  // Replace the default one with your custom domain.
  // authDomain: '[YOUR_APP]/firebaseapp.com',
  authDomain: 'auth.[YOUR_DOMAIN]'
});