Användarhandbok Avbryt

Skapa tekniska konton för att skicka avtal via API

 

Användarhandbok för Adobe Acrobat Sign

Nyheter

Kom igång

Administrera

Skicka, signera och hantera avtal

Avancerade avtalsfunktioner och arbetsflöden

Integrera med andra produkter

Adobe Sign-utvecklare

Support och felsökning

Tekniska konton hos Adobe Acrobat Sign

Tekniska konton hos Acrobat Sign är ett verktyg för att aktivera konton på storföretagsnivå som kan köra sina program under behörigheten för ett användar-ID som uttryckligen har genererats för det ändamålet (till skillnad från administratörens personliga användar-ID).

Tekniska konton är tillgängliga för storföretagskunder (via Adobe Developers Console) med inköpsplanen ETLA som hanterar deras konton via Adobe Admin Console.

Produktkortet för teknisk kontoåtkomst finns på fliken Produkter i Admin Console under erbjudandenamnet Adobe Acrobat Sign Solutions – storföretag (Leta efter flaggan Tillgängligt API):

Produktkort för tekniskt konto

Obs!

Processen nedan beskriver användningen av Tekniska konton via en API-lösning. Organisationer som vill att användare ska kunna skicka avtal manuellt på uppdrag av en centraliserad parts räkning hänvisas till Dokumentet för att upprätta tekniska konton genom manuell anslutning.

Förutsättningar

För att kunna aktivera ett tekniskt konto måste ditt Acrobat Sign-konto:

  • Ha tjänsten ETLA på storföretagsnivå
  • Hantera användare i Adobe Admin Console*
  • Ha Avancerad kontodelning aktiverad

* En anteckning i Adobe Admin Console

Adobe Admin Console tillhandahåller ett ramverk för användarhantering och licenstilldelning. De flesta kunder har endast en Admin Console.

Vissa kunder med komplexa användar-/licensieringskrav kan dock ha flera stycken Admin Console, vilket kan bli förvirrande i processer som att skapa tekniska konton, där en Admin Console kan styra den federerade användarhanteringen, och ett annat hanterar Acrobat Sign-licensieringen.

Om du vet att du har flera konton eller är osäker läser du följande:

Översikt

Att skapa ett tekniskt konto är en flerstegsprocess som kräver administratörsåtkomst på administratörsnivå till Adobe Acrobat Console och administratörsbehörighet på kontonivå i Acrobat Sign.

Processen kräver att administratören:

  1. Aktivera administratörs- eller utvecklaråtkomst för användaren som skapar det tekniska kontot.
    • Användaren måste vara administratör eller utvecklare för att konfigurera inställningarna som skapar det tekniska kontot.
  2. Skapa ett nytt projekt i Adobe Developer Console (Adobe.io).
    • Projektet är den miljö som krävs för att lagra nyckelparet offentlig/privat nyckel och åtkomsttoken som möjliggör det tekniska kontots funktionalitet.
  3. Skapa eller ladda upp ett offentligt/privat nyckelpar och skapa en åtkomsttoken.
    • När åtkomsttoken genereras skapas det tekniska kontots användar-ID i Adobe Admin Console och det fylls i i Acrobat Sign-systemet.
  4. (Valfritt) Skapa en ny grupp i Acrobat Sign-systemet.
    • Om du skapar en dedikerad grupp för det tekniska kontots användar-ID blir konfigurationen av avtalsegenskaperna mycket snäv, och den kan vara för strikt eller skilja sig från andra gruppkonfigurationer.
  5. Ge det tekniska kontots användar-ID behörighet i Acrobat Sign som administratör på gruppnivå.
  6. Skapa en ny federerad användare i Adobe Admin Console.
    • Detta skapar en e-postadress för användare med din domän som proxy för det tekniska kontots användar-ID när du skickar, och ger en e-postadress som är korrekt tillskriven ditt företag.
  7. Dela den federerade användarens konto med det tekniska kontot.
    • Användar-ID:t för det tekniska kontot skapas i Admin Console för licensiering med en e-postadress hos adobe.com. Genom att dela den federerade användarens konto ger du åtkomst till det tekniska kontots användar-ID som ska skickas på uppdrag av det federerade användar-ID:t, och ger därigenom mottagarna ett mer användarvänligt namn/e-postadress.

    När det är klart kan API:et konfigureras för att använda det tekniska kontot (via åtkomstkod) för att skapa och skicka avtal på uppdrag av en centraliserad användares räkning.

Ge användarna tillgång till utvecklarkonsolen

Innan du kan lägga till ett nytt tekniskt konto måste användaren först läggas till i produktprofilen Adobe Acrobat Sign Solutions – storföretag (i din Admin Console för licensiering) som Administratör eller Utvecklare.

  1. Klicka på länken Adobe Acrobat Sign Solutions – storföretag i den vänstra listen eller produkterna.

  2. Markera standardproduktprofilen för tjänsten Acrobat Sign.

    Klicka på produktprofilen

  3. Sidan Lägg till användare i den här produkten öppnas:

    • Klicka antingen på fliken Administratör eller Utvecklare.
  4. Ange e-postadressen till den användare som du vill ge åtkomst till.

  5. Klicka på Lägg till administratör/utvecklare.

    Lägg till utvecklare

  6. Ange e-postadressen till den användare som du vill ge åtkomst till.

  7. Ange för- och efternamn.

  8. Spara när du är klar.

    Ange utvecklarinformation

Skapa ett nytt projekt på konsolen Adobe.io

  1. Gå till https://console.adobe.io

    • Om du tillhör flera Admin Console-instanser kontrollerar du att du är ansluten till den instans som är justerad mot din Admin Console för licensiering genom att klicka på nedåtpilen i fönstrets övre högra hörn.
    Admin Console-instanser

  2. Klicka på Skapa nytt projekt.

    Skapa ett nytt projekt

  3. Det nya projektet visas på fliken Projekt på konsolen.

    Namnge projektet genom att klicka på knappen Redigera projekt.

    • Ange ett namn som dina medarbetare förstår
    • Ge en kort beskrivning
    • Spara ändringarna
    Redigera projektet

  4. Klicka på det nya projektet (på fliken Projekt) för att öppna det för konfiguration.

    På sidan Kom igång :

    1. Klicka på Lägg till i projekt
    2. Klicka på API i listrutan
    Lägg till API

  5. På sidan Lägg till ett API:

    1. Klicka på filtret Document Cloud
    2. Klicka på Acrobat Sign
    3. Klicka på Nästa
    Klicka på Acrobat Sign

Skapa en ny JSON-webbtoken

Du kan skapa ett nytt par med offentliga/privata nycklar eller ladda upp den offentliga nyckeln. Klicka på det alternativet som bäst passar dina behov:

Klicka på produktprofilen

Sidan Konfigurera API uppdateras för att visa de produktprofiler som är tillgängliga för ditt konto. Du kan ha en eller flera beroende på vilka profiler som är tillgängliga för ditt konto.

  1. Markera kryssrutan för Standard Adobe Acrobat Sign Solutions – storföretag.
  2. Spara konfigurerat API när du är klar.
Spara konfigurerat API

Skapa en åtkomsttoken

När du har sparat det tekniska kontot skapas det och du återgår till projektets startsida.

I avsnittet Skapa åtkomsttoken finns ett inmatningsfält för den privata nyckeln. 

  1. Klistra in den privata nyckel som du skapade/laddade upp tidigare i fältet Privat nyckel.

  2. Klicka på Skapa token.

  3. Efter ett ögonblick uppdateras fältet Privat nyckel för att visa Åtkomsttoken.

  4. Kopiera och spara åtkomsttoken.

    Skapa åtkomsttoken

  5. Längre ner på samma sida har du tillgång till:

    • Klient-ID
    • Klienthemlighet
    • ID för tekniskt konto
    • E-postadressen till det tekniska kontot
    • Organisations-ID

    Kopiera och spara e-postadressen till det tekniska kontot.

    Spara e-postadressen till det tekniska kontot

Överväg att skapa en unik grupp i Acrobat Sign för programmet

Acrobat Sign-grupper tillåter detaljerad konfiguration av säkerhets- och upplevelseinställningar för mottagaren (samt arbetsflöden, mallar, rapporter osv.)

Om du vill isolera det tekniska kontots användar-ID i sin egen grupp:

  1. Logga in på Acrobat Sign som administratör på kontonivå.

  2. Gå till fliken Grupper på administratörsmenyn.

  3. Klicka på plustecknet för att skapa en ny grupp.

  4. Ange ett intuitivt namn för gruppen (kanske samma namn som Projektet).

  5. Spara gruppen.

  6. (Valfritt) Öppna den nya gruppen och konfigurera de inställningar som behövs för programmet.

    Skapa en grupp

Obs!

Om din organisation

  • använder verktyget för användarsynkronisering (UST) för att automatiskt synkronisera användare mellan Adobe och Active Directory
  • inte tillåter att användare läggs till eller skapas manuellt i Acrobat Sign

du måste skapa en undantagsgrupp som blir den primära gruppen för alla användar-ID:n för tekniska konton.

Namnet på gruppen läggs till i UST-konfigurationen för att säkerställa att synkroniseringsprocessen inte påverkar användar-ID:na, vilket gör att de inaktiveras eller att deras rättigheter tas bort.

Ge det tekniska kontots användar-ID behörighet som gruppadministratör i Acrobat Sign

Vänta några minuter tills dess att den nyskapade användaren techacct.adobe.com skapas i Acrobat Sign-systemet.

  1. Logga in på ditt Acrobat Sign-konto som kontoadministratör.

  2. Gå till fliken Användare på administratörsmenyn.

  3. Sök efter den nya e-postadressen för techacct.adobe.com (kopieras från projektets startsida).

  4. Klicka på användaren och klicka på Redigera användarinformation.

    Redigera användarinformationen

  5. Klicka på plusikonen i avsnittet  Gruppmedlemskap och lägg till programmets grupp i användarens profil.

  6. Markera programgruppen och klicka på Markera som primär länk.

  7. Markera rutan för att flagga användar-ID:t som Gruppadministratör.

  8. (Valfritt) Ta bort det tekniska kontot från gruppen Standard.

  9. Klicka på Spara när du är klar.

    Spara användarinställningarna

Skapa en Svara till-användare/e-postadress

Det är problematiskt att skicka avtal med användar-ID:t/e-postadressen som är kopplad till det tekniska kontot på grund av att e-postadressen inte finns inom företagets domän.

Så här löser du problemet:

  • Ett nytt federerat användar-ID måste skapas i Admin Console för licensiering.
  • Det tekniska kontots användar-ID måste delas med det nya federerade användar-ID:et (via avancerad kontodelning).

När API-anropen har konfigurerats måste de konfigureras för att använda den tekniska kontotoken som värdet Auktorisering och användar-ID:t eller e-postadressen för det delade användar-ID:t som värdet x-på-uppdrag-av-användaren .

Skapa ett nytt federerat användar-ID

Innan du skapar det nya användar-ID:t måste du identifiera en e-postadress som kan användas för inkommande svar/frågor från mottagarna.

Så här skapar du ett nytt användar-ID:

  1. Logga in på (Federerad synkronisering) Admin Console som administratör.

  2. Gå till: Inställningar → Identitet

    Välj en katalog för att skapa den nya användaren.

    Primär domän

  3. Klicka på fliken Synkronisera .

  4. Klicka på Gå till Inställningar och klicka sedan på Aktivera redigering.

    När redigering är aktiverad tillåter din Adobe Admin Console endast redigering av användardata i Admin Console. Din IdP uppdateras inte med ändringarna.

    Kataloginställningar – fliken Synkronisera

    Obs!

    Redigering är endast aktiverad i en timme eller tills den inaktiveras manuellt.

    Tekniskt konto

  5. Logga in på Admin Console för licensiering (om du arbetar med flera stycken Admin Console).

  6. Gå till: Användare → Lägg till användare.

  7. Konfigurera det nya användar-ID:t med:

    • E-postadress eller användarnamn: använd den e-postadress du vill använda för att hämta svar på e-postmeddelanden från mottagarna.
    • ID-typ: Federated ID
    • För-/efternamn: detta värde används i Acrobat Sign-systemet och visas i granskningsrapporten. Använd ett värde som ger sammanhang. t.ex.: personalavdelning
    • SSO-användarnamn: använd samma e-postvärde.
    • Land/region: välj land eller region för ditt företag.
    • Markera den Acrobat Sign-produkt/profil som det tekniska användar-ID:t är associerat med.
    • Ställ in användarens roll till Användare.

    Klicka på Spara när det är klart.

    Tekniskt konto

  8. Logga in på den Federerade Admin Console för synkronisering igen för att aktivera synkronisering av dina IdP-data.

  9. Gå tillbaka till Inställningar → Identitet → {Directory} → Synkronisera → Gå till Inställningar.

    Klicka på Inaktivera redigering för att återaktivera synkronisering av data med din IdP.

  10. Ditt nya användar-ID skapas automatiskt i Acrobat Sign-systemet.

Dela det tekniska kontot med det nya federerade användar-ID:t

Om du vill få åtkomst till innehållet för ett användar-ID som du kan logga in på 

  1. Logga in på Acrobat Sign som en kontoadministratör.

  2. Gå till fliken Användare i administratörsmenyn.

  3. Klicka en gång på den nya användaren och Redigera användarinformationen.

  4. Klicka på Delningsstatus i menyn till vänster.

    Se till att fliken Användarens konto delas med är markerad.

  5. Klicka på fliken Delas med användare överst på sidan Delningsstatus.

  6. Dela det nya användar-ID:ts konto med det tekniska kontot

    1. Klicka på plusikonen i den övre högra raden för att öppna väljargränssnittet.
    2. Klicka på ikonen med tre rader till höger om sökrutan.
    3. Expandera gruppen där det tekniska kontots användar-ID finns.
    4. Klicka på plusikonen bredvid det tekniska kontots användar-ID för att markera det.
    5. Markera kryssrutan Ytterligare behörighet för att tillåta Sändning.
    6. Klicka på Spara.
    Tekniskt konto

Testa ditt nya tekniska konto

Så här testar du att åtkomstkoden fungerar korrekt:

  1. Klicka på metoden GET/användare.

  2. I fältet Auktorisering:

    1. Skriv ordet Innehavare följt av ett mellanslag
    2. Klistra in i Åtkomstkoden
    3. Klicka på Prova!
    Prova!

  3. Svarstexten kommer tillbaka med en lista över användarna på kontot och en Svarskod200:

    Svarstext

Testa att skicka ett avtal med det tekniska kontot på uppdrag av det nya användar-ID:t via API

  1. Hämta ett transientDocumentId eller använd en annan metod för att bifoga en fil.

  2. I fältet Auktorisering:

    1. Skriv ordet Innehavare följt av ett mellanslag
    2. Klistra in i det tekniska kontots Åtkomsttoken
    3. I fältet x-på-uppdrag-av-användaren anger du e-postadressen för det nya användar-ID:t
    4. Slutför resten av AgreementInfo med transientDocumentId, avtalets namn, signaturtypen och tillståndet.
    5. Klicka på Prova!
    Prova!

  3. Logga in på Acrobat Sign som det nya användar-ID:t och gå till fliken Hantera .

  4. När du granskar granskningsloggen för avtalet ser du att avtalet skickades av det tekniska kontot på uppdrag av det nya användar-ID:t.

Granska innehåll som har skapats på uppdrag av det nya användar-ID:t via Acrobat Sign-gränssnittet

När det tekniska kontot skapar ett avtal på uppdrag av det federerade ID:t publiceras avtalet på sidan Hantera hos det federerade användar-ID:t.

Det är på sidan Hantera hos de federerade användar-ID:n som du kan visa och hantera avtalet.

Avtal som skickas på uppdrag av användaren

Få hjälp snabbare och enklare

Ny användare?