Oversigt
Dokument-API'et til Adobe Acrobat Sign er beregnet til at integreres problemfrit med dine eksisterende programmer, uden at du er nødt til at gå igennem en separat registreringsproces styret af Acrobat Sign. Det omsluttende program er derfor ansvarligt for at sikre, at afsenderen er registreret som bruger af Acrobat Sign. Det registrerer dem rent programmæssigt via API'et, hvis de ikke er det. Der er aldrig krav om, at modtagere skal registrere sig, og Acrobat Sign administrerer altid interaktioner, der måtte være nødvendige på modtagersiden.
Angiv en dokumentafsender
Der er flere måder at angive en afsender på, når du starter en ny transaktion med metoden sendDocument. Virkemåden afhænger af, hvilke værdier der føres ind gennem den valgfri parameter SenderInfo.
- Null SenderInfo: I dette tilfælde er afsenderen af dokumentet den specifikke og entydige bruger, der er knyttet til den API-nøgle, der anvendes. Denne metode er passende til tests og til visse implementeringer med begrænset omfang, men er typisk ikke nyttig i forhold til storstilede integrationer med eksisterende brugersæt.
- AfsenderInfo med e-mail og adgangskode: I dette tilfælde er afsenderen af dokumentet den bruger, som e-mailparameteren angiver. Den angivne adgangskode skal stemme overens med brugerens adgangskode til Acrobat Sign. Når det gælder integration, kan brugeren blive bedt om e-mail og adgangskode inden for konteksten af det omsluttende program, lige før dokumentet bliver sendt. Alternativt kan det omsluttende program huske e-mailen og adgangskoden. Det kan enten være, fordi det omsluttende program har oprettet brugeren, eller fordi brugeren tidligere har oplyst disse oplysninger, og de er blevet cachelagret.
- SenderInfo med e-mail og ingen adgangskode: I dette tilfælde er afsenderen af dokumentet den bruger, som e-mailparameteren angiver. Adgangskodeværdien skal være null. Acrobat Sign bekræfter, at API-kalderen og den tiltænkte afsender hører til samme konto, men hverken behøver eller kontrollerer adgangskoden. Denne metode er undertiden relevant for API-integrationer inden for en specifik organisation, men den mindsker sikkerheden for den enkelte. Indehaveren af den primære konto skal eksplicit anmode om denne godkendelsesmodel, for at den bliver tilgængelig for Acrobat Sign-API'et.
Acrobat Sign kontostyring
Som det er beskrevet herover vil du i de fleste tilfælde angive e-mail og adgangskode for den bruger, på hvis vegne du sender dokumentet. Følgende afsnit beskriver de forskellige måder, oplysninger kan fås på.
Spørg brugeren
Bed brugeren om at angive deres Acrobat Sign-mail samt adgangskode som del af afsendelsesprocessen. Du kan bruge metoden verifyUser til at kontrollere, om brugeren er registreret med Acrobat Sign, og om adgangskoden er gyldig. Er brugeren ikke registreret, kan du enten bede vedkommende om at oprette en egen Acrobat Sign-konto eller oprette en for vedkommende (se herunder).
Opret kontoen
Hvis et kald til verifyUser viser, at der ikke findes en bruger med den e-mailadresse, kan du programmæssigt oprette en Acrobat Sign-bruger ved at kalde createUser. Under forudsætning af at der er oprettet en bruger, kan den e-mail og adgangskode, du har angivet, nu bruges som SenderInfo for dit dokument.
Husk kontoen
Efter en af scenarierne herover kan du derefter huske brugerens e-mailadresse og adgangskode og bruge disse som SenderInfo for afsendelse af efterfølgende dokumenter på vegne af den bruger. Det er muligt, at brugeren når som helst logger på sin Acrobat Sign-konto og ændrer adgangskoden, så dit program skal kunne håndtere det tilfælde, at en tidligere gemt adgangskode er ugyldig.
Konklusion
Der er en række forskellige måder at fastlægge afsenderens identitet på, når der bruges et dokument-API til Acrobat Sign. Læs oplysningerne nøje igennem for at finde ud af, hvilken metode der passer til dit program. Hvis du har spørgsmål, er du meget velkommen til at kontakte os.