Test Image

The test image is designed for testing and development purposes. It does not offer to run the NetHSM process with hardware-based separation (KVM), to encrypt the data store, or to use an external etcd. The connection between the NetHSM process and the integrated key-value store is unencrypted. The image is distributed as OCI image and can be run locally with a compatible executor such as Docker and Podman.

The image can be obtained from Docker Hub.

Avvertimento

Non utilizzare in nessun caso l’immagine di prova per i dati e i casi d’uso di produzione. Per gli ambienti di produzione con elevati requisiti di sicurezza è necessario utilizzare l’immagine di produzione.

Politica di etichettatura

Le immagini presenti nel repository sono contrassegnate con l’hash del commit Git del ramo principale del repository ` <https://github.com/nitrokey/nethsm>` __. L’ultima immagine è contrassegnata con testing.

Configurazione

L’immagine può essere configurata con le seguenti variabili d’ambiente.

Variabile d’ambiente

Descrizione

Ipsec (solo Linux)

Abilita la registrazione estesa per NetHSM.

Data Storage

La configurazione del sistema, le chiavi e i certificati sono memorizzati in un database etcd. Il servizio etcd memorizza il database nel percorso /data del contenitore. Gli esecutori del contenitore consentono di eseguire il volume o il bind mount di questo percorso.

Uso

Il contenitore può essere eseguito come segue.

$ docker run --rm -ti -p 8443:8443 docker.io/nitrokey/nethsm:testing

This will run NetHSM as a Unix process inside the container and expose the REST API via the HTTPS protocol on port 8443.

Importante

The container uses a self-signed TLS certificate. Make sure to use the correct connection settings to establish a connection. Please refer to chapter NetHSM introduction to learn more.