Eenmalig aanmelden instellen

De document-API van Adobe Sign kan naadloos in uw bestaande toepassing worden geïntegreerd zonder dat u een afzonderlijk registratieproces van Adobe Sign moet doorlopen. De overkoepelende toepassing zorgt ervoor dat de afzender een geregistreerde gebruiker van Adobe Sign is. Het systeem registreert de gebruikers automatisch via de API als ze nog niet geregistreerd zijn. Ontvangers hoeven zich nooit te registreren en Adobe Sign verzorgt alle interactie die nodig is aan de ontvangerszijde.

Er zijn verschillende manieren om een afzender te specificeren bij het starten van een nieuwe transactie met de methode sendDocument. Het gedrag hangt af van de waarden die door de optionele SenderInfo-parameter worden doorgegeven.

• Ongeldige SenderInfo: In dit geval is de afzender van het document de specifieke unieke gebruiker die geassocieerd is met de API-sleutel die wordt gebruikt. Deze methode is geschikt voor het testen en bepaalde, beperkte toepassingen maar is gewoonlijk niet nuttig voor integratie op grote schaal met bestaande gebruikers.

• SenderInfo met e-mail en wachtwoord: In dit geval is de afzender van het document de gebruiker die de e-mailparameter opgeeft. Het opgegeven wachtwoord moet overeenkomen met het Adobe Sign-wachtwoord van de gebruiker. Met het oog op een betere integratie kunnen de e-mail en het wachtwoord aan de gebruiker gevraagd worden binnen de context van de toepassing wanneer het document op het punt staat verzonden te worden. De toepassing kan anderzijds ook het e-mailadres en het wachtwoord onthouden omdat de toepassing de gebruiker aanmaakte of omdat de gebruiker deze informatie eerder al verstrekte en ze in het cachegeheugen is opgeslagen.

• SenderInfo met e-mail en zonder wachtwoord: In dit geval is de afzender van het document de gebruiker die de e-mailparameter specificeert. Het wachtwoord moet null zijn. Adobe Sign controleert of de API-aanroeper en de bedoelde afzender tot hetzelfde account behoren, maar vereist of controleert het wachtwoord niet. Deze methode is soms geschikt voor API-integratie binnen een specifieke organisatie, maar biedt minder individuele beveiliging. Dit verificatiemodel moet expliciet door de hoofdaccounthouder worden aangevraagd om beschikbaar te zijn voor gebruik via de Adobe Sign-API.

Zoals eerder is uitgelegd wilt u in de meeste gevallen het e-mailadres en het wachtwoord van de gebruiker opgeven in wiens naam u het document verzendt. De volgende sectie bevat een uitleg van de verschillende manieren waarop de informatie kan worden verkregen.

De gebruiker vragen naar zijn e-mailadres en wachtwoord voor Adobe Sign als onderdeel van de verzendingsprocedure. U kunt de verifyUser-methode gebruiken om te controleren of de gebruiker geregistreerd is bij Adobe Sign en of het wachtwoord geldig is. Als de gebruiker niet is geregistreerd, kunt u hem vragen zijn eigen account voor Adobe Sign aan te maken of u kunt een account voor hem aanmaken (zie hieronder).

Wanneer uit een aanroep naar verifyUser blijkt dat er geen gebruiker met dit e-mailadres bestaat, kunt u in het programma een Adobe Sign-gebruiker aanmaken door createUser aan te roepen. Als het aanmaken van een gebruiker met succes gebeurt, kunnen het e-mailadres en het wachtwoord die u hebt ingevoerd nu gebruikt worden als de SenderInfo voor uw document.

Na één van de scenario's hierboven, kunt u het e-mailadres en het wachtwoord van de gebruiker onthouden en gebruiken als SenderInfo voor het verzenden van documenten in naam van die gebruiker. De gebruiker kan zich op elk gewenst moment aanmelden bij zijn Adobe Sign-account en zijn wachtwoord wijzigen. Uw toepassing moet dus ook kunnen omgaan met situaties waarin een eerder opgeslagen wachtwoord ongeldig is.

Er zijn een aantal verschillende manieren om de identiteit van de afzender te bepalen wanneer de document-API van Adobe Sign wordt gebruikt. Lees de informatie hierboven om te bepalen welke methode geschikt is voor uw toepassing. Als u vragen hebt, aarzel niet om contact met ons op te nemen.