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.
Advarsel
Brug under ingen omstændigheder testbilledet til produktionsdata og use cases. Til produktionsmiljøer med høje sikkerhedskrav skal du bruge produktionsbilledet.
Politik for tagging¶
Billederne i depotet er tagget med Git commit-hash fra hovedgrenen i depotet. Det seneste billede er tagget med testing.
Konfiguration¶
Billedet kan konfigureres med følgende miljøvariabler.
Miljøvariabel |
Beskrivelse |
|---|---|
|
Aktiverer udvidet logning for NetHSM. |
Data Storage¶
Systemkonfiguration, nøgler og certifikater gemmes i en etcd-database. etcd-tjenesten gemmer databasen i /data stien til containeren. Container-eksekutorer giver mulighed for at montere volumen eller bind på denne sti.
Anvendelse¶
Beholderen kan udføres på følgende måde.
$ 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.
Vigtigt
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.