Adobe Acrobat Sign

Adobe Acrobat Sign Hjälp

Öppna i Web
Adobe Help Center
Hjälp för Adobe Acrobat Sign
Adobe Help Center
Hjälp för Adobe Acrobat Sign

Skapa tekniska konton för att skicka avtal via API

Senast uppdaterad den 1 dec. 2023

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:

Svårigheten med flera stycken Admin Console är att se till att du är i rätt konsol för de åtgärder du försöker utföra.

Så här avgör du om du har flera stycken Admin Console:

1. Logga in på Admin Console.

2. Klicka på organisationens namn i det övre högra hörnet av konsolen.

Om du har en listruta med flera organisationer har du flera stycken Admin Console.

Listruta med organisationer för Admin Console

Om du bara har en Admin Console, skapas och licensieras användare i samma organisation, och du behöver inte tänka på att växla mellan konsoler.

Om du har flera stycken Admin Console ska du ägna en stund åt att fastställa vilken organisation som hanterar skapandet av federerade användare och vilken som styr etableringen av Acrobat Sign-licenser.

Företag med flera stycken Admin Console kan driftsätta Acrobat Sign från mer än en. Du måste identifiera rätt Admin Console där du vill upprätta API-anslutningen och den tekniska kontoanvändaren.

Du bör inspektera varje organisation för att avgöra vilken som ska innehålla det tekniska kontot.

  1. Klicka på organisationen.
  2. Klicka på Produkter i den översta listen med alternativ.
  3. Leta efter produktkortet Adobe Sign – storföretag med flaggan Tillgängligt API .

I det här dokumentet kallar vi det din Admin Console för licensiering. Detta är den organisation där:

  • Du definierar den administratör eller utvecklaranvändare som ansluter API:t.
  • Din tekniska kontoanvändare skapas och hanteras.
Produktkort för tekniskt konto

Organisationer som använder federerad användarhantering måste ta bort synkroniseringen för den federerade lösningen för att skapa tjänstkontot utanför den federerade miljön.

För att göra detta måste du inspektera varje organisation för att hitta den som kontrollerar de domäner som aktiverar den federerade betrodda relationen. Flera stycken Admin Console kan lita på en domän, men endast en styr den aktivt.

  1. Klicka på organisationen
  2. Klicka på Inställningar i den översta listen med alternativ.
  3. Klicka på Identitet i den vänstra listen med alternativ.
  4. Om det finns kataloger där Typen listas som Federated ID och Statusen är Betrodd klickar du på raden där katalogen är placerad för att visa den ägande organisationen.
Gå till Identitet

Den Ägande organisation är rätt Admin Console för att hantera synkroniseringskontrollerna för ditt Federated ID.

  • Ett e-postmeddelande skickas till konsoladministratören om du för närvarande inte har åtkomst.

Om Typen är Federated ID och Statusen är Aktiv, klickar du på katalogens Namn för att öppna kataloginställningarna.

Primär domän

På inställningssidan klickar du på fliken Synkronisera , som öppnar information om IDP-synkronisering.

I det här dokumentet kallar vi det din Federerad Admin Console för synkronisering.  

Kataloginställningar – fliken Synkronisera

Obs!

Om du inte ser fliken Synkronisera kan kontot ha en Global Admin Console som du inte har åtkomst till.

Du måste kontakta de interna Adobe-administratörerna för att få åtkomst.

Organisationer som

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

måste skapa en undantagsgrupp för alla användar-ID:n för tekniska konton. Användar-ID:n för tekniska konton måste ha sin primära grupp definierad som den undantagna gruppen för att säkerställa att de inte inaktiveras och att deras licens inte tas bort vid automatisk användarsynkronisering.

Undantagsgruppen måste konfigureras som undantagen från synkronisering i UST-konfigurationen.

I de fall där Adobe är värd för UST på uppdrag av kundorganisationens räkning måste kundadministratören meddela Gruppnamnet till sin Success Manager, Technical Account Manager eller kontorepresentant så att de kan arbeta med Adobe Customer Solutions-teamet för att säkerställa att den här gruppen är undantagen från synkroniseringen.

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

  1. Klicka på Skapa ett nyckelpar.

  2. Klicka på Skapa nyckelpar.

    Skapa nyckelpar

  3. När nyckelparet har skapats uppmanas du att spara den privata nyckeln på det lokala systemet.

    Den offentliga nyckeln är tillgänglig för kopiering från gränssnittet:

    Offentlig nyckel

  4. Välj Nästa.

  1. Klicka på Ladda upp den offentliga nyckeln.

  2. Dra certifikatet för den offentliga nyckeln till uppladdningsfältet.

  3. Välj Nästa.

    Ladda upp den offentliga nyckeln

    Den uppladdade offentliga nyckeln visas på sidan Konfigurera API. Du kan kopiera den härifrån.

    Du kan ladda upp ytterligare nycklar eller skapa nya nycklar efter behov.

  4. Klicka på Nästa när alla nycklarna har lagts till.

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

  1. Klona följande rapport: https://github.com/AdobeDocs/adobeio-auth/tree/stage/JWT/samples/adobe-jwt-java

  2. Ange den tekniska kontoinformationen i filen config.properties:

    • Apikey
    • Technicalaccountid
    • Orgid
    • Hemlighet
    • expirationTime
    • metascopes
    • key_path
    • imshost
    • imsExchange 

  3. Lagra filen secrets.key i formatet DER i målmappen. 

Ö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. Gå till API-metoderna: https://secure.na1.adobesign.com/public/docs/restapi/v6

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

  3. I fältet Auktorisering:

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

  4. Svarstexten kommer tillbaka med en lista över användarna på kontot och en Svarskodpå 200:

    Svarstext

  1. Gå till API-metoderna: https://secure.na1.adobesign.com/public/docs/restapi/v6

  2. Klicka på metoden POST /users/{userId}/views.

  3. I fältet Auktorisering:

    1. Skriv ordet Innehavare följt av ett mellanslag.
    2. Klistra in i Åtkomstkoden.

  4. I fältet användar-ID anger du mig.

  5. Klicka på länken Fullständigt modellschema.

  6. Klicka i det gula fältet för att överföra schemat till fältet UserViewInfo.

  7. Redigera fältet UserViewInfo:

    • För värdet namn anger du ALLA.
    • För värdet autoLoginUser ändrar du det till sant.

  8. Klicka på Prova!

    Konfigurera API för åtkomsttoken

    Det returnerade fältet Svarstext innehåller den URL som behövs för att logga in som användare:

    Kopiera åtkomst-URL:en

  9. Kopiera URL:en och klistra in den i en webbläsare.

  10. Du uppmanas att bekräfta inloggningen.

    Klicka på Ja.

    Bekräfta inloggningen.

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. Gå till API-metoderna: https://secure.na1.adobesign.com/public/docs/restapi/v6#!/agreements/createAgreement

  3. 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!

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

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

Adobe Sign-logotypen

Effektivisera ditt arbete med Acrobat Sign
Hantera och signera dokument online snabbt och enkelt.

Öppna appen
Öppna programmet

Föregående

Flytta en användare från en Admin Console-organisation till en annan

Nästa

Skapa tjänstkonton för att skicka avtal under en funktionell enhet

Läs mer

card-link-icon

Lär dig med detaljerade videohandledningar och praktiska råd direkt i appen.

Användarforum

card-link-icon

Delta i diskussioner, hitta svar, lär dig av experter och dela med dig av dina kunskaper.

Adobe-startsidan

card-link-icon

Få tillgång till dina Creative Cloud-favoritprogram, tjänster, filhantering med mera.