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 als Assets synchronisiert, und Level-Warnungen öffnen Tickets über die Warnungsregeln von AlgaPSA.
​

Die Einrichtung umfasst beide Plattformen. In Level erstellen Sie einen API-Schlüssel und konfigurieren die Warnungszustellung über native Webhooks oder eine Automatisierung – je nach Ihrer AlgaPSA-Version. In AlgaPSA fügen Sie den Schlüssel ein, ordnen Gruppen zu und führen die Gerätesynchronisierung durch.

ℹ️ 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 zur Konfiguration von Webhooks oder einer Automatisierung)

  • Ein AlgaPSA Enterprise Edition-Konto mit Zugriff auf die Administratoreinstellungen

  • Ihre AlgaPSA-Instanz ist über eine öffentliche HTTPS-Adresse erreichbar (siehe Warnung unter Warnungen an AlgaPSA senden)

AlgaPSA-Integration

API-Schlüssel in Level erstellen

AlgaPSA verwendet einen Level-API-Schlüssel, um Ihre Gruppen, Geräte und Warnungen 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 zum Beispiel „AlgaPSA-Integration".

  4. Wählen Sie Schreibgeschütztein. Alles, was AlgaPSA aus Level abruft (Gruppenentdeckung, Gerätesynchronisierung, Warnungs-Backfill), ist ein Lesevorgang – daher reicht ein schreibgeschützter Schlüssel aus.

  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 API-Schlüssel-Einstellungen für vollständige Details zur Verwaltung von Schlüsseln.

AlgaPSA mit Level verbinden

  1. Gehen Sie in AlgaPSA zu Einstellungen → Allgemein um die Administratoreinstellungen 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 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-Menü. Legen Sie optional einen Standardkontakt, der den durch Warnungen dieser Gruppe geöffneten Tickets zugewiesen wird.

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

Zwei Verhaltensweisen sind wichtig zu wissen:

  • Untergruppen erben. Eine Untergruppe ohne eigene Zuordnung verwendet die nächste zugeordnete übergeordnete Gruppe. Daher deckt das Zuordnen der obersten Gruppe eines Clients in der Regel dessen gesamten Baum ab.

  • 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 das manuelle Zuordnen jeder Untergruppe.

Warnungen an AlgaPSA senden

Wählen Sie die von Ihrer AlgaPSA-Installation unterstützte Methode. Wenn die Level-Integrationsseite Nativer Webhook (empfohlen) mit einem Signaturgeh­eimnis, folgen Sie den unten stehenden nativen Webhook-Schritten. Wenn nur ein Warnungs-Webhook mit einem benutzerdefinierten Header und einer Nutzlastvorlage – verwenden Sie den Automatisierungs-Fallback.

Versionsverfügbarkeit, geprüft am 30. Oktober 2026: Die native signierte Webhook-Unterstützung wurde am 17. Oktober 2026 in den Hauptzweig von AlgaPSA eingebracht, in PR #3761. Die neueste veröffentlichte Version, v1.6.0 (17. September 2026), enthält dies nicht. Gehostete und selbst gehostete Bereitstellungen können sich unterscheiden. Bestätigen Sie mit Nine Minds, ob Ihr Build native Webhooks unterstützt, bevor Sie wechseln; ein Merge in den Hauptzweig bestätigt keine Verfügbarkeit auf Ihrer Installation.

Option 1: Native Webhooks für unterstützte Builds

  1. Öffnen Sie in den Level-Integrationseinstellungen von AlgaPSA Nativer Webhook (empfohlen).

  2. Kopieren Sie die vollständige Webhook-URL, einschließlich des Tenant-Abfrageparameters, und das Signaturgeheimnis , der auf dieser Karte angezeigt wird.

  3. Gehen Sie in Level zu Einstellungen → Webhooks und klicken Sie auf + Webhook hinzufügen (oder + Webhook erstellen wenn die Liste leer ist).

  4. Fügen Sie die AlgaPSA-URL in URL und sein Signaturgeheimnis in Geheimnis.

  5. Unter Zu sendende Ereignisse, wählen Sie Warnung aktiv (alert_active) und Warnung aufgelöst (alert_resolved).

  6. Lassen Sie Aktiviert ein und klicken Sie auf Webhook hinzufügen.

  7. Testen Sie die Erstellung und Auflösung von Warnungen mithilfe der nachfolgenden Prüfungen.

Level signiert diese Anfragen mit X-Level-Signature, das AlgaPSA verifiziert. Native Webhooks verwenden die Standardnutzlast von Level, daher müssen Sie keinen benutzerdefinierten Header hinzufügen, keine Nutzlastvorlage einfügen und keine HTTP-Automatisierung an jeden Monitor anhängen. Die Gruppenzuordnungen und Warnungsregeln von AlgaPSA steuern, wie eingehende Warnungen verarbeitet werden.

Siehe Webhook-Einstellungen für Konfiguration und Zustellungsprotokolle.

Option 2: Automatisierungs-HTTP-Anfrage als Fallback

Verwenden Sie diese Methode für v1.6.0, ältere Installationen oder wenn native Webhooks nicht verfügbar sind. Sie sendet die Nutzlastvorlage von AlgaPSA mit dem X-Alga-Webhook-Secret Header.

In AlgaPSA, öffnen Sie die Warnungs-Webhook Karte (bezeichnet als Fallback: Automatisierungs-HTTP-Anfrage auf neueren Builds) und kopieren Sie die drei angezeigten Werte: das Webhook-URL, das Header Name und Geheimnis (das Augensymbol zeigt das Geheimnis an), sowie das Nutzlastvorlage.

In Level:

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

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

  3. Füllen Sie die Aktion aus:

    • URL: die AlgaPSA-Webhook-URL

    • Methode: POST

    • Inhaltstyp: application/json

    • Hauptteil: die Nutzlastvorlage aus AlgaPSA, unverändert eingefügt

    • Header: klicken Sie auf + Anfrage-Header hinzufügen und fügen Sie hinzu 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 Warnungen auslöst, für die Tickets erstellt werden sollen (Monitor-Richtlinien in der Seitenleiste).

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

  3. Wählen Sie Ihre AlgaPSA-Automatisierung im Fehlerbehebungs-Automatisierung Auswahlfeld, dann speichern.

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

A monitor in a monitor policy with the Remediation section visible

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

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

Wechsel von einer Automatisierung zu nativen Webhooks

Bestätigen Sie zunächst die native Webhook-Unterstützung auf Ihrer AlgaPSA-Installation. Konfigurieren Sie den Webhook, testen Sie dann eine neue Warnung und deren Auflösung auf einem zugeordneten Gerät. Prüfen Sie die Zustellungsprotokolle sowie die resultierende AlgaPSA-Warnung und das Ticket, bevor Sie die restlichen Monitore umstellen.

Sobald die native Zustellung funktioniert, deaktivieren Sie die alte AlgaPSA-Weiterleitungsautomatisierung oder entfernen Sie diese Automatisierung aus den betroffenen Monitoren unter Fehlerbehebung Auswahl. Behalten Sie alle nicht betroffenen Fehlerbehebungsaktionen. Vermeiden Sie es, beide Weiterleitungsmethoden für dieselben Warnungen gleichzeitig zu aktivieren, da dies zu doppelten Tickets führen kann.

Vorhandene Warnungen nachfüllen

Der Webhook ist der Live-Feed. Um Warnungen abzurufen, die bereits in Level vorhanden sind, oder um nach einem verpassten Ereignis aufzuholen, klicken Sie auf Warnungen nachfüllen auf der Synchronisierungs- & Gruppenzuordnungskarte. Es gibt keine geplante Level-Warnungsabfrage; dies ist von einem eventuell in Ihrem AlgaPSA-Build verfügbaren Gerätesynchronisierungsplan getrennt.

Integration testen

  1. Stellen Sie sicher, dass die Level-Verbindungskarte in AlgaPSA Verbunden mit einem aktuellen Zeitstempel.

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

  3. Lösen Sie eine Testswarnung in Level auf einem Gerät in einer zugeordneten Gruppe aus. Verwenden Sie beim Automatisierungs-Fallback einen Monitor, an den die Weiterleitungsautomatisierung angehängt ist.

  4. Stellen Sie sicher, dass die Warnung AlgaPSA erreicht und ein Ticket erstellt wird, wenn eine passende Warnungsregel dies verlangt. Lösen Sie bei nativen Webhooks die Testwarnung in Level auf und bestätigen Sie, dass das Auflösungsereignis AlgaPSA erreicht.

Native Webhooks: Öffnen Sie Einstellungen → Webhooks → Anfragen in Level. Überprüfen Sie Ziel-URL, Zustellungsstatus, HTTP-Antwort und Antworttext. Bei einem Signaturfehler stellen Sie sicher, dass Level's Geheimnis übereinstimmt mit dem Signaturgeheimnis auf der nativen Karte von AlgaPSA.

Kopieren Sie bei einem URL-Fehler die vollständige URL erneut, einschließlich des Tenant-Parameters. Stellen Sie sicher, dass beide Warnungsereignisse ausgewählt sind und der Endpunkt öffentlich erreichbar ist. Verwenden Sie nach der Korrektur einer fehlgeschlagenen Zustellung Anfrage erneut ausführen um es erneut zu senden, und bestätigen Sie, dass kein doppeltes Ticket erstellt wurde.

Ticket-Auflösung: Der Empfang eines alert_resolved Ereignis garantiert nicht, dass ein Ticket geschlossen wird. Das automatische Schließen hängt von der Einstellung zur automatischen Auflösung der AlgaPSA-Warnungsregel und davon ab, ob am Ticket menschliche Aktivität stattgefunden hat. Bestätigen Sie das Verhalten für Ihre Regeln und Ihren Build mit Nine Minds.

Automatisierungs-Fallback: Ö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. Prüfen Sie dann:

  • 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 warnenden Geräts ist einem Client in AlgaPSA zugeordnet.

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

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 wirkt sofort, daher in dieser Reihenfolge vorgehen.

  • 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.

  • Warnungsweiterleitung pausieren: bei nativen Webhooks, schalten Sie Aktiviert am Webhook in Level deaktivieren. Beim Fallback deaktivieren Sie die Weiterleitungsautomatisierung oder entfernen Sie sie aus dem Fehlerbehebung Feld.

  • Geheimnis ändern: bei nativen Webhooks, generieren Sie das Signaturgeheimnis in AlgaPSA neu und aktualisieren Sie das Geheimnis in Level, dann testen Sie die Zustellung. Aktualisieren Sie beim Fallback den X-Alga-Webhook-Secret Header, sobald Sie das gemeinsame Geheimnis in AlgaPSA neu generieren. Verwenden Sie das Geheimnis für die von Ihnen konfigurierte Methode.

Häufig gestellte Fragen

  • Muss ich AlgaPSA auf der Integrationsseite von Level aktivieren? Nein. AlgaPSA verbindet sich über die Level-API sowie entweder native Webhooks oder eine Automatisierung, daher gibt es keinen AlgaPSA-Schalter, der auf Level's Einstellungen → Integrationen Seite.

  • Schreibgeschützt oder Lesen und Schreiben für den API-Schlüssel? Schreibgeschützt ist ausreichend für die hier beschriebene Gruppenentdeckung, Gerätesynchronisierung, Warnungs-Backfill und eingehende Warnungseinrichtung. Optionale AlgaPSA-Funktionen, die in Level zurückschreiben, können andere Anforderungen haben. Bestätigen Sie die unterstützte Funktion und die erforderlichen Berechtigungen mit Nine Minds, bevor Sie den Schlüssel erweitern.

  • Kann ich Einstellungen → Webhooks statt einer Automatisierung verwenden? Ja, wenn Ihr AlgaPSA-Build native signierte Webhooks unterstützt und die Nativer Webhook (empfohlen) Karte. Folgen Sie Option 1 oben. v1.6.0 und ältere Empfänger erfordern weiterhin den Automatisierungs-Fallback mit X-Alga-Webhook-Secret.

  • Wird durch das Schließen eines Tickets in AlgaPSA die Level-Warnung aufgelöst? Diese Anleitung konfiguriert die Warnungszustellung von Level zu AlgaPSA. Ticket-Schließaktionen, die in Level zurückschreiben, hängen von Ihrem AlgaPSA-Build, den Einstellungen und den API-Berechtigungen ab. Fragen Sie Nine Minds, wie Sie dieses Verhalten für Ihre Installation aktivieren und testen können.

  • 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. Sehen Sie deren Level RMM Integration Dokumentation und Wie RMM-Integrationen in AlgaPSA funktionieren dafür, wie Assets abgeglichen und aktualisiert werden.

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

Verwandte Artikel
Hat dies deine Frage beantwortet?