Zum Hauptinhalt springen

AlgaPSA-Integration

Connect Level to AlgaPSA so groups map to clients, devices sync as assets, and Level alerts open AlgaPSA tickets.

Einführung

AlgaPSA spiegelt Ihr Level-Setup auf der PSA-Seite wider: Level-Gruppen werden AlgaPSA-Clients zugeordnet, Geräte in zugeordneten Gruppen werden in Assets synchronisiert, und Level-Warnmeldungen öffnen Tickets über die Warnregeln von AlgaPSA.

Die Einrichtung umfasst beide Plattformen. In Level erstellen Sie einen API-Schlüssel und eine Automatisierung, die Warnmeldungen an AlgaPSA sendet. In AlgaPSA fügen Sie den Schlüssel ein, ordnen Gruppen zu und führen die Gerätesynchronisierung aus.

ℹ️ HINWEIS: Diese Integration wurde von Nine Minds, den Entwicklern von AlgaPSA, erstellt und wird von ihnen gepflegt. Informationen zur AlgaPSA-seitigen Einrichtung finden Sie in deren Dokumentation: Level RMM Integration. Es handelt sich um ein Feature der AlgaPSA Enterprise Edition.

⚙️ VORAUSSETZUNGEN

  • Level-Administratorzugriff (zum Erstellen eines API-Schlüssels und einer Automatisierung)

  • Ein AlgaPSA Enterprise Edition-Konto mit Zugriff auf die Admin-Einstellungen

  • Ihre AlgaPSA-Instanz muss unter einer öffentlichen HTTPS-Adresse erreichbar sein (siehe die Warnung unter Warnmeldungen an AlgaPSA senden)

AlgaPSA-Integration

API-Schlüssel in Level erstellen

AlgaPSA verwendet einen Level-API-Schlüssel, um Ihre Gruppen, Geräte und Warnmeldungen auszulesen.

  1. Navigieren Sie in Level zu Einstellungen → API-Schlüssel.

  2. Klicken Sie auf + API-Schlüssel erstellen.

  3. Geben Sie eine Beschreibung wie z. B. „AlgaPSA-Integration".

  4. Wählen Sie Schreibgeschütztein. Alles, was AlgaPSA von Level abruft (Gruppenermittlung, Gerätesynchronisierung, Warnmeldungs-Backfill), ist ein Lesevorgang, sodass ein schreibgeschützter Schlüssel ausreicht.

  5. Klicken Sie auf Schlüssel erstellen, verwenden Sie dann das Drei-Punkte-Menü in der neuen Zeile und wählen Sie Schlüssel kopieren.

Siehe Einstellungen für API-Schlüssel für vollständige Details zur Verwaltung von Schlüsseln.

AlgaPSA mit Level verbinden

  1. Gehen Sie in AlgaPSA zu Einstellungen → Allgemein um die Admin-Einstellungen zu öffnen.

  2. Wählen Sie Integrationen unter Daten & Integration, öffnen Sie die RMM Registerkarte und wählen Sie Level.

  3. Fügen Sie Ihren Schlüssel in das API-Schlüssel Feld auf der Level-Verbindung Karte.

  4. Klicken Sie auf Konfiguration speichern, dann Verbindung testen.

Ein erfolgreicher Test markiert die Integration als Verbunden und zeigt die Verbindungszeit an.

Gruppen zuordnen und Geräte synchronisieren

Die Zuordnung erfolgt vollständig in AlgaPSA, auf der Synchronisieren & Gruppenzuordnungen Karte.

  1. Klicken Sie auf Gruppen ermitteln. AlgaPSA importiert Ihre Level-Gruppenhierarchie in die Zuordnungstabelle.

  2. Wählen Sie für jede von Ihnen verwaltete Gruppe einen AlgaPSA-Client im Zugeordneter Client Dropdown. Optional können Sie einen Standardkontakt, der Tickets zugewiesen wird, die durch Warnmeldungen dieser Gruppe geöffnet werden.

  3. Klicken Sie auf Gerätesynchronisierung ausführenfestlegen. Geräte in zugeordneten Gruppen werden zu AlgaPSA-Assets.

Zwei Verhaltensweisen sind wissenswert:

  • Untergruppen erben. Eine Untergruppe ohne eigene Zuordnung verwendet die nächste zugeordnete übergeordnete Gruppe, sodass die Zuordnung der obersten Gruppe eines Clients in der Regel dessen gesamte Hierarchie abdeckt.

  • Nicht zugeordnete Gruppen werden übersprungen. Geräte in einer Gruppe ohne Zuordnung und ohne zugeordnete übergeordnete Gruppe werden nicht synchronisiert.

💡 TIPP: Ordnen Sie eine Level-Gruppe der obersten Ebene pro Client zu und lassen Sie die Untergruppen erben. Das ist weniger Aufwand, als jede Untergruppe manuell zuzuordnen.

Warnmeldungen an AlgaPSA senden

AlgaPSA authentifiziert eingehende Warnmeldungen mit seinem eigenen X-Alga-Webhook-Secret Header und erwartet eine eigene JSON-Nutzlast. Die integrierten Webhooks von Level (Einstellungen → Webhookssenden eine feste Nutzlast und fügen nur einen X-Level-Signature Header, sodass Warnmeldungen über eine Automatisierung mit einer HTTP-Anfrage Aktion stattdessen, mit der Sie benutzerdefinierte Header und einen benutzerdefinierten Body festlegen können.

In AlgaPSA, öffnen Sie die Warnmeldungs-Webhook Karte und kopieren Sie die drei Werte, die sie liefert: den Webhook-URL, die Header Name und Geheimnis (das Augensymbol zeigt das Geheimnis an) sowie die Nutzlast-Vorlage.

In Level:

  1. Navigieren Sie zu Automatisierungen und erstellen Sie eine neue Automatisierung, zum Beispiel „AlgaPSA-Warnmeldungsticket".

  2. Klicken Sie in der Pipeline auf + und wählen Sie HTTP-Anfrage aus der Kategorie „Sonstige".

  3. Füllen Sie die Aktion aus:

    • URL: die AlgaPSA-Webhook-URL

    • Methode: POST

    • Inhaltstyp: application/json

    • Body: die Nutzlast-Vorlage aus AlgaPSA, unverändert eingefügt

    • Header: klicken Sie auf + Anfrage-Header hinzufügen und fügen Sie X-Alga-Webhook-Secret mit dem Geheimniswert

  4. Speichern Sie die Automatisierung.

An automation in edit mode with an HTTP request action panel open, showing the URL, Method POST, Content type application/json, Body, and a custom request header row

Weisen Sie nun die Monitore, die Tickets öffnen sollen, dieser Automatisierung zu:

  1. Öffnen Sie die Monitor-Richtlinie, die die Warnmeldungen auslöst, die Sie als Ticket erfassen möchten (Monitor-Richtlinien in der Seitenleiste).

  2. Öffnen Sie einen Monitor und suchen Sie den Problembehebung Abschnitt „Automatisierungen ausführen, wenn diese Warnmeldung ausgelöst wird".

  3. Wählen Sie Ihre AlgaPSA-Automatisierung in der Automatisierung zur Problembehebung Auswahl, dann speichern.

  4. Wiederholen Sie dies für jeden Monitor, dessen Warnmeldungen zu Tickets werden sollen.

A monitor in a monitor policy with the Remediation section visible

Die Automatisierung wird gegen das Gerät ausgeführt, das die Warnmeldung ausgelöst hat, sodass die Anfrage die Details dieses Geräts enthält.

⚠️ WARNUNG: Die HTTP-Anfrage-Aktion ruft nur öffentliche Adressen auf. Wenn Sie AlgaPSA selbst auf einer privaten oder Loopback-Adresse hosten, schlägt die Aktion mit der Meldung „Anfrage blockiert: Anfragen an private oder Loopback-Adressen sind nicht möglich." fehl. Geben Sie Ihrer AlgaPSA-Instanz einen öffentlich auflösbaren HTTPS-Hostnamen, bevor Sie die Automatisierung einrichten.

Vorhandene Warnmeldungen auffüllen

Der Webhook ist der Live-Feed. Um Warnmeldungen abzurufen, die bereits in Level vorhanden sind, oder um nach einem verpassten Ereignis aufzuholen, klicken Sie auf Warnmeldungen auffüllen auf AlgaPSAs Synchronisierungs- & Gruppenzuordnungskarte. Es gibt keine geplante Abfrage.

Integration testen

  1. Bestätigen Sie, dass die Level-Verbindungskarte in AlgaPSA Verbunden mit einem aktuellen Zeitstempel.

  2. Gleichen Sie die Asset-Liste eines Clients in AlgaPSA stichprobenartig mit seiner Level-Gruppe ab.

  3. Lösen Sie in Level eine Testwarnmeldung auf einem Monitor aus, dem Sie die Automatisierung zugewiesen haben.

  4. Bestätigen Sie, dass ein Ticket in AlgaPSA erscheint und über Ihre Warnregeln weitergeleitet wird.

Wenn kein Ticket erscheint, öffnen Sie den Automatisierungslauf für dieses Gerät und lesen Sie die Ausgabe der HTTP-Anfrage-Aktion. Sie protokolliert die Antwort, zum Beispiel HTTP 401 - Unauthorized bei einem ungültigen Geheimnis oder HTTP 404 - Not Found bei einer falsch eingegebenen URL. Überprüfen Sie dann:

  • Der Header-Name lautet genau X-Alga-Webhook-Secret und das Geheimnis keine zusätzlichen Leerzeichen enthält.

  • Die Webhook-URL wurde vollständig kopiert.

  • Die Gruppe des Geräts, das die Warnmeldung ausgelöst hat, ist einem Client in AlgaPSA zugeordnet.

  • Der Monitor listet Ihre Automatisierung tatsächlich unter Problembehebung.

Laufende Verwaltung

  • Schlüssel rotieren: erstellen Sie einen neuen API-Schlüssel in Level, fügen Sie ihn in AlgaPSA ein, testen Sie die Verbindung und löschen Sie dann den alten Schlüssel. Das Löschen eines Schlüssels tritt sofort in Kraft, führen Sie die Schritte also in dieser Reihenfolge aus.

  • Gruppen oder Geräte hinzufügen: führen Sie Gruppen ermitteln nachdem Sie Gruppen in Level hinzugefügt haben, und Gerätesynchronisierung ausführen um neue Geräte zu übertragen.

  • Ticketerstellung pausieren: deaktivieren Sie die Level-Automatisierung oder entfernen Sie sie aus dem Problembehebung Feld, um nur die Warnmeldungen dieses Monitors zu stoppen.

  • Geheimnis ändern: aktualisieren Sie den Header-Wert in der Level-Automatisierung, wann immer Sie ihn in AlgaPSA neu generieren.

Häufig gestellte Fragen

  • Muss ich AlgaPSA auf der Level-Integrationsseite aktivieren? Nein. Einstellungen → Integrationen in Level umfasst ConnectWise PSA, HaloPSA, Zest, Hudu und DeskDay. AlgaPSA verbindet sich über die Level-API und eine Automatisierung, sodass dort nichts aktiviert werden muss.

  • Schreibgeschützt oder Lese- und Schreibzugriff für den API-Schlüssel? Schreibgeschützt. AlgaPSA liest Gruppen, Geräte und Warnmeldungen aus Level und schreibt nichts zurück. Wenn ein Verbindungstest oder eine Synchronisierung mit einem Berechtigungsfehler fehlschlägt, wenden Sie sich an Nine Minds, bevor Sie den Schlüssel erweitern.

  • Kann ich Einstellungen → Webhooks anstelle einer Automatisierung verwenden? Nicht für AlgaPSA. Die Webhooks von Level können keinen benutzerdefinierten Header hinzufügen, und AlgaPSA erfordert X-Alga-Webhook-Secret bei jeder Anfrage. Die HTTP-Anfrage-Aktion innerhalb einer Automatisierung ist dafür zuständig, diese zu senden.

  • Löst das Schließen eines Tickets in AlgaPSA die Level-Warnmeldung auf? Die Dokumentation von AlgaPSA behandelt die Richtung von Level zu AlgaPSA (Warnmeldungen öffnen Tickets). Fragen Sie Nine Minds nach dem Verhalten beim Schließen von Tickets auf ihrer Seite.

  • Welche Geräte werden in AlgaPSA synchronisiert? Geräte in Gruppen, die Sie einem Client zugeordnet haben, sowie Geräte in Untergruppen, die eine zugeordnete übergeordnete Gruppe erben. Nicht zugeordnete Zweige werden übersprungen.

  • Werden vorhandene AlgaPSA-Assets überschrieben? Die Gerätesynchronisierung wird von AlgaPSA gesteuert. Siehe deren Level RMM Integration Dokumentation und Funktionsweise von RMM-Integrationen in AlgaPSA Dokumentation dazu, wie Assets abgeglichen und aktualisiert werden.

  • Wer kann dies einrichten? Ein Level-Administrator (für den API-Schlüssel und die Automatisierung) und ein AlgaPSA-Benutzer mit Zugriff auf die Admin-Einstellungen.

Verwandte Artikel
Hat dies deine Frage beantwortet?