Amazon Elastic Kubernetes Service (EKS)

Amazon Elastic Kubernetes Service (EKS) について

Amazon EKS コネクタは、EKS AWS API を通じて公開されるクラスター、ノードグループ、アドオン、アクセスエントリのメタデータを収集します(データプレーン内の Kubernetes RBAC とは異なります)。認証は、eks:Describe* / eks:List* をカバーするお客様のロールへの sts:AssumeRole で行います。

仕組み

Iru は独自の AWS アカウントで稼働しています。お客様のアカウントの Amazon EKS のクラスターとアドオンのメタデータを読み取るには、sts:AssumeRole の信頼(ウィザードの External ID)と、セキュリティチームが承認した eks:、ec2:、および関連する API に対する読み取り専用の権限を持つ IAM ロールを作成します。ロールの ARN を Iru に貼り付けます。すべての API を網羅する単一の AWS マネージドの「EKS のすべてを読み取り専用」ポリシーはありません。プラットフォームチームが厳選したバリエーションを公開していない限り、以下のインライン JSON から始めてください。

項目	値
カテゴリ	開発者ツール
認証	クロスアカウント IAM ロール

前提条件

ロールを管理できる IAM 権限。
すぐにインベントリを得たい場合は、少なくとも 1 つの EKS クラスター。

AWS EKS を Iru に接続する

Iru Compliance
AWS

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

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

ソースを開く

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

左側のナビゲーション: Compliance を展開し、Sources を選択した状態

AWS EKS をオンにする

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

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

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

copy=false

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::753695775620:role/IruConnect"
      },
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_EXTERNAL_ID"
        }
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

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

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

Iru でロール ARN を送信する

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

IAM Role ARN を貼り付ける

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

接続を完了する

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

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

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

このロールを作成する前に、Iru Compliance タブの Iru から信頼ポリシーを取得するを完了してください。Trusted entity を設定する際は、最新のウィザードに表示される外部 ID と信頼ポリシーを使用します。

AWS で IAM ロールを作成する

ロール作成のワークフローを開始する

IAM → Roles → Create role を開きます。

信頼されたエンティティを設定する

AWS account → Another AWS account を選択します。753695775620(または Iru に表示される ID)を入力します。Require external ID を有効にし、Iru からコピーした外部 ID を貼り付けます。

EKS のメタデータ用インラインポリシーをアタッチする

次のインラインポリシーを追加します:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "eks:Describe*",
        "eks:List*"
      ],
      "Resource": "*"
    }
  ]
}

ロールに名前を付けて ARN をコピーする

ロールに名前を付け(例: IruEKSReadOnly)、作成して Role ARN をコピーします。Iru Compliance タブに戻り、Iru でロール ARN を送信するを完了します。

信頼関係を確認する

Trust relationships がウィザードの JSON と一致していることを確認します。

Iru Compliance タブに進み、Role ARN を貼り付けてウィザードを完了します(Iru でロール ARN を送信する)。

トラブルシューティング

ソースをオンにしても何も開かない

Iru サイトのポップアップブロッカーの設定を確認してから、再試行してください。

AssumeRole が拒否される

外部 ID が一致していません。

クラスターが一部しかカバーされない

新しい EKS API は頻繁に追加されます。ワイルドカードを使用するとポリシーの将来的な互換性が保たれます。範囲を絞り込む場合は、必ずテストしてください。

考慮事項

AWS 側の EKS API が対象で、Pod レベルの証跡は…

対象は AWS 側の EKS API です。Pod レベルの証跡は、引き続き Kubernetes の監査/ログ記録のパイプラインで取得します。

ソース管理

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

コンプライアンスの開始

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

Iru の概要

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

アーティファクト管理

ソースとアクションからの証跡のアップロード、確認、整理。

はじめに

アクション

フレームワーク

アーティファクト

ソース

ポリシー

トラストセンター

ワークフロー

Amazon Elastic Kubernetes Service (EKS)