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.

警告

本番データやユースケースには、いかなる場合でもテスト・イメージを使用しないでください。高いセキュリティが要求される本番環境では、本番用イメージを使用する必要があります。

タギング・ポリシー

リポジトリ内の画像には、`リポジトリ<https://github.com/nitrokey/nethsm>`__ のメインブランチの Git コミットハッシュがタグ付けされています。最新のイメージには``testing`` のタグが付いています。

構成

イメージは以下の環境変数で設定できる。

環境変数

説明

DEBUG_LOG`

NetHSM の拡張ロギングを有効にします。

Data Storage

システム構成、鍵、証明書は etcd データベースに格納される。etcd サービスは、コンテナの``/data`` パスにデータベースを格納する。コンテナ・エグゼキュータはこのパスをボリュームまたはバインドしてマウントすることができる。

使用方法

コンテナは、次のように実行できます。

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

重要

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.