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

# Halcyon

> Anti-Ransomware-Warnungen aus Halcyon importieren, Endgeräte verwalten und Dateien unter Quarantäne stellen oder freigeben

Die Halcyon-Integration synchronisiert Anti-Ransomware-Warnungen und Endgerätedaten aus Halcyon in Wirespeed, darunter:

* **Ransomware-Detektionen**: bösartige ausführbare Dateien, Brute-Force-Versuche, anfällige Treiber und mehr
* **Artefakt-Anreicherung**: SHA256-Hashes, Dateipfade, IPs und DNS-Einträge werden automatisch zur weiteren Anreicherung extrahiert
* **Endgeräte-Inventar**: Geräte, auf denen der Halcyon-Agent installiert ist, werden als Endgeräte synchronisiert

## Voraussetzungen

Stellen Sie vor der Einrichtung dieser Integration sicher, dass Sie Folgendes haben:

1. Ein Halcyon-Konto mit **Administrator**-Rechten
2. Benutzername und Passwort Ihres Halcyon-Kontos
3. Ihre Mandanten-ID (bei einer Multi-Mandanten- oder MSSP-Umgebung)

## Schritt 1: Zugangsdaten zusammenstellen

Sie benötigen die folgenden Informationen aus Ihrem Halcyon-Konto:

| Feld | Beschreibung |
| - | - |
| **Benutzername** | Der Benutzername Ihres Halcyon-Administratorkontos |
| **Passwort** | Das Passwort Ihres Halcyon-Administratorkontos |
| **Mandanten-ID** | *(Optional)* Die UUID Ihres Halcyon-Mandanten. Erforderlich für Multi-Mandanten- oder MSSP-Umgebungen. |

> [!WARNING]
>
> Ihre Zugangsdaten gewähren Zugriff auf Ihren Halcyon-Mandanten. Bewahren Sie sie sicher auf und verwenden Sie nach Möglichkeit ein Konto, das ausschließlich für die Wirespeed-Integration bestimmt ist.

## Schritt 2: Integration in Wirespeed hinzufügen

1. Melden Sie sich bei Wirespeed an und gehen Sie zu Integrationen > [**Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Suchen Sie nach **Halcyon** und wählen Sie es aus
3. Geben Sie Ihren **Benutzernamen**, Ihr **Passwort** und optional Ihre **Mandanten-ID** ein
4. Klicken Sie auf **Integrieren**, um die Einrichtung abzuschließen

## Was wird synchronisiert?

### Warnungen (Detektionen)

Wirespeed erfasst Warnungen aus Halcyon. Jede Warnung wird angereichert mit:

* **Artefakten**: Datei-Hashes (SHA256), Dateipfaden, IP-Adressen und DNS-Einträgen aus der Warnung
* **Assets**: betroffenen Geräten, die mit der Warnung verknüpft sind

> [!TIP]
>
> Aus Halcyon-Artefakten extrahierte SHA256-Hashes werden, sofern verfügbar, automatisch durch andere Integrationen wie ReversingLabs angereichert.

### Geräte (Endgeräte)

Alle Geräte mit dem Halcyon-Agenten werden als Endgeräte synchronisiert, einschließlich Hostname, Betriebssystem und Online-Status.

## Fehlerbehebung

### Authentifizierungsfehler

Wenn Authentifizierungsfehler angezeigt werden:

1. Prüfen Sie, ob Benutzername und Passwort korrekt sind
2. Stellen Sie sicher, dass Ihr Konto über Administratorrechte verfügt
3. Prüfen Sie bei einer Multi-Mandanten-Umgebung, ob die Mandanten-ID korrekt ist

### Keine Warnungen sichtbar

Wenn keine Warnungen angezeigt werden:

1. Nach der Ersteinrichtung kann es einige Minuten dauern, bis Warnungen erscheinen
2. Die erste Synchronisierung ruft bis zu 5.000 der neuesten Warnungen ab
3. Prüfen Sie, ob in Ihrer Halcyon-Konsole Warnungen vorhanden sind

## Weitere Ressourcen

* [Halcyon-API-Dokumentation](https://api.halcyon.ai/docs/index.html)

> [!NOTE]
>
> Bei der ersten Synchronisierung ruft Wirespeed bis zu **5.000** der neuesten Warnungen ab.


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