Preguntas frecuentes y solución de problemas de autenticación

¿Cómo puedo evitar el abuso de SMS cuando uso la autenticación por teléfono?

Para proteger tu proyecto contra el incremento desmedido de tráfico de SMS y el abuso de la API, sigue estos pasos:

Considera establecer una política de región de SMS

1. Consulta el uso de SMS regional

   Busca regiones con una cantidad muy alta de SMS enviados y una cantidad muy baja (o cero) de SMS verificados. La proporción de verificados y enviados es tu tasa de éxito. Por lo general, las tasas de éxito positivas son de entre el 70% y el 85%, ya que los SMS no son un protocolo de entrega garantizado, y algunas regiones pueden experimentar abuso. Las tasas de éxito inferiores al 50% implican muchos SMS enviados, pero pocos accesos exitosos, lo que es un indicador común de las personas que actúan de mala fe y del incremento desmedido de tráfico de SMS.

2. Usa la Política de región de SMS para rechazar regiones de SMS con tasas de éxito bajas o permitir solo ciertas regiones si tu app está destinada únicamente a la distribución en determinados mercados.

Limita tus dominios de autenticación autorizados

Usa el panel de configuración de Authentication para administrar los dominios autorizados. El dominio localhost se agrega de forma predeterminada a los dominios de autenticación aprobados para simplificar el desarrollo. Procura quitar localhost de los dominios autorizados de tu proyecto de producción para evitar que personas malintencionadas ejecuten código en su localhost para acceder a tu proyecto de producción.

Habilita y aplica App Check

Habilita App Check para ayudar a proteger tu proyecto de abusos de API. Para ello, certifica que las solicitudes solo provienen de aplicaciones asociadas a tu proyecto.

Para usar App Check con Firebase Authentication, debes actualizar a Firebase Authentication with Identity Platform.

Recuerda que debes aplicar App Check para Authentication en la consola de Firebase (considera supervisar el tráfico antes de aplicar la medida). Además, vuelve a verificar la lista de sitios aprobados de reCAPTCHA Enterprise para validar que solo contenga los sitios de producción y que la lista de aplicaciones registradas en el proyecto en App Check sea precisa.

Ten en cuenta que App Check ayuda a protegerte de ataques automatizados, ya que afirma que la llamada proviene de una de tus aplicaciones registradas. No impide que los usuarios usen la app de formas no deseadas (por ejemplo, iniciar los flujos de acceso y nunca finalizarlos para generar SMS enviados).

¿Los números de teléfono transferidos a un operador nuevo son compatibles con la autenticación telefónica?

En este momento, los números transferidos entre operadores provocarán que todos los SMS no se puedan entregar a esos usuarios finales. No hay una solución alternativa y Firebase está trabajando en este problema.

En mi app para Android, ¿por qué recibo el siguiente error:
Google sign in failed?

Sigue los pasos para solucionar problemas que aparecen en estas Preguntas frecuentes si recibes el siguiente error:

GoogleFragment: Google sign in failed
    com.google.android.gms.common.api.ApiException: 13: Unable to get token.
        at
com.google.android.gms.internal.auth-api.zbay.getSignInCredentialFromIntent(com.google.android.gms:play-services-auth@@20.3.0:6)

1. Asegúrate de que el Acceso con Google esté habilitado de forma correcta como proveedor de autenticación:

   1. En Firebase console, abre la sección Authentication.

   2. En la pestaña Método de acceso, inhabilita y vuelve a habilitar el método de acceso de Google (incluso si ya está habilitado):

      1. Abre el método de acceso de Google, inhabilítalo y haz clic en Guardar.

      2. Vuelve a abrir el método de acceso de Google, habilítalo y haz clic en Guardar.

2. Asegúrate de que tu app use su archivo de configuración de Firebase actualizado (google-services.json).
   Obtén el archivo de configuración de tu app.

3. Revisa si aún recibes el error. Si es así, continúa con el siguiente paso para solucionar el problema.

4. Asegúrate de que estén presentes los clientes de OAuth 2.0 subyacentes necesarios.

   1. En la página Credenciales de la consola de Google Cloud, revisa la sección IDs de cliente de OAuth 2.0.

   2. Si los clientes de OAuth 2.0 no están presentes (y ya completaste todos los pasos anteriores de solución de problemas), comunícate con el equipo de asistencia.

En mi app para la plataforma de Apple, ¿por qué recibo el siguiente error:
You must specify <clientID> in <GIDConfiguration>?

Sigue los pasos para solucionar problemas que aparecen en estas Preguntas frecuentes si recibes el siguiente error:

You must specify |clientID| in |GIDConfiguration|

1. Asegúrate de que el Acceso con Google esté habilitado de forma correcta como proveedor de autenticación:

   1. En Firebase console, abre la sección Authentication.

   2. En la pestaña Método de acceso, inhabilita y vuelve a habilitar el método de acceso de Google (incluso si ya está habilitado):

      1. Abre el método de acceso de Google, inhabilítalo y haz clic en Guardar.

      2. Vuelve a abrir el método de acceso de Google, habilítalo y haz clic en Guardar.

2. Asegúrate de que tu app use su archivo de configuración de Firebase actualizado (GoogleService-Info.plist).
   Obtén el archivo de configuración de tu app.

3. Revisa si aún recibes el error. Si es así, continúa con el siguiente paso para solucionar el problema.

4. Asegúrate de que estén presentes los clientes de OAuth 2.0 subyacentes necesarios.

   1. En la página Credenciales de la consola de Google Cloud, revisa la sección IDs de cliente de OAuth 2.0.

   2. Si los clientes de OAuth 2.0 no están presentes (y ya completaste todos los pasos anteriores de solución de problemas), comunícate con el equipo de asistencia.

En mi app web, ¿por qué recibo el siguiente error:
AuthErrorCode.INVALID_OAUTH_CLIENT_ID?

Sigue los pasos para solucionar problemas que aparecen en estas Preguntas frecuentes si recibes el siguiente error:

AuthErrorCode.INVALID_OAUTH_CLIENT_ID

1. Asegúrate de que el Acceso con Google esté habilitado de forma correcta como proveedor de autenticación:

   1. En Firebase console, abre la sección Authentication.

   2. En la pestaña Método de acceso, inhabilita y vuelve a habilitar el método de acceso de Google (incluso si ya está habilitado):

      1. Abre el método de acceso de Google, inhabilítalo y haz clic en Guardar.

      2. Vuelve a abrir el método de acceso de Google, habilítalo y haz clic en Guardar.

2. Además, en la configuración del proveedor de acceso de Google de la sección Authentication, asegúrate de que el ID y el secreto de cliente de OAuth coincidan con el cliente web que se muestra en la página Credenciales de la consola de Google Cloud (consulta la sección IDs de cliente de OAuth 2.0).

En mi app web, ¿por qué el acceso con redireccionamientos falla con el siguiente error:
This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation?

Sigue los pasos para solucionar problemas que aparecen en estas Preguntas frecuentes si recibes el siguiente error:

This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation.

Es probable que este error se deba a que tu dominio de redireccionamiento no aparece como un dominio autorizado para Firebase Authentication, o a que la clave de API que usas con el servicio de Firebase Authentication no es válida.

Primero, asegúrate de que YOUR_REDIRECT_DOMAIN esté en la lista de dominios autorizados de tu proyecto de Firebase. Si tu dominio de redireccionamiento ya aparece en la lista, sigue los pasos para solucionar problemas relacionados con una clave de API no válida.

De forma predeterminada, el SDK de Firebase Authentication JS se basa en la clave de API de tu proyecto de Firebase que está etiquetada como Browser key y la usa para verificar que una URL de redireccionamiento de acceso sea válida según la lista de dominios autorizados. Authentication obtiene esta clave de API según la forma en que accedas al SDK de Authentication:

• Si usas los auxiliares de Auth proporcionados por Hosting para que los usuarios accedan con el SDK de Authentication JS, Firebase obtiene automáticamente tu clave de API con el resto de la configuración de Firebase cada vez que realizas una implementación en Firebase Hosting. Asegúrate de que el authDomain de tu app web firebaseConfig esté configurado correctamente para usar uno de los dominios de ese sitio de Hosting. Para verificarlo, puedes ir a https://authDomain__/firebase/init.json y comprobar que projectId coincida con el de firebaseConfig.

• Si autoalojas el código de acceso, puedes usar un archivo __/firebase/init.json para proporcionar la configuración de Firebase al auxiliar de redireccionamiento del SDK de Authentication JS autoalojado. La clave de API y el projectId que se enumeran en este archivo de configuración deben coincidir con tu firebaseConfig de la app web.

Asegúrate de que no se haya borrado esta clave de API: Ve al panel APIs y servicios > Credenciales de la consola de Google Cloud, en el que se enumeran todas las claves de API de tu proyecto.

• Si no se borró Browser key, verifica lo siguiente:

  • Asegúrate de que la API de Firebase Authentication esté en la lista de APIs permitidas para que la clave pueda acceder (obtén más información sobre las restricciones de API para claves de API).

  • Si autoalojas el código de acceso, asegúrate de que la clave de API que aparece en el archivo __/firebase/init.json coincida con la clave de API de la consola de Google Cloud. Corrige la clave en el archivo, si es necesario, y vuelve a implementar la app.

  • Si se borró el Browser key, puedes hacer que Firebase genere una clave de API nueva para ti: En la consola de Browser key, ve a settings > Configuración del proyecto y, luego, en la sección Tus apps, haz clic en tu app web. Esta acción crea automáticamente una clave de API que puedes ver en la sección Configuración y configuración del SDK de tu app web.Firebase

  Ten en cuenta que, en la consola de Google Cloud, esta nueva clave de API no se llamará Browser key, sino que tendrá el mismo nombre que el sobrenombre de tu app web de Firebase. Si decides agregar restricciones de API a esta clave de API nueva, asegúrate de que la API de Firebase Authentication esté en la lista de APIs permitidas.

  Una vez que crees tu nueva clave de API, completa los pasos correspondientes a continuación:

  • Si usas URLs de Hosting reservadas, vuelve a implementar tu app en Firebase para que pueda obtener automáticamente la clave de API nueva con el resto de la configuración de Firebase.

  • Si autoalojas el código de acceso, copia la nueva clave de API y agrégala a tu archivo __/firebase/init.json. Luego, vuelve a implementar la app.

¿Cómo creo un cliente web de OAuth de forma manual?

1. Abre la página Credenciales de la consola de Google Cloud.

2. En la parte superior de la página, selecciona Crear credenciales > ID de cliente de OAuth.

3. Si se te solicita que configures la pantalla de consentimiento, sigue las instrucciones en pantalla y, luego, continúa con los siguientes pasos de estas Preguntas frecuentes.

4. Crea el cliente web de OAuth:

   1. En Tipo de aplicación, selecciona Aplicación web.

   2. En Orígenes autorizados de JavaScript, agrega lo siguiente:

      • http://localhost
      • http://localhost:5000
      • https://PROJECT_ID.firebaseapp.com
      • https://PROJECT_ID.web.app

   3. Para los URIs de redireccionamiento autorizados, agrega lo siguiente:

      • https://PROJECT_ID.firebaseapp.com/__/auth/handler
      • https://PROJECT_ID.web.app/__/auth/handler

   4. Guarda el cliente de OAuth.

5. Copia el nuevo ID de cliente y el secreto de cliente de OAuth en el portapapeles.

6. En Firebase console, abre la sección Authentication.

7. En la pestaña Método de acceso, abre el proveedor de Acceso con Google y pega el ID de cliente y el secreto del servidor web que acabas de crear y copiar de la consola de Google Cloud. Haga clic en Guardar.

¿Cómo se determina %APP_NAME% para la plantilla de correo electrónico del correo electrónico de confirmación que se puede enviar a un usuario cuando este se registra con una dirección de correo electrónico y una contraseña?

Antes de diciembre de 2022, %APP_NAME% de la plantilla de correo electrónico se completaba con el nombre de la marca de OAuth que se aprovisionaba automáticamente cada vez que se registraba una app para Android en el proyecto de Firebase. Ahora, como la marca de OAuth se aprovisiona solo cuando el Acceso con Google está habilitado, lo siguiente describe cómo se determina %APP_NAME%:

• Si el nombre de la marca de OAuth está disponible, %APP_NAME% en la plantilla de correo electrónico será el nombre de la marca de OAuth (igual que el comportamiento anterior a diciembre de 2022).

• Si el nombre de marca de OAuth no está disponible, así es como se determina %APP_NAME% en la plantilla de correo electrónico:

  • En el caso de las apps web, %APP_NAME% será el nombre del sitio predeterminado de Firebase Hosting (el valor anterior a .firebaseapp.com y .web.app, que suele ser el ID del proyecto de Firebase).

  • En apps para dispositivos móviles:

    • Si el nombre del paquete de Android o el ID del paquete de iOS están presentes en la solicitud, %APP_NAME% será el nombre de la app que se usará en Play Store o App Store (respectivamente).

    • De lo contrario, %APP_NAME% será el nombre del sitio predeterminado de Firebase Hosting (el valor anterior a .firebaseapp.com y .web.app, que suele ser el ID del proyecto de Firebase).

  Ten en cuenta que, si falla la búsqueda del nombre del sitio predeterminado de Firebase Hosting, el resguardo final es usar el ID del proyecto de Firebase como %APP_NAME%.