AWS CloudHSM 用戶端 SDK 3 組態範例 - AWS CloudHSM

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AWS CloudHSM 用戶端 SDK 3 組態範例

這些範例示範如何使用適用於 AWS CloudHSM 用戶端 3 SDK configure的工具。

範例 :更新 AWS CloudHSM 用戶端和 key_mgmt_util HSM的資料

此範例使用 -a 參數configure來更新 AWS CloudHSM 用戶端和 key_mgmt_util HSM的資料。若要使用 -a 參數,您必須擁有叢集HSMs中其中一個 的 IP 地址。使用 主控台或 AWSCLI來取得 IP 地址。

取得 HSM(主控台) 的 IP 地址
  1. https://console.aws.amazon.com/cloudhsm/在家中開啟 AWS CloudHSM 主控台。

  2. 若要變更 AWS 區域,請使用頁面右上角的區域選取器。

  3. 若要開啟叢集詳細資訊頁面,請在叢集表格中選擇叢集 ID。

  4. 若要取得 IP 地址,請前往 HSMs索引標籤。對於IPv4叢集,請選擇地址下列出的ENIIPv4地址。對於雙堆疊叢集,請使用 ENIIPv4或ENIIPv6地址地址。

取得 HSM(AWS CLI) 的 IP 地址
  • HSM 使用 describe-clusters命令,從 取得 的 IP 地址 AWS CLI。在 命令的輸出中, 的 IP 地址HSMs是 EniIp和 的值 EniIpV6(如果是雙堆疊叢集)。

    $ aws cloudhsmv2 describe-clusters { "Clusters": [ { ... } "Hsms": [ { ... "EniIp": "10.0.0.9", ... }, { ... "EniIp": "10.0.1.6", "EniIpV6": "2600:113f:404:be09:310e:ed34:3412:f733", ...
更新HSM資料
  1. 更新 -a 參數之前,請先停止 AWS CloudHSM 用戶端。這可防止在 configure 編輯用戶端的組態檔案時可能發生的衝突。如果用戶端已停止,而此命令不會帶來任何影響,因此您可以在指令碼中使用它。

    Amazon Linux
    $ sudo stop cloudhsm-client
    Amazon Linux 2
    $ sudo service cloudhsm-client stop
    CentOS 7
    $ sudo service cloudhsm-client stop
    CentOS 8
    $ sudo service cloudhsm-client stop
    RHEL 7
    $ sudo service cloudhsm-client stop
    RHEL 8
    $ sudo service cloudhsm-client stop
    Ubuntu 16.04 LTS
    $ sudo service cloudhsm-client stop
    Ubuntu 18.04 LTS
    $ sudo service cloudhsm-client stop
    Windows
    • 用於 Windows 用戶端 1.1.2+:

      C:\Program Files\Amazon\CloudHSM>net.exe stop AWSCloudHSMClient
    • 用於 Windows 用戶端 1.1.1 和更早版本:

      在您啟動 AWS CloudHSM 用戶端的命令視窗中使用 CtrlC

  2. 此步驟使用 -a 參數configure10.0.0.9 ENI IP 地址新增至組態檔案。

    Amazon Linux
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    Amazon Linux 2
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    CentOS 7
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    CentOS 8
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    RHEL 7
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    RHEL 8
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    Ubuntu 16.04 LTS
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    Ubuntu 18.04 LTS
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe -a 10.0.0.9
  3. 接著,重新啟動 AWS CloudHSM 用戶端。當用戶端啟動時,它會使用其組態檔案中的 ENI IP 地址來查詢叢集。然後,它會將叢集HSMs中所有 的 ENI IP 地址寫入 cluster.info 檔案。

    Amazon Linux
    $ sudo start cloudhsm-client
    Amazon Linux 2
    $ sudo service cloudhsm-client start
    CentOS 7
    $ sudo service cloudhsm-client start
    CentOS 8
    $ sudo service cloudhsm-client start
    RHEL 7
    $ sudo service cloudhsm-client start
    RHEL 8
    $ sudo service cloudhsm-client start
    Ubuntu 16.04 LTS
    $ sudo service cloudhsm-client start
    Ubuntu 18.04 LTS
    $ sudo service cloudhsm-client start
    Windows
    • 用於 Windows 用戶端 1.1.2+:

      C:\Program Files\Amazon\CloudHSM>net.exe start AWSCloudHSMClient
    • 用於 Windows 用戶端 1.1.1 和更早版本:

      C:\Program Files\Amazon\CloudHSM>start "cloudhsm_client" cloudhsm_client.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_client.cfg

    當命令完成時, AWS CloudHSM 用戶端和 key_mgmt_util 使用HSM的資料完整且準確。

範例 :CMU從用戶端 3.2.1 SDK 及更早版本更新 HSM的資料

此範例使用 -mconfigure命令,將更新HSM的資料從 cluster.info 檔案複製到 cloudhsm_mgmt_util 使用cloudhsm_mgmt_util.cfg的檔案。搭配 用戶端 3.2.1 SDK 及更早CMU版本隨附的 使用。

  • 在執行 之前-m,請停止 AWS CloudHSM 用戶端、執行 -a命令,然後重新啟動 AWS CloudHSM 用戶端,如上一個範例所示。這可確保從 cluster.info 檔案複製到 cloudhsm_mgmt_util.cfg 檔案的資料既完整且準確。

    Linux
    $ sudo /opt/cloudhsm/bin/configure -m
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe -m
範例 :CMU從用戶端 3.3.0 SDK 及更新版本更新 HSM 的資料

此範例使用 configure命令的 --cmu 參數來更新 HSM的資料CMU。搭配 Client 3.3.0 SDK 及更新版本CMU隨附的 使用。如需使用 的詳細資訊CMU,請參閱使用雲端HSM管理公用程式 (CMU) 管理使用者,以及CMU搭配用戶端 3.2.1 SDK 和更早版本使用 。

  • 使用 --cmu 參數傳遞叢集HSM中 的 IP 地址。

    Linux
    $ sudo /opt/cloudhsm/bin/configure --cmu <IP address>
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe --cmu <IP address>