Jak vytvořit webhook z aplikace typu REST s přístupovým tokenem vygenerovaným při procesu OAuth pomocí adresy URL webhooku vytvořené ve službě Azure AD? | Adobe Sign

Naposledy aktualizováno 27. 4. 2021

Cíl

Jak vytvořit webhook z REST aplikace s přístupovým tokenem generovaným z OAuth procesu pomocí webhook URL vytvořené z Azure AD?

Prostředí

Adobe Sign REST API V6

Postup

Chcete-li vytvořit webhook přímo v uživatelském rozhraní služby Adobe Sign, musíte nejprve vytvořit adresu URL webhooku ve funkčních aplikacích služby Azure AD, a to následujícím postupem:

Na https://portal.azure.com/ se přihlaste přes účet Microsoft.

Zaregistrujte Function Apps pod účtem AzureAD.

Přejděte do AzureAD a přejděte do Function Apps > Klikněte na ikonu + pro funkce.

Vyberte Webhook+API s JavaScript jako programovací jazyk a klikněte na Vytvořit funkci.

Nahraďte soubor Index.js následujícím fragmentem kódu:

Klikněte na tlačítko Test v pravém rohu a zadejte následující hlavičku:

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

Klikněte na Uložit a Spustit.

Jakmile obdržíte odpověď 200 OK s následující hlavičkou, klikněte na Získat URL funkce

Zkopírujte URL a přejděte do Adobe Sign UI > Webhooks > Klikněte na ikonu + pro vytvoření.

Zadejte následující údaje: 

  • Název: Doporučuje se intuitivní název, kterému ostatní správci snadno porozumí.
  • Rozsah: Jak širokou síť zachytává webhook.Účet a skupina jsou k dispozici v rozhraní.
    \n Rozhraní API podporuje rozsahy Účet, Skupina, Uživatel a Zdroje.
  • K jednomu webhooku lze nastavit pouze jeden rozsah
  • URL: Cílová URL, na kterou Adobe Sign odešle JSON payload.
  • Události: Aktivační událost, která způsobí, že Adobe Sign vytvoří JSON a odešle jej na URL.
    Každá událost vytvoří jinou datovou část relevantní pro spouštěcí událost
    \nDo jednoho webhooku lze zahrnout více událostí.
  • Parametry oznámení: Parametry oznámení identifikují sekce JSON payload události, což vám umožňuje vybrat pouze ty sekce události, které jsou důležité.

Jakmile je webhook plně definován, klikněte na Uložit a nový webhook začne okamžitě reagovat na spouštěcí události.