Zum Inhalt springen

PENS-API

PENS ist ein recht einfaches Protokoll, das als eine Reihe von HTTP-Nachrichten implementiert ist. Die gesamte PENS-Kommunikation findet zwischen einem Inhaltssystem (z.B. imc Express) und einem Zielsystem (z.B. einem LMS) statt.

imc Express initiiert eine PENS-Benachrichtigung, indem es eine COLLECT-Nachricht an das Zielsystem sendet. Eine COLLECT-Nachricht (und jede andere PENS-Nachricht) ist einfach eine HTTP-Anfrage an eine vom Zielsystem bereitgestellte URL.

Diese COLLECT-Nachricht enthält eine URL und Zugangsdaten, die das Zielsystem für den Zugriff auf den Inhalt verwenden kann.

Das Zielsystem ist dann für das Herunterladen und Importieren der Inhalte verantwortlich. Sobald es damit fertig ist, sendet es eine Nachricht zurück an imc Express.

Voraussetzungen

Die folgenden Voraussetzungen müssen erfüllt sein, um den Austausch von Inhalten über PENS zu ermöglichen:

Eingangszugang (imc Express zum Zielsystem)

imc Express muss in der Lage sein, den PENS HTTP(s) Endpunkt zu erreichen, um die COLLECT Nachricht zu senden. Wenn das Zielsystem (LMS) nicht über das Internet erreichbar ist, muss der Kunde einen öffentlich erreichbaren Reverse Proxy bereitstellen, der die COLLECT Nachrichten an das geschützte Zielsystem weiterleitet.

Outbound-Zugang (Zielsystem zu imc Express)

Das Zielsystem (LMS) muss in der Lage sein, die Inhalte aus der imc Express Cloud herunterzuladen und Nachrichten zurückzuschicken.

Zurzeit muss die folgende URL erlaubt sein: https://app.imc-express.cloud/*

Hinweis: Das Pinning von IP-Adressen ist nicht möglich, da der imc Express Load Balancer automatisch skaliert (Hinzufügen und Entfernen von IPs).