Saltar al contenido

Supabase Vault: cómo se filtran secretos a la clave pública

Supabase

Ver como MarkdownAbrir en ClaudeAbrir en ChatGPTAbrir en Perplexity

La pregunta también se copia. Si el chat se abre vacío, péguela.

En esta página
  1. ¿Qué protege Supabase Vault?
  2. ¿Quién puede leerlo por defecto?
  3. ¿Cómo se filtra un secreto de todos modos?
  4. ¿Cómo usar Vault de forma segura?
  5. Mi caso similar

En resumen

Supabase Vault guarda los secretos cifrados y los descifra a través de la vista vault.decrypted_secrets. Por defecto solo service_role y postgres pueden leerla; en mi stack local, anon y authenticated no tenían ningún acceso al esquema vault. Los secretos se filtran de dos maneras: un grant sobre Vault a un rol de cliente, o una función SECURITY DEFINER en un esquema expuesto que devuelve un valor descifrado. Mi función de prueba devolvió un secreto ficticio a la clave pública con 200; tras revocar EXECUTE, respondió 42501.

Mi verificador de seguridad de Supabase gratuito tiene una regla para cada vía de filtración: “Secretos de Vault legibles por roles de la API”, clasificada como crítica cuando anon puede leerlos, y “Funciones security definer invocables desde la API”. Esta nota muestra por qué la segunda importa para Vault.

¿Qué protege Supabase Vault?

La guía de Vault de Supabase lo describe como una tabla de secretos guardados con cifrado autenticado, legibles en forma descifrada a través de una vista. El secreto sigue cifrado en disco, en las copias de seguridad y en la replicación. La guía también da la condición de la que depende todo: cualquiera con acceso a la vista tiene acceso a los secretos descifrados, así que el acceso a ella debe limitarse siempre mediante privilegios SQL.

¿Quién puede leerlo por defecto?

En un stack local de Supabase (CLI 2.109.1, Postgres 17.6) guardé un valor ficticio con vault.create_secret y comprobé cada rol:

Rol Usage en el esquema vault Select en vault.decrypted_secrets
anon no no
authenticated no no
service_role sí sí

El esquema vault tampoco está por defecto entre los esquemas expuestos de la Data API. Así que, de fábrica, la clave pública no puede llegar a Vault.

¿Cómo se filtra un secreto de todos modos?

El motivo habitual es una app que necesita el secreto. Una función es la forma más corta de dárselo:

Qué puede sacar de Vault la clave pública. Supabase local, un secreto ficticio, publishable key. Valores por defecto: Publishable key → esquema vault → sin acceso; Una función definer devuelve el secreto: Publishable key → rpc/get_api_key → 200, secreto; EXECUTE revocado a los roles de cliente: Publishable key → rpc, sin EXECUTE → 401, 42501.
Mi reproducción en un stack local de Supabase, 23 de octubre de 2026.
create function public.get_api_key() returns text
language sql security definer set search_path = ''
as $$ select decrypted_secret from vault.decrypted_secrets where name = 'demo_api_key' $$;

SECURITY DEFINER la ejecuta con los derechos del propietario, así que puede leer Vault. En proyectos existentes, las funciones de public reciben EXECUTE para anon y authenticated por defecto, y public está expuesto, así que la Data API la sirve como /rest/v1/rpc/get_api_key:

Petición con la publishable key Resultado
POST /rest/v1/rpc/get_api_key 200, el valor ficticio descifrado
igual, tras revoke execute … from public, anon, authenticated 401, 42501 “permission denied for function get_api_key”

La segunda vía de filtración es un grant: alguien añade vault a los esquemas expuestos o concede a un rol de cliente usage y select para que una consulta funcione. Ese es el caso que el verificador clasifica como crítico.

¿Cómo usar Vault de forma segura?

  • Lea los secretos solo en el lado del servidor: en funciones de base de datos que nunca los devuelvan, en triggers y webhooks, o en Edge Functions que usen la secret key.
  • Si una función debe leer un secreto, manténgala en un esquema que no esté expuesto, o revoque EXECUTE a public, anon y authenticated y concédalo solo al rol que lo necesite.
  • No devuelva nunca un valor descifrado desde una función que el cliente pueda llamar. Devuelva en su lugar el resultado de usar el secreto, como la respuesta de una llamada a una API.
  • No añada nunca vault a los esquemas expuestos; expliqué qué abre esa lista en Supabase exposed schemas.

Las funciones también son una API, y el resto de esa regla, incluidos search_path y el manejo de NULL, está en mi lista de seguridad para apps Lovable. Cómo se puede volver el search_path de una función envoltorio en su contra está en Supabase “function search path mutable”: qué significa.

Si prefiere que una persona revise la aplicación entera y no solo un ajuste, hago una auditoría de alcance fijo con un veredicto de conservar, reparar o reescribir para cada parte.

Mi caso similar

Una empresa para la que construí pagaba miles de dólares al mes por un producto documental empresarial. Su propia plataforma cuesta ahora cientos al mes, con roles para documentos, formularios, informes y un portal de clientes, y solo las funciones que usa el equipo. Vea el caso de la plataforma documental de obra.

¿No sabe dónde se guardan sus secretos? Escríbame y los revisaremos.

¿Dónde se guardan sus secretos?

Cuénteme lo que tiene ahora y lo que necesita. Le responderé con la opción que yo elegiría.

Escríbame

© 2026 Denys Zaichenko. Artículo original: https://madsalt.tech/es/notes/supabase-vault-secrets/