Informationen zu REST-Benachrichtigungen

Wenn es darum geht, REST-API-Aufrufe für andere Anwendungen zu senden, in denen kein nativer OCI-Connector implementiert ist (z.B. Functions), lässt OCI nur die Verwendung von HTTPS und nicht HTTP zu.

So werden ein gewisses Maß an Sicherheit und die Einführung bewährter Verfahren gewährleistet. Damit ein Demonstranten jedoch einen Dummy-Client erstellen können, der es uns ermöglicht, den Empfang einer Nachricht zu sehen, sind zusätzliche Setup-Maßnahmen erforderlich, um ein vertrauenswürdiges Zertifikat zu erstellen (also keine selbstsignierenden Zertifikate). Während wir mit APIs arbeiten, können wir einfach ein Modellierungs-/Testwerkzeugprodukt verwenden. Für diese Demo verwenden wir Postman. Es gibt viele andere Werkzeuge, aber als Produkt hat es eine kostenlose Nutzungsstufe und ist bekannt.

Mock-Endpunkt konfigurieren

Wenn Sie keinen Postman-Account haben, erstellen Sie im ersten Schritt einen Cloud-Account.

Mit dem Cloud-Account-Setup können wir Postman konfigurieren. Sie benötigen einen Workspace. Verwenden Sie den Standardbereich, oder erstellen Sie einen separaten Workspace. Dann möchten wir einen Mock-Server erstellen.

Wenn die Mock-Serverkonfiguration abgeschlossen ist, muss die URL für den Server angezeigt werden, da diese für die Einrichtung des ONS-Abonnements erforderlich ist. Dies wird auf der Registerkarte für die Konfiguration der Mock-Serveransicht angezeigt.

REST-Abonnement in ONS konfigurieren

Die Einrichtung des Abonnements in OCI ähnelt Slack sehr. Im Wesentlichen stellen wir nur den Postman-REST-Endpunkt unseres Mock-Servers zur Verfügung.

Wie beim Slack-Setup ist die erste an den Abonnenten gesendete Nachricht der URL-Validator, der mit der OCI-Abonnementkonsole ausgeführt werden kann. In diesem Fall wird dies als URL im Nachrichtenheaderattribut POST und als Nachrichten-Payload im Text angezeigt. Die angegebene URL muss aufgerufen werden, damit nachfolgende Nachrichten gesendet werden können. Daher muss die URL in einen Browser kopiert werden. Das Ergebnis ist eine Webseite, auf der die Aktivierung bestätigt wird.

Für eine echte Clientanwendung muss die erforderliche Triggerlogik bereitgestellt werden, oder die Aufrufe werden über einen Proxy weitergeleitet, der die ersten Aufrufe herausfiltern und den Consumer Point aktivieren kann.

Unter "Weitere Informationen" finden Sie Links zu ausführlichen Einrichtungsanweisungen.

Clientanwendung erneut ausführen

Zuvor waren die von uns gesendeten Benachrichtigungen in Klartext. Eine Anwendung erwartet jedoch, dass der Payload-Body JSON ist. Wenn Sie unsere App erneut ausführen und Benachrichtigungen senden, werden die Daten sowohl an Slack als auch an unseren Mock-Server übertragen. Es werden nachfolgende Nachrichten angezeigt, die den Mock-Server erreichen. Nach der Aktivierung werden Nachrichten wie diese mit Postman angezeigt.