Yleiskatsaus
Adobe Acrobat Signin Document API integroituu saumattomasti olemassa olevaan sovellukseesi, eikä erillistä Acrobat Signin hallittua rekisteröitymisprosessia ole tarpeen suorittaa. Näin ollen taustasovellus pitää huolen siitä, että lähettäjä on rekisteröitynyt Acrobat Signin käyttäjä. Rekisteröimättömät käyttäjät rekisteröidään ohjelmallisesti API:n kautta. Vastaanottajilta ei vaadita koskaan rekisteröitymistä, ja Acrobat Sign pitää huolen kaikista vastaanottajapuolelta vaadituista toimista.
Asiakirjan lähettäjän määrittäminen
Lähettäjä voidaan määrittää useilla eri tavoilla, kun uusi toimenpide aloitetaan sendDocument-menetelmällä. Toiminta riippuu siitä, mitä arvoja välitetään valinnaisen SenderInfo-parametrin kautta.
- SenderInfo on tyhjä: tässä tapauksessa dokumentin lähettäjä on yksilöity käyttäjä, joka on liitetty käytössä olevaan API-avaimeen. Menetelmä soveltuu testaukseen ja tiettyihin rajoitettuihin toteutuksiin, mutta siitä ei lähtökohtaisesti ole hyötyä laajamittaisissa integraatioissa, joissa on olemassa olevia käyttäjäjoukkoja.
- SenderInfo sähköpostilla ja salasanalla: tässä tapauksessa dokumentin lähettäjä on sähköpostiparametrin määrittelemä käyttäjä. Annetun salasanan on vastattava käyttäjän Acrobat Sign -salasanaa. Taustasovellus voi pyytää käyttäjältä sähköpostia ja salasanaa integroinnin vuoksi, kun dokumenttia ollaan lähettämässä. Vaihtoehtoisesti taustasovellus voi muistaa sähköpostin ja salasanan, koska se on itse luonut käyttäjän tai koska käyttäjä on aiemmin antanut tietonsa, ja ne on tallennettu välimuistiin.
- SenderInfo sähköpostilla ilman salasanaa: tässä tapauksessa dokumentin lähettäjä on käyttäjä, jonka sähköpostiparametri määrittelee. Salasanan arvon on oltava tyhjä. Acrobat Sign varmistaa, että API-kutsun tekijä ja lähettäjä kuuluvat samaan tiliin, mutta se ei vaadi tai tarkista salasanaa. Tämä menetelmä voi soveltua API-integraatioihin organisaation sisällä, mutta siinä ei ole yhtä vahvaa yksilöllistä tietoturvaa. Tilin pääkäyttäjän on erikseen pyydettävä, että tämä todennusmalli voidaan ottaa käyttöön Acrobat Sign API:ssa.
Acrobat Sign -tilin hallinta
Kuten yllä on kuvattu, useimmissa tapauksissa on paras antaa sen käyttäjän sähköpostiosoite ja salasana, jonka puolesta olet lähettämässä dokumenttia. Seuraavassa osiossa on kuvattu eri tapoja sille, kuinka tiedot voidaan hankkia.
Kysyminen käyttäjältä
Kysy käyttäjältä Acrobat Signin sähköpostiosoitetta ja salasanaa osana lähetysprosessia. Voit käyttää verifyUser -metodia tarkistaaksesi, että käyttäjä on rekisteröitynyt Acrobat Signiin ja että salasana on kelvollinen. Jos käyttäjä ei ole rekisteröitynyt, voit joko pyytää häntä luomaan oman Acrobat Sign -tilin tai luoda sen itse (katso tiedot alta).
Tilin luominen
Jos verifyUser-kutsu osoittaa, että kyseisellä sähköpostiosoitteella ei löydy käyttäjää, voit ohjelmallisesti luoda Acrobat Sign -käyttäjän createUser-kutsulla. Mikäli käyttäjän luominen onnistuu, antamaasi sähköpostiosoitetta ja salasanaa voidaan nyt käyttää dokumentin SenderInfo-tietoina.
Tilin muistaminen
Molemmat yllä kuvatut toiminnot mahdollistavat sen, että voit niiden jälkeen muistaa käyttäjän sähköpostiosoitteen ja salasanan. Voit sitten käyttää niitä SenderInfo-tietoina muiden dokumenttien lähettämiseen. Koska on mahdollista, että käyttäjä kirjautuu Acrobat Sign -tiliinsä ja vaihtaa salasanansa, sovelluksesi täytyy pystyä käsittelemään tilanne, jossa aiemmin tallennettu salasana on virheellinen.
Yhteenveto
Lähettäjän henkilöllisyys voidaan todentaa Acrobat Signin Document API:ssa usein eri tavoin. Lue yllä olevat tiedot tarkasti, jotta voit päättää, mikä menetelmä soveltuu parhaiten omaan sovellukseesi. Jos sinulla on kysyttävää, älä epäröi ottaa meihin yhteyttä.
Kirjaudu sisään tiliisi