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

> Importez les alertes anti-rançongiciel, gérez les terminaux et mettez en quarantaine ou libérez des fichiers depuis Halcyon

L’intégration Halcyon synchronise dans Wirespeed les alertes anti-rançongiciel et les données des terminaux provenant de Halcyon, notamment :

* **Détections de rançongiciels** : exécutables malveillants, tentatives de force brute, pilotes vulnérables, etc.
* **Enrichissement des artefacts** : les hachages SHA256, les chemins de fichiers, les IP et les enregistrements DNS sont automatiquement extraits en vue d’un enrichissement complémentaire
* **Inventaire des terminaux** : les appareils sur lesquels l’agent Halcyon est installé sont synchronisés en tant que terminaux

## Prérequis

Avant de configurer cette intégration, assurez-vous de disposer des éléments suivants :

1. Un compte Halcyon avec des privilèges **admin**
2. Le nom d’utilisateur et le mot de passe de votre compte Halcyon
3. Votre ID de locataire (si vous utilisez une configuration multilocataire ou MSSP)

## Étape 1 : rassembler vos identifiants

Vous aurez besoin des informations suivantes issues de votre compte Halcyon :

| Champ | Description |
| - | - |
| **Nom d’utilisateur** | Le nom d’utilisateur de votre compte administrateur Halcyon |
| **Mot de passe** | Le mot de passe de votre compte administrateur Halcyon |
| **ID de locataire** | *(Facultatif)* L’UUID de votre locataire Halcyon. Obligatoire pour les configurations multilocataires ou MSSP. |

> [!WARNING]
>
> Vos identifiants donnent accès à votre locataire Halcyon. Conservez-les en lieu sûr et, dans la mesure du possible, utilisez un compte dédié à l’intégration Wirespeed.

## Étape 2 : ajouter l’intégration dans Wirespeed

1. Connectez-vous à Wirespeed et accédez à Intégrations > [**Ajouter une intégration**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Recherchez et sélectionnez **Halcyon**
3. Saisissez votre **Nom d’utilisateur**, votre **Mot de passe** et, si nécessaire, votre **ID de locataire**
4. Cliquez sur **Intégrer** pour terminer la configuration

## Quelles données sont synchronisées ?

### Alertes (détections)

Wirespeed ingère les alertes de Halcyon. Chaque alerte est enrichie avec :

* **Artefacts** : hachages de fichiers (SHA256), chemins de fichiers, adresses IP et enregistrements DNS issus de l’alerte
* **Actifs** : appareils concernés associés à l’alerte

> [!TIP]
>
> Les hachages SHA256 extraits des artefacts Halcyon sont automatiquement enrichis par d’autres intégrations, comme ReversingLabs, lorsqu’elles sont disponibles.

### Appareils (terminaux)

Tous les appareils équipés de l’agent Halcyon sont synchronisés en tant que terminaux, avec leur nom d’hôte, leur système d’exploitation et leur statut de connexion.

## Dépannage

### Erreurs d’authentification

Si vous constatez des erreurs d’authentification :

1. Vérifiez que votre nom d’utilisateur et votre mot de passe sont corrects
2. Assurez-vous que votre compte dispose de privilèges administrateur
3. Si vous utilisez une configuration multilocataire, vérifiez que l’ID de locataire est correct

### Aucune alerte n’apparaît

Si les alertes ne s’affichent pas :

1. Les alertes peuvent mettre quelques minutes à apparaître après la configuration initiale
2. La synchronisation initiale récupère jusqu’aux 5 000 alertes les plus récentes
3. Vérifiez que des alertes existent dans votre console Halcyon

## Ressources complémentaires

* [Documentation de l’API Halcyon](https://api.halcyon.ai/docs/index.html)

> [!NOTE]
>
> Lors de la première synchronisation, Wirespeed récupère jusqu’aux **5 000** alertes les plus récentes.


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