Halo ITSM

​

Prérequis

1. Connectez-vous à votre instance Halo ITSM
2. Accédez à Configuration > Integrations > HaloPSA API > View Applications
3. Cliquez sur New pour créer une application
4. Définissez Authentication Method sur Client ID and Secret (Services)
5. Définissez Login Type sur Agent et Agent sur Application Identity
6. Sous Identity Roles, sélectionnez IT Agent
7. Accordez à l’application l’accès aux scopes suivants : read:tickets, edit:tickets, read:customers
8. Copiez le Client ID et le Client Secret
9. Enregistrez l’application

​

Connecter Wirespeed à Halo ITSM

1. Connectez-vous à Wirespeed et accédez à Intégrations > Ajouter une intégration
2. Sélectionnez Halo ITSM et cliquez sur Intégrer
3. Renseignez les champs suivants :
   • URL de l’instance Halo — l’URL de base de votre instance Halo (par exemple https://yourcompany.halopsa.com)
   • ID client — issu de l’application API créée ci-dessus
   • Secret client — issu de l’application API créée ci-dessus
4. Cliquez sur Enregistrer

​

Configurer le comportement des tickets

​

Ajouter un webhook

1. Connectez-vous à Wirespeed et accédez à Intégrations > sélectionnez votre intégration Halo ITSM > Configurer
2. Copiez l’URL du webhook et le Secret du webhook
3. Connectez-vous à votre instance Halo ITSM
4. Accédez à Configuration > Integrations > Webhooks
5. Cliquez sur New pour créer un webhook
6. Collez l’URL du webhook obtenue à l’étape 2
7. Définissez Authentication sur Sign Request Body with a Secret Key
8. Définissez Secret sur le Secret du webhook obtenu à l’étape 2
9. Configurez x-signature comme nom de l’en-tête de signature et définissez Signing Algorithm sur SHA-256
   La liste déroulante Signing Algorithm de Halo propose également RSA-SHA256 et d’autres variantes RSA. Ne sélectionnez pas l’une d’entre elles : Wirespeed ne peut pas vérifier les requêtes signées avec RSA, et chaque appel du webhook échouera avec une erreur 400 tant que l’algorithme n’aura pas été redéfini sur SHA-256.
10. Ajoutez les Request Headers suivants à la signature, dans cet ordre exact :
    1. content-length
    2. content-type
    3. host
    4. x-halo-date
    Les quatre en-têtes sont obligatoires. L’omission de l’un d’eux invalide le HMAC et Wirespeed renvoie 400. Le champ Version de Halo est ignoré par Wirespeed. Conservez la valeur par défaut ; elle n’a aucune incidence sur la vérification de la signature.
11. Sous Events, ajoutez Ticket Updated by Agent. Dans Edit criteria, définissez :
    • Rule Type: Contains (comma separated value)
    • Summary: Wirespeed:, WSPD-, DTN-
12. Ajoutez Ticket Updated by User avec les mêmes valeurs dans Edit criteria
13. Enregistrez le webhook

content-length: <content-length>
content-type: <content-type>
host: <host>
x-halo-date: <x-halo-date>
<raw request body>

​

Fonctionnement

• Lorsqu’un dossier est créé ou qu’une détection se déclenche dans Wirespeed, un ticket est créé dans Halo en tant qu’Incident, avec une priorité déterminée à partir de la gravité (Critique → P1, Élevée → P2, Moyenne → P3, Faible/Information → P4).
• Lorsqu’un ticket est clôturé dans Halo (ID de statut 9), le dossier Wirespeed correspondant est automatiquement clôturé.
• Les notes ajoutées à un ticket dans Halo sont resynchronisées dans la chronologie du dossier Wirespeed.
• Les commentaires ajoutés à un dossier Wirespeed ou à l’une de ses détections sont publiés dans le ticket Halo associé.