CloudHSM 管理ユーティリティ (CMU) を使用したユーザーの管理 - AWS CloudHSM

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CloudHSM 管理ユーティリティ (CMU) を使用したユーザーの管理

このトピックでは、クライアント SDK に付属するコマンドラインツールである CloudHSM 管理ユーティリティ (CMU) を使用して、ハードウェアセキュリティモジュール (HSM) ユーザーを管理する step-by-step 方法について説明します。CMU または HSM ユーザーの詳細情報は、CloudHSM 管理ユーティリティHSM ユーザーを理解する を参照してください。

CMU を使用した HSM ユーザー管理について

HSM ユーザーを管理するには、暗号化オフィサー (CO) のユーザー名とパスワードを使用して HSM にログインする必要があります。CO のみユーザーを管理できます。HSM には、admin という名前のデフォルト CO が含まれています。admin クラスターのアクティブ化 の際に必要なパスワードを設定しました。

CMU を使用する場合、設定ツールでローカル設定を更新する必要があります。CMU はクラスターへの独自の接続を作成しますが、この接続はクラスターを 認識しません。クラスター情報を追跡するため、CMU はローカル設定ファイルを保持します。これは、毎回 CMU を使用する際、まず、--cmu パラメータを指定して 設定 コマンドラインツールを実行し、設定ファイルを更新する必要があります。Client SDK 3.2.1 以前のバージョンを使用している場合、--cmu とは異なるパラメータを使用する必要があります。詳細については、「Client SDK 3.2.1 以前のバージョンでの CMU の使用」を参照してください。

--cmu パラメータには、クラスター内の HSM の IP アドレスを追加する必要があります。複数の HSM をお持ちの方は、任意の IP アドレスを使用できます。これで確実に CMU がクラスター全体に加えた変更を伝播できます。CMU はローカルファイルを使用してクラスター情報を追跡することに注意してください。特定のホストから CMU を最後に使用後にクラスターが変更されている場合、該当するホストに保存されているローカル設定ファイルにそれらの変更を追加する必要があります。CMU の使用中に HSM を追加または削除しないでください。

HSM の IP アドレスを取得するには (コンソール)
  1. https://console.aws.amazon.com/cloudhsm/home で AWS CloudHSM コンソールを開きます。

  2. AWS リージョンを変更するには、ページの右上隅にあるリージョンセレクターを使用します。

  3. クラスターの詳細ページを開くには、クラスターテーブルでクラスター ID を選択します。

  4. IP アドレスを取得するには、[HSM] タブで、[ENI IP アドレス] にリストされている IP アドレスのいずれかを選択します。

HSM の IP アドレスを取得するには (AWS CLI)
  • describe-clusters から AWS CLIコマンドを実行して、HSM の IP アドレスを取得します。コマンドの出力では、HSM の IP アドレスは EniIp の値です。

    $ aws cloudhsmv2 describe-clusters { "Clusters": [ { ... } "Hsms": [ { ... "EniIp": "10.0.0.9", ... }, { ... "EniIp": "10.0.1.6", ...

Client SDK 3.2.1 以前のバージョンでの CMU の使用

Client SDK 3.3.0 では、 --cmuパラメータのサポート AWS CloudHSM が追加されました。これにより、CMU の設定ファイルを更新するプロセスが簡素化されます。Client SDK 3.2.1 以前のバージョンの CMU を使用している場合は、-a-m パラメータを引き続き使用して設定ファイルを更新する必要があります。パラメータの詳細情報は、設定ツール を参照してください。

CloudHSM 管理ユーティリティのダウンロード

Client SDK 5 および Client SDK 3 の使用の有無を問わず、 HSM ユーザー管理タスクで最新バージョンの CMU を使用できます。

CMU のダウンロードおよびインストール
  • CMU をダウンロードおよびインストールします。

    Amazon Linux
    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL6/cloudhsm-mgmt-util-latest.el6.x86_64.rpm
    $ sudo yum install ./cloudhsm-mgmt-util-latest.el6.x86_64.rpm
    Amazon Linux 2
    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-mgmt-util-latest.el7.x86_64.rpm
    $ sudo yum install ./cloudhsm-mgmt-util-latest.el7.x86_64.rpm
    CentOS 7.8+
    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-mgmt-util-latest.el7.x86_64.rpm
    $ sudo yum install ./cloudhsm-mgmt-util-latest.el7.x86_64.rpm
    CentOS 8.3+
    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL8/cloudhsm-mgmt-util-latest.el8.x86_64.rpm
    $ sudo yum install ./cloudhsm-mgmt-util-latest.el8.x86_64.rpm
    RHEL 7 (7.8+)
    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-mgmt-util-latest.el7.x86_64.rpm
    $ sudo yum install ./cloudhsm-mgmt-util-latest.el7.x86_64.rpm
    RHEL 8 (8.3+)
    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL8/cloudhsm-mgmt-util-latest.el8.x86_64.rpm
    $ sudo yum install ./cloudhsm-mgmt-util-latest.el8.x86_64.rpm
    Ubuntu 16.04 LTS
    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Xenial/cloudhsm-mgmt-util_latest_amd64.deb
    $ sudo apt install ./cloudhsm-mgmt-util_latest_amd64.deb
    Ubuntu 18.04 LTS
    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Bionic/cloudhsm-mgmt-util_latest_u18.04_amd64.deb
    $ sudo apt install ./cloudhsm-mgmt-util_latest_u18.04_amd64.deb
    Windows Server 2012
    1. CloudHSM 管理ユーティリティ をダウンロードします。

    2. Windows 管理権限を持つ CMU インストーラ (AWSCloudHSMManagementUtil-latest.msi) を実行します。

    Windows Server 2012 R2
    1. CloudHSM 管理ユーティリティ をダウンロードします。

    2. Windows 管理権限を持つ CMU インストーラ (AWSCloudHSMManagementUtil-latest.msi) を実行します。

    Windows Server 2016
    1. CloudHSM 管理ユーティリティ をダウンロードします。

    2. Windows 管理権限を持つ CMU インストーラ (AWSCloudHSMManagementUtil-latest.msi) を実行します。

CMU で HSM ユーザーを管理する方法

このセクションでは、CMU を使用した HSM ユーザーを管理用の基本的なコマンドについて説明します。

HSM に createUser を使用して新しいユーザーを作成します。ユーザーを作成する場合、CO としてログインする必要があります。

新しい CO ユーザーの作成
  1. 設定ツールで CMU 設定を更新します。

    Linux
    $ sudo /opt/cloudhsm/bin/configure --cmu <IP address>
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe --cmu <IP address>
  2. CMU を開始します。

    Linux
    $ /opt/cloudhsm/bin/cloudhsm_mgmt_util /opt/cloudhsm/etc/cloudhsm_mgmt_util.cfg
    Windows
    C:\Program Files\Amazon\CloudHSM> .\cloudhsm_mgmt_util.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_mgmt_util.cfg
  3. CO ユーザーとして HSM にログインします。

    aws-cloudhsm>loginHSM CO admin co12345

    接続 CMU リストの数が、クラスター内の HSM 数と一致していることを確認します。一致しない場合、ログアウトして最初からやり直してください。

  4. createUser を使用して、 パスワードを example_officer に設定して password1 という CO ユーザーを作成します。

    aws-cloudhsm>createUser CO example_officer password1

    CMU は、ユーザーの作成オペレーションについてプロンプトを表示します。

    *************************CAUTION******************************** This is a CRITICAL operation, should be done on all nodes in the cluster. AWS does NOT synchronize these changes automatically 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)?
  5. タイプ y

新しい CU ユーザーの作成
  1. 設定ツールで CMU 設定を更新します。

    Linux
    $ sudo /opt/cloudhsm/bin/configure --cmu <IP address>
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe --cmu <IP address>
  2. CMU を開始します。

    Linux
    $ /opt/cloudhsm/bin/cloudhsm_mgmt_util /opt/cloudhsm/etc/cloudhsm_mgmt_util.cfg
    Windows
    C:\Program Files\Amazon\CloudHSM> .\cloudhsm_mgmt_util.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_mgmt_util.cfg
  3. CO ユーザーとして HSM にログインします。

    aws-cloudhsm>loginHSM CO admin co12345

    接続 CMU リストの数が、クラスター内の HSM 数と一致していることを確認します。一致しない場合、ログアウトして最初からやり直してください。

  4. createUser を使用して、example_user という CU ユーザーをパスワードは password1 で作成します。

    aws-cloudhsm>createUser CU example_user password1

    CMU は、ユーザーの作成オペレーションについてプロンプトを表示します。

    *************************CAUTION******************************** This is a CRITICAL operation, should be done on all nodes in the cluster. AWS does NOT synchronize these changes automatically 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)?
  5. タイプ y

createUser の詳細情報は、createUser を参照してください。

listUsers コマンドを使用して、クラスター上のすべてのユーザーを一覧表示します。listUsers を実行する際、ログインは不要であり、すべてのユーザータイプでユーザーをリストアップできます。

クラスター上のすべてのユーザーを一覧表示
  1. 設定ツールで CMU 設定を更新します。

    Linux
    $ sudo /opt/cloudhsm/bin/configure --cmu <IP address>
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe --cmu <IP address>
  2. CMU を開始します。

    Linux
    $ /opt/cloudhsm/bin/cloudhsm_mgmt_util /opt/cloudhsm/etc/cloudhsm_mgmt_util.cfg
    Windows
    C:\Program Files\Amazon\CloudHSM> .\cloudhsm_mgmt_util.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_mgmt_util.cfg
  3. listUsers を使用して、クラスター上のすべてのユーザーを一覧表示します。

    aws-cloudhsm>listUsers

    CMU は、クラスター上のすべてのユーザーを一覧表示します。

    Users on server 0(10.0.2.9): Number of users found:4 User Id User Type User Name MofnPubKey LoginFailureCnt 2FA 1 AU app_user NO 0 NO 2 CO example_officer NO 0 NO 3 CU example_user NO 0 NO Users on server 1(10.0.3.11): Number of users found:4 User Id User Type User Name MofnPubKey LoginFailureCnt 2FA 1 AU app_user NO 0 NO 2 CO example_officer NO 0 NO 3 CU example_user NO 0 NO Users on server 2(10.0.1.12): Number of users found:4 User Id User Type User Name MofnPubKey LoginFailureCnt 2FA 1 AU app_user NO 0 NO 2 CO example_officer NO 0 NO 3 CU example_user NO 0 NO

listUsers の詳細情報は、listUsers を参照してください。

changePswd を使用してパスワードを変更します。

ユーザータイプとパスワードは大文字と小文字が区別されますが、ユーザー名では区別されません。

暗号化ユーザー (CU) とアプライアンスユーザー (AU) は、自分のパスワードのみ変更できます。別のユーザーのパスワードを変更する場合、CO としてログインする必要があります。ただし、現在ログインしているユーザーのパスワードを変更することはできません。

自分のパスワードの変更
  1. 設定ツールで CMU 設定を更新します。

    Linux
    $ sudo /opt/cloudhsm/bin/configure --cmu <IP address>
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe --cmu <IP address>
  2. CMU を開始します。

    Linux
    $ /opt/cloudhsm/bin/cloudhsm_mgmt_util /opt/cloudhsm/etc/cloudhsm_mgmt_util.cfg
    Windows
    C:\Program Files\Amazon\CloudHSM> .\cloudhsm_mgmt_util.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_mgmt_util.cfg
  3. HSM へログインします。

    aws-cloudhsm>loginHSM CO admin co12345

    接続 CMU リストの数が、クラスター内の HSM 数と一致していることを確認します。一致しない場合、ログアウトして最初からやり直してください。

  4. changePswd を使用してユーザー自身のパスワードを変更します。

    aws-cloudhsm>changePswd CO example_officer <new password>

    CMU は、パスワードの変更オペレーションについてプロンプトを表示します。

    *************************CAUTION******************************** This is a CRITICAL operation, should be done on all nodes in the cluster. AWS does NOT synchronize these changes automatically 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)?
  5. タイプ y

    CMU は、パスワードの変更オペレーションについてプロンプトを表示します。

    Changing password for example_officer(CO) on 3 nodes
別のユーザーのパスワードの変更
  1. 設定ツールで CMU 設定を更新します。

    Linux
    $ sudo /opt/cloudhsm/bin/configure --cmu <IP address>
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe --cmu <IP address>
  2. CMU を開始します。

    Linux
    $ /opt/cloudhsm/bin/cloudhsm_mgmt_util /opt/cloudhsm/etc/cloudhsm_mgmt_util.cfg
    Windows
    C:\Program Files\Amazon\CloudHSM> .\cloudhsm_mgmt_util.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_mgmt_util.cfg
  3. CO ユーザーとして HSM にログインします。

    aws-cloudhsm>loginHSM CO admin co12345

    接続 CMU リストの数が、クラスター内の HSM 数と一致していることを確認します。一致しない場合、ログアウトして最初からやり直してください。

  4. changePswd を使用して別のユーザーのパスワードを変更します。

    aws-cloudhsm>changePswd CU example_user <new password>

    CMU は、パスワードの変更オペレーションについてプロンプトを表示します。

    *************************CAUTION******************************** This is a CRITICAL operation, should be done on all nodes in the cluster. AWS does NOT synchronize these changes automatically 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)?
  5. タイプ y

    CMU は、パスワードの変更オペレーションについてプロンプトを表示します。

    Changing password for example_user(CU) on 3 nodes

changePswd の詳細情報は、[パスワードの変更] を参照してください。

deleteUser を使用してユーザーを削除します。別のユーザーを削除する場合、CO としてログインする必要があります。

ヒント

キーを所有している暗号化ユーザー (CU) を削除することはできません。

ユーザーの削除
  1. 設定ツールで CMU 設定を更新します。

    Linux
    $ sudo /opt/cloudhsm/bin/configure --cmu <IP address>
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe --cmu <IP address>
  2. CMU を開始します。

    Linux
    $ /opt/cloudhsm/bin/cloudhsm_mgmt_util /opt/cloudhsm/etc/cloudhsm_mgmt_util.cfg
    Windows
    C:\Program Files\Amazon\CloudHSM> .\cloudhsm_mgmt_util.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_mgmt_util.cfg
  3. CO ユーザーとして HSM にログインします。

    aws-cloudhsm>loginHSM CO admin co12345

    接続 CMU リストの数が、クラスター内の HSM 数と一致していることを確認します。一致しない場合、ログアウトして最初からやり直してください。

  4. deleteUser を使用してユーザーを削除します。

    aws-cloudhsm>deleteUser CO example_officer

    CMU がユーザーを削除します。

    Deleting user example_officer(CO) on 3 nodes deleteUser success on server 0(10.0.2.9) deleteUser success on server 1(10.0.3.11) deleteUser success on server 2(10.0.1.12)

deleteUser の詳細情報は、deleteUser を参照してください。