Troubleshooting: Error (auth/admin-restricted-operation) en Firebase

La Solución Paso a Paso

Paso 1: Habilitar el proveedor de autenticación en Firebase Console

Si el error ocurre al llamar a signInAnonymously() o createUserWithEmailAndPassword():

1. 1

   Paso 1

   Ingresa a Firebase Console.
2. 2

   Paso 2

   Selecciona tu proyecto y dirígete a Build > Authentication > Sign-in method (Métodos de inicio de sesión).
3. 3

   Paso 3

   Localiza el proveedor que estás invocando (por ejemplo, Anónimo o Correo electrónico/Contraseña).
4. 4

   Paso 4

   Haz clic en el proveedor, marca la casilla Habilitar (Enable) y pulsa Guardar.

Paso 2: Ejecutar operaciones administrativas en un entorno seguro (Admin SDK)

Si intentas modificar Custom Claims, deshabilitar usuarios o gestionar roles de seguridad desde el frontend, Firebase bloqueará la llamada:

// ❌ INCORRECTO: No intentes asignar claims desde el frontend
// ✔️ CORRECTO: Ejecutar en Node.js Backend o Cloud Functions con Firebase Admin:
import admin from 'firebase-admin';

if (!admin.apps.length) {
  admin.initializeApp({
    credential: admin.credential.applicationDefault()
  });
}

// Asignar rol de administrador a un usuario de forma segura
export async function setUserAsAdmin(uid) {
  await admin.auth().setCustomUserClaims(uid, { admin: true });
  console.log(`Rol de administrador asignado exitosamente a ${uid}`);
}

Paso 3: Revisar la configuración de Google Cloud Identity Platform

Si tu proyecto de Firebase está vinculado a Google Cloud Platform:

1. Accede a Google Cloud Console > Identity Platform > Settings.
2. En la pestaña Security, verifica que la creación de usuarios no esté bloqueada por directivas de acceso condicional o políticas de organización.

Paso 4: Validar la clave de API de Firebase

Asegúrate de que la clave de API web (apiKey) en tu configuración de inicialización de Firebase no tenga restricciones de API que bloqueen Identity Toolkit API:

// firebaseConfig.js
const firebaseConfig = {
  apiKey: "AIzaSy...",
  authDomain: "tu-proyecto.firebaseapp.com",
  projectId: "tu-proyecto"
};

❓ Preguntas Frecuentes (FAQ)

¿Por qué signInAnonymously arroja admin-restricted-operation?

Porque la autenticación anónima viene deshabilitada por defecto en todos los proyectos nuevos de Firebase para prevenir abusos de cuotas.

¿Puedo habilitar la creación de usuarios solo para administradores?

Sí. En la configuración avanzada de Authentication puedes desactivar el registro público de nuevos usuarios y gestionarlos únicamente mediante el Admin SDK.