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 Ihre Level-Einrichtung auf der PSA-Seite wider: Level-Gruppen werden AlgaPSA-Clients zugeordnet, Geräte in zugeordneten Gruppen werden in Assets synchronisiert, und Level-Alarme öffnen Tickets über die Alarmregeln von AlgaPSA.
​

Die Einrichtung erstreckt sich über beide Plattformen. In Level erstellen Sie einen API-Schlüssel und eine Automatisierung, die Alarme 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 ist eine Funktion der AlgaPSA Enterprise Edition.

⚙️ VORAUSSETZUNGEN

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

  • Ein AlgaPSA Enterprise Edition-Konto mit Zugang zu den Administrator-Einstellungen

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

AlgaPSA-Integration

Einen API-Schlüssel in Level erstellen

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

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

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

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

  4. Wählen Sie Schreibgeschütztein. Alles, was AlgaPSA von Level abruft (Gruppenermittlung, Gerätesynchronisierung, Alarm-Nachfüllung), ist ein Lesevorgang – ein schreibgeschützter Schlüssel genügt daher.

  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 Administrator-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 in 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 Synchronisierung & 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 an Tickets angehängt wird, die durch Alarme aus 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. Das Zuordnen der obersten Gruppe eines Clients deckt daher in der Regel dessen gesamten Baum ab.

  • Nicht zugeordnete Gruppen werden übersprungen. Geräte in einer Gruppe ohne Zuordnung und ohne zugeordnetes übergeordnetes Element 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 die manuelle Zuordnung jeder einzelnen Untergruppe.

Alarme an AlgaPSA senden

AlgaPSA authentifiziert eingehende Alarme mit seinem eigenen X-Alga-Webhook-Secret Header hinzu 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, damit Alarme über eine Automatisierung mit einer HTTP-Anfrage Aktion stattdessen, mit der Sie benutzerdefinierte Header und einen Textkörper festlegen können.
​

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

In Level:

  1. Navigieren Sie zu Automatisierungen und erstellen Sie eine neue Automatisierung, z. B. „AlgaPSA-Alarmticket".

  2. Klicken Sie in der Pipeline auf Eine Aktion hinzufügen und wählen Sie HTTP-Anfrage aus der Sonstige Kategorie.

  3. Füllen Sie die Aktion aus:

    • URL: die AlgaPSA-Webhook-URL

    • Methode: POST

    • Inhaltstyp: application/json

    • Textkörper: die Nutzlastvorlage 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. Klicken Sie auf Speichern im Aktions-Seitenbereich.

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 Alarme auslöst, für die Sie Tickets wünschen (Monitor-Richtlinien in der Seitenleiste).

  2. Öffnen Sie einen Monitor und suchen Sie den Abhilfe Abschnitt: „Automatisierungen ausführen, wenn dieser Alarm ausgelöst wird".

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

  4. Wiederholen Sie dies für jeden Monitor, dessen Alarme 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 den Alarm 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 „Request blocked: Cannot make requests to private or loopback addresses." fehl. Geben Sie Ihrer AlgaPSA-Instanz einen öffentlich auflösbaren HTTPS-Hostnamen, bevor Sie die Automatisierung einrichten.

Vorhandene Alarme nachfüllen

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

Integration testen

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

  2. Überprüfen Sie stichprobenartig die Asset-Liste eines Clients in AlgaPSA mit seiner Level-Gruppe.

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

  4. Bestätigen Sie, dass ein Ticket in AlgaPSA erscheint und durch Ihre Alarmregeln 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, z. B. HTTP 401 - Unauthorized bei einem ungültigen Geheimnis oder HTTP 404 - Not Found bei einer falsch eingegebenen URL. Dann prüfen Sie:

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

  • Die Webhook-URL wurde vollständig kopiert.

  • Die Gruppe des alarmierenden Geräts ist einem Client in AlgaPSA zugeordnet.

  • Der Monitor führt Ihre Automatisierung tatsächlich unter Abhilfe.

Laufende Verwaltung

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

  • Gruppen oder Geräte hinzufügen: ausführen 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 Abhilfe Feld, um nur die Alarme dieses Monitors zu stoppen.

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

FAQ

  • Muss ich AlgaPSA auf der Level-Integrationsseite aktivieren? Nein. Einstellungen → Integrationen in Level deckt ConnectWise PSA, HaloPSA, Zest, Hudu und DeskDay ab. AlgaPSA verbindet sich über die Level-API und eine Automatisierung, daher gibt es dort nichts umzuschalten.

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

  • Kann ich Einstellungen → Webhooks statt einer Automatisierung verwenden? Nicht für AlgaPSA. Level-Webhooks 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 es, die sie sendet.

  • Löst das Schließen eines Tickets in AlgaPSA den Level-Alarm auf? Die Dokumentation von AlgaPSA behandelt die Richtung von Level zu AlgaPSA (Alarme ö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 ein zugeordnetes übergeordnetes Element 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 Wie RMM-Integrationen in AlgaPSA funktionieren Dokumentation dazu, wie sie Assets abgleichen und aktualisieren.

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

Verwandte Artikel
Hat dies deine Frage beantwortet?