Podręcznik użytkownika Anuluj

Tworzenie kont technicznych w celu wysyłania umów za pośrednictwem interfejsu API

 

Podręcznik Adobe Acrobat Sign

Nowości

Pierwsze kroki

Administrowanie

Wysyłanie i podpisywanie umów oraz zarządzanie nimi

Zaawansowane możliwości umów i obiegów pracy

Integracja z innymi produktami

Programista Acrobat Sign

Pomoc techniczna i rozwiązywanie problemów

Konta techniczne Adobe Acrobat Sign

Konta techniczne Acrobat Sign to narzędzie umożliwiające uruchamianie aplikacji na poziomie korporacyjnym za pomocą identyfikatora użytkownika wygenerowanego specjalnie w tym celu (zamiast używania osobistego identyfikatora użytkownika administratora).

Konta techniczne są dostępne dla klientów korporacyjnych (za pośrednictwem konsoli programisty Adobe) w planie zakupowym ETLA, który zarządza ich kontami za pośrednictwem Adobe Admin Console.

Kartę produktu umożliwiającą dostęp do konta technicznego można znaleźć na stronie Produkty w konsoli administracyjnej pod nazwą oferty Rozwiązania Adobe Acrobat Sign dla przedsiębiorstw (Poszukaj flagi Dostępny interfejs API):

Karty produktów konta technicznego

Uwaga:

W poniższym procesie opisano korzystanie z Kont technicznych za pomocą rozwiązania API. Organizacje, które chcą umożliwić użytkownikom ręczne wysyłanie umów w imieniu scentralizowanej strony, powinny zapoznać się z dokumentem do konfigurowania kont technicznych przez połączenie ręczne.

Wymagania wstępne

Aby włączyć konto techniczne, konto Acrobat Sign musi:

  • posiadać usługę ETLA na poziomie Enterprise;
  • zarządzać użytkownikami w Adobe Admin Console*;
  • mieć włączone zaawansowane udostępnianie konta.

* Uwaga dotycząca Adobe Admin Console

Adobe Admin Console udostępnia strukturę do zarządzania użytkownikami i przydzielania licencji. Większość klientów ma tylko jedną konsolę Admin Console.

Jednak niektórzy klienci ze złożonymi wymaganiami dotyczącymi użytkowników i licencji mogą mieć wiele konsol Admin Console, co może stać się mylące w procesie takim jak tworzenie konta technicznego, gdzie jedna konsola Admin Console może zarządzać sfederowanym zarządzaniem użytkownikami, a inna zarządza licencjonowaniem Acrobat Sign.

Jeśli wiesz, że posiadasz wiele kont lub nie masz pewności — przeczytaj poniższe informacje:

Omówienie

Tworzenie konta technicznego jest procesem wieloetapowym, który wymaga dostępu na poziomie administratora do konsoli Adobe Acrobat oraz uprawnień administratora na poziomie konta w usłudze Acrobat Sign.

Administrator musi wykonać następujące czynności:

  1. Włączenie dostępu administratora lub programisty dla użytkownika tworzącego konto techniczne.
    • Użytkownik musi być administratorem lub programistą, aby skonfigurować ustawienia tworzenia konta technicznego.
  2. Utworzenie nowego projektu w usłudze konsoli programisty Adobe (Adobe.io).
    • Projekt jest środowiskiem wymaganym do przechowywania pary kluczy publiczny/prywatny i tokenu dostępu, który umożliwia funkcjonalność konta technicznego.
  3. Utworzenie lub przekazanie par kluczy publicznych/prywatnych i wygenerowanie tokenu dostępu.
    • Wygenerowanie tokenu dostępu tworzy identyfikator użytkownika konta technicznego w Adobe Admin Console i wypełnia go w systemie Acrobat Sign.
  4. (Opcjonalnie) Utworzenie nowej grupy w systemie Acrobat Sign.
    • Utworzenie dedykowanej grupy dla identyfikatora użytkownika konta technicznego umożliwia bardzo ścisłą konfigurację właściwości umowy, które mogą być zbyt rygorystyczne lub różnić się od innych konfiguracji grupy.
  5. Nadanie identyfikatorowi użytkownika konta technicznego w programie Acrobat Sign uprawnienia administratora na poziomie grupy.
  6. Utworzenie nowego użytkownika sfederowanego w Adobe Admin Console.
    • Spowoduje to utworzenie adresu e-mail użytkownika z Twoją domeną w celu wysłania do konta technicznego identyfikatora podczas wysyłania, podając adres e-mail, który jest prawidłowo przypisany do firmy.
  7. Udostępnianie konta użytkownika sfederowanego kontu technicznemu.
    • Identyfikator użytkownika konta technicznego jest generowany w konsoli administracyjnej licencjonowania z adresem e-mail adobe.com. Udostępniając konto użytkownika sfederowanego, udzielasz dostępu użytkownikowi konta technicznego do wysyłania w imieniu użytkownika sfederowanego, zapewniając w ten sposób bardziej przyjazną dla człowieka nazwę/adres e-mail dla odbiorców.

    Po zakończeniu API może być skonfigurowane tak, aby używać konta technicznego (poprzez kod dostępu) do tworzenia i wysyłania umów w imieniu scentralizowanego użytkownika.

Umożliwianie użytkownikom dostępu do konsoli programisty

Aby można było dodać nowe konto techniczne, użytkownik musi najpierw zostać dodany do profilu produktowego Rozwiązania Adobe Acrobat Sign dla przedsiębiorstw (w konsoli administracyjnej licencjonowania) jako Administrator lub Programista.

  1. Kliknij łącze Rozwiązania Adobe Acrobat Sign dla przedsiębiorstw po lewej stronie lub w produktach.

  2. Wybierz domyślny profil produktowy dla usługi Acrobat Sign.

    Wybierz profil produktowy

  3. Otwiera się strona Dodaj użytkowników do tego produktu:

    • Wybierz opcję Administrator lub Programista.
  4. Wpisz adres e-mail użytkownika, któremu chcesz przyznać dostęp.

  5. Kliknij Dodaj administratora/programistę.

    Dodaj programistę

  6. Wpisz adres e-mail użytkownika, któremu chcesz przyznać dostęp.

  7. Wprowadź imię i nazwisko.

  8. Kliknij Zapisz po zakończeniu.

    Wprowadź informacje programisty

Tworzenie nowego projektu w konsoli Adobe.io

  1. Przejdź do https://console.adobe.io

    • Jeśli należysz do wielu instancji konsol Admin Console, upewnij się, że nawiązano połączenie z instancją, która jest zgodna z konsolą administracyjną licencjonowania, klikając strzałkę w dół w prawym górnym rogu okna.
    Instancje konsoli Admin Console

  2. Wybierz Utwórz nowy projekt.

    Utwórz nowy projekt

  3. Nowy projekt jest wyświetlany na karcie Projekty konsoli.

    Nadaj projektowi nazwę, klikając przycisk Edytuj projekt.

    • Podaj nazwę, którą będą rozumieć Twoi współpracownicy.
    • Podaj krótki opis.
    • Zapisz zmiany.
    Edytuj projekt

  4. Wybierz nowy projekt (na karcie Projekty), aby otworzyć go do konfiguracji.

    Na stronie Pierwsze kroki:

    1. Wybierz Dodaj do projektu.
    2. W menu rozwijanym wybierz Interfejs API.
    Dodawanie adresu API

  5. Na stronie Dodaj interfejs API:

    1. Wybierz filtr Document Cloud.
    2. Wybierz Acrobat Sign.
    3. Kliknij przycisk Dalej.
    Wybierz Acrobat Sign

Tworzenie nowego tokenu sieciowego JSON

Możesz wygenerować nową parę kluczy publicznych/prywatnych lub przesłać klucz publiczny. Wybierz opcję, która najlepiej odpowiada Twoim potrzebom:

Wybierz profil produktowy

Strona Konfiguracja interfejsu API odświeża się, aby pokazać profile produktowe dostępne dla Twojego konta. W zależności od profili dostępnych na koncie może istnieć jeden lub większa ich liczba.

  1. Zaznacz pole wyboru dla Domyślne rozwiązania Adobe Acrobat Sign dla przedsiębiorstw.
  2. Zapisz skonfigurowany interfejs API, gdy wszystko będzie gotowe.
Zapisz skonfigurowany interfejs API

Wygeneruj token dostępu

Po zapisaniu zostanie utworzone konto techniczne i nastąpi powrót do strony głównej projektu.

W sekcji Wygeneruj token dostępu znajduje się pole wprowadzania klucza prywatnego. 

  1. Wklej wygenerowany/przesłany wcześniej klucz prywatny w polu Klucz prywatny.

  2. Wybierz Wygeneruj token.

  3. Po chwili pole Klucz prywatny odświeży się i wyświetli Token dostępu.

  4. Skopiuj i zapisz token dostępu.

    Wygeneruj token dostępu

  5. Niżej na tej stronie znajdują się następujące elementy:

    • Identyfikator klienta
    • Tajny klucz klienta
    • Identyfikator konta technicznego
    • Adres e-mail konta technicznego
    • Identyfikator organizacji

    Skopiuj i zapisz Adres e-mail konta technicznego.

    Zapisz adres e-mail konta technicznego

Generowanie unikalnej grupy dla aplikacji w usłudze Acrobat Sign

Grupy Acrobat Sign umożliwiają precyzyjną konfigurację ustawień zabezpieczeń i oświadczeń dla odbiorcy (obiegi pracy, szablony, raporty itp.)

Jeśli chcesz wyizolować identyfikator użytkownika konta technicznego we własnej grupie:

  1. Zaloguj się do usługi Acrobat Sign jako administrator na poziomie konta.

  2. Przejdź do karty Grupy w menu administratora.

  3. Kliknij ikonę plusa, aby utworzyć nową grupę.

  4. Wprowadź intuicyjną nazwę grupy (być może taką samą jak nazwa projektu).

  5. Zapisz grupę.

  6. (Opcjonalnie) Otwórz nową grupę i skonfiguruj ustawienia wymagane dla aplikacji.

    Tworzenie grupy

Uwaga:

Jeśli Twoja organizacja

  • wykorzystuje narzędzie Synchronizacja użytkowników (UST) do automatycznej synchronizacji użytkowników między firmą Adobe a usługą Active Directory,
  • nie pozwala na ręczne dodawanie lub tworzenie użytkowników w Acrobat Sign,

należy utworzyć grupę wyjątków, która będzie grupą podstawową dla wszystkich identyfikatorów użytkowników kont technicznych.

Nazwa grupy zostanie dodana do konfiguracji narzędzia UST, aby zagwarantować, że proces synchronizacji nie wpłynie na identyfikatory użytkowników, powodując ich dezaktywację lub usunięcie uprawnień.

Nadanie identyfikatorowi użytkownika konta technicznego uprawnienie administratora grupy w usłudze Acrobat Sign

Poczekaj kilka minut, aż nowo utworzony użytkownik techacct.adobe.com zostanie wygenerowany w systemie Acrobat Sign.

  1. Zaloguj się do swojego konta Acrobat Sign jako administrator na poziomie konta.

  2. Przejdź do karty Użytkownicy w menu administratora.

  3. Wyszukaj nowy adres e-mail techact.adobe.com (skopiowany ze strony głównej projektu).

  4. Kliknij użytkownika i wybierz Edytuj szczegóły użytkownika.

    Edytuj szczegóły użytkownika

  5. Kliknij ikonę plusa w sekcji Członkostwo w grupie i dodaj grupę aplikacji do profilu użytkownika.

  6. Wybierz grupę aplikacji i kliknij Oznacz jako łącze podstawowe.

  7. Zaznacz pole wyboru, aby oflagować identyfikator użytkownika jako Administrator grupy.

  8. (Opcjonalnie) Usuń konto techniczne z grupy Domyślna.

  9. Na koniec kliknij przycisk Zapisz.

    Zapisz ustawienia użytkownika

Tworzenie użytkownika / adresu e-mail Odpowiedz do

Wysyłanie umów przy użyciu identyfikatora użytkownika / adresu e-mail powiązanego z kontem technicznym jest problematyczne, ponieważ adres e-mail nie należy do domeny firmy.

Aby rozwiązać ten problem:

  • Należy utworzyć nowy identyfikator użytkownika sfederowanego w konsoli licencjonowania Admin Console.
  • Identyfikator użytkownika konta technicznego należy udostępnić nowemu identyfikatorowi użytkownika sfederowanego (poprzez zaawansowane udostępnianie konta).

Po skonfigurowaniu wywołania API muszą być skonfigurowane tak, aby używać tokena konta technicznego jako wartości autoryzacji, a identyfikator użytkownika lub adres e-mail współdzielonego identyfikatora użytkownika jako wartości x-on-behalf-of-user .

Utwórz nowy identyfikator użytkownika sfederowanego

Przed utworzeniem nowego identyfikatora użytkownika musisz określić adres e-mail, którego można użyć w przypadku odpowiedzi/pytań przychodzących od odbiorców.

Aby utworzyć nowy identyfikator użytkownika:

  1. Zaloguj się do swojej konsoli Admin Console (sfederowana synchronizacja) jako administrator.

  2. Przejdź do sekcji: Ustawienia → Tożsamość

    Wybierz katalog, aby utworzyć nowego użytkownika.

    Domena aktywna

  3. Wybierz kartę Synchronizacja.

  4. Wybierz Przejdź do ustawień i kliknij Włącz edytowanie.

    Gdy opcja edycji jest włączona, Adobe Admin Console umożliwia modyfikowanie danych użytkowników tylko w ramach niej samej. Edycja nie obejmuje aktualizacji usługi IdP.

    Ustawienia katalogu — karta Synchronizacja

    Uwaga:

    Edycja pozostanie włączona tylko przez godzinę lub do momentu jej ręcznego wyłączenia.

    Konto techniczne

  5. Zaloguj się do konsoli Admin Console licencjonowania (w przypadku pracy z wieloma konsolami Admin Console).

  6. Przejdź do: Użytkownicy → Dodaj użytkownika.

  7. Skonfiguruj nowy identyfikator użytkownika przy użyciu następujących elementów:

    • Adres e-mail lub nazwa użytkownika: użyj adresu e-mail, na który chcesz otrzymywać wiadomości e-mail z odpowiedziami od odbiorców.
    • Typ identyfikatora: identyfikator sfederowany
    • Imię/nazwisko: ta wartość używana jest w systemie Acrobat Sign i jest odzwierciedlana w raporcie kontroli. Użyj wartości zapewniającej kontekst. np.: Kadry
    • Nazwa użytkownika SSO: użyj tej samej wartości adresu e-mail.
    • Kraj/region: wybierz odpowiedni kraj lub region dla firmy.
    • Wybierz produkt/profil Acrobat Sign, z którym jest powiązany identyfikator użytkownika technicznego.
    • Ustaw rolę użytkowników na Użytkownik.

    Na koniec kliknij przycisk Zapisz.

    Konto techniczne

  8. Zaloguj się ponownie do konsoli Admin Console sfederowanej synchronizacji, aby włączyć synchronizację danych IdP.

  9. Wróć do sekcji Ustawienia → Tożsamość → {Katalog} → Synchronizacja → Przejdź do ustawień.

    Kliknij Wyłącz edytowanie, aby ponownie włączyć synchronizację danych z usługą IdP.

  10. Nowy identyfikator użytkownika zostanie automatycznie wygenerowany w systemie Acrobat Sign.

Udostępnij konto techniczne nowemu sfederowanemu identyfikatorowi użytkownika

Aby uzyskać dostęp do zawartości dla identyfikatora użytkownika, do którego można się zalogować, 

  1. Zaloguj się do usługi Acrobat Sign jako administrator konta.

  2. Przejdź do sekcji Użytkownicy w menu administratora.

  3. Kliknij raz nowego użytkownika, a następnie Edytuj szczegóły użytkownika.

  4. Wybierz Stan udostępniania w lewym menu.

    Upewnij się, że zaznaczono kartę Konto użytkownika udostępnione.

  5. Wybierz Udostępniono użytkownikowi u góry strony Stan udostępniania.

  6. Udostępnij nowe konto identyfikatora użytkownika kontu technicznemu

    1. Kliknij ikonę plusa w prawym górnym wierszu, aby otworzyć interfejs selektora.
    2. Kliknij ikonę trzech linii po prawej stronie pola wyszukiwania.
    3. Rozwiń grupę, w której znajduje się identyfikator użytkownika konta technicznego.
    4. Kliknij ikonę plusa obok identyfikatora użytkownika konta technicznego, aby go wybrać.
    5. Sprawdź Dodatkowe uprawnienie, aby umożliwić Wysyłanie.
    6. Kliknij przycisk Zapisz.
    Konto techniczne

Testowanie nowego konta technicznego

Aby sprawdzić, czy kod dostępu działa poprawnie:

  1. Wybierz metodę GET /users.

  2. W polu Autoryzacja:

    1. Wpisz słowo Bearer, po którym występuje spacja.
    2. Wklej Kod dostępu.
    3. Kliknij opcję Wypróbuj!
    Wypróbuj!

  3. Zostanie zwrócona treść odpowiedzi zawierająca listę użytkowników konta oraz Kod odpowiedzi 200:

    Treść odpowiedzi

Testowanie wysyłania umowy przy użyciu konta technicznego w imieniu nowego identyfikatora użytkownika za pośrednictwem interfejsu API

  1. Uzyskaj identyfikator transientDocumentId lub przygotuj plik za pomocą innej metody.

  2. W polu Autoryzacja:

    1. Wpisz słowo Bearer, po którym występuje spacja.
    2. Wklej token dostępu konta technicznego.
    3. W polu x-on-behalf-of-user, wprowadź adres e-mail nowego identyfikatora użytkownika.
    4. Wypełnij pozostałe elementy AgreementInfo za pomocą właściwości transientDocumentId, nazwy umowy, typu podpisu i stanu.
    5. Kliknij opcję Wypróbuj!
    Wypróbuj!

  3. Zaloguj się do usługi Acrobat Sign jako nowy identyfikator użytkownika i przejdź do karty Zarządzaj.

  4. Przeglądając dziennik kontroli umowy, można zauważyć, że umowa została wysłana przez konto techniczne w imieniu nowego identyfikatora użytkownika.

Przeglądanie zawartości wygenerowanej w imieniu nowego identyfikatora użytkownika za pośrednictwem interfejsu Acrobat Sign

Gdy konto techniczne utworzy umowę w imieniu sfederowanego identyfikatora użytkownika, umowa zostanie opublikowana na stronie Zarządzaj sfederowanego identyfikatora użytkownika.

Znajduje się ona na stronie Zarządzaj sfederowanego identyfikatora użytkownika, na której można wyświetlać umowę i nią zarządzać.

Umowa wysłana w imieniu użytkownika

Pomoc dostępna szybciej i łatwiej

Nowy użytkownik?