Guía de seguridad / Secretos y claves de API

Escaneo de secretos: claves de API, archivos .env y bundles de cliente

Encuentra variables de entorno públicas de riesgo y claves de API expuestas. Sigue un flujo práctico de revisión y rotación de credenciales para apps web modernas.

Por Bryxe Shield · Actualizado · Política editorial

¿Ha acabado una clave de API privada en mi frontend?

Revisa la exposición de variables de entorno, los imports del lado del cliente y los assets del build para encontrar credenciales que hayan cruzado una frontera de confianza. Si se expuso una clave privada activa, revócala o rótala con el proveedor, actualiza la aplicación e investiga el uso de la credencial antigua.

Para quién es: Desarrolladores que manejan credenciales de Stripe, Supabase, proveedores de IA y cloud en aplicaciones web.

PASO 01

Decide si el valor es realmente secreto

No todas las cadenas con forma de token tienen el mismo privilegio. Identifica el proveedor, el tipo de credencial, el entorno y las operaciones permitidas. Es normal encontrar identificadores públicos de proyecto y publishable keys en un navegador; credenciales privilegiadas, no. Usa el hallazgo del escáner para investigar el papel del valor en lugar de copiar la credencial en bruto en tickets o en el chat.

Prueba esto: Para cada hallazgo, anota el proveedor, el alcance y el lugar de exposición sin reproducir la credencial activa.

PASO 02

Inspecciona lo que recibe realmente el navegador

Un archivo fuente puede parecer solo de servidor mientras un import o un ajuste del build hace que configuración sensible llegue a un bundle de cliente. Revisa las variables de entorno públicas y los assets generados. Comprueba los source maps desplegados y la salida de errores cuando corresponda. La pregunta relevante es si un visitante no confiable puede obtener un valor privilegiado, no si el repositorio en sí es privado.

Prueba esto: Busca en los artefactos de la release e inspecciona las peticiones del cliente usando marcadores de posición seguros o huellas de las credenciales.

PASO 03

Primero contén, después evita que se repita

Quitar un secreto del último commit no invalida las copias que ya se filtraron. Rota a través del proveedor, despliega el reemplazo de forma segura y revisa los registros de uso relevantes. Después corrige la vía de exposición y añade una comprobación al flujo de desarrollo. Si repositorios históricos o artefactos antiguos pueden contener el valor, examínalos por separado.

Prueba esto: Verifica que la credencial antigua ya no autoriza peticiones y que la aplicación funciona con la nueva.

Tu checklist de revisión

  • Identifica el proveedor, el privilegio y el entorno de la credencial.
  • Revisa las variables de entorno públicas y los imports del cliente.
  • Inspecciona los artefactos de la release en busca de valores privilegiados.
  • Revoca o rota las credenciales cuya exposición se haya confirmado.
  • Revisa los registros de uso y los sistemas afectados.
  • Añade una comprobación de regresión para la vía de exposición original.

Qué puede revisar Bryxe

Bryxe revisa el código fuente aportado en busca de patrones de secretos reconocidos y ofrece una herramienta de exposición del entorno. Usa la herramienta específica con marcadores de posición al revisar nombres de variables y configuración.

Lo que aún debes verificar

Escanear los archivos que envías no inspecciona todo el historial del repositorio, los despliegues antiguos ni los registros del proveedor. Un hallazgo no rota una credencial, y la ausencia de hallazgos no demuestra que se haya detectado cualquier secreto posible.

Preguntas frecuentes

¿Debo pegar secretos de producción en un escáner público?

Usa marcadores de posición para revisar la configuración. Si una credencial real ya está expuesta, rótala con su proveedor. Revisa la documentación de seguridad y privacidad del servicio antes de subir archivos propietarios.

¿Basta con borrar de Git la clave filtrada?

No. Borrarla no revoca la credencial ni elimina las copias de artefactos anteriores. Rótala o revócala, actualiza los despliegues y revisa el uso relevante en busca de actividad inesperada.

¿Puede una variable pública contener una clave privada de forma segura?

Trata los valores configurados para exponerse al cliente como legibles por los visitantes. Mantén las claves privilegiadas en entornos de servidor de confianza y llama al servicio privilegiado a través de una operación de servidor autenticada y autorizada.

Documentación y lecturas adicionales

Estas fuentes primarias explican el comportamiento de la plataforma descrito arriba. Consulta la documentación de las versiones y la configuración que usas.

Continúa tu revisión de seguridad