LaunchLatam
ESPTEN

Filtraste tu clave service_role de Supabase: qué hacer en la próxima hora

Respuesta corta: si tu clave service_role (o una clave secreta sb_secret_) apareció en el frontend, en un repositorio o en un commit, dala por comprometida. Esa clave elude Row Level Security y da acceso completo a tu proyecto. Primero cortá la vía de filtración, después creá una clave secreta nueva en Settings → API Keys, actualizá el servidor y retirá la clave vieja. Si era una service_role heredada, también tenés que reemplazar la anon en el cliente: al desactivar las claves legacy se apagan las dos.

En una app hecha con Lovable, Bolt, Cursor o Replit, la clave que va al navegador tiene que ser solo la pública (anon o, en proyectos nuevos, sb_publishable_). La de servicio es otra: según la documentación de claves de Supabase, elude Row Level Security y no debe salir de un servidor que controles. Si llegó al frontend o a un repo, no alcanza con borrarla del archivo. Hay que rotarla.

Qué está en juego

Supabase está dejando de usar las claves anon y service_role para finales de 2026, a favor de las claves sb_publishable_ y sb_secret_ (fuente). Mientras tanto, muchas apps hechas con IA siguen usando las claves legacy. La service_role es un JWT: si está en el cliente, cualquiera puede copiarla y hablarle a tu API con privilegios de servidor. Las claves secretas nuevas no funcionan en el navegador (Supabase responde 401 según el encabezado User-Agent), pero igual no van en el código ni en el frontend.

Este control es el punto 5 de nuestra checklist de seguridad. Después de rotar, conviene revisar que las tablas tengan RLS, porque la clave pública va a seguir en el cliente: cómo saber si tu base está abierta y cerrarla.

Minutos 0 a 10: confirmá la filtración y cortá la vía

La guía oficial para rotar una clave filtrada pide corregir la causa raíz antes de rotar. Si no, la clave nueva se vuelve a filtrar igual.

  1. Buscá en el repo (y en el historial de git) textos como service_role, sb_secret_, SUPABASE_SERVICE_ROLE o variables públicas de frontend (VITE_, NEXT_PUBLIC_, PUBLIC_) que estén cargando la clave de servicio.
  2. Si el repositorio es o fue público, o la clave quedó en un commit aunque después la hayas sacado del archivo, dala por comprometida.
  3. Sacala del código del cliente, de los .env que se hayan subido y de cualquier secreto de Lovable o Bolt que se esté inyectando al navegador. Agregá .env a .gitignore si no estaba.

Si tenés indicios de que alguien ya está usando la clave, la misma guía dice que la retires de inmediato, aunque los componentes que todavía la usen dejen de funcionar hasta que la reemplaces.

Minutos 10 a 45: rotá según la documentación de Supabase

El procedimiento oficial es: crear una clave secreta nueva, reemplazar la comprometida en toda la aplicación y recién entonces retirar la vieja (fuente).

  1. Creá una clave secreta nueva en Settings → API Keys del Dashboard (empieza con sb_secret_). No la pegues en el chat del agente ni en un issue.
  2. Reemplazala en todos los lugares del servidor: secretos de Edge Functions, cron, workers y cualquier webhook de base de datos que la estuviera enviando. Confirmá que ningún componente sigue usando la clave vieja.
  3. Si la filtrada era una service_role legacy, cambiá también la anon del cliente por una clave sb_publishable_. Al retirar la clave comprometida se desactivan las dos claves legacy, la de servicio y la anónima (fuente).
  4. Retirá la clave comprometida. Si es una clave secreta nueva, eliminala (esa acción no se puede deshacer). Si es una anon o service_role legacy, desactivá las claves legacy en la misma pantalla. No las vuelvas a activar: reactivarlas restaura la clave comprometida.
  5. Si era una service_role legacy, revocá también el secreto JWT legacy. Esas claves son JWTs firmados con ese secreto, y cualquier sistema que todavía lo acepte puede seguir validando la clave filtrada. El detalle está en la guía de JWT signing keys, enlazada desde el procedimiento de rotación.

Minutos 45 a 60: revisá el daño y el RLS

Quien tuvo la clave de servicio pudo leer o cambiar datos, aunque después la hayas rotado. Revisá en el Dashboard si hubo actividad que no reconocés y confirmá que cada tabla del esquema public tenga RLS con políticas filtradas por auth.uid(). Si todavía no lo hiciste, seguí el paso a paso de RLS para apps de Lovable.

Volvé a mirar el repo para comprobar que la clave nueva no haya quedado en el código. Podés usar nuestro escaneo gratis en un repositorio público: corre en tu navegador y busca secretos expuestos, tablas sin RLS y páginas legales que falten. No reemplaza una revisión del historial de git ni una auditoría completa.

Después de la primera hora

Si tu app todavía usa anon y service_role, planificá la migración a las claves nuevas: Supabase las depreca para finales de 2026 (guía de migración). Un secreto por componente del backend permite rotar uno sin tocar los demás.

Si querés que te avisemos cuando salga la próxima guía, el boletín de LaunchLatam es gratis.

Preguntas frecuentes

¿Qué puede hacer alguien con mi clave service_role?

Eludir Row Level Security y acceder a los datos de tu proyecto con privilegios de servidor. No debe salir de un backend que controles: ni al frontend, ni a un repositorio, ni a un commit. Supabase documenta que la clave secreta es la llave maestra del proyecto.

Roté la clave en el Dashboard, pero el código viejo sigue en GitHub. ¿Alcanza?

No. La guía oficial pide corregir la causa de la filtración antes de rotar, reemplazar la clave en todos los componentes y recién entonces retirar la comprometida. Si era una service_role legacy, al desactivarla también se apaga la clave anon: hay que poner una sb_publishable_ en el cliente.

¿Es lo mismo service_role que sb_secret_?

sb_secret_ es la clave secreta nueva que reemplaza a service_role, que Supabase depreca para finales de 2026. Las dos eluden RLS. Las claves secretas nuevas responden 401 si se usan en un navegador, pero igual no van en el código ni en el frontend.

¿Querés saber cómo está tu app?

Escaneá tu repo gratis en segundos, sin crear cuenta.