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.

Waarschuwing

Gebruik de testimage in geen geval voor productiegegevens en use cases. Voor productieomgevingen met hoge beveiligingseisen moet je de productie-image gebruiken.

Tagging-beleid¶

De afbeeldingen in het archief zijn gelabeld met de Git commit hash van de hoofdbranch van het archief. De nieuwste afbeelding is getagd met testing.

Configuratie¶

De image kan worden geconfigureerd met de volgende omgevingsvariabelen.

Omgevingsvariabele	Beschrijving
DEBUG_LOG	Schakelt uitgebreide logboekregistratie voor NetHSM in.

Data Storage¶

De systeemconfiguratie, sleutels en certificaten worden opgeslagen in een etcd database. De etcd service slaat de database op in het /data pad van de container. Containeruitvoerders staan toe om volume of bind mount dit pad.

Gebruik¶

De container kan als volgt worden uitgevoerd.

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

$ podman 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.

Belangrijk

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.