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

# Upwind

> Upwind-Bedrohungsdetektionen für Cloud und Workloads als Detektionen und Bedrohungsereignisse als Protokolle erfassen

Um Upwind zu integrieren, erstellen Sie in der Upwind-Konsole API-Client-Zugangsdaten und übergeben sie zusammen mit Ihrer Organisations-ID und dem API-Host Ihrer Region an Wirespeed.

## Voraussetzungen

* Ein Upwind-Konto, das API-Client-Zugangsdaten (eine Client-ID und einen geheimen Clientschlüssel) erstellen darf
* Ein API-Client, der Bedrohungsdetektionen und Bedrohungsereignisse lesen und Bedrohungsdetektionen aktualisieren darf, sofern die Integration nicht **Schreibgeschützt** ist
* Ihre Upwind-Organisations-ID, zum Beispiel `org_Xk9mPq7RtYwN2vLs`
* Der API-Host Ihrer Upwind-Region:

| Region | API-Host |
| - | - |
| USA | `api.upwind.io` |
| EU | `api.eu.upwind.io` |
| Naher Osten | `api.me.upwind.io` |

## API-Zugangsdaten erstellen

1. Melden Sie sich an der Upwind-Konsole an
2. Navigieren Sie zu **Settings** > **Access Management** und öffnen Sie die Registerkarte **Credentials**
3. Klicken Sie auf **Generate Credential**
4. Wählen Sie **API** als Typ der Zugangsdaten und behalten Sie den automatisch erzeugten Namen bei oder geben Sie einen sprechenden Namen wie `Wirespeed` ein
5. Kopieren Sie **Client ID** und **Client Secret**. Das Secret wird möglicherweise nur einmal angezeigt

## Integration in Wirespeed hinzufügen

1. Navigieren Sie in Wirespeed zu **Integrationen** > [**Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse) > **Upwind**
2. Prüfen Sie den **API-Host**. Standardmäßig ist `api.upwind.io` (USA) eingetragen. Ändern Sie ihn, wenn sich Ihre Organisation in der Region EU oder Naher Osten befindet
3. Geben Sie **Organisations-ID**, **Client-ID** und **Geheimer Clientschlüssel** ein
4. Senden Sie die Integration ab

Beim Speichern prüft Wirespeed die Zugangsdaten, die Region und die Organisations-ID. Ein Token, das für eine Region ausgestellt wurde, wird von den anderen Regionen abgelehnt. Der API-Host muss daher zur Region Ihrer Upwind-Organisation passen.

## Von Wirespeed erfasste Daten

| Quelle | Upwind-API | Zweck |
| - | - | - |
| Bedrohungsdetektionen | `GET /v1/organizations/{organization-id}/threat-detections` | Detektionen mit der betroffenen Cloud-Ressource und dem betroffenen Konto, MITRE-ATT\&CK-Kontext sowie den Prozessen, Dateien, Netzwerk-Gegenstellen mit schlechter Reputation und Principals aus Audit-Protokollen oder CloudTrail aus jedem Auslöser |
| Bedrohungsereignisse | `GET /v1/organizations/{organization-id}/threat-events` | Prozessausführungen, Aktivitäten bösartiger Dateien, Netzwerkaktivitäten mit schlechter Reputation, Ereignisse aus Kubernetes- und Cloud-Audit-Protokollen, CloudTrail-Ereignisse und Belege für Bedrohungsverstöße, gespeichert als Protokolle |

Wirespeed fragt Detektionen danach ab, wann Upwind sie zuletzt gesehen hat, beginnend mit den vergangenen 24 Stunden. Eine Detektion, die erneut auftritt, nachdem Wirespeed sie erfasst hat, wird nicht noch einmal erfasst.

Wirespeed fragt Bedrohungsereignisse danach ab, wann Upwind sie zum ersten Mal gesehen hat, beginnend mit den vergangenen 24 Stunden. Ereignisse werden etwa zwei Minuten, nachdem Upwind sie zum ersten Mal gesehen hat, gelesen. Schlägt eine Abfrage mittendrin fehl, liest die nächste Abfrage denselben Zeitraum erneut, sodass manche Ereignisse doppelt gespeichert werden können.

## Aktualisierungen von Detektionen

Wenn eine Detektion abgeschlossen wird, archiviert Wirespeed die Upwind-Bedrohungsdetektion. Upwind bietet keine API für Kommentare, daher bleiben die Kommentare der Analysten in Wirespeed. Um die Archivierung zu verhindern, aktivieren Sie beim Hinzufügen der Integration in den erweiterten Optionen **Schreibgeschützt**. Diese Einstellung lässt sich danach nicht mehr ändern.

## Aktuelle Einschränkungen

* Eindämmungs- und Behebungsmaßnahmen sind nicht verfügbar
* Das erneute Öffnen einer Detektion hebt die Archivierung der Upwind-Bedrohungsdetektion nicht auf
* Detektionen werden erst eskaliert, wenn Kategorisierungsregeln für Upwind definiert sind


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