Lista blanca de IP para las API Keys de Binance: separación de permisos spot y de futuros, notación CIDR e IP de salida de funciones cloud

El laboratorio biabalab prueba la configuración segura de API Keys de Binance: separación entre spot, futuros y retirada, sintaxis CIDR de la lista blanca, obtención de la IP de salida en funciones cloud, rotación cada 90 días y script de alertas, con matriz de permisos y ejemplos de máscaras.

Publicado el 2026-07-08 · Unos 22 min de lectura · Ajustes de seguridad

Resumen en una línea: la seguridad de una API Key de Binance es el producto de tres factores — clave, permisos y lista blanca de IP — y cualquiera de los tres que se afloje deja tu cuenta spot, tus futuros e incluso la retirada expuestos a Internet. En junio de 2026, el laboratorio biabalab midió la superficie de ataque de 12 combinaciones distintas de permisos en API Keys reales. En este artículo entregamos una plantilla lista para copiar y pegar: matriz de permisos, notación CIDR, script para obtener la IP de salida de una función cloud y el flujo de contención tras una filtración. Antes de crear cualquier clave, entra al Sitio Oficial de Binance desde un equipo confiable e instala la App Oficial de Binance por si necesitas revocar la clave desde el móvil.

1. Por qué una API Key filtrada es peor que la contraseña de la cuenta

La contraseña tiene 2FA, control de riesgo de inicio de sesión y alertas por país. Una API Key no lleva 2FA: solo una firma HMAC-SHA256 y un timestamp. Cuando se filtra:

  1. El atacante coloca órdenes en milisegundos; antes de que veas la alerta, tu bolsa ya se habrá vendido en una pump.
  2. Si la Key tiene permiso de retirada activo y no tiene lista blanca de IP, el atacante gira directamente a su propia dirección.
  3. Algunas plataformas (Binance es una de ellas) permiten transferencias internas entre cuentas por API, ampliando aún más la superficie.

La postura de biabalab es clara: por defecto sin retirada, por defecto con lista blanca de IP, por defecto rotación cada 90 días. Si no se cumplen las tres, es mejor no usar API Key y operar manualmente en la web.

2. Matriz de separación de permisos (lista para copiar)

Cada finalidad debería tener su propia Key. No abras todas las puertas con la misma llave. Ésta es la matriz que el laboratorio utiliza a diario.

Finalidad Spot Futuros Transferencias Retirada Lectura Lista blanca IP Vigencia
Monitor de solo lectura (dashboard) No No No No Sí Obligatoria 90 días
Bot spot en grid Sí No No No Sí Obligatoria 90 días
Estrategia de cobertura en futuros No Sí Sí No Sí Obligatoria 30 días
Consolidación financiera No No Sí Sí Sí Obligatoria + dirección en lista blanca 30 días
Backfill de datos puntual No No No No Sí Obligatoria Borrar tras uso

Regla clave: toda Key con lista blanca de IP (Binance permite hasta 20 IPs o 20 rangos CIDR), y ninguna Key con «todos los permisos activos». La única finalidad que necesita retirada es la consolidación financiera, y siempre con dirección de retirada también en lista blanca.

En la página de gestión de API del Sitio Oficial de Binance, cada permiso se marca por separado: no cedas al impulso de marcarlo todo por comodidad.

3. Tres formas de escribir la lista blanca

Binance acepta IP única, lista separada por comas o notación CIDR. La forma correcta depende del escenario de despliegue.

Escenario Notación recomendada Ejemplo IPs cubiertas Nota
IP pública fija en casa IP única 203.0.113.42 1 Máxima rigidez, mínima disponibilidad
Doble ISP en casa Varias IPs 203.0.113.42,198.51.100.7 2 Ruta primaria + secundaria
Pequeño rack /29 CIDR /29 203.0.113.40/29 8 Cubre servidores del mismo tramo
Pool elástico en la nube CIDR /28 198.51.100.16/28 16 Cubre el auto-scaling group
NAT Gateway de funciones cloud Lista de IPs de salida 4-8 IPs de NAT ≤ 20 Cada NAT se registra por separado
Banda ancha DHCP dinámico No recomendado — — Mejor VPS + túnel

Conversión rápida de CIDR: /32 = 1 IP, /31 = 2, /30 = 4, /29 = 8, /28 = 16, /27 = 32. Binance limita cada entrada a /24 como máximo (256 IPs), por encima da error, y en la práctica nunca se necesita algo tan amplio.

3.1 Cómo hacerlo con banda ancha doméstica

La IP doméstica suele ser DHCP del proveedor y cambia cada pocos días. En biabalab no recomendamos conectar directo desde una IP doméstica: alquila un VPS de bajo coste (5-10 USD al mes), abre SSH desde casa al VPS y desde ahí ataca la API. Solo hay que registrar la IP fija del VPS.

3.2 Cómo hacerlo con funciones cloud

Las funciones cloud (Tencent SCF / Alibaba FC / AWS Lambda) usan IPs de salida aleatorias por defecto y no se pueden meter en lista blanca directamente. El procedimiento correcto:

  1. Coloca un NAT Gateway en la VPC de la función.
  2. Asigna al NAT entre 1 y 4 IPs elásticas (EIP).
  3. Añade esas 1-4 EIPs a la lista blanca de la API.
  4. Todo el tráfico saliente de la función pasa por el NAT y la IP queda estable.

Beneficio adicional: puedes escalar la función a 100 réplicas sin tocar la lista blanca, porque el punto de salida sigue siendo el NAT.

4. Los seis pasos para crear una API Key

  1. Inicia sesión en Binance → foto de perfil → Gestión de API.
  2. Pulsa «Crear API» y elige «System generated» (para evitar una clave débil creada por ti).
  3. Ponle un nombre con formato «finalidad+fecha» (por ejemplo spot-grid-20260707), útil para limpieza masiva futura.
  4. Introduce el código 2FA y el código del correo.
  5. Nada más creada, inmediatamente activa «Restrict access to trusted IPs only» y rellena la lista blanca; marca los permisos.
  6. Copia API Key y Secret Key en tu gestor de contraseñas (1Password / Bitwarden / Vault) y cierra la página. La Secret Key solo se muestra una vez; al cerrar la página, ya no la recuperas, tocará borrar y recrear.

Pregunta: ¿Y si me olvido de guardar la Secret Key? Respuesta: Solo puedes borrar la Key y crear una nueva. No dejes la página abierta indefinidamente pensando que se conservará: Binance la oculta al terminar la sesión.

Pregunta: ¿Puedo usar la misma API Key en varias máquinas? Respuesta: Técnicamente sí (metiendo todas las IPs en la lista blanca), pero no lo recomendamos. Cuando una máquina falle, no sabrás quién colocó qué orden. Un servidor, una Key.

5. Automatización de la rotación a 90 días

El flujo de rotación en biabalab:

  1. El día 1 de cada mes, escanea la página de gestión de API y etiqueta como «pendiente de rotación» las Keys con más de 60 días.
  2. Cinco días antes crea una nueva Key con los mismos permisos.
  3. En la configuración de la estrategia, migra en canary: la nueva absorbe 10 % → 50 % → 100 % del tráfico.
  4. Tras 24 horas sin incidencias, borra la Key vieja desde la página de gestión.
  5. Registra la rotación en el log interno.

Riesgo de no rotar: si la Key se filtra, quizá tardes mucho en enterarte; filtrarse mucho tiempo equivale a estar bajo vigilancia mucho tiempo. La rotación fuerza el cierre de la ventana de fuga.

6. Ejemplo de script de alerta

biabalab sugiere un script diario minimalista (pseudocódigo Python que ilustra la estructura):

  1. Cada día a las 09:00, consulta /sapi/v1/account/apiTradingStatus y revisa la puntuación de control de riesgo.
  2. Cada día a las 09:00, consulta /api/v3/account, calcula el diff del saldo spot y avisa si la desviación supera el 5 %.
  3. Cada día a las 09:00, consulta la lista blanca actual, la compara con el fichero de configuración y avisa si difieren.
  4. Cada día a las 09:00, revisa la fecha de creación de la Key y avisa si le quedan menos de 10 días de vida.

Canales de alerta: correo + WeCom en paralelo, para no depender de uno solo.

7. Contención tras una filtración: cuatro pasos

  1. Inmediatamente, entra al Sitio Oficial de Binance y borra la API Key (prioridad más alta incluso que cambiar la contraseña).
  2. Desactiva el interruptor general «API Trading» de la cuenta para invalidar todas las Keys a la vez.
  3. Revisa las últimas 24 horas de órdenes, retiradas y transferencias internas.
  4. Si ya hay pérdidas, abre un ticket con soporte; y limpia por completo el origen de la fuga (commit de GitHub, app de notas, grabación de pantalla).

Aviso: tras la filtración no dudes. Borrar una Key es una acción no destructiva, si te equivocas creas otra en unos minutos; retrasar diez minutos puede ser la pérdida total.

8. Preguntas frecuentes

¿Puedo poner un dominio en la lista blanca?

No. Binance solo acepta direcciones IPv4 o CIDR IPv4. IPv6 aún no está soportado. Si tu máquina solo tiene IPv6, monta NAT64 o un VPS intermedio que reescriba a IPv4.

¿Y si mi VPS cambia de IP?

Inicia sesión en Binance → Gestión de API → editar Key → cambiar la IP de la lista blanca → guardar. Modificar la lista blanca no tiene periodo de enfriamiento, entra en vigor de inmediato. Es distinto de la lista blanca de retiradas: se diseñó así para dar flexibilidad a la Key de trading.

¿Puedo activar «Lectura» y «Retirada» sin «Trading»?

Sí, los permisos de Binance se marcan por separado. Es exactamente el caso de la Key de consolidación financiera: lee saldos y retira, sin operar.

Si me paso del rate limit, ¿me banean la Key?

No banean la Key, banean la IP (respuesta 418). Cuando la IP está baneada, las demás Keys en esa IP tampoco funcionan. Deja al menos un 20 % de margen de rate limit por estrategia.

9. Descarga y lecturas relacionadas

Si aún no tienes cuenta, primero regístrate y luego vuelve a la configuración. Comienza descargando la App Oficial de Binance, o pasa por nuestra página de descargas para elegir instalador. La app también permite crear y gestionar API Keys en «Yo → Seguridad → Gestión de API».

Lecturas internas: Lista blanca de retiradas en Binance, guía práctica cubre el candado de la lista blanca a nivel de cuenta, complementario al de IP; Guía completa de migración 2FA de Binance explica la base 2FA que debe existir antes de crear cualquier API Key.

10. Lista de auto-verificación

Punto de control ¿Cumple?
Una Key independiente por finalidad Sí / No
Lista blanca de IP activa en todas las Keys Sí / No
Permiso de retirada solo en la Key de consolidación Sí / No
Funciones cloud saliendo por NAT fijo Sí / No
Secret Key en gestor de contraseñas, no en texto plano Sí / No
Nombre de Key con finalidad + fecha Sí / No
Rotación cada 90 días Sí / No
Script diario de saldo y lista blanca Sí / No
Manual de emergencia para fugas archivado Sí / No

Solo cuando todas las respuestas sean «Sí» tu configuración está a la altura.

11. Advertencia final

Aviso: cada ampliación de permisos en una API Key aumenta la superficie de ataque; la comodidad de «lo activo todo y ya lo cerraré si pasa algo» se paga en el mercado real. De los cinco incidentes de API Key que el equipo biabalab ha analizado, cuatro fueron por no cerrar el permiso de retirada y uno por rellenar 0.0.0.0/0 en la lista blanca. Que no seas el sexto. Cualquier script de terceros, extensión de Chrome o bot de Telegram que ofrezca «generar automáticamente API Keys» es un intermediario potencial y debe evitarse: crea siempre a mano desde el Sitio Oficial de Binance, o desde la App Oficial de Binance.

Documento publicado el 2026-07-01, próxima revisión prevista el 2026-10-01.