すべてのプロダクト
Search
ドキュメントセンター

Key Management Service:shareKey

最終更新日:Jan 03, 2025

このトピックでは、他のユーザーとキーを共有したり、キーの共有を取り消したりするためのshareKeyコマンドの使用について説明します。

説明

共有キーコマンドを使用すると、キー所有者は他のユーザーとキーを共有したり、既存のキー共有を取り消したりできます。 キー共有は、キー作成中に実行することもできる。

重要

hsm_mgmt_toolを起動し、HSMにログオンし、実行する前にユーザータイプがこのコマンドを実行する権限を与えられていることを確認します。

ユーザータイプ

次のユーザータイプでこのコマンドを実行できます。 ユーザータイプの説明については、「HSMユーザー権限テーブル」をご参照ください。

  • 暗号化ユーザー (CU)

構文

以下の構文で指定したパラメーターを入力します。 詳細については、「パラメーター」をご参照ください。

shareKey <key handle> <user id> <(share/unshare key?) 1/0>
重要

パラメーターは、構文で概説されている順序で入力する必要があります。

  1. listUsersコマンドでHSMユーザーを一覧表示します。

    cloudmgmt>listUsers
    Users on server 0(172.16.0.2):
    Number of users found:4
    
        User Id    		User Type      	User Name      			   MofnPubKey  	 LoginFailureCnt       	 2FA
             1     		CO     		admin                                  	 NO               0    	       	  NO
             2     		AU     		app_user                               	 NO               0    	       	  NO
             3     		CU     		crypto_user                            	 NO               0    	       	  NO
             4     		CU     		crypto_user1                           	 NO               0    	       	  NO
  2. loginHSMコマンドを使用して、暗号ユーザーとしてHSMにログインします。

    cloudmgmt>loginHSM CU crypto_user user123
    loginHSM success on server 0(172.16.0.2)
  3. 暗号化ユーザー間の共有キー6 crypto_userとcrypto_user1 (ユーザーID 4) 。

    cloudmgmt>shareKey 6 4 1
    *************************CAUTION********************************
    This is a CRITICAL operation, should be done on all nodes in the
    cluster. Cav server does NOT synchronize these changes with the
    nodes on which this operation is not executed or failed, please
    ensure this operation is executed on all nodes in the cluster.
    ****************************************************************
    
    Do you want to continue(y/n)?y
    shareKey success on server 0(172.16.0.2)

Parameters

パラメーター名

説明

必須 / 任意

有効値

<キーハンドル>

キーハンドル

対象

特別な要件なし

<ユーザーid>

User ID

対象

特別な要件なし

<(共有 /共有解除キー?) 1/0>

キーが共有されているか

対象

  • 1共有キー

  • 0共有解除