> ## 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-Aktivitätsprotokollintegration

> Konfigurieren Sie die Amazon S3-Integration in Iru Endpoint, um einheitliche Tenant-Aktivitätsprotokolle einschließlich Endpoint-, Detections- und Compliance-Ereignissen zu exportieren.

### Über die Amazon S3-Aktivitätsprotokollintegration

Mit der Amazon S3-Aktivitätsprotokollintegration in Iru Endpoint können Organisationen einheitliche Tenant-Aktivitätsprotokolle in einen selbst gehosteten S3-Bucket exportieren, um sie zentral zu sammeln und mit SIEM-Diensten zu analysieren.

### Funktionsweise

Diese Integration überträgt Ereignisdaten mithilfe eines kontoübergreifenden Zugriffs über eine von Iru Endpoint bereitgestellte IAM-Rolle in Ihren angegebenen S3-Bucket.

Nach der Konfiguration liefert sie dieselben Tenant-Aktivitätsereignisse, die Sie unter [Unified Activity](/de/iru/platform-overview/unified-activity) einsehen. Dazu gehören Aktivitäten in den Bereichen **Tenant** (System), **Endpoint**, **Erkennungen**, **Schwachstellen** und **Compliance**. Verwenden Sie Unified Activity, um die aufgezeichneten Ereignisse zu durchsuchen und zu filtern; verwenden Sie Ihren S3-Bucket für die Langzeitspeicherung, die SIEM-Aufnahme oder die Offline-Analyse.

Feldbeschreibungen der Ereignisse und API-Details finden Sie in der [API-Dokumentation](https://api-docs.kandji.io/#06022d9d-426b-4aea-826a-d7f084e4f1e3) zum Aktivitätsprotokoll.

<Note>
  Die erste Protokollerfassung nach dem Verbinden der Integration umfasst nur die Aktivitäten der vorangegangenen Stunde. Die weitere Erfassung der Aktivitätsprotokolle erfolgt stündlich.
</Note>

### Voraussetzungen

Stellen Sie vor der Konfiguration dieser Integration Folgendes sicher:

* Sie haben ein aktives AWS-Konto.
* Sie haben Berechtigungen zum Erstellen eines neuen S3-Buckets.
* Sie haben Berechtigungen zum Erstellen einer IAM-Rolle mit AssumeRole- und S3-Schreibberechtigungen.

### AWS-Zugriff einrichten

#### Einrichtung der Iru Endpoint-Integration

<Steps>
  <Step title="Integrationen öffnen">
    Wählen Sie in der Seitenleiste die [**Schaltfläche Kontomenü**](/de/iru/platform-overview/account-menu) und dann **Integrationen**.

    <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="Screenshot des Kontomenüs mit hervorgehobener Option Integrations" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="Alle Integrationen durchsuchen">
    Wählen Sie oben rechts auf der Seite „Integrations“ **Alle Integrationen durchsuchen**.
  </Step>

  <Step title="Amazon S3 Activity Log Integration auswählen">
    Wählen Sie die Kachel **Amazon S3 Activity Log Integration**.
  </Step>

  <Step title="IAM-Rolle kopieren">
    Kopieren Sie den Wert für **IRU\_ENDPOINT\_IAM\_ROLE** und bewahren Sie ihn an einem sicheren Ort auf.
  </Step>

  <Step title="AWS-Konto-ID kopieren">
    Kopieren Sie den Wert für **IRU\_ENDPOINT\_AWS\_ACCOUNT\_ID** und bewahren Sie ihn an einem sicheren Ort auf.
  </Step>

  <Step title="Werte sicher aufbewahren">
    Diese Werte werden im nächsten Abschnitt als Teil Ihrer IAM-Rollenberechtigungen verwendet.
  </Step>
</Steps>

#### S3-Bucket erstellen

<Note>
  Sie müssen einen neuen S3-Bucket erstellen, um die Amazon S3-Aktivitätsprotokollintegration zu verwenden.
</Note>

<Steps>
  <Step title="AWS-Konsole aufrufen">
    Melden Sie sich bei AWS an.
  </Step>

  <Step title="Zu S3 navigieren">
    Navigieren Sie zu Amazon S3 > Buckets.
  </Step>

  <Step title="Bucket erstellen">
    Wählen Sie **Create bucket**.
  </Step>

  <Step title="Bucket-Typ auswählen">
    Wählen Sie den Bucket-Typ **General purpose**.
  </Step>

  <Step title="Bucket-Namen eingeben">
    Geben Sie einen einprägsamen **Bucket name** ein.

    * Auf diesen Namen wird in Richtlinien verwiesen.
  </Step>

  <Step title="Öffentlichen Zugriff konfigurieren">
    Stellen Sie unter **Block Public Access settings for this bucket** sicher, dass die Option **Block all public access** ausgewählt ist.
  </Step>

  <Step title="Versionierung festlegen">
    Lassen Sie unter **Bucket Versioning** die Option **Disable** ausgewählt.
  </Step>

  <Step title="Verschlüsselung konfigurieren">
    Wählen Sie unter **Encryption type** die Option **Server side encryption with Amazon S3 managed Keys (SSE-S3)**.
  </Step>

  <Step title="Bucket Key aktivieren">
    Wählen Sie unter **Bucket Key** die Option **Enabled**.
  </Step>

  <Step title="Konfiguration prüfen">
    Iru Endpoint unterstützt derzeit nur die oben definierten Standardverschlüsselungsoptionen.
  </Step>

  <Step title="Bucket erstellen">
    Wählen Sie **Create bucket**.
  </Step>

  <Step title="Erstellten Bucket auswählen">
    Wählen Sie den soeben erstellten Bucket aus.
  </Step>

  <Step title="Berechtigungen aufrufen">
    Wählen Sie die Registerkarte **Berechtigungen**.
  </Step>

  <Step title="Bucket-Richtlinie bearbeiten">
    Wählen Sie unter **Bucket policy** die Option **Bearbeiten**.
  </Step>

  <Step title="Bucket-Richtlinie hinzufügen">
    Fügen Sie die folgende Bucket-Richtlinie zu den Rollenberechtigungen hinzu. Wählen Sie **Änderungen speichern**.

    <Steps>
      <Step title="Verweise auf den Bucket-Namen ersetzen">
        Ersetzen Sie alle Verweise auf **BUCKET\_NAME** durch den Namen des soeben erstellten Buckets.
      </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="Zu IAM navigieren">
    Navigieren Sie in AWS zu **IAM > Roles**.
  </Step>

  <Step title="Neue Rolle erstellen">
    Wählen Sie **Create role**.
  </Step>

  <Step title="Vertrauensrichtlinie auswählen">
    Wählen Sie **Custom trust policy**.
  </Step>

  <Step title="Benutzerdefinierte Vertrauensrichtlinie hinzufügen">
    Fügen Sie die folgende **Custom trust policy** hinzu, damit Iru Endpoint diese Rolle beim Schreiben in Ihren S3-Bucket übernehmen kann.

    * Ersetzen Sie die Texte **IRU\_ENDPOINT\_AWS\_ACCOUNT\_ID** und **IRU\_ENDPOINT\_IAM\_ROLE** durch die Werte, die Sie sich zu Beginn des Artikels notiert haben.

      ```
      {
          "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="Rollenerstellung fortsetzen">
    Wählen Sie **Weiter**.
  </Step>

  <Step title="Berechtigungen überspringen">
    Wählen Sie auf dem Bildschirm **Add permissions** „Next“, ohne eine der aufgeführten **Permissions policies** auszuwählen.
  </Step>

  <Step title="Rollendetails hinzufügen">
    Fügen Sie einen **Role name** und eine **Beschreibung** hinzu.
  </Step>

  <Step title="Rollenerstellung abschließen">
    Wählen Sie **Create role**.
  </Step>

  <Step title="Erstellte Rolle auswählen">
    Wählen Sie die soeben erstellte **IAM Role** aus.
  </Step>

  <Step title="Registerkarte Permissions aufrufen">
    Wählen Sie die Registerkarte **Berechtigungen**.
  </Step>

  <Step title="Berechtigungen hinzufügen">
    Wählen Sie **Add permissions**.
  </Step>

  <Step title="Inline-Richtlinie erstellen">
    Wählen Sie **Create inline policy**.
  </Step>

  <Step title="Zu JSON wechseln">
    Wählen Sie die Registerkarte **JSON**.
  </Step>

  <Step title="Inline-Richtlinie eingeben">
    Geben Sie Folgendes für die Inline-Richtlinie ein:

    <Steps>
      <Step title="Bucket-Namen ersetzen">
        Ersetzen Sie BUCKET\_NAME durch den Namen des von Ihnen erstellten Buckets, in dem Iru Endpoint die Aktivitätsprotokolldateien ablegen wird.
      </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="Richtlinienerstellung fortsetzen">
    Wählen Sie **Weiter**.
  </Step>

  <Step title="Richtlinie benennen">
    Geben Sie einen **Policy name** ein.
  </Step>

  <Step title="Richtlinie erstellen">
    Wählen Sie **Create policy**.
  </Step>
</Steps>

### Die Integration in Iru Endpoint einrichten

Sobald die obigen Schritte in Ihrem AWS-Konto konfiguriert sind, können Sie mit der Einrichtung der Integration in Ihrem Iru Endpoint-Konto fortfahren.

<Steps>
  <Step title="Integrationen öffnen">
    Wählen Sie in der Seitenleiste die [**Schaltfläche Kontomenü**](/de/iru/platform-overview/account-menu) und dann **Integrationen**.

    <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="Screenshot des Kontomenüs mit hervorgehobener Option Integrations" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="Alle Integrationen durchsuchen">
    Wählen Sie oben rechts auf der Seite „Integrations“ **Alle Integrationen durchsuchen**.
  </Step>

  <Step title="Amazon S3 Activity Log Integration auswählen">
    Wählen Sie die Kachel **Amazon S3 Activity Log Integration**.
  </Step>

  <Step title="Einrichtung fortsetzen">
    Wählen Sie **Weiter**.
  </Step>

  <Step title="AWS-Konto-ID eingeben">
    Geben Sie die **AWS Account ID** ein.
  </Step>

  <Step title="S3-Bucket-Namen eingeben">
    Geben Sie den **S3 Bucket Name** des zuvor in diesem Leitfaden erstellten Buckets ein.
  </Step>

  <Step title="Zielpfad festlegen">
    Geben Sie optional einen **Destination Path** ein.
  </Step>

  <Step title="IAM-Rollen-ARN eingeben">
    Geben Sie den **IAM Role ARN** der zuvor in diesem Leitfaden erstellten IAM-Rolle ein.
  </Step>

  <Step title="AWS-Region eingeben">
    Geben Sie die **AWS Region** ein.
  </Step>

  <Step title="Mit S3 verbinden">
    Wählen Sie **Connect to S3**.
  </Step>

  <Step title="Verbindung überprüfen">
    Iru Endpoint versucht, eine Testdatei in den angegebenen S3-Bucket hochzuladen und wieder zu löschen. Wenn Iru Endpoint die Integration mit Ihrem S3-Bucket nicht erfolgreich herstellen kann, können Sie nicht speichern und müssen den in der Oberfläche angezeigten Fehlermeldungen folgen, um die Verbindung zu reparieren.
  </Step>

  <Step title="Ereignisdaten überprüfen">
    Prüfen Sie Ihren S3-Bucket, um sicherzustellen, dass Iru Endpoint Aktivitätsprotokolldaten überträgt. Dies dauert maximal zwei Stunden, sofern in Ihrem Konto Tenant-Aktivitätsereignisse erzeugt wurden.
  </Step>
</Steps>

## Hinweise

<CardGroup cols={2}>
  <Card title="Häufigkeit der Aktivitätsprotokolle" icon="clock">
    Aktivitätsprotokollereignisse werden stündlich aktualisiert, wobei die erste Erfassung nur die Aktivitäten der vorangegangenen Stunde umfasst. Die exportierten Ereignisse entsprechen dem Umfang von [Unified Activity](/de/iru/platform-overview/unified-activity) (alle unterstützten Aktivitätstypen aus Tenant, Endpoint, Detections, Schwachstellen und Compliance).
  </Card>

  <Card title="IAM-Rollenberechtigungen" icon="key">
    Die IAM-Rolle muss über die erforderlichen Berechtigungen verfügen, damit Iru Endpoint diese Rolle übernehmen und in den S3-Bucket schreiben kann.
  </Card>

  <Card title="S3-Bucket-Richtlinie" icon="file-lines">
    Möglicherweise müssen Sie die S3-Bucket-Richtlinie anpassen, damit Iru Endpoint Objekte in den Bucket schreiben kann.
  </Card>

  <Card title="Sicherheitsanforderungen" icon="lock">
    Stellen Sie sicher, dass für den S3-Bucket eine ordnungsgemäße Verschlüsselung aktiviert und der öffentliche Zugriff blockiert ist, um die Sicherheits-Compliance zu gewährleisten.
  </Card>

  <Card title="Datenaufbewahrung" icon="archive">
    Erwägen Sie die Implementierung von S3-Lebenszyklusrichtlinien, um die Aufbewahrung von Protokolldaten und die Speicherkosten zu verwalten.
  </Card>

  <Card title="Überwachung" icon="chart-line">
    Richten Sie CloudWatch-Alarme ein, um den Zugriff auf den S3-Bucket und die Zustellung der Aktivitätsprotokolle zu überwachen.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Einheitliche Aktivität" icon="timeline" href="/de/iru/platform-overview/unified-activity">
    Durchsuchen und filtern Sie dieselben Tenant-Aktivitätsereignisse in der Iru-Web-App vor oder nach dem Export nach S3.
  </Card>

  <Card title="Aktivitätsseite" icon="timeline" href="/de/endpoint/devices/activity-page">
    Aktuelle Aktivitätszeitleiste von Endpoint, verfügbar neben Unified Activity, solange sich diese in der Vorschau befindet.
  </Card>
</CardGroup>