Einführung
Regentra ist eine kombinierte PSA- und Compliance-Plattform für MSPs. Die Level-Integration importiert die in Level verwalteten Geräte als Assets in Regentra, sodass sie im Asset-Inventar von Regentra, in Tickets und im Kundenportal erscheinen.
Die Einrichtung ist kurz und erfolgt größtenteils in Regentra. In Level erstellen Sie einen schreibgeschützten API-Schlüssel und optional einen Webhook, damit Geräteänderungen Regentra innerhalb von Sekunden erreichen, anstatt auf die nächste geplante Synchronisierung zu warten.
ℹ️ HINWEIS: Diese Integration wurde von Regentra entwickelt und wird von Regentra gepflegt. Informationen zur Einrichtung auf der Regentra-Seite finden Sie in deren Dokumentation: Level.io RMM-Integration.
⚙️ VORAUSSETZUNGEN
Level-Administratorzugang. API-Schlüssel und Webhooks sind ausschließlich für Administratoren.
Ein Regentra-Konto mit Zugang zu Einstellungen → Integrationen.
Regentra-Integration
Einen API-Schlüssel in Level erstellen
Regentra verwendet einen Level-API-Schlüssel, um Ihr Geräteinventar auszulesen.
Navigieren Sie in Level zu Einstellungen → API-Schlüssel.
Klicken Sie auf + API-Schlüssel erstellen.
Geben Sie eine Beschreibung z. B. „Regentra-Integration".
Wählen Sie Schreibgeschütztein. Regentra liest Gerätedaten aus Level und schreibt nichts zurück, daher reicht ein schreibgeschützter Schlüssel aus.
Klicken Sie auf Schlüssel erstellen, dann verwenden Sie das Drei-Punkte-Menü in der neuen Zeile und wählen Schlüssel kopieren.
Siehe Einstellungen für API-Schlüssel für alle Details zur Verwaltung von Schlüsseln.
Regentra mit Level verbinden
Wechseln Sie in Regentra zu Einstellungen → Integrationen → Level.io RMM.
Fügen Sie den kopierten Schlüssel in das API-Schlüssel Feld.
Klicken Sie auf Verbindung testen ein, um zu bestätigen, dass Regentra die Level-API erreichen kann.
Speichern Sie die Konfiguration und klicken Sie dann auf Jetzt synchronisieren , um den ersten Import zu starten.
Nach dem ersten Import ruft Regentra Ihr gesamtes Geräteinventar planmäßig ab. Regentra dokumentiert dies als alle sechs Stunden.
Was synchronisiert wird
Jedes Level-Gerät wird zu einem Asset in Regentra, wobei folgende Felder aus Level befüllt werden:
Level | Regentra-Asset |
Hostname | Gerätename |
Seriennummer | Seriennummer |
Betriebssystem | BS |
Hersteller | Hersteller |
Modell | Modell |
Online-Status | Online-/Offline-Status |
Die Synchronisierung ist einseitig. Regentra liest aus Level und schreibt nie zurück, daher ändert keine Bearbeitung in Regentra ein Gerät in Level.
ℹ️ HINWEIS: Level erfasst keine Hardware-Garantiedaten, daher bleiben Garantiefelder in Regentra manuelle Einträge.
Echtzeit-Geräteaktualisierungen per Webhook senden
Die geplante Synchronisierung reicht für die meisten Teams aus. Fügen Sie einen Webhook hinzu, wenn neue Geräte, Geräteänderungen und Löschungen Regentra sofort erreichen sollen.
Öffnen Sie in Regentra Einstellungen → Integrationen → Level.io RMM und kopieren Sie die Webhook-Endpunkt-URL.
Navigieren Sie in Level zu Einstellungen → Webhooks und klicken Sie auf + Webhook hinzufügen.
Fügen Sie den Regentra-Endpunkt in das URL Feld.
Wenn Regentra Ihnen ein Signing-Secret für diesen Endpunkt gegeben hat, fügen Sie es in Secret. Andernfalls lassen Sie es leer. Level fügt nur den
X-Level-SignatureHeader, wenn ein Secret gesetzt ist, und der empfangende Endpunkt muss so aufgebaut sein, dass er dieses verifiziert.Lassen Sie den Aktiviert Schalter aktiviert.
Unter Zu sendende Ereignisse, wählen Sie Zu sendende Typen auswählen und aktivieren Sie Gerät erstellt, Gerät aktualisiert, und Gerät gelöscht.
Klicken Sie auf Webhook hinzufügen.
Regentra bestätigt den Empfang des ersten Ereignisses und zeigt den Webhook als Aktiv auf seiner Seite.
Siehe Webhook-Einstellungen für das Payload-Format, das Zustellungsprotokoll und das Wiederholungsverhalten.
Die Integration testen
Bestätigen Sie, dass die Level.io RMM-Integration in Regentra Verbunden.
Überprüfen Sie stichprobenartig die Asset-Liste von Regentra mit Ihrer Level-Geräteliste.
Wenn Sie den Webhook eingerichtet haben, benennen Sie ein Gerät in Level um und öffnen Sie dann Einstellungen → Webhooks → Anfragen in Level und suchen Sie nach einer Gerät aktualisiert Zustellung mit einem 2xx-Statuscode.
Wenn eine Zustellung fehlgeschlagen ist, klicken Sie auf die Zeile, um die Fehlermeldung und den Antwortinhalt zu lesen. Level wiederholt eine fehlgeschlagene Zustellung automatisch bis zu dreimal, und Sie können auf Anfrage erneut ausführen sobald Sie die Ursache behoben haben. Häufige Ursachen sind eine falsch eingegebene Endpunkt-URL oder ein Secret, das nur auf einer Seite gesetzt ist.
Wenn Assets fehlen, die Verbindung aber einwandfrei getestet wird, ist der API-Schlüssel die erste Stelle zum Prüfen. Ein gelöschter oder rotierter Schlüssel stoppt die Synchronisierung sofort und die Integrationskarte von Regentra wechselt zu Fehlerklicken.
Laufende Verwaltung
Schlüssel rotieren: erstellen Sie einen neuen API-Schlüssel in Level, fügen Sie ihn in Regentra 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 es daher in dieser Reihenfolge durch.
Echtzeit-Aktualisierungen pausieren: deaktivieren Sie den Webhook in Level. Die geplante Synchronisierung läuft weiter.
Integration beenden: entfernen Sie den API-Schlüssel aus Regentra oder löschen Sie den Schlüssel in Level.
Gelöschte Geräte: Das Entfernen eines Geräts aus Level löscht nicht sein Regentra-Asset. Regentra behält den Eintrag für die Historie und aktualisiert dessen Status.
⚠️ WARNUNG: Wenn Sie sowohl Level als auch NinjaOne mit derselben Regentra-Organisation verbinden, behandelt Regentra NinjaOne als Gerätequelle mit höherer Priorität und deaktiviert die Level-Kopie jedes Geräts, das in beiden erscheint. Siehe Regentras NinjaOne RMM-Integration Dokumentation.
Häufig gestellte Fragen
Muss ich Regentra auf der Integrationsseite von Level aktivieren? Nein. Einstellungen → Integrationen in Level umfasst ConnectWise PSA, HaloPSA, Zest, Hudu und DeskDay. Regentra verbindet sich über die Level-API und optional einen Webhook, sodass dort nichts aktiviert werden muss.
Schreibgeschützt oder Lesen und Schreiben für den API-Schlüssel? Schreibgeschützt. Regentra liest nur Geräte aus Level. Wenn ein Verbindungstest oder eine Synchronisierung mit einem Berechtigungsfehler fehlschlägt, wenden Sie sich an Regentra, bevor Sie den Schlüssel erweitern.
Ist der Webhook erforderlich? Nein. Die geplante Synchronisierung funktioniert ohne ihn. Der Webhook fügt lediglich nahezu sofortige Aktualisierungen für Teams hinzu, die aktuelle Asset-Daten zwischen den Synchronisierungen benötigen.
Öffnen Level-Alarme Regentra-Tickets? Die Level-Integration von Regentra dokumentiert die Geräte- und Asset-Synchronisierung, nicht die Benachrichtigungen. Level kann Alarm aktiv und Alarm behoben Ereignisse an beliebige Endpunkte, fragen Sie daher Regentra, ob deren Endpunkt diese akzeptiert, bevor Sie diese Ereignistypen zum Webhook hinzufügen.
Warum erscheint ein Gerät zweimal in Regentra? Regentra dedupliziert Geräte aus Level gegen Geräte aus Microsoft Entra oder Intune durch Abgleich von Seriennummer und Hostname. Ein Gerät ohne Seriennummer kann als zwei Einträge erscheinen, bis Sie diese zusammenführen. Siehe Regentras Level.io RMM-Integration Dokumentation.
Kann ich einschränken, welche Level-Geräte synchronisiert werden? Die Level-Seite hat keinen Filter. Ein schreibgeschützter API-Schlüssel kann jedes Gerät in Ihrer Level-Organisation lesen, daher erfolgt jegliche Einschränkung in Regentra.
Wer kann dies einrichten? Ein Level-Administrator für den API-Schlüssel und den Webhook sowie ein Regentra-Benutzer mit Zugang zu Einstellungen → Integrationen.