NetHSM

A high-level library abstracting the use of the nethsm-sdk-rs library.

The NetHSM is a hardware appliance, that serves as secure store for cryptographic keys. With the help of a REST API it is possible to communicate with the device (as well as the official nethsm container) for setup and various cryptographic actions.

The nethsm-sdk-rs library is auto-generated using openapi-generator. This leads to a broad API surface with sparse documentation, that this crate attempts to rectify with the help of a central struct used for authentication setup and communication.

Testing

This library is integration tested against Nitrokey's official nethsm container. To run these long running tests a podman installation with running systemd user socket (podman.socket) is required, as the tests handle the creation and teardown of containers as needed.

cargo test --all -- --ignored

License

This project is licensed under the terms of the Apache-2.0 and MIT.