テーマ別の解説テーマ:AWS CLI:設定・認証・要求先
AWS CLI入門:profile・認証・Regionの確認方法
AWS Command Line Interface(AWS CLI)は、コマンドでAWSへ要求するための道具です。profileは設定名、認証は誰として使うか、Regionは要求先の条件です。架空の月次レポートの例で、名前が合っていても進めてはいけない場面を読み分けます。
profile・認証セッション・アカウント/ロール・Region・操作対象を分け、条件が不明・不一致なら実行を保留できる。
認証と認可、アカウントとロールの基礎。実AWSやCLIは不要です。この教材の例を端末へ貼り付けません。
profile・身元・Region・対象を分ける
AWSアカウントは資源を管理する単位で、利用する人そのものではありません。 人は組織のID等で認証します。アクセスを管理するAWS Identity and Access Management(IAM)のロールは権限を設定する身元で、引き受けると一時認証情報を使うロールセッションが作られます。以下は指定されたロールを使う1例で、すべてのログインが同じ形になるという意味ではありません。
- 作業 → 設定名担当者が承認したアクセス方法と、それに対応する設定を選ぶ。
- 設定名 → 身元設定名ではなく、その要求で使う身元を確かめる。
- 身元 → 対象身元が合っていても、要求先と操作の許可は別に確認する。
- 作業
- 既存レポートアプリの状態確認。資源を作成・変更しない。
- 設定名
- report-trainingは設定を選ぶ名前。認証方式や参照先を確認する。
- 身元
- 有効なセッションが、どのアカウント・ロールの要求になるか照合する。
- 対象
- サービス・操作・Region・資源を作業メモと照合する。
| 言葉 | 役割 | 確認すること |
|---|---|---|
| profile(プロファイル) | 名前付きの設定のまとまり | 名前が同じでも、実際の認証情報や身元が期待どおりか |
| 認証セッション | サインインに対応する有効な利用状態。方式により一時認証情報を使う | 有効期限と、対応するアカウント・ロール |
| Region(リージョン) | 要求先を決める設定の一つ | 対象サービスのRegionと、その要求で有効な指定 |
| サービス・資源・操作 | 何に何を要求するか | 対象ID・必要な操作・許可。身元確認だけでは確定しない |
認証方法は組織の指定とCLIの版で選ぶ
人が使うCLIでは、組織が承認した一時認証の方法を先に確認します。IAM Identity Centerは、人にAWSアカウントなどへのアクセスを割り当てるサービスです。SSO(シングルサインオン)は、1回のサインインを複数の割り当て先の利用につなげる仕組みを指します。 コンソール認証情報を使う方法や、外部の認証基盤と連携するフェデレーションは、それぞれ前提が異なります。長期アクセスキーの作成や、日常作業でのルート利用を入門の既定手順にしません。
| 条件 | 対応する公式手順 | 先に確認すること |
|---|---|---|
| IAM Identity Centerを指定された | aws configure ssoで設定し、aws sso loginでサインインする手順 | 組織の割当、ポータル等の指定、SSO Region。SSO Regionと作業対象のRegionは別 |
| 対応するコンソール認証情報の方法を組織が承認した | aws login。現行文書ではAWS CLI 2.32.0以上が必要 | CLIの版、利用する身元と必要な利用許可。Identity Centerの人は別のSSO手順へ |
| 方式・割当・CLIの版が不明、または別の認証基盤 | 担当者へ確認してから、その方式の公式手順を選ぶ | 見よう見まねで方式を切替えたり、新しいキーを作ったりしない |
具体例:profile名が合っても、要求先を確かめる
AWS Security Token Service(STS)のGetCallerIdentityは、要求に使う身元を調べるAPI(プログラムがサービスを呼び出す窓口)です。 下の出力のAccountはアカウントID、Arnは要求に使った身元を識別する名前です。これはEC2の資源一覧や、EC2を操作できるかを返す要求ではありません。
実行しない入力例:身元を調べるSTS要求を読む
aws sts get-caller-identity --profile report-training --region ap-northeast-3架空の出力例(実行結果ではありません)
{
"UserId": "TRAINING-ROLE-ID:lesson-01",
"Account": "444455556666",
"Arn": "arn:aws:sts::444455556666:assumed-role/ReportViewer/lesson-01"
}| 項目 | 作業で必要な条件 | この例で読めること |
|---|---|---|
| profile | 承認された設定を使う | report-trainingを指定。ただし名前だけでは身元は決まらない |
| 要求主体 | アカウントA / 111122223333、指定されたロール | Accountは444455556666(研修B)。同じReportViewerという文字列でも別アカウント |
| 作業対象のRegion | EC2は東京 / ap-northeast-1 | 作業メモとSTS要求は大阪 / ap-northeast-3。次のEC2要求先はまだ確認していない |
| サービスと資源 | 既存EC2のR17 / report-webを特定し、許可された状態確認のみ | この例の要求はSTS。EC2の存在、実ID、状態、操作の許可は分からない |
この例ではEC2の照会へ進まず、アカウントと対象Regionを確認し直します。 GetCallerIdentityは、その要求で使う身元の情報を返すAPIです。成功しても、EC2の照会が許可された証拠にはなりません。--regionはそのコマンドの指定で、後続コマンドのRegionを恒久的に変更する指定ではありません。実環境の設定は環境変数などにも影響されるため、profile名だけで決めつけません。
期限切れ・拒否・対象不明を分ける
| 観測 | 次の確認 | その結果だけでは分からないこと |
|---|---|---|
| 認証セッションの期限切れを示す | 組織の方式に従って再サインインする条件を確認 | 新しい長期キーが必要、という意味ではない |
| 別のサービス要求でAccessDeniedが返る | 使った身元・操作・対象と適用する制御を確認 | 身元確認が成功しても、その操作の許可は別 |
| 期待した資源が見つからない | アカウント、サービス、Region、対象IDや絞り込みを照合 | 資源が存在しない、削除済み、再作成すべき、とはまだ決まらない |
一時認証情報やログイン状態の有効期間、更新・再ログインの条件は方式により異なります。エラー文言も状況や版によって異なります。期限切れや拒否の原因を、この固定例だけで診断しません。
条件を変えて、次の確認を選ぶ
選択すると、正誤と理由が表示されます。
次に読むIAMの基礎
必要な前提を確認する
- サインイン成功と操作の許可を区別したいとき。:認証と認可の違い →
- 一時認証情報とロールの前提を確認したいとき。:人とアプリの認証経路 →
確認して、自分の言葉で説明する
- profile名と、実際の要求主体を別に説明する。
- 組織の認証方式と、期限切れ時の再開条件を確認する。
- サービス・操作・Region・資源を、作業条件と照合してから進む。
理解を確かめる: profile名が予定どおりなら、対象のEC2操作へ進める?
名前だけでは進めない。要求主体・セッション・対象と、必要な操作の許可を確認する。
profileは設定を選ぶ名前です。例のように同じロール名が別アカウントにあることも、対象Regionが違うこともあります。身元を確認したAPIの成功と、別サービスの操作許可も分けて判断します。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件名前付きprofileと設定ファイルの役割。名前だけで身元を確定しない。
参照した本文profile・身元・Region・対象を分ける
確認した内容・条件設定・認証情報の参照先は複数。コマンドのRegion指定と永続設定を区別し、全優先順の再実装はしない。
確認した内容・条件aws loginはCLI2.32.0以上と対象の認証経路・許可が条件。Identity Centerは別手順。認証やポリシー付与を実施しない。
確認した内容・条件組織の割当・指定を前提にconfigureとsign-inを区別。SSO Regionと作業Regionを混同せず、権限拡大例を転載しない。
確認した内容・条件要求で使う身元の情報でありEC2操作の許可ではない。架空の静的入出力のみで実データを収集しない。
参照した本文profile・身元・Region・対象を分ける 具体例:profile名が合っても、要求先を確かめる 期限切れ・拒否・対象不明を分ける
確認した内容・条件複数の認証経路から組織の指定・前提に合う一時認証を選び、全員同じコマンドや長期キー作成へ固定しない。
参照した本文認証方法は組織の指定とCLIの版で選ぶ
確認した内容・条件人はフェデレーション/Identity Center、workloadは一時的なロール認証情報、最小権限、長期認証情報を標準にしない。
参照した本文profile・身元・Region・対象を分ける 認証方法は組織の指定とCLIの版で選ぶ 期限切れ・拒否・対象不明を分ける
- IAM roles確認日:
確認した内容・条件IAMロールの主体・信頼・一時認証情報、ロールとセッションの違い。
参照した本文profile・身元・Region・対象を分ける
確認した内容・条件アカウントという資源管理の単位と利用者本人を区別する基礎に限定。アカウント作成や新しい申込方法は扱わない。
参照した本文profile・身元・Region・対象を分ける