Azure AD から作成された Webhook URL を使用して、OAuth プロセスから生成されたアクセストークンを用いて、REST アプリケーションから Webhook を作成する方法を教えてください。 | Adobe Sign

最終更新日 : 2021年4月27日

目的

Azure AD から作成された Webhook URL を使用して、OAuth プロセスで生成されたアクセストークンを持つ REST アプリケーションから Webhook を作成する方法は?

環境

Adobe Sign REST API V6

手順

Adobe Acrobat Sign UI から Webhook を直接作成するには、まず次の手順に従って Azure AD Function アプリを介して Webhook URL を作成します。

Microsoft アカウントで https://portal.azure.com/ にログインします。

AzureAD アカウントの Function Apps に登録します。

AzureAD に移動し、Function Apps に移動します > Functions の + アイコン をクリックします。

Webhook+API を選択し、言語として JavaScript を選択して Create Function をクリックします。

Index.js ファイルを次のコードスニペットで置き換えます。

右隅の Test ボタンをクリックし、次のヘッダーを入力します:

X-AdobeSign-ClientId as ***********************

Save Run をクリックします。

次のヘッダーで 200 OK 応答を受信したら、Get function URL をクリックします

URL をコピーして Adobe Sign UI に移動します > Webhooks > + アイコンをクリックして作成します。

次の情報を入力します。 

  • 名前:他の管理者が簡単に理解できる直感的な名前を推奨します。
  • 範囲:webhook がキャッチする範囲の広さ。アカウントとグループはインターフェイスで使用できます。
    API は、アカウント、グループ、ユーザー、リソースのスコープをサポートします。
  • Webhook ごとに 1 つのスコープのみを定義できます
  • URL:Adobe Sign が JSON ペイロードをプッシュするターゲット URL。
  • イベント:Adobe Sign が JSON を作成して URL にプッシュするトリガー。
    各イベントは、トリガーイベントに関連する異なるペイロードを構築します。
    複数のイベントを 1 つの webhook に含めることができます。
  • 通知パラメーター:通知パラメーターは、イベント JSON ペイロードのセクションを識別し、重要なイベントのセクションのみを選択できるようにします。

webhook が完全に定義されたら、Save をクリックすると、新しい webhook がトリガーイベントに即座に反応し始めます。