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

# AWS GuardDuty

> Integration mit AWS GuardDuty

> [!NOTE]
>
> Wirespeed verwendet die [AssumeRole API](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html), um sich in Ihre AWS-Konten zu integrieren.

## Alle Konten integrieren (empfohlen)

Diese Methode verwendet [AWS CloudFormation StackSets](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html), um die erforderlichen Integrationsberechtigungen in allen AWS-Organisationen unterhalb Ihres Root-Kontos bereitzustellen. Außerdem wird Wirespeed automatisch in allen neuen AWS-Konten bereitgestellt, die Sie anlegen.

> [!WARNING]
>
> Wir empfehlen, die Bereitstellung zunächst mit einer Teilmenge der Konten zu testen, um Fehler zu minimieren. Kopieren Sie unseren [CloudFormation-Quick-Link](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/quickcreate?templateURL=https://s3.us-west-2.amazonaws.com/aws-deploy.wirespeed.co/deploy-template.yaml\&stackName=Wirespeed-GuardDuty-Integration), melden Sie sich im gewünschten Konto der AWS-Konsole an und rufen Sie den kopierten Link auf, um die Bereitstellung in einem einzelnen Konto durchzuführen.

### In Wirespeed

1. Navigieren Sie zu Integrationen > [Integration hinzufügen](https://app.wirespeed.co/settings/integrations?tab=browse) > AWS GuardDuty > Organisationsweit
2. **Kopieren Sie den API-Schlüssel** zur Verwendung in **Schritt 2** weiter unten

### In AWS

Stellen Sie sicher, dass GuardDuty in allen Konten aktiviert ist, die Sie integrieren möchten. Andernfalls werden die Integrationen auf „fehlgeschlagen“ gesetzt.

1. Melden Sie sich in der AWS-Konsole **als Administrator** bei Ihrem AWS-Root-Konto an
2. Stellen Sie sicher, dass [Trusted Access](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html) für Ihr Konto aktiviert ist
3. Navigieren Sie zu **CloudFormation** > **Stack Sets** > **Create Stack Set**
4. Fahren Sie mit den folgenden Schritten fort

#### Schritt 1

1. Permission Model > Service-Managed Permissions
2. Prepare Template > Template is ready
3. Specify Template > **Amazon S3 URL** > `https://s3.us-west-2.amazonaws.com/aws-deploy.wirespeed.co/deploy-template.yaml`

#### Schritt 2

1. Verwenden Sie einen sinnvollen Namen und eine Beschreibung
2. Geben Sie den **API-Schlüssel** an, den Sie im Schritt **Erste Schritte** > **In Wirespeed** weiter oben kopiert haben

#### Schritt 3

1. Bestätigen Sie den Haftungsausschluss

#### Schritt 4

1. Behalten Sie alle Standardeinstellungen bei
2. Wählen Sie eine einzelne Region für die Bereitstellung (IAM-Rollen sind global, daher müssen Sie nur eine auswählen)

#### Schritt 5

1. Klicken Sie auf Submit

#### Schritt 6

1. Dieses Stack Set umfasst keine Bereitstellung in Ihrem Root-Verwaltungskonto. Um in diesem Konto bereitzustellen, melden Sie sich in der AWS-Konsole bei Ihrem Root-Konto an, rufen Sie [diesen Link](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/quickcreate?templateURL=https%3A%2F%2Fs3.us-west-2.amazonaws.com%2Faws-deploy.wirespeed.co%2Fdeploy-template.yaml\&stackName=Wirespeed-GuardDuty-Integration) auf und folgen Sie den Anweisungen.
   \[!NOTE] Stellen Sie sicher, dass das Stack Set in allen Konten Ihrer Organisation korrekt bereitgestellt wird, und beheben Sie Fehler bei Bedarf. Wenden Sie sich an Wirespeed, wenn Sie Unterstützung benötigen. Nach erfolgreicher Bereitstellung werden die Konten in Wirespeed unter [Integrationen](https://app.wirespeed.co/settings/integrations) angezeigt.
   \[!TIP] Dieser CloudFormation-Stack wird künftig in allen neuen Konten bereitgestellt, die Sie in Ihrer Organisation anlegen.

## Ein einzelnes Konto integrieren

### CloudFormation (Option A)

1. Melden Sie sich bei Wirespeed an und navigieren Sie zu Integrationen > [**Neue Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Wählen Sie **AWS GuardDuty** aus der Dropdown-Liste
3. Wählen Sie **Einzelnes Konto (automatisch)**
4. Kopieren Sie den API-Schlüssel
5. Klicken Sie [hier](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?templateURL=https://s3.us-west-2.amazonaws.com/aws-deploy.wirespeed.co/deploy-template.yaml\&stackName=Wirespeed-GuardDuty-Integration), um einen CloudFormation-Stack bereitzustellen
6. Folgen Sie allen Anweisungen und übernehmen Sie die Standardoptionen

Nach Abschluss wird das Konto auf der Seite [Integrationen](https://app.wirespeed.co/settings/integrations) in Wirespeed angezeigt.

### Manuell (Option B)

1. Melden Sie sich in Ihrer AWS-Konsole an und öffnen Sie die Seite **IAM**.
2. Gehen Sie zu **Access Management** > **Roles**.
3. Klicken Sie auf **Create Role**.
4. Wählen Sie unter **Trusted Entity Type** die Option **AWS Account**.
5. Aktivieren Sie **Require External ID** und geben Sie ein sicheres, zufällig generiertes Passwort ein.
   a. Speichern Sie diese Angabe unbedingt, da Sie sie später benötigen, um das Konto in Wirespeed hinzuzufügen.
   b. **Hinweis:** AWS verlangt, dass die External ID dem regulären Ausdruck `^[\w+=,.@:/-]*$` entspricht.
6. Wählen Sie **Another AWS Account** und geben Sie die ID `590183894387` ein.
7. Wählen Sie **Next**, um zur Seite **Add Permissions** zu gelangen.
8. Öffnen Sie in IAM einen neuen Tab und gehen Sie zur Seite **Policies**. Wählen Sie **Create Policy**.
9. Fügen Sie im neu geöffneten Browserfenster die folgende JSON-Vorlage ein:

```
{
  "Version": "2012-10-17",
  "Statement": [
  {
    "Sid": "VisualEditor0",
    "Effect": "Allow",
    "Action": [
      "ec2:DescribeRegions",
      "guardduty:EnableOrganizationAdminAccount",
      "guardduty:DeleteMalwareProtectionPlan",
      "guardduty:ListThreatIntelSets",
      "guardduty:GetThreatIntelSet",
      "guardduty:CreateDetector",
      "guardduty:DisassociateMembers",
      "guardduty:DescribeMalwareScans",
      "guardduty:UpdateMemberDetectors",
      "guardduty:GetAdministratorAccount",
      "guardduty:GetDetector",
      "guardduty:AcceptInvitation",
      "guardduty:GetRemainingFreeTrialDays",
      "guardduty:UpdateMalwareScanSettings",
      "guardduty:ListInvitations",
      "guardduty:DisassociateFromAdministratorAccount",
      "guardduty:UpdateMalwareProtectionPlan",
      "guardduty:UnarchiveFindings",
      "guardduty:GetMemberDetectors",
      "guardduty:DeclineInvitations",
      "guardduty:DeleteDetector",
      "guardduty:ListPublishingDestinations",
      "guardduty:GetFilter",
      "guardduty:ListTagsForResource",
      "guardduty:ListMembers",
      "guardduty:ListIPSets",
      "guardduty:ListCoverage",
      "guardduty:CreateSampleFindings",
      "guardduty:GetMasterAccount",
      "guardduty:UpdateFindingsFeedback",
      "guardduty:GetCoverageStatistics",
      "guardduty:ListMalwareProtectionPlans",
      "guardduty:GetMembers",
      "guardduty:GetOrganizationStatistics",
      "guardduty:UpdateFilter",
      "guardduty:SendSecurityTelemetry",
      "guardduty:CreateThreatIntelSet",
      "guardduty:StopMonitoringMembers",
      "guardduty:CreateMalwareProtectionPlan",
      "guardduty:CreateFilter",
      "guardduty:GetMalwareScanSettings",
      "guardduty:DisableOrganizationAdminAccount",
      "guardduty:ListFilters",
      "guardduty:DeleteThreatIntelSet",
      "guardduty:GetInvitationsCount",
      "guardduty:GetFindings",
      "guardduty:DeleteMembers",
      "guardduty:DeleteIPSet",
      "guardduty:DeleteFilter",
      "guardduty:AcceptAdministratorInvitation",
      "guardduty:DeletePublishingDestination",
      "guardduty:ListFindings",
      "guardduty:DisassociateFromMasterAccount",
      "guardduty:DeleteInvitations",
      "guardduty:DescribePublishingDestination",
      "guardduty:GetMalwareProtectionPlan",
      "guardduty:InviteMembers",
      "guardduty:ListDetectors",
      "guardduty:ArchiveFindings",
      "guardduty:UpdateDetector",
      "guardduty:GetIPSet",
      "guardduty:StartMalwareScan",
      "guardduty:UpdateOrganizationConfiguration",
      "guardduty:StartMonitoringMembers",
      "guardduty:GetUsageStatistics",
      "guardduty:CreateMembers",
      "guardduty:ListOrganizationAdminAccounts",
      "guardduty:DescribeOrganizationConfiguration",
      "guardduty:GetFindingsStatistics"
    ],
    "Resource": "*"
   }
 ]
}
```

10. Klicken Sie auf **Next**, geben Sie einen Namen für die Richtlinie ein und wählen Sie **Create Policy**.
11. Kehren Sie zum Fenster für die Rollenerstellung zurück, aktualisieren Sie die Richtlinienliste und aktivieren Sie das Kontrollkästchen der neu erstellten Richtlinie.
12. Klicken Sie auf **Next**.
13. Geben Sie einen Namen für die Rolle an und prüfen Sie dann den Abschnitt **Trusted Entities**. Die Vertrauensrichtlinie sollte etwa so aussehen:

```
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "sts:AssumeRole", 
      "Principal": {
        "AWS": "arn:aws:iam::590183894387:root"
      },
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "[RANDOM_PASSWORD]"
        }
      }
    }
  ]
}
```

14. Stellen Sie sicher, dass die neu erstellte Richtlinie im Abschnitt mit den Berechtigungen angezeigt wird, und wählen Sie dann „Create Role“. Notieren Sie sich den ARN der Rolle.
15. Melden Sie sich bei Wirespeed an und navigieren Sie zu Integrationen > [**Neue Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse)
16. Wählen Sie **AWS GuardDuty** aus der Dropdown-Liste
17. Wählen Sie **Einzelnes Konto (manuell)**
18. Geben Sie den **Rollen-ARN** und die **External ID** ein
19. Klicken Sie auf **Integrieren**

> [!NOTE]
>
> Bei der ersten Synchronisierung ruft Wirespeed GuardDuty-Findings ab, die in den letzten **90 Tagen** aktualisiert wurden (pro Detector und Region).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.