1Password を使用して AWS CDK ツールキットを安全に認証する

1Passwordマニュアル｜AWS CDK Toolkitシェルプラグインで1Passwordを活用し、安全かつ効率的にAWS環境へ認証する方法を解説します。

AWS CDK Toolkit シェルプラグインを使うと、1Password を使用してAWS CDK Toolkit を安全に認証できます。資格情報をプレーンテキストでSaveするのではなく、fingerprint、Apple Watch、またはシステム認証を使用してSaveします。

指示に従ってデフォルトの認証情報を設定し、plugins.shファイルを取得すると、生体認証を使用して AWS CDK ツールキットを認証するように求められます。

AWS CLI シェルプラグインを設定することもできます。

必要条件

①1Passwordにサインアップしてください。
②MacまたはLinux用の 1Password をインストールしてサインインします。
③1Password CLI 2.17.0 以降をインストールします。 1Password CLI を既にインストールしている場合は、インストールを更新する方法を確認してください。
④1Password CLI を 1Password アプリと統合します。
⑤AWS CDK ツールキットをインストールする。

次のシェルがサポートされています:

Bash
Zsh
fish

ステップ 1: デフォルトの資格情報

AWS CDK Toolkitシェルプラグインの使用を開始するには:

①AWS CDK Toolkitプラグインで使う 1Password アカウントにサインインします。
$ op signin
②特定のディレクトリでのみプラグインを設定したい場合は、そのディレクトリに変更します。
③プラグインを設定するには、次のコマンドを実行します。
$ op plugin init cdk

AWS CDK Toolkit の認証情報を 1Passwordにインポートするか、認証情報がSaveされている保存済みの 1Password 項目を選択して、認証情報をいつ使うかを設定するように求められます。

ステップ 1.1: アイテムをインポートまたは選択する

新しいアイテムをインポートする

AWS CDK Toolkit認証情報を 1PasswordにまだSaveしていない場合は、Import into 1Passwordを選択します。認証情報を入力し、新しい 1Password アイテムの名前を選択して、Save先の保管庫を選択します。

1Password がローカル開発環境で資格情報を検出すると、自動的にインポートするように求められます。

保存済みのアイテムを選択

既にAWS CDK Toolkit の認証情報を 1PasswordにSaveしている場合は、Search in 1Passwordを選択します。

関連するアイテムとそれらがSaveされている保管庫のリストが表示されます。資格情報が表示されない場合は、Expand searchを選択して、アカウント内の全てのアイテムを参照します。

ステップ 1.2: デフォルトの資格情報スコープを設定する

認証情報を選択またはインポートすると、 AWS CDK Toolkit を認証するためにその項目をいつ使うかを設定するように求められます。

"Prompt me for each new terminal session"を選択すると、現在のターミナルセッションの期間中のみ資格情報が設定されます。ターミナルを終了すると、デフォルトは削除されます。
"Use automatically when in this directory or subdirectories"を選択すると、他のディレクトリ固有のデフォルトが設定されていない限り、現在のディレクトリとその全てのサブディレクトリで資格情報がデフォルトになります。ターミナルセッションのデフォルトは、ディレクトリ固有のデフォルトよりも優先されます。
"Use as global default on my system"を選択すると、資格情報が全てのターミナルセッションとディレクトリのデフォルトとして設定されます。ディレクトリ固有のデフォルトは、グローバルデフォルトよりも優先されます。

ステップ2: plugins.shファイルをsource化する

プラグインを使用できるようにするには、plugins.shファイルをソース化します。例:

$ source ~/.config/op/plugins.sh

フォルダーのファイルパスは、構成ディレクトリopによって異なる場合があります。op plugin initは正しいファイルパスを含むソースコマンドを出力します。

シェルプラグインを初めてインストールする場合は、現在のターミナルセッションを超えてプラグインを永続化するために、RC ファイルまたはシェルプロファイルに source コマンドを追加する必要があります。例:

Bash

$ echo "source ~/.config/op/plugins.sh" >> ~/.bashrc && source ~/.bashrc

$ echo "source ~/.config/op/plugins.sh" >> ~/.zshrc && source ~/.zshrc

fish

$ echo "source ~/.config/op/plugins.sh" >> ~/.config/fish/config.fish && source ~/.config/fish/config.fish

ステップ3: CLIを使う

次回AWS CDK Toolkitを使用してコマンドを入力するときに、生体認証またはシステム認証による認証を求めるメッセージが表示されます。

ステップ4: インポートした資格情報をdiskから削除

AWS CDK Toolkit認証情報を 1PasswordにSaveしたら、以前にディスクにSaveした全てのローカルコピーを削除できます。

次のステップ

1Password Shell プラグインは60 を超えるサードパーティの CLI をサポートしています。サポートされている CLI のリストを表示するには:

$ op plugin list

別のプラグインを選択して開始するには:

$ op plugin init

シームレスなコンテキスト切り替えのためにシェルプラグインを使うには、複数の環境または複数のアカウントでプラグインを構成する方法を学習します。

ヘルプを受ける

設定を検査する

現在のAWS CDK Toolkit設定を検査するには:

$ op plugin inspect cdk

1Password CLI は、 AWS CDK Toolkitで使うために設定した認証情報とそのデフォルトスコープのリスト、およびAWS CDK Toolkit用に設定されたエイリアスのリストを返します。

資格情報を消去する

AWS CDK Toolkitで使用される認証情報をリセットするには:

$ op plugin clear cdk

次の優先順位に従って、一度に 1 つの構成をクリアできます。

①ターミナルセッションのデフォルト
②ディレクトリのデフォルト、現在のディレクトリから$HOME
③グローバルデフォルト

例えば、ディレクトリ内にいて$HOME/projects/awesomeProject、ターミナルセッションのデフォルト、$HOMEおよびのディレクトリのデフォルト$HOME/projects/awesomeProject、およびグローバルデフォルトの資格情報が構成されている場合、全てのデフォルトをクリアするには op plugin clear cdkを 4 回実行する必要があります。

グローバルデフォルト資格情報、ターミナルセッションデフォルト、および現在のディレクトリのデフォルトを同時にクリアするには、op plugin clear cdk --all を実行します。

参照

1Password は、プラグインコマンドに必要な認証情報を 1Password アカウントから直接環境変数に挿入することで、AWS CDK Toolkitで認証します。

新しい項目をインポートするために op pluginを使うのではなく、AWS CDK Toolkit 認証情報を 1Passwordに手動でSaveした場合は、フィールド名が以下の表と一致していることを確認してください。

アイテムに必要な名前のフィールドが含まれていない場合は、保存済みのフィールドのいずれかの名前を変更するように求められます。

1Passwordフィールド名

環境変数

Access Key ID

AWS_ACCESS_KEY_ID

Secret Access Key

AWS_SECRET_ACCESS_KEY

Default region (optional)

AWS_DEFAULT_REGION

もっと詳しく知る

Previous1Passwordを使用してAWS CLIを安全に認証する Next1Passwordを使用してBinance CLIを安全に認証する