Zum Hauptinhalt springen
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:

​
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 > 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

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