Protege tus claves API de Solana: prácticas recomendadas de seguridad

Alerta de seguridad de claves API: Las claves API expuestas pueden provocar uso no autorizado, agotamiento de la cuota y cargos inesperados. Protege siempre tus claves en las aplicaciones de producción.

Por qué es importante proteger las claves

Cuando expones claves API en el lado del cliente, los actores maliciosos pueden descubrirlas y usarlas de forma indebida, lo que podría:

Exhaust Your Quota

El uso malicioso puede consumir rápidamente los límites de tu API y causar interrupciones del servicio

Increase Your Bills

Las solicitudes no autorizadas pueden generar cargos por escalado automático o hacer que superes los límites del plan

Compromise Security

Las claves expuestas pueden dar acceso a datos y operaciones confidenciales

Damage Performance

Un uso elevado no autorizado puede afectar el rendimiento de tu aplicación

Métodos de protección

Helius ofrece varias capas de protección para mantener seguras tus claves API:

RPC Proxy
Access Control Rules
Secure URL

Implementa tu propio proxy para obtener la máxima seguridad y control.

Helius RPC Proxy

Un proxy RPC sencillo y de código abierto que puedes implementar en Cloudflare con un solo clic.

Ventajas de usar un proxy

Complete Key Protection

Tu clave API permanece en el servidor y nunca se expone a los clientes

Custom Rate Limiting

Implementa tus propios límites de velocidad y controles de uso

Request Filtering

Filtra y valida las solicitudes antes de que lleguen a Helius

Usage Analytics

Supervisa y analiza los patrones de uso de tu API

Configura controles de acceso precisos en tu panel de Helius para restringir el uso de la API.

Configure RPC Access Control Rules in the RPCs section of your dashboard.

Tipos de reglas disponibles

Allowed Domains

Restringe el acceso a dominios específicos; es perfecto para aplicaciones web.Casos de uso:

Sitios web de producción (yourdapp.com)
Entornos de preproducción (staging.yourdapp.com)
Implementaciones de vista previa (preview.yourdapp.com)

Ejemplo de configuración:

yourdapp.com
www.yourdapp.com
staging.yourdapp.com

Allowed IPs

Restringe el acceso a direcciones IP específicas; es ideal para aplicaciones de servidor.Casos de uso:

Servidores backend con IP estáticas
Procesos de CI/CD
Servicios alojados en la nube

Ejemplo de configuración:

0.113.1
51.100.42
199.108.153

Aquí solo funcionan las direcciones IP públicas. Las IP privadas o locales (como 192.168.x.x o 10.x.x.x) no funcionan.

Allowed CIDRs

Restringe el acceso a intervalos de IP mediante la notación CIDR; es una excelente opción para redes empresariales.Casos de uso:

Intervalos de IP públicas corporativas
Intervalos de IP de proveedores de nube
Bloques de IP de centros de datos

Ejemplo de configuración:

0.113.0/24
51.100.0/24
199.108.0/22

Aquí solo funcionan los intervalos de IP públicas. Los bloques CIDR privados (192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12) no funcionan.

Usa nuestra URL segura en aplicaciones frontend sin exponer tu clave API.

Con límite de velocidad: Las URL seguras tienen un límite de 5 solicitudes por segundo (RPS) por dirección IP, lo que las hace perfectas para aplicaciones frontend.Solo para planes de pago: Las URL seguras están disponibles en los planes de pago. Los planes gratuitos no incluyen esta función.

Cómo usar las URL seguras

Get Your Secure URL

Busca tu URL segura en la sección RPCs del panel de Helius

Replace Your Regular RPC URL

Usa la URL segura en lugar de tu URL RPC habitual con clave API

No API Key Required

La URL segura no requiere un parámetro de clave API

// Instead of this (exposes API key):
const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY');

// Use this (secure, no API key exposed):
const connection = new Connection('https://your-secure-url.helius-rpc.com');

Perfecto para: Aplicaciones frontend, aplicaciones móviles y cualquier código del lado del cliente donde no puedas ocultar la clave API.

Prácticas recomendadas

Environment Variables

Nunca codifiques las claves API directamente en tu código fuente. Usa variables de entorno.

// ❌ Don't do this
const apiKey = "your-api-key-here";

// ✅ Do this instead
const apiKey = process.env.HELIUS_API_KEY;

Separate Keys for Different Environments

Usa claves API diferentes para los entornos de desarrollo, preproducción y producción.

const getApiKey = () => {
  switch (process.env.NODE_ENV) {
    case 'production':
      return process.env.HELIUS_API_KEY_PROD;
    case 'staging':
      return process.env.HELIUS_API_KEY_STAGING;
    default:
      return process.env.HELIUS_API_KEY_DEV;
  }
};

Regular Key Rotation

Rota tus claves API periódicamente y de inmediato si sospechas que se han vulnerado.

Generate New Key

Crea una nueva clave API en tu panel de Helius

Update Applications

Actualiza todas las aplicaciones para que usen la clave nueva

Test Thoroughly

Asegúrate de que todos los servicios funcionen con la clave nueva

Revoke Old Key

Elimina la clave anterior de tu panel

Monitor Usage

Revisa periódicamente el uso de tu API en el panel de Helius para detectar patrones inusuales.Señales de alerta que debes vigilar:

Aumentos repentinos del uso
Solicitudes desde ubicaciones inesperadas
Tasas de error elevadas
Uso fuera del horario habitual

Lista de verificación de seguridad

✅ Development Security

Usa variables de entorno para las claves API
Nunca envíes claves API al control de versiones
Usa claves diferentes para cada entorno
Configura reglas de control de acceso para los dominios de desarrollo
Usa URL seguras para el desarrollo frontend

✅ Production Security

Implementa reglas de control de acceso adecuadas
Usa un proxy RPC para obtener la máxima seguridad
Supervisa periódicamente el uso de la API
Configura alertas para patrones de uso inusuales
Rota las claves periódicamente
Documenta tus procedimientos de seguridad

✅ Emergency Response

Ten listo un procedimiento de rotación de claves
Aprende a revocar rápidamente las claves vulneradas
Supervisa posibles brechas de seguridad
Ten a mano la información de contacto del soporte de Helius
Conserva copias de seguridad de tus configuraciones de seguridad

Errores comunes que debes evitar

Evita estos errores comunes de seguridad:

Codificar claves directamente en el JavaScript del frontend - Usa siempre URL seguras o proxies
Enviar claves a repositorios de Git - Usa variables de entorno y .gitignore
Usar claves de producción para el desarrollo - Usa claves distintas para cada entorno
No establecer reglas de control de acceso - Configura siempre restricciones de dominio o IP
Ignorar patrones de uso inusuales - Supervisa tu panel periódicamente

¿Necesitas ayuda?

Discord Community

Obtén ayuda de la comunidad y del equipo de Helius

Support Team

Contacta a nuestro equipo de soporte si tienes dudas de seguridad

⌘I

Comienza aquí

Datos en tiempo real

Trading de baja latencia

Datos históricos y de billeteras

Guías de métodos RPC

Preparación para producción

Uso de Orb

Otras guías prácticas

Protege tus claves API de Solana: prácticas recomendadas de seguridad

Por qué es importante proteger las claves

Exhaust Your Quota

Increase Your Bills

Compromise Security

Damage Performance

Métodos de protección

Helius RPC Proxy

Ventajas de usar un proxy

Complete Key Protection

Custom Rate Limiting

Request Filtering

Usage Analytics

Tipos de reglas disponibles

Cómo usar las URL seguras

Prácticas recomendadas

Environment Variables

Separate Keys for Different Environments

Regular Key Rotation

Monitor Usage

Lista de verificación de seguridad

Errores comunes que debes evitar

¿Necesitas ayuda?

Discord Community

Support Team

​Por qué es importante proteger las claves

Exhaust Your Quota

Increase Your Bills

Compromise Security

Damage Performance

​Métodos de protección

Helius RPC Proxy

​Ventajas de usar un proxy

Complete Key Protection

Custom Rate Limiting

Request Filtering

Usage Analytics

​Tipos de reglas disponibles

​Cómo usar las URL seguras

​Prácticas recomendadas

Environment Variables

Separate Keys for Different Environments

Regular Key Rotation

Monitor Usage

​Lista de verificación de seguridad

​Errores comunes que debes evitar

​¿Necesitas ayuda?

Discord Community

Support Team

Por qué es importante proteger las claves

Métodos de protección

Ventajas de usar un proxy

Tipos de reglas disponibles

Cómo usar las URL seguras

Prácticas recomendadas

Lista de verificación de seguridad

Errores comunes que debes evitar

¿Necesitas ayuda?