Kuinka luon webhookin REST-sovelluksella käyttämällä käyttöoikeustietuetta, joka on luotu käyttämällä Azure AD:sta luotua URL-osoitetta OAuth-prosessissa? | Adobe Sign

Päivitetty viimeksi 27. huhtikuuta 2021

Tavoite

Kuinka luoda webhook REST-sovelluksesta OAuth-prosessin tuottamalla käyttöoikeustokenilla käyttäen Azure AD:sta luotua webhook-URL:ää?

Ympäristö

Adobe Sign REST API V6

Vaiheet

Jos haluat luoda webhookin suoraan Adobe Sign -käyttöliittymästä, luo ensin webhookin URL-osoite Azure AD -funktiosovelluksista toimimalla seuraavien ohjeiden mukaan:

Kirjaudu Microsoft-tilillä sisään osoitteessa https://portal.azure.com/.

Rekisteröidy Function Apps -palveluun AzureAD-tilin alla.

Siirry AzureAD-palveluun ja mene kohtaan Function Apps > Napsauta +-kuvaketta Functions-toimintoja varten.

Valitse Webhook+API JavaScript-kielellä ja napsauta Create Function.

Korvaa Index.js-tiedosto seuraavalla koodikatkelmalla:

Napsauta Test-painiketta oikeassa kulmassa ja anna seuraava otsikko:

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

Napsauta Tallenna ja Suorita.

Kun saat 200 OK -vastauksen seuraavalla otsikolla, napsauta Get function URL

Kopioi URL ja siirry Adobe Sign -käyttöliittymään > Webhooks > Napsauta +-kuvaketta luodaksesi.

Anna seuraavat tiedot: 

  • Nimi: Intuitiivista nimeä, jonka muut järjestelmänvalvojat ymmärtävät helposti, suositellaan.
  • Laajuus: Kuinka laajalle webhook ulottuu.Tili ja Ryhmä ovat saatavana käyttöliittymässä.
    API tukee Tili-, Ryhmä-, Käyttäjä- ja Resurssi-käyttöalueita.
  • Voit määrittää vain yhden käyttöalueen webhookia kohti.
  • URL: Kohde-URL, johon Adobe Sign työntää JSON-kuorman.
  • Tapahtumat: Laukaisin, joka saa Adobe Signin luomaan JSON:n ja lähettämään sen URL-osoitteeseen.
    Jokainen tapahtuma luo erilaisen kuorman käynnistystapahtuman perusteella.
    Yhteen webhookiin voi sisältyä useita tapahtumia.
  • Ilmoitusparametrit: Ilmoitusparametrit tunnistavat Event JSON -kuorman osiot, jolloin voit valita vain ne tapahtuman osiot, jotka ovat tärkeitä.

Kun webhook on täysin määritelty, napsauta Tallenna, niin uusi webhook alkaa reagoida laukaisutapahtumiin välittömästi.