Saltar al contenido principal
Versión: Next

Endurecimiento de producción

Antes de abrir una instancia a Internet, compruebe qué sirve su puerto público, use certificados TLS de confianza y restrinja el acceso al clúster. Esta página describe los listeners de la versión actual. Antes de v1.6.0, las métricas y las sondas de salud se servían en el puerto público de la API y eran accesibles mediante /api/<area>/...; actualice antes de confiar en la separación descrita aquí.

Puerto público y puerto de operaciones​

Los pods y el Service de cada área tienen dos puertos HTTP:

PuertoNombreQué sirveEnrutado desde fuera
8080graphql/graphql, las rutas HTTP propias del área y /graphiql con herramientas de desarrollo habilitadasSí: el chart reenvía /api/<area>/<path> a /<path>
8083ops/metrics, /healthz y /readyzNo: ninguna ruta del chart apunta a él

Los endpoints operativos responden sin autenticación; por eso están en un puerto al que no llega ninguna ruta pública. A través de la ruta pública por prefijo, /api/<area>/metrics, /api/<area>/healthz y /api/<area>/readyz devuelven 404: el puerto de la API no sirve esas rutas. Las sondas de Kubernetes y los ServiceMonitor de Prometheus del chart usan el puerto ops directamente dentro del clúster. Consulte Observabilidad.

/graphiql sirve la página del explorador sin autenticación cuando se habilitan las herramientas de desarrollo. Están deshabilitadas por defecto, y la introspección del esquema se deshabilita con ellas.

/graphql también es accesible antes de iniciar sesión: la autenticación y autorización dependen de la operación. El inicio de sesión, el inicio de SSO y el descubrimiento público deben funcionar sin token; las operaciones protegidas siguen exigiendo credenciales verificadas y permisos.

La emisión de tokens de servicio /auth/service-token y las claves de firma /auth/jwks están en el listener interno separado de user-management, no en el puerto 8080. El chart no publica ninguna ruta a ese listener; el puerto público devuelve 404 para esas rutas. Mantenga su Service interno. Los perfiles Go están deshabilitados por defecto y usan otro listener de loopback al habilitarlos; consulte Perfilar un servicio.

Su propia entrada o perímetro​

Si aporta su propio controlador de entrada, Gateway o proxy inverso, dirija la API solo al puerto graphql, nunca a ops ni al listener interno de user-management. Cierre el acceso público directo a puertos de nodo, balanceadores y puertos de servicio distintos de su perímetro, para que nadie llegue al puerto ops rodeándolo.

Si habilita las herramientas de desarrollo en una instancia accesible desde Internet, bloquee también el explorador en el perímetro. En un proxy inverso NGINX delante de la entrada o Gateway del chart, añada esta ubicación al bloque HTTPS server de la instancia, antes de la ubicación de proxy general. devicechain_edge representa el upstream existente hacia la entrada o Gateway:

location ~* ^/api/[^/]+/graphiql(/|$) {
return 403;
}
location / {
proxy_pass http://devicechain_edge;
}

Bloquear el explorador no bloquea las consultas GraphQL y, con las herramientas de desarrollo habilitadas, la introspección del esquema sigue disponible en /graphql. Mantenga las herramientas de desarrollo deshabilitadas en una instancia expuesta a Internet.

Tras una instalación, una actualización o un cambio en el perímetro, compruebe desde fuera sin credenciales:

curl -i https://INSTANCE_HOST/api/device-management/metrics
curl -i https://INSTANCE_HOST/api/device-management/healthz
curl -i https://INSTANCE_HOST/api/device-management/readyz
curl -i https://INSTANCE_HOST/api/device-management/graphiql

/metrics, /healthz y /readyz deben devolver 404, o 403 si su propio perímetro también los bloquea. /graphiql debe devolver 404 con las herramientas de desarrollo deshabilitadas, o 403 con la regla anterior. Repita para cada área pública habilitada. Confirme que funcionan el inicio de sesión y una petición GraphQL autorizada, que las sondas siguen sanas y que Prometheus sigue recogiendo métricas. Cualquier respuesta de métricas o de salud desde fuera indica un perímetro que enruta al puerto ops.

Controles del clúster y las credenciales​

  • Use certificados TLS de confianza en el perímetro público y conserve TLS del broker. Consulte Conexión desde fuera.
  • Configure proxies de confianza para la cadena real, de modo que los límites por dirección usen la dirección de origen prevista.
  • Restrinja el acceso de red a bases de datos, broker, monitorización y puertos internos de los servicios, incluido ops; un perímetro público no aísla los pods de otras cargas del clúster.
  • Limite los permisos de Kubernetes para leer Secrets, ejecutar en pods o redirigir puertos. Mantenga los perfiles deshabilitados fuera de sesiones de diagnóstico controladas.
  • Proteja la clave raíz de la instancia y las copias de seguridad, y ensaye la recuperación ante desastres. Use roles con privilegios mínimos y rote credenciales filtradas. Revise los límites restantes en el Modelo de seguridad.