CloudHSM CLI を使用してクォーラムトークンを生成する - AWS CloudHSM

CloudHSM CLI を使用してクォーラムトークンを生成する

CloudHSM CLI の quorum token-sign generate コマンドを使用して、クォーラム承認サービスのトークンを生成します。

サービスユーザーとクォーラムの HSM クラスターでは、サービスごとに 1 ユーザーにつき 1 つのアクティブトークンを取得することには制限があります。

注記

サービストークンを生成できるのは管理者のみです。

管理サービス: クォーラム認証は、ユーザーの作成、ユーザーの削除、ユーザーパスワードの変更、クォーラム値の設定、クォーラム機能と MFA 機能の無効化などの管理者権限を持つサービスに使用されます。

各サービスタイプはさらに適格なサービス名に分類されます。このサービス名には、実行可能なクォーラムがサポートする特定のサービスオペレーションのセットが含まれます。

サービス名 サービスタイプ サービスオペレーション
ユーザー 管理
  • user create

  • user delete

  • user change-password

  • user change-mfa

quorum 管理
  • quorum token-sign set-quorum-value

cluster1 管理
  • cluster mtls register-trust-anchor

  • cluster mtls deregister-trust-anchor

  • cluster mtls set-enforcement

[1] クラスターサービスは hsm2m.medium でのみ利用できます

ユーザーのタイプ

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

  • 管理

  • Crypto User (CU)

Syntax

aws-cloudhsm > help quorum token-sign generate Generate a token Usage: quorum token-sign generate --service <SERVICE> --token <TOKEN> Options: --cluster-id <CLUSTER_ID> Unique Id to choose which of the clusters in the config file to run the operation against. If not provided, will fall back to the value provided when interactive mode was started, or error --service <SERVICE> Service the token will be used for Possible values: - user: User management service is used for executing quorum authenticated user management operations - quorum: Quorum management service is used for setting quorum values for any quorum service - cluster: Cluster management service is used for executing quorum for cluster wide configuration managements like mtls enforcement, mtls registration and mtls deregistration - registration: Registration service is used for registering a public key for quorum authentication --token <TOKEN> Filepath where the unsigned token file will be written -h, --help Print help

このコマンドは、クラスター内の HSM ごとに 1 つの未署名トークンを token で指定されたファイルに書き込みます。

例 : クラスターの HSM ごとに 1 つの署名なしトークンを書き込みます
aws-cloudhsm > quorum token-sign generate --service user --token /home/tfile { "error_code": 0, "data": { "filepath": "/home/tfile" } }

引数

<CLUSTER_ID>

このオペレーションを実行するクラスターの ID。

必須: 複数のクラスターが設定されている場合。

<SERVICE>

トークンを生成するには、クォーラム承認サービスを指定します。このパラメータは必須です。

有効な値

  • ユーザー:クォーラム承認ユーザー管理オペレーションの実行に使用されるユーザー管理サービス。

  • クォーラム: すべてのクォーラム承認サービスのクォーラム承認クォーラム値を設定するために使用されるクォーラム管理サービス。

  • クラスター: mtls 適用、mtls 登録、mtls 登録解除などのクラスター全体の構成管理のクォーラムを実行するために使用されるクラスター管理サービス。

  • 登録:クォーラム認可用のパブリックキーの登録に使用する署名なしトークンを生成します。

必須: はい

<TOKEN>

署名されていないトークンファイルが書き込まれるファイルパス。

必須: はい

関連トピック