---
title: "Supabase Vault: cómo se filtran secretos a la clave pública"
description: "Supabase Vault cifra los secretos, pero un grant o una función envoltorio puede entregarlos a la clave pública. Qué mostró mi prueba local y cómo evitarlo."
url: "https://madsalt.tech/es/notes/supabase-vault-secrets/"
author: "Denys Zaichenko"
author_url: "https://madsalt.tech/es/about/"
language: "es"
published: 2026-11-13
---

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

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](https://madsalt.tech/es/tools/supabase-security-check/) 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](https://supabase.com/docs/guides/database/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.](https://madsalt.tech/charts/es/supabase-vault-secrets.svg)

*Mi reproducción en un stack local de Supabase, 23 de octubre de 2026.*

```sql
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](https://madsalt.tech/es/notes/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](https://madsalt.tech/es/blog/lovable-app-security-checklist/). 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](https://madsalt.tech/es/notes/supabase-function-search-path-mutable/).

Si prefiere que una persona revise la aplicación entera y no solo un ajuste, hago una [auditoría de alcance fijo](https://madsalt.tech/es/services/vibe-coded-app-audit/) 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](https://madsalt.tech/es/work/construction-document-platform/).

¿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](https://madsalt.tech/es/#contact)
