Saltearse al contenido

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.

Ventana de terminal
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
FlagVariable de entornoSignificado
--tls-certNAMIDB_TLS_CERTCadena de certificados PEM (la hoja primero).
--tls-keyNAMIDB_TLS_KEYClave 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

Ventana de terminal
curl -s --cacert ca.pem https://namidb.internal:8443/v0/health
URL de BoltÚsala cuando
bolt+s://host:7687El certificado encadena a una CA en la que el cliente confía.
bolt+ssc://host:7687Certificado autofirmado o de una CA privada (cifrado sin verificación).
bolt://host:7687Solo 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

Ventana de terminal
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/health

Docker

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:

Ventana de terminal
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://demo

El 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.