Příručka uživatele Zrušit

Vytváření technických účtů pro odesílání dohod přes rozhraní API

 

Příručka služby Adobe Acrobat Sign

Co je nového

Začínáme

Správa

Odesílání, podepisování a správa dohod

Rozšířené možnosti a pracovní postupy dohod

Integrace s jinými produkty

Vývojář služby Acrobat Sign

Podpora a řešení problémů

Technické účty Adobe Acrobat Sign

Technické účty Acrobat Sign jsou prostředkem k povolení účtů na podnikové úrovni se schopností spouštět své aplikace s oprávněním ID uživatele výslovně vytvořeného pro daný účel (vs. pomocí osobního ID uživatele správce).

Technické účty jsou pro podnikové zákazníky dostupné (prostřednictvím konzole Adobe Developer Console) v nákupním plánu dohody ETLA, který spravuje jejich účty pomocí konzole Adobe Admin Console.

Karta produktu pro přístup k technickému účtu se nachází na kartě Produkty konzole Admin Console pod názvem nabídky Adobe Acrobat Sign Solutions – Enterprise (Dívejte se po příznaku Dostupné rozhraní API ):

Karty produktů technických účtů

Poznámka:

Níže uvedený proces popisuje použití technických účtů prostřednictvím řešení rozhraní API. Informace pro organizace, které chtějí uživatelům umožnit ručně odesílat dohody jménem centralizované strany, naleznete v dokumentu určeném k nastavování technických účtů prostřednictvím ručního připojení.

Předpoklady

Pokud chcete povolit technický účet, musí váš účet Acrobat Sign:

  • Mít službu ETLA na podnikové úrovni
  • Spravovat uživatele v konzoli Adobe Admin Console*
  • Mít povolené rozšířené sdílení účtů

* Poznámka ke konzoli Adobe Admin Console

Konzole Adobe Admin Console poskytuje rámec pro správu uživatelů a udělování licencí. Většina zákazníků má pouze jednu konzoli Admin Console.

Někteří zákazníci se složitými uživatelskými/licenčními požadavky mohou však mít více konzolí Admin Console, což může být matoucí během procesu, jako je vytváření technického účtu, kde jedna konzole Admin Console může řídit federovanou správu uživatelů a jiná zase spravuje udělování licencí služby Acrobat Sign.

Pokud víte, že máte více účtů, nebo si nejste jistí, přečtěte si níže uvedené informace:

Přehled

Vytvoření technického účtu je vícekrokový proces, který vyžaduje přístup na úrovni správce ke konzoli Adobe Acrobat a roli správce na úrovni účtu ve službě Acrobat Sign.

Proces vyžaduje, aby správce:

  1. Povolil uživateli vytvářejícímu technický účet přístup správce nebo vývojáře.
    • Uživatel musí být správce nebo vývojář, aby mohl nakonfigurovat nastavení, která vytváří technický účet.
  2. Vytvořil nový projekt v konzoli Adobe Developer Console (Adobe.io).
    • Projekt je vyžadovaným prostředím pro držení dvojice veřejných/soukromých klíčů a přístupového tokenu, který umožňuje fungování technického účtu.
  3. Vytvořil nebo nahrál dvojici veřejných/soukromých klíčůvygeneroval přístupový token.
    • Vygenerování přístupového tokenu vytvoří v konzoli Adobe Admin Console ID uživatele technického účtu a vyplní jej do systému služby Acrobat Sign.
  4. (Volitelné) Vytvořil novou skupinu v systému služby Acrobat Sign.
    • Vytvoření skupiny vyhrazené pro ID uživatele technického účtu umožňuje velmi podrobnou konfiguraci vlastností dohody, které mohou být příliš přísné či odlišné od konfigurací jiných skupin.
  5. Privilegoval ID uživatele technického účtu ve službě Acrobat Sign jako správce na úrovni skupiny.
  6. Vytvořil nového federovaného uživatele v konzoli Adobe Admin Console.
    • Vytvoří se tak e-mail uživatele s vaší doménou, který slouží jako proxy pro ID uživatele technického účtu při odesílání, a poskytuje e-mailovou adresu správně přiřazenou vaší společnosti.
  7. Sdílel účet federovaného uživatele s technickým účtem.
    • ID uživatele technického účtu je vygenerováno v konzoli Admin Console pro udělování licencí s e-mailovou adresou adobe.com. Sdílením účtu federovaného uživatele udělujete ID uživatele technického účtu přístup k odesílání jménem federovaného ID uživatele, čímž příjemcům poskytnete jméno/e-mailovou adresu, která je pro člověka přívětivější.

    Po dokončení lze rozhraní API nakonfigurovat tak, aby používalo technický účet (prostřednictvím přístupového kódu) k vytváření a odesílání dohod jménem centralizovaného uživatele.

Povolení přístupu uživatelů ke konzolím Developer Console

Než bude možné přidat nový technický účet, musí být uživatel nejprve přidán do profilu produktu Adobe Acrobat Sign Solutions – Enterprise (v konzoli Admin Console pro udělování licencí) jako Správce nebo Vývojář.

  1. Klikněte na odkaz Adobe Acrobat Sign Solutions – Enterprise v levé nabídce nebo v produktech.

  2. Vyberte výchozí profil produktu pro službu Acrobat Sign.

    Výběr profilu produktu

  3. Otevře se stránka Přidat uživatele k tomuto produktu:

    • Vyberte kartu Správce nebo Vývojář.
  4. Zadejte e-mailovou adresu uživatele, kterému chcete udělit přístup.

  5. Klikněte na možnost Přidat správce/vývojáře.

    Přidání správce

  6. Zadejte e-mailovou adresu uživatele, kterému chcete udělit přístup.

  7. Zadejte křestní jméno a příjmení.

  8. Po dokončení klikněte na Uložit.

    Zadávání informací o vývojáři

Vytvoření nového projektu v konzoli Adobe.io

  1. Přejděte na stránku https://console.adobe.io

    • Pokud patříte k více instancím konzole Admin Console, ujistěte se, že jste připojeni k instanci, která odpovídá vaší konzoli Admin Console pro udělování licencí kliknutím na šipku dolů v pravém horním rohu okna.
    Instance konzole Admin Console

  2. Vyberte možnost Vytvořit nový projekt
    .

    Vytváření nového projektu

  3. Nový projekt se v konzoli zobrazí na kartě Projekty.

    Věnujte chvíli pojmenování vašeho projektu kliknutím na tlačítko Upravit projekt.

    • Zadejte název, kterému vaši kolegové porozumí
    • Zadejte krátký popis
    • Uložte úpravy
    Úprava projektu

  4. Vyberte nový projekt (na kartě Projekty) a otevřete jej za účelem konfigurace.

    Na stránce Začínáme:

    1. Vyberte možnost Přidat projekt
    2. Vyberte v rozevírací nabídce možnost rozhraní API
    Přidání rozhraní API

  5. Na stránce Přidat rozhraní API:

    1. Vyberte filtr Document Cloud
    2. Vyberte možnost Acrobat Sign
    3. Klikněte na možnost Následující
    Výběr možnosti Acrobat Sign

Vytvoření nového webového tokenu JSON

Máte možnost vygenerovat novou dvojici veřejných/soukromých klíčů nebo nahrát svůj veřejný klíč. Vyberte možnost, která nejlépe vyhovuje vašim potřebám:

Výběr profilu produktu

Stránka Konfigurace rozhraní API se obnoví a zobrazí profil produktu dostupného / profily produktů dostupných pro váš účet. V závislosti na profilech, které máte k dispozici, můžete mít jeden nebo více profilů.

  1. Vyberte zaškrtávací políčko pro produkt Výchozí Adobe Acrobat Sign Solutions – Enterprise.
  2. Až budete připraveni, uložte nakonfigurované rozhraní API.
Uložení nakonfigurovaného rozhraní API

Vygenerování přístupového tokenu

Po uložení se vytvoří technický účet a vy se vrátíte na domovskou stránku projektu.

V části Vygenerování přístupového tokenu je vstupní pole pro váš soukromý klíč. 

  1. Vložte dříve vygenerovaný/nahraný soukromý klíč do pole Soukromý klíč.

  2. Vyberte možnost Vygenerovat token.

  3. Po chvíli se pole Soukromý klíč obnoví a zobrazí přístupový token.

  4. Zkopírujte a uložte přístupový token.

    Vygenerování přístupového tokenu

  5. Níže na stejné stránce máte přístup k:

    • ID klienta
    • Tajemství klienta
    • ID technického účtu
    • E-mailu technického účtu
    • ID organizace

    Zkopírujte a uložte e-mail technického účtu.

    Uložení e-mailu technického účtu

Zvažte vygenerování jedinečné skupiny ve službě Acrobat Sign pro aplikaci

Skupiny služby Acrobat Sign umožňují podrobnou konfiguraci nastavení zabezpečení a prostředí pro příjemce (stejně jako pracovních postupů, šablon, hlášení atd.)

Pokud chcete izolovat ID uživatele technického účtu v jejich vlastní skupině:

  1. Přihlaste se do služby Acrobat Sign jako správce na úrovni účtu.

  2. Přejděte v nabídce správce na kartu Skupiny.

  3. Vytvořte novou skupinu kliknutím na ikonu plus.

  4. Zadejte intuitivní název skupiny (například stejný název jako Projekt).

  5. Uložte skupinu.

  6. (Volitelné) Otevřete novou skupinu a nakonfigurujte nastavení potřebná pro aplikaci.

    Vytvoření skupiny

Poznámka:

Pokud vaše organizace

  • používá nástroj pro synchronizaci uživatelů (UST) k automatické synchronizaci uživatelů mezi společností Adobe a vaším aktivním adresářem
  • nepovoluje ruční přidání či vytvoření uživatelů ve službě Acrobat Sign

musíte vytvořit skupinu s výjimkou, která bude působit jako primární skupina všech ID uživatelů technických účtů.

Název skupiny je přidán do konfigurace nástroje UST, aby se zajistilo, že proces synchronizace neovlivní ID uživatelů a nezpůsobí jejich deaktivaci či odebrání jejich oprávnění.

Privilegování ID uživatele technického účtu jako správce skupiny ve službě Acrobat Sign

Počkejte několik minut na vygenerování nově vytvořeného uživatele techacct.adobe.com v systému služby Acrobat Sign.

  1. Přihlaste se k účtu Acrobat Sign jako správce na úrovni účtu.

  2. Přejděte na kartu Uživatelé v nabídce správce.

  3. Vyhledejte novou e-mailovou adresu techacct.adobe.com (zkopírována z domovské stránky projektu).

  4. Klikněte na uživatele a vyberte možnost Upravit podrobnosti uživatele.

    Úprava podrobností uživatele

  5. Klikněte na ikonu plus v části Členství ve skupině a přidejte skupinu aplikace do profilu uživatele.

  6. Vyberte skupinu aplikace a klikněte na možnost Označit jako primární odkaz.

  7. Zaškrtněte políčko, abyste ID uživatele označili jako Správce skupiny.

  8. (Volitelné) Odeberte technický účet ze skupiny Výchozí.

  9. Po dokončení klikněte na možnost Uložit.

    Uložení uživatelských nastavení

Vytvoření uživatele/e-mailu Odpovědět

Odesílání dohod pomocí ID uživatele / e-mailu propojeného s technickým účtem je problematické, protože e-mail není v doméně vaší společnosti.

Řešení tohoto problému:

  • Nové federované ID uživatele je třeba vytvořit v konzoli Admin Console pro udělování licencí.
  • ID uživatele technického účtu musí být sdíleno s novým federovaným ID uživatele (prostřednictvím rozšířeného sdílení účtu).

Po konfiguraci musí být volání rozhraní API nakonfigurováno tak, aby používalo token technického účtu jako hodnotu Autorizace a ID uživatele nebo e-mail sdíleného ID uživatele jako hodnotu x-on-behalf-of-user.

Vytvoření nového federovaného ID uživatele

Před vytvořením nového ID uživatele musíte určit e-mailovou adresu, kterou lze použít pro příchozí odpovědi/dotazy od příjemců.

Vytvoření nového ID uživatele:

  1. Přihlaste se ke konzoli Admin Console (pro federovanou synchronizaci) jako správce.

  2. Přejděte do nabídky:  Nastavení → Identita

    Vyberte adresář pro vytvoření nového uživatele.

    Aktivní doména

  3. Vyberte kartu Synchronizace.

  4. Vyberte možnost Přejít do nastavení a klikněte na možnost Povolit úpravy.

    Pokud jsou úpravy povoleny, konzole Adobe Admin Console povoluje provádět úpravy dat uživatelů pouze v rámci konzole Admin Console. S těmito úpravami se neaktualizuje vaše IdP.

    Nastavení adresáře – karta synchronizace

    Poznámka:

    Provádění úprav zůstane povolené pouze na jednu hodinu nebo dokud není ručně zakázáno.

    Technický účet

  5. Přihlaste se ke konzoli Admin Console pro udělování licencí (pokud pracujete s více konzolemi Admin Console).

  6. Přejděte do nabídky: Uživatelé → Přidat uživatele.

  7. Nakonfigurujte své nové ID uživatele pomocí:

    • E-mailu nebo uživatelského jména: Použijte e-mailovou adresu, u které chcete, aby zachytila všechny e-maily s odpověďmi od vašich příjemců.
    • Typu ID: Federated ID
    • Křestního jména / příjmení: tato hodnota je použita v systému služby Acrobat Sign a projeví se ve zprávě o auditu. Použijte hodnotu, která poskytuje kontext. např. lidské zdroje
    • Uživatelské jméno jednotného přihlašování (SSO): Použijte stejnou hodnotu e-mailu.
    • Země/region: Vyberte pro svou společnost vhodnou zemi či region.
    • Vyberte produkt/profil služby Acrobat Sign, se kterým je spojeno technické ID uživatele.
    • Nastavte roli uživatele na Uživatel.

    Po dokončení klikněte na možnost Uložit.

    Technický účet

  8. Přihlaste se znovu ke konzoli Admin Console pro federovanou synchronizaci a povolte synchronizaci vašich dat IdP.

  9. Vraťte se do nabídky Nastavení → Identita → {Directory} → Synchronizace → Přejít do nastavení.

    Klikněte na možnost Zakázat úpravy a znovu povolte synchronizaci dat svého IdP.

  10. Nové ID uživatele se automaticky vygeneruje v systému služby Acrobat Sign.

Sdílení technického účtu s novým federovaným ID uživatele

Pokud chcete získat přístup k obsahu pro ID uživatele, ke kterému se můžete přihlásit,

  1. Přihlaste se do služby Acrobat Sign jako správce účtu.

  2. Přejděte na kartu Uživatelé v nabídce správce.

  3. Klikněte jednou na nového uživatele a poté na možnost Upravit podobnosti uživatele.

  4. Vyberte v levé nabídce možnost Stav sdílení.

    Ujistěte se, že je vybrána karta Účet uživatelů sdílen s.

  5. Vyberte kartu Sdílen s uživatelem v horní části stránky Stav sdílení.

  6. Sdílejte nový účet ID uživatele s technickým účtem

    1. Klikněte na ikonu plus v pravém horním řádku a otevřete rozhraní výběru.
    2. Klikněte na ikonu tří čar napravo od vyhledávacího pole.
    3. Rozbalte skupinu, ve které se nachází ID uživatele technického účtu.
    4. Vyberte ID uživatele technického účtu kliknutím na ikonu plus vedle něj.
    5. Zaškrtněte možnost Další oprávnění a povolte Odesílání.
    6. Klikněte na možnost Uložit.
    Technický účet

Testování nového technického účtu

Pokud chcete otestovat, zda váš přístupový kód funguje správně:

  1. Přejděte na metody rozhraní API: https://secure.na1.adobesign.com/public/docs/restapi/v6

  2. Vyberte metodu GET /users.

  3. V poli Autorizace:

    1. Zadejte slovo Bearer následované mezerou
    2. Vložte Přístupový kód
    3. Klikněte na možnost Vyzkoušet!
    Vyzkoušet!

  4. Tělo odpovědi se vrátí se seznamem uživatelů v účtu a kódem odezvy 200:

    Tělo odpovědi

Testování odeslání dohody pomocí technického účtu jménem nového ID uživatele prostřednictvím rozhraní API

  1. Získejte prvek transientDocumentId nebo mějte připravenou jinou metodu pro přiložení souboru.

  2. V poli Autorizace:

    1. Zadejte slovo Bearer následované mezerou
    2. Vložte Přístupový token
      technického účtu
    3. poli x-on-behalf-of-user zadejte e-mailovou adresu nového ID uživatele
    4. Dokončete zbytek objektu AgreementInfo s prvkem transientDocumentId, názvem dohody, typem podpisu a stavem.
    5. Klikněte na možnost Vyzkoušet!
    Vyzkoušet!

  3. Přihlaste se do služby Acrobat Sign jako nové ID uživatele a přejděte na kartu Správa.

  4. Při kontrolování protokolu auditu dohody uvidíte, že byla dohoda odeslána technickým účtem jménem nového ID uživatele.

Kontrola obsahu vygenerovaného jménem nového ID uživatele prostřednictvím rozhraní služby Acrobat Sign

Když technický účet vytvoří dohodu jménem federovaného ID uživatele, dohoda je publikována na stránku Správa federovaného ID uživatele.

Dohodu můžete zobrazit a spravovat na stránce Správa federovaného ID uživatele.

Dohoda odeslaná jménem uživatele

Získejte pomoc rychleji a snáze

Nový uživatel?