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

Naposledy aktualizováno 1. 12. 2023

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 ):

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:

Potíž s více konzolemi Admin Console spočívá v zajištění toho, abyste se nacházeli ve správné konzoli pro akce, které se snažíte provést.

Pokud chcete určit, za máte více konzolí:

1. Přihlaste se ke konzoli Admin Console.

2. Klikněte v pravém horním rohu konzole na název organizace.

Pokud se zobrazí rozevírací nabídka s více organizacemi, máte více konzolí Admin Console.

Rozbalovací nabídka organizace konzole Admin Console

Pokud máte pouze jednu konzoli Admin Console, probíhá tvorba uživatelů a udělování licencí ve stejné organizaci a nemusíte se starat o přepínání mezi konzolemi.

Pokud máte více konzolí Admin Console, věnujte chvíli určení toho, která organizace spravuje federovanou tvorbu uživatelů a která řídí udělování licencí služby Acrobat Sign.

Společnosti s více konzolemi Admin Console mohou službu Acrobat Sign nasadit z více než jedné. Musíte určit správnou konzoli Admin Console, kde chcete zřídit připojení rozhraní API a uživatele technického účtu.

Každou organizaci byste měli prozkoumat a určit, které by měly obsahovat technický účet.

Vyberte organizaci.
Vyberte v horní nabídce možností možnost Produkty.
Vyhledejte kartu produktu Adobe Sign – Enterprise s příznakem Dostupné rozhraní API.

Pro účely tohoto dokumentu budeme tuto funkci nazývat vaší konzolí Admin Console pro udělování licencí. Jedná se o organizaci, kde:

Určíte uživatele, který je správcem nebo vývojářem a bude se k rozhraní API připojovat.
Je vytvořen a spravován váš uživatel technického účtu.

Organizace, které používají federovanou správu uživatelů, musí zrušit synchronizaci federovaného řešení, aby mohly vytvořit uživatele mimo federované prostředí.

Pokud chcete provést tuto akci, musíte prozkoumat každou organizaci, abyste našli tu, která řídí domény, jež povolují federované důvěryhodné propojení. Více konzolí Admin Console může označit doménu za důvěryhodnou, ale aktivně ji ovládá pouze jedna.

Vyberte organizaci
Vyberte v horní nabídce možností možnost Nastavení.
Vyberte v levé nabídce možností možnost Identita.
Pokud jsou v seznamu uvedeny adresáře s Typem Federated ID a Stav je Důvěryhodný, klikněte na řadu, na které se adresář nachází, a zobrazte si Vlastnící organizaci.

Vlastnící organizace je správná konzole Admin Console k manipulaci ovládacích prvků synchronizace federovaného ID.

Pokud momentálně nemáte přístup, bude správci konzole poskytnut e-mail.

Pokud je Typ Federated ID a Stav je Aktivní, klikněte na Název adresáře a otevřete nastavení adresáře.

Na stránce nastavení vyberte kartu Synchronizace, která otevře informace o synchronizaci IDP.

Pro účely tohoto dokumentu budeme tuto funkci nazývat vaší konzolí Admin Console pro federovanou synchronizaci.

Nastavení adresáře – karta synchronizace

Poznámka

Pokud kartu Synchronizace nevidíte, váš účet může mít konzoli Global Admin Console, ke které nemáte přístup.

Abyste k ní získali přístup, musíte kontaktovat své interní správce Adobe.

Organizace, které

využívají nástroj pro synchronizaci uživatelů (UST) k automatické synchronizaci uživatelů mezi společností Adobe a jejím aktivním adresářem
nepovolují ruční přidávání či vytváření uživatelů ve službě Acrobat Sign

musí vytvořit skupinu s „výjimkou“ pro všechna ID uživatelů technických účtů. Všechna ID uživatelů technických účtů musí mít svou primární skupinu definovanou jako skupinu s výjimkou, aby bylo zajištěno, že nebudou během automatické synchronizace uživatelů deaktivována nebo že jim nebude odebrána licence.

Skupina s výjimkou musí být nakonfigurována jako výjimka ze synchronizace v rámci konfigurace UST.

V případech, kdy společnost Adobe hostuje nástroj UST jménem zákazníkovi organizace, musí správce zákazníků sdělit Název skupiny jeho manažerovi pro úspěch, manažerovi technického účtu nebo zástupci účtu, aby mohli spolupracovat s týmem Adobe Customer Solutions a zajistit, že bude tato skupina ze synchronizace vyjmuta.

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:

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.
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.
Vytvořil nebo nahrál dvojici veřejných/soukromých klíčů a 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.
(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.
Privilegoval ID uživatele technického účtu ve službě Acrobat Sign jako správce na úrovni skupiny.
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.
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ář.

Klikněte na odkaz Adobe Acrobat Sign Solutions – Enterprise v levé nabídce nebo v produktech.
Vyberte výchozí profil produktu pro službu Acrobat Sign.
Otevře se stránka Přidat uživatele k tomuto produktu:
- Vyberte kartu Správce nebo Vývojář.
Zadejte e-mailovou adresu uživatele, kterému chcete udělit přístup.
Klikněte na možnost Přidat správce/vývojáře.
Zadejte e-mailovou adresu uživatele, kterému chcete udělit přístup.
Zadejte křestní jméno a příjmení.
Po dokončení klikněte na Uložit.

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

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.
Vyberte možnost Vytvořit nový projekt
.
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
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
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í

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:

Vyberte možnost Vygenerovat dvojici klíčů.
Klikněte na možnost Vygenerovat dvojici klíčů.
Po vytvoření dvojice klíče jste vyzvání k uložení soukromého klíče do místního systému.

Veřejný klíč je dostupný ke kopírování z rozhraní:
Vyberte možnost Další.

Vyberte možnost Nahrát veřejný klíč.
Přetáhněte svůj certifikát veřejného klíče do pole pro nahrávání.
Vyberte možnost Další.

Nahraný veřejný klíč se zobrazí na stránce Konfigurace rozhraní API. Odtud jej můžete kopírovat.

Můžete nahrát další klíče nebo dle potřeby vygenerovat nové.
Po přidání všech klíčů vyberte možnost Další.

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ů.

Vyberte zaškrtávací políčko pro produkt Výchozí Adobe Acrobat Sign Solutions – Enterprise.
Až budete připraveni, uložte nakonfigurované 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íč.

Vložte dříve vygenerovaný/nahraný soukromý klíč do pole Soukromý klíč.
Vyberte možnost Vygenerovat token.
Po chvíli se pole Soukromý klíč obnoví a zobrazí přístupový token.
Zkopírujte a uložte přístupový token.
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.

Naklonujte následující úložiště: https://github.com/AdobeDocs/adobeio-auth/tree/stage/JWT/samples/adobe-jwt-java
V souboru config.properties nastavte informace technického účtu:
- Apikey
- Technicalaccountid
- Orgid
- Secret
- expirationTime
- metascopes
- key_path
- imshost
- imsExchange
Uložte secret.key do cílové složky ve formátu DER.

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ě:

Přihlaste se do služby Acrobat Sign jako správce na úrovni účtu.
Přejděte v nabídce správce na kartu Skupiny.
Vytvořte novou skupinu kliknutím na ikonu plus.
Zadejte intuitivní název skupiny (například stejný název jako Projekt).
Uložte skupinu.
(Volitelné) Otevřete novou skupinu a nakonfigurujte nastavení potřebná pro aplikaci.

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.

Přihlaste se k účtu Acrobat Sign jako správce na úrovni účtu.
Přejděte na kartu Uživatelé v nabídce správce.
Vyhledejte novou e-mailovou adresu techacct.adobe.com (zkopírována z domovské stránky projektu).
Klikněte na uživatele a vyberte možnost Upravit podrobnosti uživatele.
Klikněte na ikonu plus v části Členství ve skupině a přidejte skupinu aplikace do profilu uživatele.
Vyberte skupinu aplikace a klikněte na možnost Označit jako primární odkaz.
Zaškrtněte políčko, abyste ID uživatele označili jako Správce skupiny.
(Volitelné) Odeberte technický účet ze skupiny Výchozí.
Po dokončení klikněte na možnost Uložit.

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:

Přihlaste se ke konzoli Admin Console (pro federovanou synchronizaci) jako správce.
Přejděte do nabídky: Nastavení → Identita

Vyberte adresář pro vytvoření nového uživatele.
Vyberte kartu Synchronizace.
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.

Poznámka

Provádění úprav zůstane povolené pouze na jednu hodinu nebo dokud není ručně zakázáno.
Přihlaste se ke konzoli Admin Console pro udělování licencí (pokud pracujete s více konzolemi Admin Console).
Přejděte do nabídky: Uživatelé → Přidat uživatele.
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.
Přihlaste se znovu ke konzoli Admin Console pro federovanou synchronizaci a povolte synchronizaci vašich dat IdP.
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.
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,

Přihlaste se do služby Acrobat Sign jako správce účtu.
Přejděte na kartu Uživatelé v nabídce správce.
Klikněte jednou na nového uživatele a poté na možnost Upravit podobnosti uživatele.
Vyberte v levé nabídce možnost Stav sdílení.

Ujistěte se, že je vybrána karta Účet uživatelů sdílen s.
Vyberte kartu Sdílen s uživatelem v horní části stránky Stav sdílení.
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.

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

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

Přejděte na metody rozhraní API: https://secure.na1.adobesign.com/public/docs/restapi/v6
Vyberte metodu GET /users.
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!
Tělo odpovědi se vrátí se seznamem uživatelů v účtu a kódem odezvy 200:

Přejděte na metody rozhraní API: https://secure.na1.adobesign.com/public/docs/restapi/v6
Vyberte metodu POST /users/{userId}/views.
V poli Autorizace:
1. Zadejte slovo Bearer následované mezerou.
2. Vložte Přístupový kód.
V poli userId zadejte me.
Klikněte na odkaz Dokončit schéma modelu.
Klikněte do žlutého pole a přeneste schéma do pole UserViewInfo.
Upravení pole UserViewInfo:
- U hodnoty název zadejte možnost VŠE.
- Hodnotu autoLoginUser změňte na možnost true.
Klikněte na možnost Vyzkoušet!

Vrácené pole tělo odpovědi obsahuje adresu URL potřebnou k přihlášení jako uživatel:
Zkopírujte adresu URL a vložte ji do prohlížeče.
Budete vyzváni k potvrzení přihlášení.

Klikněte na možnost Ano.

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

Získejte prvek transientDocumentId nebo mějte připravenou jinou metodu pro přiložení souboru.
Přejděte na metody rozhraní API: https://secure.na1.adobesign.com/public/docs/restapi/v6#!/agreements/createAgreement
V poli Autorizace:
1. Zadejte slovo Bearer následované mezerou
2. Vložte Přístupový token
  technického účtu
3. V 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!
Přihlaste se do služby Acrobat Sign jako nové ID uživatele a přejděte na kartu Správa.
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.

Zefektivněte svou práci s aplikací Acrobat Sign
Rychle a snadno spravujte a podepisujte dokumenty online

Aplikaci otevřete

Předchozí

Přesunutí uživatele z jedné organizace Admin Console do jiné

Další

Vytvoření podnikových účtů pro odesílání dohod v rámci funkčního subjektu

Informace

Učte se pomocí podrobných výukových videí a praktických pokynů přímo v aplikaci.

Komunita

Zapojte se do diskuzí, najděte odpovědi, učte se od odborníků a sdílejte své znalosti.

Domovská stránka Adobe

Získejte přístup k oblíbeným aplikacím, službám, správě souborů a dalším funkcím Creative Cloud.