Einführung
Die Provider-API ermöglicht MSP-Partnern den Zugriff auf Nutzungsdaten für verwaltete Organisationen, einschließlich Lizenzverbrauch und Organisationsstatus. In diesem Artikel erfahren Sie, wie Sie NordPass-MSP-Dienste mithilfe der Provider-API in Ihre Business-Management-Tools integrieren können.
Bevor Sie beginnen
Die Provider-API stellt tägliche und monatliche Nutzungsinformationen für alle von MSPs verwalteten Organisationen bereit, darunter:
- Anzahl der verbrauchten Lizenzen und Stufe
- Testversion-Status
- Not-For-Resale-Kennzeichnungen (NFR)
Die Endpunkte von NordPass folgen den REST-API-Prinzipien und verwenden ausschließlich JSON in Anforderungstexten. Bei Bedarf müssen Sie einen Header „Content-Type: application/json“ verwenden und eine gültige JSON-Nutzlast im Anforderungstext erstellen. Bei Erfolg erhalten Sie eine gültige JSON-Antwort, bei einem Fehler eine Fehlermeldung.
So gehen Sie vor
So erstellen Sie Ihren privaten Schlüssel
Um API-Anfragen zu authentifizieren, müssen Sie JWT-Daten für Ihr Unternehmen generieren. Führen Sie dazu die folgenden Schritte aus:
- Öffnen Sie das MSP-Admin-Panel und klicken Sie auf die Schaltfläche „Integrationen“ auf der rechten Seite.
- Wählen Sie anschließend die Schaltfläche „Provider-API“ aus und klicken Sie auf die Schaltfläche „Privaten Schlüssel generieren“.
- Speichern Sie die Daten und bewahren Sie sie an einem sicheren Ort auf. Aktivieren Sie anschließend das Kontrollkästchen neben „Ich habe eine Kopie der obigen Daten gemacht“ und klicken Sie auf die Schaltfläche „Fertig“.
Hinweis: Wenn Sie Ihren privaten Schlüssel verlieren, müssen Sie einen neuen generieren.
So widerrufen oder generieren Sie einen API-Schlüssel neu
Wenn Ihr privater Schlüssel verloren geht oder kompromittiert wird, befolgen Sie diese Schritte:
- Öffnen Sie das MSP-Admin-Panel und klicken Sie auf die Schaltfläche „Integrationen“ auf der rechten Seite.
- Wählen Sie anschließend die Schaltfläche „Provider-API“ aus und klicken Sie auf „Privaten Schlüssel widerrufen“.
- Sobald die Popup-Eingabeaufforderung angezeigt wird, wählen Sie die Schaltfläche „Widerrufen“ aus, um Ihre Auswahl zu bestätigen.
Hinweis: Durch das Widerrufen eines privaten Schlüssels werden alle bestehenden Integrationen, die diesen Schlüssel verwenden, sofort deaktiviert.
Weitere Tipps
- Bewahren Sie Ihren privaten Schlüssel sicher auf und beschränken Sie den Zugriff darauf.
- Widerrufen Sie den Schlüssel sofort, wenn Sie den Verdacht haben, dass er kompromittiert wurde.