#signing #hsm #encryption

nethsm

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

9 releases (breaking)

new 0.7.1 Nov 27, 2024
0.6.0 Sep 11, 2024
0.3.0 Jul 12, 2024
0.1.0 Mar 23, 2024

#648 in Cryptography

Download history 151/week @ 2024-08-28 135/week @ 2024-09-04 185/week @ 2024-09-11 37/week @ 2024-09-18 24/week @ 2024-09-25 7/week @ 2024-10-02 4/week @ 2024-10-09 81/week @ 2024-11-20

85 downloads per month
Used in 4 crates (3 directly)

Apache-2.0 OR MIT

415KB
4.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

Contributing

Please refer to the contributing guidelines to learn how to contribute to this project.

License

This project may be used under the terms of the Apache-2.0 or MIT license.

Changes to this project - unless stated otherwise - automatically fall under the terms of both of the aforementioned licenses.

Dependencies

~30–43MB
~764K SLoC