TLS
namidb-server termina TLS por sí mismo (rustls, TLS 1.2 y 1.3). Pásale
una cadena de certificados PEM y su clave privada; entonces ambos
listeners, HTTP y Bolt, requieren TLS.
namidb-server \ --store "file:///var/lib/namidb?ns=prod" \ --auth-tokens-file /etc/namidb/tokens.json \ --listen 0.0.0.0:8443 \ --bolt-listen 0.0.0.0:7687 \ --tls-cert /etc/namidb/tls/fullchain.pem \ --tls-key /etc/namidb/tls/privkey.pem| Flag | Variable de entorno | Significado |
|---|---|---|
--tls-cert | NAMIDB_TLS_CERT | Cadena de certificados PEM (la hoja primero). |
--tls-key | NAMIDB_TLS_KEY | Clave privada PEM del certificado hoja. |
Define ambos o ninguno. Sin ellos el servidor habla en texto plano; en ese caso termina TLS delante de él (un reverse proxy, un balanceador de carga o un service mesh) y mantén el puerto en texto plano en una red privada.
Clientes
curl -s --cacert ca.pem https://namidb.internal:8443/v0/health| URL de Bolt | Úsala cuando |
|---|---|
bolt+s://host:7687 | El certificado encadena a una CA en la que el cliente confía. |
bolt+ssc://host:7687 | Certificado autofirmado o de una CA privada (cifrado sin verificación). |
bolt://host:7687 | Solo texto plano. Contra un listener TLS falla. |
from neo4j import GraphDatabase
driver = GraphDatabase.driver("bolt+s://namidb.internal:7687", auth=("namidb", token))Un certificado de prueba
openssl req -x509 -newkey rsa:2048 -nodes -keyout key.pem -out cert.pem -days 30 \ -subj "/CN=localhost" -addext "subjectAltName=DNS:localhost,IP:127.0.0.1"
namidb-server --store memory://tls --auth-token "$NAMIDB_AUTH_TOKEN" \ --listen 127.0.0.1:8443 --bolt-listen 127.0.0.1:7687 \ --tls-cert cert.pem --tls-key key.pem
curl -s --cacert cert.pem https://localhost:8443/v0/healthDocker
Monta los archivos del certificado y defínelos mediante el entorno para que el health check integrado de la imagen detecte TLS y consulte por HTTPS:
docker run -d -p 8443:8443 \ -v /etc/namidb/tls:/tls:ro \ -e NAMIDB_LISTEN=0.0.0.0:8443 \ -e NAMIDB_TLS_CERT=/tls/fullchain.pem \ -e NAMIDB_TLS_KEY=/tls/privkey.pem \ -e NAMIDB_AUTH_TOKEN \ namidb/namidb-server:3.3.0 --store memory://demoEl health check lee NAMIDB_LISTEN, NAMIDB_TLS_CERT y NAMIDB_TLS_KEY.
Si defines la dirección de escucha o TLS con flags de línea de comandos,
replícalos en estas variables o reemplaza el health check en tu
orquestador. El probe omite la verificación del certificado en su propia
petición loopback, ya que los certificados de despliegue rara vez incluyen
direcciones loopback.
Rotación de certificados
El certificado y la clave se leen al arrancar. Para rotarlos, reemplaza los archivos y reinicia el servidor; planifica el reinicio como cualquier otro (un servidor por namespace, consulta Modo multi-tenant).
Conexiones salientes
Las conexiones del servidor hacia object stores, un endpoint JWKS o un
endpoint de políticas usan HTTPS según sus URLs. El HTTP plano hacia un
endpoint compatible con S3 debe permitirse explícitamente con
allow_http=true en el URI de almacenamiento.