INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

テーマ別の解説テーマ: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例で、すべてのログインが同じ形になるという意味ではありません。

CLIの要求前に確認する4項目:矢印は確認の順序
CLIの要求前に確認する4項目:矢印は確認の順序1: 作業 — 担当者が承認したアクセス方法と、それに対応する設定を選ぶ。 — 設定名. 2: 設定名 — 設定名ではなく、その要求で使う身元を確かめる。 — 身元. 3: 身元 — 身元が合っていても、要求先と操作の許可は別に確認する。 — 対象123作業設定名身元対象CLIの要求前に確認する4項目:矢印は確認の順序1: 作業 — 担当者が承認したアクセス方法と、それに対応する設定を選ぶ。 — 設定名. 2: 設定名 — 設定名ではなく、その要求で使う身元を確かめる。 — 身元. 3: 身元 — 身元が合っていても、要求先と操作の許可は別に確認する。 — 対象123作業設定名身元対象
  1. 作業 → 設定名担当者が承認したアクセス方法と、それに対応する設定を選ぶ。
  2. 設定名 → 身元設定名ではなく、その要求で使う身元を確かめる。
  3. 身元 → 対象身元が合っていても、要求先と操作の許可は別に確認する。
作業
既存レポートアプリの状態確認。資源を作成・変更しない。
設定名
report-trainingは設定を選ぶ名前。認証方式や参照先を確認する。
身元
有効なセッションが、どのアカウント・ロールの要求になるか照合する。
対象
サービス・操作・Region・資源を作業メモと照合する。
CLIで確かめる情報は、それぞれ役割が違う
言葉役割確認すること
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という文字列でも別アカウント
作業対象のRegionEC2は東京 / 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 Identity Centerを指定しています。別記事でaws loginを見つけました。次は?
答えと理由を読む

正解:指定された割当とCLIの版を確かめ、SSO手順を確認する · 方式を先にそろえると、別のログイン経路やアカウントを誤って選ぶのを防げます。

例ではprofileがreport-training、ロール名はReportViewerですがAccountが研修Bでした。次は?
答えと理由を読む

正解:処理を保留し、承認された身元と対象を確認し直す · Accountが作業条件と異なります。身元とRegion・資源を照合してから、必要な操作の許可を別に確認します。

承認済みの一時セッションが期限切れと示されました。次は?
答えと理由を読む

正解:指定された方式の再認証条件を確認する · 期限切れを回避する別認証を増やす前に、同じ承認経路で再開できる条件を確かめます。

次に読むIAMの基礎

必要な前提を確認する

確認して、自分の言葉で説明する

  1. profile名と、実際の要求主体を別に説明する。
  2. 組織の認証方式と、期限切れ時の再開条件を確認する。
  3. サービス・操作・Region・資源を、作業条件と照合してから進む。
理解を確かめる: profile名が予定どおりなら、対象のEC2操作へ進める?

名前だけでは進めない。要求主体・セッション・対象と、必要な操作の許可を確認する。

profileは設定を選ぶ名前です。例のように同じロール名が別アカウントにあることも、対象Regionが違うこともあります。身元を確認したAPIの成功と、別サービスの操作許可も分けて判断します。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。