本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
用戶端 SDK 3 設定工具
使用 Client SDK 3 設定工具啟動用戶端精靈並設定「雲端HSM管理公用程式」。
語法
configure -h | --help -a
<ENI IP address>
-m [-i<daemon_id>
] --ssl --pkey<private key file>
--cert<certificate file>
--cmu<ENI IP address>
範例
這些範例會示範如何使用 configure 工具。
範例 :更新用 AWS CloudHSM 戶端和金鑰的HSM資料
此範例使用的-a
參數configure來更新用 AWS CloudHSM 戶端和 key_mgmt_util 的HSM資料。若要使用-a
參數,您必須擁有叢集中其中一個HSMs的 IP 位址。使用主控台或AWSCLI取得 IP 位址。
取得 HSM (主控台) 的 IP 位址
請在https://console.aws.amazon.com/cloudhsm/家
中開啟 AWS CloudHSM 主機。 -
若要變更「AWS地區」,請使用頁面右上角的「地區」選取器。
-
若要開啟叢集詳細資訊頁面,請在叢集表格中選擇叢集 ID。
-
若要取得 IP 位址,請在HSMs索引標籤上,選擇 IP 位址下列出的其中一個 ENIIP 位址。
若要取得 HSM (AWS CLI) 的 IP 位址
-
使用來自的describe-clusters命令取得的 IP 位址 AWS CLI。HSM在命令的輸出中,的 IP 位址HSMs是的值
EniIp
。$
aws cloudhsmv2 describe-clusters
{ "Clusters": [ { ... } "Hsms": [ { ... "EniIp": "10.0.0.9", ... }, { ... "EniIp": "10.0.1.6", ...
若要更新資HSM料
-
更新
-a
參數之前,請停止用 AWS CloudHSM 戶端。這可防止在 configure 編輯用戶端的組態檔案時可能發生的衝突。如果用戶端已停止,而此命令不會帶來任何影響,因此您可以在指令碼中使用它。 -
此步驟會使用的
-a
參數configure將10.0.0.9
ENI IP 位址新增至組態檔案。 -
接下來,重新啟動 AWS CloudHSM 用戶端。用戶端啟動時,會使用其組態檔案中的 ENI IP 位址來查詢叢集。然後,它會將叢集HSMs中所有項目的 ENI IP 位址寫入
cluster.info
檔案。當命令完成時, AWS CloudHSM 用戶端和 key_mgmt_util 所使用的HSM資料是完整且正確的。
範例 :更新用戶端 SDK 3.2.1 及更早版本的HSM資料 CMU
此範例會使用指-m
configure令,將更新的HSM資料從cluster.info
檔案複製到 cloudhsm_mgmt_util 所使用的cloudhsm_mgmt_util.cfg
檔案。與客戶端 SDK 3.2.1 及更早版本CMU一起使用此功能。
-
執行之前
-m
,請停止用 AWS CloudHSM 戶端、執行-a
命令,然後重新啟動 AWS CloudHSM 用戶端,如前面的範例所示。這可確保從cluster.info
檔案複製到cloudhsm_mgmt_util.cfg
檔案的資料既完整且準確。
範例 :CMU從用戶端 SDK 3.3.0 及更新版本更新的HSM資料
此範例使用configure指令的--cmu
參數來更新HSM資料CMU。使用CMU它與客戶端 SDK 3.3.0 及更高版本一起提供。如需有關使用的詳細資訊CMU,請參閱使用雲端HSM管理公用程式 (CMU) 管理使用者和CMU搭配用戶端 SDK 3.2.1 和更早版本搭配使用。
-
使用
--cmu
參數傳遞叢集HSM中的 IP 位址。
參數
- -h | --help
-
顯示命令的語法。
必要:是
- -a
<ENI IP address>
-
將指定的 HSM elastic network interface (ENI) IP 位址新增至 AWS CloudHSM 組態檔。輸入叢集中任何一個HSMs的 ENI IP 位址。選擇哪一個都可以。
若要取得叢集HSMs中的 ENI IP 位址,請使用DescribeClusters作業、描述叢集命令或 AWS CLI 指令程式。Get-HSM2Cluster PowerShell
注意
執行
-a
configure命令之前,請先停止用 AWS CloudHSM 戶端。然後,當-a
命令完成時,重新啟動用 AWS CloudHSM 戶端。如需詳細資訊,請參閱範例。此參數會編輯以下組態檔案:
-
/opt/cloudhsm/etc/cloudhsm_client.cfg
:由用 AWS CloudHSM 戶端和密鑰使用。 -
/opt/cloudhsm/etc/cloudhsm_mgmt_util.cfg
:由 cloudhsm_mgmt_util 使用。
當用 AWS CloudHSM 戶端啟動時,它會使用其組態檔案中的 ENI IP 位址來查詢叢集,並使用叢集HSMs中所有項目的正確 ENI IP 位址更新
cluster.info
檔案 (/opt/cloudhsm/daemon/1/cluster.info
)。必要:是
-
- -m
-
更新使CMU用的組態檔中的 HSM ENI IP 位址。
注意
此
-m
參數適用於用戶端 SDK 3.2.1 及更早版本的用戶端。CMU對於CMU客戶端 SDK 3.3.0 及更高版本,請--cmu
參閱參數,該參數簡化了更新HSM. CMU當您更新的
-a
參數configure並啟動用戶端時, AWS CloudHSM 用戶端精靈會查詢叢集,並使用叢集HSMs中所有項目的正確 HSM IP 位址更新cluster.info
檔案。執行命-m
configure令會將 HSM IP 位址從複製到 cloudhsm_mgmt_utilcluster.info
使用的cloudhsm_mgmt_util.cfg
組態檔,以完成更新。執行
-a
configure命令之前,請務必執行命令並重新啟動 AWS CloudHSM 用戶端。-m
這可確保從cluster.info
複製到cloudhsm_mgmt_util.cfg
檔案的資料既完整且準確。必要:是
- -i
-
指定替代的用戶端常駐程式。預設值代表 AWS CloudHSM 用戶端。
預設:
1
必要:否
- --ssl
-
以指定的私SSL密金鑰和憑證取代叢集的金鑰和憑證。使用此參數時,需要
--pkey
和--cert
參數。必要:否
- --pkey
-
指定新的私有金鑰。輸入包含私有金鑰之檔案的路徑和名稱。
必要:如果指定的是 -ssl,則為是。否則不應使用此項目。
- --cert
-
指定新的憑證。輸入包含憑證之檔案的路徑和名稱。此憑證應會鏈結至
customerCA.crt
憑證,即用於初始化叢集的自簽憑證。如需詳細資訊,請參閱初始化叢集。必要:如果指定的是 -ssl,則為是。否則不應使用此項目。
- -CMU
<ENI IP address>
-
將
-a
和-m
參數合併為一個參數。將指定的 elastic HSM network interface (ENI) IP 位址新增至 AWS CloudHSM 組態檔,然後更新CMU組態檔案。輸入叢集HSM中任何一個 IP 位址。對於用戶端 SDK 3.2.1 及更早版本,請參閱CMU與用戶端 SDK 3.2.1 及更早版本搭配使用。必要:是