> ## 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.

# Amazon S3 アクティビティログ統合

> Iru Endpoint で Amazon S3 統合を構成して、Endpoint、Detections、Compliance のイベントを含む統合テナントアクティビティログをエクスポートします。

### Amazon S3 アクティビティログ統合について

Iru Endpoint の Amazon S3 アクティビティログ統合を使用すると、組織は統合テナントアクティビティログをセルフホストの S3 バケットにエクスポートし、SIEM サービスで一元的に収集および分析できます。

### 仕組み

この統合は、Iru Endpoint が提供する IAM ロールを介したクロスアカウントアクセスを使用して、指定した S3 バケットにイベントデータをプッシュします。

構成が完了すると、[Unified Activity](/ja/iru/platform-overview/unified-activity) で確認するものと同じテナントアクティビティイベントが配信されます。これには、**Tenant** (System)、**Endpoint**、**検出**、**脆弱性**、**コンプライアンス** 全体のアクティビティが含まれます。記録された内容の閲覧とフィルタリングには Unified Activity を使用し、長期保存、SIEM への取り込み、またはオフライン分析には S3 バケットを使用します。

イベントフィールドの定義と API の詳細については、アクティビティログの [API ドキュメント](https://api-docs.kandji.io/#06022d9d-426b-4aea-826a-d7f084e4f1e3)を参照してください。

<Note>
  統合の接続後、最初のログ収集には直前 1 時間分のアクティビティのみが含まれます。以降のアクティビティログの収集は 1 時間ごとに行われます。
</Note>

### 前提条件

この統合を構成する前に、次のことを確認してください。

* アクティブな AWS アカウントがあること。
* 新しい S3 バケットを作成する権限があること。
* AssumeRole と S3 書き込み権限を持つ IAM ロールを作成する権限があること。

### AWS アクセスを設定する

#### Iru Endpoint の統合のセットアップ

<Steps>
  <Step title="インテグレーションを開く">
    サイドバーで [**アカウントメニューボタン**](/ja/iru/platform-overview/account-menu) を選択し、**インテグレーション** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-integrations.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=e89fa7e9b81ac504a6f519608e10b8a3" alt="Integrations オプションが強調表示されたアカウントメニューのスクリーンショット" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="すべての統合を参照する">
    Integrations ページの右上にある **すべてのインテグレーションを参照** を選択します。
  </Step>

  <Step title="Amazon S3 Activity Log Integration を選択する">
    **Amazon S3 Activity Log Integration** タイルを選択します。
  </Step>

  <Step title="IAM ロールをコピーする">
    **IRU\_ENDPOINT\_IAM\_ROLE** の値をコピーし、安全な場所に保管します。
  </Step>

  <Step title="AWS アカウント ID をコピーする">
    **IRU\_ENDPOINT\_AWS\_ACCOUNT\_ID** の値をコピーし、安全な場所に保管します。
  </Step>

  <Step title="値を安全に保管する">
    これらの値は、次のセクションで IAM ロールの権限の一部として使用します。
  </Step>
</Steps>

#### S3 バケットを作成する

<Note>
  Amazon S3 アクティビティログ統合を使用するには、新しい S3 バケットを作成する必要があります。
</Note>

<Steps>
  <Step title="AWS コンソールにアクセスする">
    AWS にログインします。
  </Step>

  <Step title="S3 に移動する">
    Amazon S3 > Buckets に移動します。
  </Step>

  <Step title="バケットを作成する">
    **Create bucket** を選択します。
  </Step>

  <Step title="バケットタイプを選択する">
    **General purpose** バケットタイプを選択します。
  </Step>

  <Step title="バケット名を入力する">
    覚えやすい **Bucket name** を入力します。

    * この名前はポリシーで参照されます。
  </Step>

  <Step title="パブリックアクセスを構成する">
    **Block Public Access settings for this bucket** で、**Block all public access** オプションが選択されていることを確認します。
  </Step>

  <Step title="バージョニングを設定する">
    **Bucket Versioning** で、**Disable** オプションを選択したままにします。
  </Step>

  <Step title="暗号化を構成する">
    **Encryption type** で **Server side encryption with Amazon S3 managed Keys (SSE-S3)** を選択します。
  </Step>

  <Step title="バケットキーを有効にする">
    **Bucket Key** で **Enabled** を選択します。
  </Step>

  <Step title="構成を確認する">
    Iru Endpoint は現在、上記で定義したデフォルトの暗号化オプションのみをサポートしています。
  </Step>

  <Step title="バケットを作成する">
    **Create bucket** を選択します。
  </Step>

  <Step title="作成したバケットを選択する">
    作成したバケットを選択します。
  </Step>

  <Step title="権限にアクセスする">
    **アクセス許可** タブを選択します。
  </Step>

  <Step title="バケットポリシーを編集する">
    **Bucket policy** で **編集** を選択します。
  </Step>

  <Step title="バケットポリシーを追加する">
    次のバケットポリシーをロールの権限に追加します。**変更を保存** を選択します。

    <Steps>
      <Step title="バケット名の参照を置き換える">
        **BUCKET\_NAME** へのすべての参照を、作成したバケットの名前に置き換えます。
      </Step>
    </Steps>

    ```
    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AllowSSLRequestsOnly",
                "Effect": "Deny",
                "Principal": "*",
                "Action": "s3:*",
                "Resource": [
                  "arn:aws:s3:::BUCKET_NAME/*",
                  "arn:aws:s3:::BUCKET_NAME"
                ],
                "Condition": {
                    "Bool": {
                        "aws:SecureTransport": "false"
                    }
                }
            }
        ]
    }
    ```
  </Step>
</Steps>

<Steps>
  <Step title="IAM に移動する">
    AWS で **IAM > Roles** に移動します。
  </Step>

  <Step title="新しいロールを作成する">
    **Create role** を選択します。
  </Step>

  <Step title="信頼ポリシーを選択する">
    **Custom trust policy** を選択します。
  </Step>

  <Step title="カスタム信頼ポリシーを追加する">
    以下の **Custom trust policy** を追加して、Iru Endpoint が S3 バケットに書き込む際にこのロールを引き受けられるようにします。

    * **IRU\_ENDPOINT\_AWS\_ACCOUNT\_ID** と **IRU\_ENDPOINT\_IAM\_ROLE** のテキストを、この記事の冒頭でメモした値に置き換えます。

      ```
      {
          "Version": "2012-10-17",
          "Statement": [
              {
                  "Effect": "Allow",
                  "Principal": {
                      "AWS": "arn:aws:iam::IRU_ENDPOINT_AWS_ACCOUNT_ID:role/IRU_ENDPOINT_IAM_ROLE"
                  },
                  "Action": "sts:AssumeRole"
              }
          ]
      }
      ```
  </Step>

  <Step title="ロールの作成を続行する">
    **次へ** を選択します。
  </Step>

  <Step title="権限をスキップする">
    **Add permissions screen** で、一覧にある **Permissions policies** をいずれも選択せずに Next を選択します。
  </Step>

  <Step title="ロールの詳細を追加する">
    **Role name** と **説明** を追加します。
  </Step>

  <Step title="ロールの作成を完了する">
    **Create role** を選択します。
  </Step>

  <Step title="作成したロールを選択する">
    作成した **IAM Role** を選択します。
  </Step>

  <Step title="Permissions タブにアクセスする">
    **アクセス許可** タブを選択します。
  </Step>

  <Step title="権限を追加する">
    **Add permissions** を選択します。
  </Step>

  <Step title="インラインポリシーを作成する">
    **Create inline policy** を選択します。
  </Step>

  <Step title="JSON に切り替える">
    **JSON** タブを選択します。
  </Step>

  <Step title="インラインポリシーを入力する">
    インラインポリシーとして次の内容を入力します。

    <Steps>
      <Step title="バケット名を置き換える">
        BUCKET\_NAME を、Iru Endpoint がアクティビティログファイルを配置する、作成したバケットの名前に置き換えます。
      </Step>
    </Steps>

    ```
    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Action": "s3:ListBucket",
                "Effect": "Allow",
                "Resource": "arn:aws:s3:::BUCKET_NAME"
            },
            {
                "Action": "s3:*",
                "Effect": "Allow",
                "Resource": "arn:aws:s3:::BUCKET_NAME/*"
            }
        ]
    }
    ```
  </Step>

  <Step title="ポリシーの作成を続行する">
    **次へ** を選択します。
  </Step>

  <Step title="ポリシーに名前を付ける">
    **Policy name** を入力します。
  </Step>

  <Step title="ポリシーを作成する">
    **Create policy** を選択します。
  </Step>
</Steps>

### Iru Endpoint で統合を設定する

AWS アカウントで上記の構成が完了したら、Iru Endpoint アカウントで統合の設定に進むことができます。

<Steps>
  <Step title="インテグレーションを開く">
    サイドバーで [**アカウントメニューボタン**](/ja/iru/platform-overview/account-menu) を選択し、**インテグレーション** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-integrations.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=e89fa7e9b81ac504a6f519608e10b8a3" alt="Integrations オプションが強調表示されたアカウントメニューのスクリーンショット" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="すべての統合を参照する">
    Integrations ページの右上にある **すべてのインテグレーションを参照** を選択します。
  </Step>

  <Step title="Amazon S3 Activity Log Integration を選択する">
    **Amazon S3 Activity Log Integration** タイルを選択します。
  </Step>

  <Step title="セットアップを続行する">
    **次へ** を選択します。
  </Step>

  <Step title="AWS アカウント ID を入力する">
    **AWS Account ID** を入力します。
  </Step>

  <Step title="S3 バケット名を入力する">
    このガイドで先ほど作成したバケットの **S3 Bucket Name** を入力します。
  </Step>

  <Step title="宛先パスを設定する">
    必要に応じて、**Destination Path** を入力します。
  </Step>

  <Step title="IAM ロール ARN を入力する">
    このガイドで先ほど作成した IAM ロールの **IAM Role ARN** を入力します。
  </Step>

  <Step title="AWS リージョンを入力する">
    **AWS Region** を入力します。
  </Step>

  <Step title="S3 に接続する">
    **Connect to S3** を選択します。
  </Step>

  <Step title="接続を確認する">
    Iru Endpoint は、指定された S3 バケットにテストファイルをアップロードして削除しようとします。Iru Endpoint が S3 バケットとの統合に成功しなかった場合は保存できないため、UI に表示されるエラーメッセージに従って接続を修正する必要があります。
  </Step>

  <Step title="イベントデータを確認する">
    S3 バケットを確認して、Iru Endpoint がアクティビティログデータをプッシュしていることを確認します。アカウントでテナントアクティビティイベントが生成されていれば、最大で 2 時間かかります。
  </Step>
</Steps>

## 考慮事項

<CardGroup cols={2}>
  <Card title="アクティビティログの頻度" icon="clock">
    アクティビティログイベントは 1 時間ごとに更新され、最初の収集には直前 1 時間分のアクティビティのみが含まれます。エクスポートされるイベントは [Unified Activity](/ja/iru/platform-overview/unified-activity) の範囲 (サポートされているすべての Tenant、Endpoint、Detections、脆弱性、Compliance のアクティビティタイプ) と一致します。
  </Card>

  <Card title="IAM ロールの権限" icon="key">
    IAM ロールには、Iru Endpoint がそのロールを引き受けて S3 バケットに書き込むことを許可するために必要な権限が必要です。
  </Card>

  <Card title="S3 バケットポリシー" icon="file-lines">
    Iru Endpoint がバケットにオブジェクトを書き込めるように、S3 バケットポリシーを調整する必要がある場合があります。
  </Card>

  <Card title="セキュリティ要件" icon="lock">
    セキュリティコンプライアンスのため、S3 バケットで適切な暗号化が有効になっており、パブリックアクセスがブロックされていることを確認してください。
  </Card>

  <Card title="データの保持" icon="archive">
    ログデータの保持とストレージコストを管理するために、S3 ライフサイクルポリシーの実装を検討してください。
  </Card>

  <Card title="モニタリング" icon="chart-line">
    S3 バケットへのアクセスとアクティビティログの配信を監視するために、CloudWatch アラームを設定します。
  </Card>
</CardGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="統合アクティビティ" icon="timeline" href="/ja/iru/platform-overview/unified-activity">
    S3 へのエクスポートの前後に、Iru Web アプリで同じテナントアクティビティイベントを閲覧、検索、フィルタリングできます。
  </Card>

  <Card title="アクティビティページ" icon="timeline" href="/ja/endpoint/devices/activity-page">
    現在の Endpoint アクティビティのタイムラインです。Unified Activity がプレビュー段階の間、併せて利用できます。
  </Card>
</CardGroup>