Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Cómo almacenar claves API de forma segura en el código de dispositivos e integraciones

Las claves API se filtran a través de sus copias: URL en registros, archivos de configuración confirmados y firmware grabado en cada dispositivo. Una regla para cada lugar, con los estándares que la respaldan.

Para almacenar las claves API de forma segura, manténgalas fuera de todo lo que se copia: código fuente, repositorios, imágenes de firmware, URL y registros. Lea cada clave en tiempo de ejecución desde un almacén de secretos o desde un archivo que solo pueda leer el servicio, asígnele el conjunto más pequeño de permisos y esté preparado para revocarla y reemplazarla.

Una clave se filtra a través de sus copias, así que cada regla siguiente trata de dónde termina una copia.

Dónde está la claveCómo se copiaRegla
Una cadena de consulta de URLHistorial del navegador, registros de servidor y de proxyEnvíela en una cabecera, sobre TLS
Código fuente y repositoriosCada clon, y el historialLéala en tiempo de ejecución; revóquela si se confirmó en un repositorio
Variables de entornoOtros procesos, registros, volcados del sistemaPrefiera un almacén de secretos o un archivo protegido
Imágenes de firmwareCada dispositivo al que se grabó la imagenUna credencial por dispositivo, sin claves API externas

¿Es seguro poner una clave API en una URL?

No. El estándar de tokens bearer de OAuth, RFC 6750, establece que los tokens bearer no deben enviarse en las URL de las páginas, porque los navegadores, los servidores web y otro software pueden no proteger adecuadamente las URL en el historial del navegador, en los registros del servidor y en otras estructuras de datos.

Una clave API en una cadena de consulta queda expuesta en los mismos lugares, así que aplico la misma regla: poner la clave en una cabecera de la petición y enviarla solo sobre TLS, que el RFC 6750 exige para los tokens bearer. Si un servicio solo acepta su clave como parámetro de consulta, considero que esa clave está medio expuesta y le asigno los permisos más restringidos disponibles.

¿Deben las claves API estar en variables de entorno?

Son mejores que el código fuente, pero son una solución de reserva. La OWASP Secrets Management Cheat Sheet afirma que las variables de entorno suelen ser accesibles para todos los procesos y pueden incluirse en registros o volcados del sistema, y recomienda usarlas solo cuando no sea posible emplear otros métodos.

En el código de integración, leo la clave al arrancar desde un almacén de secretos o desde un archivo que solo pueda leer la cuenta de servicio, y nunca registro la configuración cargada. Un archivo .env de desarrollo se mantiene fuera del repositorio. Una vez confirmada, una clave está en cada clon y en el historial.

¿Cómo se mantienen las credenciales fuera del firmware?

No las compile en el firmware. La línea base de IoT de consumo ETSI EN 303 645 establece que no deben usarse parámetros de seguridad críticos codificados en el código fuente del software del dispositivo, porque la ingeniería inversa puede encontrar credenciales, incluidas las claves API, con facilidad, y la ofuscación simple se rompe trivialmente.

Los dispositivos industriales quedan fuera del alcance de esa norma, pero el argumento se sostiene en la planta. Dé a cada dispositivo su propia credencial en la puesta en servicio, guárdela en un almacenamiento protegido y distribuya una única imagen de firmware que no contenga ningún secreto, de modo que una credencial obtenida de un dispositivo solo abra ese dispositivo (más información sobre por qué las contraseñas compartidas dejan de escalar). Un sensor no debería tener ninguna clave de una API externa: envía los datos a su plataforma, y el servidor hace la llamada externa (véase cómo debe enterarse otro sistema de los nuevos datos del dispositivo).

Hermetry conecta dispositivos de campo con paneles en vivo, reglas y alertas: telemetría IoT y SCADA en una sola plataforma. En sus flujos de automatización, un bloque que llama a un sistema externo nunca contiene la dirección ni la contraseña; nombra una conexión, y el bloque de petición HTTP toma el esquema, el host, el puerto, la autenticación y TLS únicamente de esa conexión, nunca del mensaje. Los secretos de las conexiones se almacenan cifrados, no pueden leerse una vez guardados y nunca llegan a los mensajes, registros de ejecución, registros, el registro de auditoría ni las exportaciones, por lo que un flujo importado necesita que sus secretos se introduzcan de nuevo.

Limite cada clave a una integración y a un trabajo (véase el mínimo privilegio para personas, programas y dispositivos). Una clave por integración le indica qué expone una filtración y le permite revocarla sin detener todo lo demás.

Preguntas frecuentes

¿Qué debo hacer si una clave API se confirmó en un repositorio?

Revóquela primero. La OWASP Secrets Management Cheat Sheet establece el orden de contención: revocar la clave expuesta, rotar a un nuevo secreto y, por último, eliminar el secreto revocado del código y de los registros. Reescribir el historial por sí solo no sirve, porque los clones y las bifurcaciones pueden contener ya la confirmación antigua.

¿Con qué frecuencia deben rotarse las claves API?

OWASP recomienda rotar los secretos periódicamente, para que una credencial robada funcione solo durante poco tiempo, y automatizar la rotación siempre que sea posible, porque la rotación manual es difícil y puede dar lugar a errores. Elija un intervalo que su integración pueda asumir sin tiempo de inactividad, y rote de inmediato siempre que una clave pueda haberse filtrado.

¿Basta con cifrar una clave dentro del firmware?

No, si el dispositivo puede descifrarla por sí mismo. ETSI EN 303 645 señala que los métodos de ofuscación simples usados para ocultar o cifrar información codificada en el código se rompen trivialmente. Si el dispositivo puede recuperar la clave sin ayuda externa, también podrá hacerlo cualquiera que extraiga su firmware.

Compartir

Vea sus datos de campo en vivo esta semana

Inicie una prueba en su región con sus primeros dispositivos, o reserve una demo y traiga su propio caso de uso.