Přehled

API dokumentu e-podpisových služeb Document Cloud slouží k bezproblémové integraci do vaší stávající aplikace, aniž byste museli procházet samostatným procesem registrace řízené e-podpisovými službami. Vlastní aplikace tak zodpovídá za, aby byl odesílatel registrovaným uživatelem e-podpisových služeb. Pokud jím není, zaregistruje jej programově prostřednictvím API. Příjemci se nikdy registrovat nemusí a e-podpisové služby vždy řídí, zda jsou interakce na straně příjemce nezbytné.

Určení odesílatele dokumentu

Při zahájení nové transakce pomocí metody sendDocument lze odesílatele určit několika způsoby. Chování závisí na tom, jaké hodnoty jsou dodávány prostřednictvím volitelné metody SenderInfo.

  • Prázdná hodnota SenderInfo: V tomto případě je odesílatelem dokumentu konkrétní jedinečný uživatel spojený s použitým klíčem API. Tato metoda je vhodná pro testování a určité implementace s omezeným rozsahem, ale obvykle se nehodí pro rozsáhlé integrace se stávajícími sadami uživatelů.
  • SenderInfo e-mailem a heslem: V tomto případě je odesílatelem dokumentu uživatel specifikovaný parametrem e-mail. Zadané heslo se musí shodovat s uživatelovým heslem pro službu EchoSign. Pro účely integrace lze e-mail a heslo v kontextu vlastní aplikace od uživatele vyžádat před odesláním dokumentu. Případně si vlastní aplikace může e-mail a heslo pamatovat, protože uživatele vytvořila nebo protože uživatel tyto údaje dříve zadal a údaje byly uloženy do mezipaměti.
  • SenderInfoe-mailem a bez hesla: V tomto případě je odesílatelem dokumentu uživatel specifikovaný parametrem e-mail. Hodnota hesla musí být nulová. Služba EchoSign ověřuje, zda uživatel volající API a zamýšlený odesílatel patří ke stejnému účtu, ale nevyžaduje ani nekontroluje heslo. Tato metoda je někdy vhodná pro integrace API v konkrétní organizaci, ale omezuje omezené individuální zabezpečení. Tento model ověřování musí být výslovně požadován držitelem hlavního účtu, aby byl k dispozici k používání prostřednictvím API služby EchoSign.

Správa účtu e-podpisových služeb

Jak je popsáno výše, ve většině případů chcete zadat e-mail a heslo uživatele, jehož jménem dokument odesíláte. V následující sekci jsou popsány různé způsoby, jak lze tyto údaje získat.

Požádání uživatele

Požádejte uživatele o jeho e-mail a heslo k e-podpisovým službám v rámci procesu odesílání. Pomocí metody verifyUser můžete zkontrolovat, zda je uživatel zaregistrovaný k e-podpisovým službám a heslo je platné. Pokud uživatel zaregistrovaný není, můžete jej požádat o vytvoření vlastního účtu pro e-podpisové služby nebo mu účet vytvořit (viz níže).

Vytvoření účtu

Pokud volání metody verifyUser ukáže, že žádný uživatel s takovou e-mailovou adresou neexistuje, můžete uživatele e-podpisových služeb programově vytvořit voláním metody createUser. V případě úspěšného vytvoření uživatele lze zadaný e-mail a heslo použít jako hodnoty SenderInfo pro dokument.

Zapamatování účtu

V návaznosti na oba scénáře výše si můžete uživatelův e-mail a heslo zapamatovat a používat je jako hodnoty SenderInfo pro odesílání následujících dokumentů jménem daného uživatele. Je možné, že se uživatel ve skutečnosti přihlásí ke svému účtu e-podpisových služeb a heslo si kdykoli změní, proto vaše aplikace musí zvládat případy, kdy je dříve uložené heslo neplatné.

Závěr

Existuje řada různých způsobů, jak zjistit identitu odesílatele při používání API dokumentu e-podpisových služeb. Pečlivě si přečtěte výše uvedené informace, abyste zjistili, která metoda je vhodná pro vaši aplikaci. V případě dotazů nás neváhejte kontaktovat.

Tato práce podléhá licenci Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License.  Na příspěvky ze služeb Twitter™ a Facebook se nevztahují podmínky licence Creative Commons.

Právní upozornění   |   Zásady ochrany osobních údajů online