Zum Hauptinhalt springen

​
Voraussetzungen

In Halo ITSM benötigen Sie eine API-Anwendung mit dem Grant-Typ Client Credentials. So erstellen Sie eine:
  1. Melden Sie sich bei Ihrer Halo ITSM-Instanz an
  2. Gehen Sie zu Configuration > Integrations > HaloPSA API > View Applications
  3. Klicken Sie auf New, um eine Anwendung zu erstellen
  4. Setzen Sie Authentication Method auf Client ID and Secret (Services)
  5. Setzen Sie Login Type auf Agent und Agent auf Application Identity
  6. Wählen Sie unter Identity Roles die Option IT Agent
  7. Gewähren Sie der Anwendung Zugriff auf die folgenden Scopes: read:tickets, edit:tickets, read:customers
  8. Kopieren Sie Client ID und Client Secret
  9. Speichern Sie die Anwendung

​
Wirespeed mit Halo ITSM verbinden

  1. Melden Sie sich bei Wirespeed an und gehen Sie zu Integrationen > Integration hinzufügen
  2. Wählen Sie Halo ITSM und klicken Sie auf Integrieren
  3. Füllen Sie die folgenden Felder aus:
    • URL der Halo-Instanz – die Basis-URL Ihrer Halo-Instanz (z. B. https://yourcompany.halopsa.com)
    • Client-ID – aus der oben erstellten API-Anwendung
    • Geheimer Clientschlüssel – aus der oben erstellten API-Anwendung
  4. Klicken Sie auf Speichern
Wirespeed prüft die Zugangsdaten, indem der Zugriff auf Teams, Ticket Types und Categories getestet wird. Schlägt eine Prüfung fehl, wird die Integration nicht aktiviert – prüfen Sie in diesem Fall Zugangsdaten und Scopes erneut.

​
Ticketverhalten konfigurieren

Klicken Sie nach dem Aktivieren der Integration auf Konfigurieren, um die Einstellungen für die Ticketerstellung festzulegen: Klicken Sie anschließend auf Speichern.

​
Webhook hinzufügen

Damit Wirespeed Fälle automatisch schließt, wenn ein Ticket in Halo gelöst wird, und Notizen zurücksynchronisiert, richten Sie einen Webhook ein:
  1. Melden Sie sich bei Wirespeed an und gehen Sie zu Integrationen > wählen Sie Ihre Halo-ITSM-Integration > Konfigurieren
  2. Kopieren Sie die Webhook-URL und das Webhook-Secret
  3. Melden Sie sich bei Ihrer Halo ITSM-Instanz an
  4. Gehen Sie zu Configuration > Integrations > Webhooks
  5. Klicken Sie auf New, um einen Webhook zu erstellen
  6. Fügen Sie die Webhook-URL aus Schritt 2 ein
  7. Setzen Sie Authentication auf Sign Request Body with a Secret Key
  8. Setzen Sie Secret auf das Webhook-Secret aus Schritt 2
  9. Konfigurieren Sie als Namen des Signatur-Headers x-signature und setzen Sie Signing Algorithm auf SHA-256
    Das Dropdown Signing Algorithm in Halo bietet auch RSA-SHA256 und andere RSA-Varianten an. Wählen Sie keine davon aus – Wirespeed kann RSA-signierte Anfragen nicht prüfen, und jeder Webhook-Aufruf schlägt mit einem 400-Fehler fehl, bis der Algorithmus wieder auf SHA-256 gesetzt wird.
  10. Fügen Sie der Signatur die folgenden Request Headers in genau dieser Reihenfolge hinzu:
    1. content-length
    2. content-type
    3. host
    4. x-halo-date
    Alle vier Header sind erforderlich. Fehlt einer davon, ist der HMAC ungültig und Wirespeed gibt 400 zurück. Das Feld Version in Halo wird von Wirespeed ignoriert. Behalten Sie den Standardwert bei; er hat keinen Einfluss auf die Signaturprüfung.
  11. Fügen Sie unter Events das Ereignis Ticket Updated by Agent hinzu. Legen Sie unter Edit criteria Folgendes fest:
    • Rule Type: Contains (comma separated value)
    • Summary: Wirespeed:, WSPD-, DTN-
  12. Fügen Sie Ticket Updated by User mit denselben Werten unter Edit criteria hinzu
  13. Speichern Sie den Webhook
Das Webhook-Secret ist erforderlich. Wirespeed prüft den Header x-signature per HMAC-SHA256 mit dem Webhook-Secret aus Schritt 2 als Schlüssel. Halo bezieht x-halo-date in diese Signatur ein; Wirespeed lehnt außerdem Callbacks ab, deren x-halo-date fehlt, nicht auswertbar ist oder mehr als 5 Minuten von der Serveruhr abweicht.Halo sollte die Signatur aus dieser kanonischen Zeichenfolge berechnen:
Der resultierende HMAC-SHA256-Digest sollte base64-kodiert und im Header x-signature gesendet werden.

​
Funktionsweise

  • Wenn ein Wirespeed-Fall oder eine Detektion ausgelöst wird, wird in Halo ein Ticket als Incident erstellt; die Priorität wird aus dem Schweregrad abgeleitet (Kritisch → P1, Hoch → P2, Mittel → P3, Niedrig/Informativ → P4).
  • Wenn ein Ticket in Halo geschlossen wird (Status-ID 9), wird der zugehörige Wirespeed-Fall automatisch geschlossen.
  • Notizen, die einem Ticket in Halo hinzugefügt werden, werden in die Zeitleiste des Wirespeed-Falls zurücksynchronisiert.
  • Kommentare zu einem Wirespeed-Fall oder einer seiner Detektionen werden im verknüpften Halo-Ticket veröffentlicht.