Skip to main content

AWS Organizations について

AWS Organizations のエビデンスには、アカウント、OU、ルート、SCP、および関連するポリシーが含まれます。ロールは管理アカウントに作成する必要があります。メンバーアカウントでは、これらの API を通じて組織全体の構造を列挙できません。

仕組み

Iru は独自の AWS アカウントで稼働しています。管理アカウントの AWS Organizations の構造と設定を読み取るには、sts:AssumeRole の信頼関係(ウィザードの External ID)と読み取り専用の organizations: 権限を持つ IAM ロールを作成します。そのロールの ARN を Iru に貼り付けます。 AWSOrganizationsReadOnlyAccess をアタッチするか、インライン JSON で organizations:Describe* / organizations:List* に範囲を限定します。

前提条件

  • 管理アカウント(ワークロードのメンバーアカウントではない)における IAM 管理者権限。
  • コネクタのプリンシパルと外部 ID。

AWS Organizations を Iru に接続する

まずここから始めます。ソースウィザードを開き、信頼ポリシーをコピーします(外部 ID も控えておきます)。AWS でロールを作成する準備ができたら、AWS タブに切り替えて 管理アカウントで IAM ロールを作成するの手順に従います。Role ARN を取得したら、Iru Compliance タブに戻り、以下の Iru でロール ARN を送信するを完了します。

Iru から信頼ポリシーを取得する

1

ソースを開く

Iru Compliance の左側のナビゲーションバーで コンプライアンス を展開し、ソース を選択します。
左側のナビゲーション: Compliance を展開し、Sources を選択した状態
2

AWS Organizations をオンにする

AWS Organizations を探します(カテゴリ または 名前または説明で検索 を使用します)。そのカードのトグルをオンにします。Iru が外部サービスへのアクセスをリクエストしています ウィザードのタブは開いたままにしておきます。
3

信頼ポリシーの JSON をコピーする

ウィザードには、IAM ロールで使用する必要がある信頼ポリシーの JSON(Principal と sts:ExternalId)が表示されます。以下は構造の例です。アカウント、プリンシパル ARN、外部 ID が正確に一致するように、ウィザードに表示される最新の JSON をコピーしてください。
copy=false
4

AWS に切り替えてロールを作成する

参照用に Iru ウィザードのタブを開いたまま、AWS タブに切り替えて 管理アカウントで IAM ロールを作成するの手順に従います。

Iru でロール ARN を送信する

新しいロールの Role ARN を取得するため、先に AWS タブ(管理アカウントで IAM ロールを作成するまで)を完了してください。
1

IAM Role ARN を貼り付ける

Iru ウィザードのタブに戻ります。コネクタで求められる場所に Role ARN を貼り付けます。
2

接続を完了する

Submit Role を選択します。接続に成功すると、ウィザードに 接続が構成されました と表示されます。
3

ソースが有効であることを確認する

Iru が外部サービスへのアクセスをリクエストしています のブラウザタブを閉じてから コンプライアンス → ソース に戻り、AWS Organizations カードが 有効 になっていることを確認します。

トラブルシューティング

Iru サイトのポップアップブロッカーの設定を確認してから、もう一度お試しください。
ロールが管理アカウントで作成されたことを確認してください。
外部 ID が一致していません。

考慮事項

Org API は進化するため、ワイルドカード Describe / List** は…

Org API は進化し続けます。ワイルドカードの Describe* / List* の組み合わせを使用すると、AWS が新しい読み取り操作をリリースした際の変更を減らせます。

関連記事

Sources の管理

すべての Compliance ソースを参照・管理します。

Compliance の利用を開始する

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。