syncKey

cloudhsm_mgmt_util の syncKey コマンドを使用して、クラスター内、または、クローンクラスター間の HSM インスタンス間でキーを手動で同期することができます。通常、クラスター内の HSM インスタンスは自動的にキーを同期させるため、このコマンドを使用する必要はありません。ただし、クローン複製されたクラスター間でキーを同期する場合は、手動で実行する必要があります。クローンされたクラスターは通常、グローバルスケーリングとディザスタリカバリのプロセスを簡素化するために、異なる AWS リージョンに作成されます。

syncKey を使用して、任意のクラスター間でキーを同期させることはできません。クラスターの 1 つは、他のクラスターのバックアップから作成する必要があります。さらに、オペレーションが成功するように、両方のクラスターの CO および CU の認証情報が一致している必要があります。詳細については、「HSM ユーザー」を参照してください。

を使用するにはsyncKey、まずソースクラスターから 1 つの HSM を指定し、宛先クラスターから 1 つの HSM を指定するAWS CloudHSM 設定ファイルを作成する必要があります。これにより、cloudhsm_mgmt_util は両方の HSM インスタンスに接続することができます。cloudhsm_mgmt_util を起動するには、この設定を使用します。。次に、同期させるキーを所有する CO または CU の認証情報を使用して、ログインします。

ユーザーのタイプ

このコマンドは、次のタイプのユーザーが実行できます。

• Crypto Officer (CO)

• Crypto User (CU)

注記

CO は、任意のキーの syncKey を使用できますが、CU は、所有するキーでのみこのコマンドを使用できます。詳細については、「HSM ユーザーを理解する」を参照してください。

前提条件

開始する前に、送信先の HSM と同期する送信元 HSM のキーの key handle を把握しておく必要があります。key handle を検索するには、listUsers コマンドを使用して、名前付きユーザーのすべての識別子を表示します。次に、 findAllKeys コマンドを使用して、特定のユーザーに属するすべてのキーを検索します。

また、cloudhsm_mgmt_util が開始時に返すトレース出力に表示される、出典とデスティネーションの HSM に割り当てられた server IDs も知っておく必要があります。これらは、設定ファイルに表示されている HSM と同じ順序で表示されます。

「クローンされたクラスター間で CMU を使用する」の手順に従って、新しい設定ファイルでcloudhsm_mgmt_util を初期化します。続いて、server コマンドを発行して、送信元 HSM のサーバーモードを入力します。

構文

注記

syncKey を実行するには、まず HSM のサーバーモードを入力します。これには、同期されるキーが含まれます。

このコマンドには名前付きパラメータがないため、引数は図表で指定された順序で入力する必要があります。

ユーザータイプ: Crypto user (CU)

syncKey <key handle> <destination hsm>

例

server コマンドを実行して、送信元 HSM にログインし、サーバーモードを入力します。この例では、server 0 が送信元 HSM であると仮定しています。

aws-cloudhsm> server 0

ここで、syncKey コマンドを実行します。この例では、キー 261251 が、server 1 に同期されると仮定しています。

aws-cloudhsm> syncKey 261251 1
syncKey success

引数

このコマンドには名前付きパラメータがないため、引数は図表で指定された順序で入力する必要があります。

syncKey <key handle> <destination hsm>

<key handle>

同期させるキーのキーハンドルを指定します。各コマンドに指定できるキーは 1 つのみです。キーのキーハンドルを取得するには、HSM サーバーにログインfindAllKeysしているときに を使用します。

必須：はい

<destination hsm>

キーを同期しているサーバーの数を指定します。

必須: はい

関連トピック

• listUsers

• findAllKeys

• のクラスターを記述する AWS CLI

• サーバー