#hsm #encryption #signing

nethsm

A high-level library to interact with the API of a Nitrokey NetHSM

3 unstable releases

new 0.2.0 May 10, 2024
0.1.1 May 4, 2024
0.1.0 Mar 23, 2024

#1671 in Cryptography

Download history 143/week @ 2024-03-21 19/week @ 2024-03-28 8/week @ 2024-04-04 154/week @ 2024-05-02

154 downloads per month

Apache-2.0 OR MIT

200KB
2.5K SLoC

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 is required. 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.

Dependencies

~77MB
~2M SLoC