REST通知について学習

ネイティブOCIコネクタが実装されていない他のアプリケーション(ファンクションなど)に対してREST API呼出しを送信する場合、OCIではHTTPではなくHTTPSのみを使用できます。

これにより、セキュリティの程度と適切なプラクティスの採用が保証されます。ただし、デモンストレーション者が、メッセージの受信を確認できるようにすることを目的としたダミー・クライアントを作成するために、信頼できる証明書(自己署名証明書ではない)を確立するための追加の設定作業が行われます。APIに取り組んでいるので、単に模擬/テスト・ツール製品を使用できます。このデモでは、Postmanを使用します。他にも多くのツールがありますが、製品として、無料の使用層があり、よく知られています。

モック・エンドポイントの構成

Postmanアカウントがない場合は、最初のステップとしてクラウド・アカウントを作成します。

クラウド・アカウントを設定すると、Postmanの構成を開始できます。ワークスペースが必要になります。デフォルトのスペースを使用するか、別のスペースを作成します。次に、モック・サーバーを作成します。

モック・サーバー構成が完了したら、ONSサブスクリプションの設定に役立つ必要があるため、サーバーのURLを確認する必要があります。これはモック・サーバー・ビューの構成タブで確認できます。

ONSでのRESTサブスクリプションの構成

OCIでサブスクリプションを設定するプロセスは、Slackとよく似ています。基本的に、モック・サーバーのPostman RESTエンドポイントを提供します。

Slackの設定と同様に、サブスクライバに送信される最初のメッセージはURLバリデータであり、OCIサブスクリプション・コンソールで実行できます。この場合、これはPOSTメッセージ・ヘッダー属性ではURLとして、本文ではメッセージ・ペイロードとして表示されます。後続のメッセージの送信を有効にするには、指定されたURLをコールする必要があります。したがって、URLをブラウザにコピーする必要があります。結果は、アクティブ化を確認するWebページになります。

実際のクライアント・アプリケーションの場合、必要なトリガー・ロジックを提供する必要があり、起動は、初期コールをフィルタで除外してコンシューマ・ポイントを有効にできるプロキシを介してルーティングされます。

詳細な設定手順へのリンクについては、「詳細の確認」を参照してください。

クライアント・アプリケーションの再実行

以前は、送信した通知メッセージは平文でした。ただし、アプリケーションはペイロード本体をJSONと想定します。アプリの再実行と通知メッセージの送信によって、Slackとモック・サーバーの両方にデータが流れることがわかります。モック・サーバーに到達する後続のメッセージが表示されます。有効にすると、Postmanを使用してこのようなメッセージを表示できます。