> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS Lambda

> クロスアカウント IAM ロールを使用して AWS Lambda を Iru Compliance に接続し、関数のインベントリ、ランタイム、IAM ロールの紐付け、レイヤーの設定メタデータを収集します。

### AWS Lambda について

**AWS Lambda** コネクタは、関数の呼び出しやデプロイパッケージのダウンロードを行わずに、リージョン全体の**関数の設定**、**レイヤー**、**イベントソースマッピング**、**同時実行の設定**、および関連するメタデータを収集します。Iru は、ウィザードの**外部 ID** で保護された状態で、お客様が作成したロールに **`sts:AssumeRole`** を使用して切り替えます。

### 仕組み

Iru は独自の AWS アカウントで稼働しています。お客様のアカウントの **Lambda** の設定を読み取るには、Iru のプリンシパルを信頼し（**`sts:AssumeRole`** + ウィザードの **External ID**）、読み取り専用の **`lambda:`** 権限を持つ **IAM ロール**を作成します。そのロールの **ARN** を Iru に貼り付けます。

Iru のプリンシパルを信頼する IAM ロールを作成して **`AWSLambda_ReadOnlyAccess`** をアタッチするか、セキュリティチームが最小権限を求める場合は、以下の範囲を限定したインラインポリシーを使用します。

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

参考資料: [AWSLambda\_ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSLambda_ReadOnlyAccess.html)、[Lambda のセキュリティ](https://docs.aws.amazon.com/lambda/latest/dg/lambda-security.html)。

### 前提条件

* **ロールの作成**とポリシーのアタッチができる IAM 権限。
* **ご自身の**最新のコネクタからコピーした**プリンシパル**と**外部 ID** の値（アカウント `753695775620` などのサンプルはテナントごとに異なる場合があります）。

### AWS Lambda を Iru に接続する

<Tabs>
  <Tab title="Iru Compliance">
    <Note>
      まずここから始めます。ソースウィザードを開き、**信頼ポリシー**をコピーします（**外部 ID** も控えておきます）。AWS でロールを作成する準備ができたら、[**AWS**](#aws) タブに切り替えて [**AWS で IAM ロールを作成する**](#create-the-iam-role-in-aws)の手順に従います。**Role ARN** を取得したら、[**Iru Compliance**](#iru-compliance) タブに戻り、以下の [**Iru でロール ARN を送信する**](#submit-the-role-arn-in-iru)を完了します。
    </Note>

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

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="AWS Lambda をオンにする">
        **AWS Lambda** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。ウィザードのタブは開いたままにしておきます。
      </Step>

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

        ```json copy=false lines theme={null}
        {
          "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"
            }
          ]
        }
        ```
      </Step>

      <Step title="AWS に切り替えてロールを作成する">
        参照用に Iru ウィザードのタブを開いたまま、[**AWS**](#aws) タブに切り替えて [**AWS で IAM ロールを作成する**](#create-the-iam-role-in-aws)の手順に従います。
      </Step>
    </Steps>

    #### Iru でロール ARN を送信する

    <Note>
      新しいロールの **Role ARN** を取得するため、先に [**AWS**](#aws) タブ（[**AWS で IAM ロールを作成する**](#create-the-iam-role-in-aws)まで）を完了してください。
    </Note>

    <Steps>
      <Step title="IAM Role ARN を貼り付ける">
        Iru ウィザードのタブに戻ります。コネクタで求められる場所に **Role ARN** を貼り付けます。
      </Step>

      <Step title="接続を完了する">
        **Submit Role** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**AWS Lambda** カードが **有効** になっていることを確認します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="AWS">
    <Note>
      このロールを作成する前に、[**Iru Compliance**](#iru-compliance) タブの [**Iru から信頼ポリシーを取得する**](#get-the-trust-policy-from-iru)を完了してください。**Trusted entity** を設定する際は、最新のウィザードに表示される**外部 ID** と信頼ポリシーを使用します。
    </Note>

    #### AWS で IAM ロールを作成する

    <Steps>
      <Step title="ロール作成ワークフローを開始する">
        **IAM** → **Roles** → **Create role** を開きます。
      </Step>

      <Step title="信頼されたエンティティを設定する">
        **AWS account** → **Another AWS account** を選択します。**`753695775620`** を入力します（ウィザードの表示が異なる場合はその値を入力します）。**Require external ID** を有効にし、Iru からコピーした外部 ID を貼り付けます。
      </Step>

      <Step title="Lambda の読み取り権限をアタッチする">
        **`AWSLambda_ReadOnlyAccess`** をアタッチする**か**、次の**インラインポリシー**をアタッチします。

        ```json lines theme={null}
        {
          "Version": "2012-10-17",
          "Statement": [
            {
              "Effect": "Allow",
              "Action": [
                "lambda:Get*",
                "lambda:List*"
              ],
              "Resource": "*"
            }
          ]
        }
        ```

        マネージドポリシーは `GetFunction`、`ListFunctions`、`GetFunctionConfiguration`、レイヤー、エイリアス、マッピングなどのアクションをカバーしています。インラインの方式では `Get*` / `List*` のワイルドカードを使用します。
      </Step>

      <Step title="ロールに名前を付けて ARN をコピーする">
        ロールに名前を付け（例: **`IruLambdaReadOnly`**）、作成してその **ARN** をコピーします。[**Iru Compliance**](#iru-compliance) タブに戻り、[**Iru でロール ARN を送信する**](#submit-the-role-arn-in-iru)を完了します。
      </Step>

      <Step title="信頼関係を確認する">
        **Trust relationships** が Iru と一致していることを確認します。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進み、**Role ARN** を貼り付けてウィザードを完了します（[**Iru でロール ARN を送信する**](#submit-the-role-arn-in-iru)）。
    </Note>
  </Tab>
</Tabs>

### トラブルシューティング

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**の設定を確認してから、もう一度お試しください。
  </Accordion>

  <Accordion title="AssumeRole が拒否される">
    外部 ID またはプリンシパルが一致していません。Iru からもう一度コピーしてください。
  </Accordion>

  <Accordion title="リージョンの一覧が空になる">
    有効なリージョンに関数が存在すること、およびロールが正しいアカウントを対象としていることを確認してください。
  </Accordion>

  <Accordion title="暗号化された環境変数の内容が見えない">
    読み取り専用 API では暗号文の詳細が公開されない場合がありますが、メタデータによって設定の存在は引き続き証明できます。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="Lambda はリージョン単位のため、初回のスキャンではすべての有効な…" icon="circle-info">
    Lambda は**リージョン単位**です。初回のスキャンでは、すべての有効なリージョンを順に確認します。
  </Card>

  <Card title="Iru は関数を呼び出したり ZIP を展開したり…" icon="shield">
    Iru は関数を**呼び出したり**、ZIP アーティファクトを展開したりすることは**ありません**。設定のエビデンスのみを収集します。
  </Card>
</CardGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="Sources の管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照・管理します。
  </Card>

  <Card title="Compliance の利用を開始する" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="Artifacts の管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースやアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>
