融合#

该章描述了各种任务的流程，并针对所有用户群体。

REST-API#

NetHSM 的主要接口是一个现代 RESTAPI，可确保最佳性能和功能。API 规范以`OpenAPI 格式提供<https://nethsmdemo.nitrokey.com/api_docs/nethsm-api.yaml>`_ ，可在`API 浏览器<https://nethsmdemo.nitrokey.com/api_docs/index.html>`_ 中检查和测试。

PKCS#11#

NetHSM 支持 PKCS#11 标准。所需驱动程序可从`存储库<https://github.com/Nitrokey/nethsm-pkcs11>`__中获取。该资源库包含适用于不同操作系统的源代码和库。`PKCS#11 指南<pkcs11-setup.html>`_ 详细介绍了使用方法。

开发和测试#

公共 NetHSM 演示实例可在`nethsmdemo.nitrokey.com<https://nethsmdemo.nitrokey.com/api/v1/info>`_ 上获得。它将每八小时重置一次（欧洲中部时间 6:00、14:00、22:00）。用户名 “admin”，密码 “adminadmin”，解锁密码 “unlockunlock”。

另外，你也可以将NetHSM作为一个`Docker容器<https://hub.docker.com/r/nitrokey/nethsm>`_ ，在本地运行。

容器可以按以下方式执行。

$ sudo docker run --rm -ti -p8443:8443 nitrokey/nethsm:testing

这将在容器内以 Unix 进程的形式运行 NetHSM，并通过 HTTPS 协议在端口 8443 上公开 REST API。

除了作为 Unix 进程运行 NetHSM 外，它还可以作为 KVM 支持的单内核运行。

容器可以按以下方式执行。

$ docker run -ti --rm -p 8443:8443 --device /dev/net/tun --device /dev/kvm --cap-add=NET_ADMIN nitrokey/nethsm:testing

这将在 KVM 虚拟机中以单内核方式运行 NetHSM。容器将通过 HTTPS 协议，在 IP 地址为 192.168.1.100、端口为 8443 的接口 “tap200 “上公开 REST API。

重要

容器使用一个自签的TLS证书。请确保使用正确的连接设置来建立连接。请参考`NetHSM介绍<index.html>`__一章，了解更多信息。

集成到自定义应用程序中#

要将 NetHSM 集成到自己的定制应用程序中，几乎所有编程语言都有客户端库。以下是`Python<https://github.com/Nitrokey/nethsm-sdk-py>`_ 和`Rust<https://github.com/Nitrokey/nethsm-sdk-rs>`_ 以及`这个第三方 Rust crate<https://crates.io/crates/nethsm>`_ 的库。对于所有其他编程语言，我们建议使用`OpenAPI Generator<https://github.com/OpenAPITools/openapi-generator>`_ 。

所有可用语言的列表可按如下方式检索。

$ docker run --rm -ti openapitools/openapi-generator-cli list -i stable

可以为你的编程语言生成NetHSM客户端，如下所示。

$ docker run --rm -ti -v "${PWD}/out:/out" openapitools/openapi-generator-cli generate -i=https://nethsmdemo.nitrokey.com/api_docs/nethsm-api.yaml -o out -g javascript

生成的客户端代码，在本例中为JavaScript，将在``./out/``目录下创建。这个文件夹也包含了如何使用它的必要文档。

重要

如果Podman与执行SELinux一起使用，可能需要对卷挂载进行标注。SELinux的模式可以用``sestatus |grep “Current mode”请求。如果模式被设置为``enforcing，则需要对上下文进行更改。在这种情况下，卷挂载必须用``:z``后缀，结果是``-v “${PWD}/out:/out:z”``。

命令行界面#

用户可使用专用命令行界面 (CLI) 管理和使用 NetHSM。Nitrokey 提供``nitropy``，它发布在基于 Python 的`pynitrokey<https://pypi.org/project/pynitrokey/>`_ 中。nethsm 还有一个第三方应用程序，它是在 Rust crate`nethsm-cli<https://crates.io/crates/nethsm-cli/>`_ 中开发的。