Adobe Acrobat Sign

Adobe Acrobat Sign Hjælp

Åbn i Web
Adobe Hjælpecenter
Hjælp til Adobe Acrobat Sign
Adobe Hjælpecenter
Hjælp til Adobe Acrobat Sign

Opret tekniske konti for at sende aftaler via API

Sidst opdateret den 1. dec. 2023

Adobe Acrobat Sign tekniske konti

Acrobat Sign tekniske konti er et værktøj til at aktivere konti på virksomhedsniveau med mulighed for at køre deres programmer under autoritet af et bruger-id, der udtrykkeligt er genereret til dette formål (vs. ved hjælp af administratorens personlige bruger-id).

Tekniske konti er tilgængelige for erhvervskunder (via Adobe Developers Console) på ETLA-købsplanen, der administrerer deres konto via Adobe Admin Console.

Produktkortet til teknisk kontoadgang kan findes på fanen Produkter i Admin Console under tilbudsnavnet Adobe Acrobat Sign Solutions – Enterprise (Se efter flaget API tilgængelig):

Produktkort for Tech-konto

Note

Nedenstående proces beskriver brugen af tekniske konti gennem en API-løsning. Organisationer, der ønsker at give brugerne mulighed for manuelt at sende aftaler på vegne af en centraliseret part, henviser til dokumentet til oprettelse af tekniske konti via manuel forbindelse.

Forudsætninger

For at aktivere en teknisk konto skal din Acrobat Sign-konto:

  • Have ETLA-tjeneste på virksomhedsniveau
  • Administrer brugere på Adobe Admin Console*
  • Have avanceret kontodeling aktiveret

* En bemærkning på Adobe Admin Console

Adobe Admin Console giver en ramme for brugeradministration og licensallokering. De fleste kunder har kun én Admin Console.

Nogle kunder med komplekse bruger-/licenskrav kan dog have flere Admin Consoles, hvilket kan blive forvirrende i en proces som oprettelse af en teknisk konto, hvor én Admin Console kan styre den fødererede brugeradministration, og en anden administrerer Acrobat Sign-licenserne.

Hvis du ved, at du har flere konti, eller hvis du ikke er sikker, skal du læse nedenstående:

Problemet med flere Admin Consoles er at sikre, at du er i den rigtige konsol til de handlinger, du prøver at udføre.

Sådan finder du ud af, om du har flere Admin Consoles:

1. Log ind på Admin Console.

2. Klik på organisationens navn i øverste højre hjørne af konsollen.

Hvis du har en rullemenu med flere organisationer, har du flere Admin Consoles.

Rullemenuen Admin Console-organisation

Hvis du kun har én Admin Console, foregår brugeroprettelse og licenseringsoperationer i den samme organisation, og du behøver ikke at bekymre dig om at skifte mellem konsoller.

Hvis du har flere administratorkonsoller, skal du bruge et øjeblik på at finde ud af, hvilken organisation der administrerer oprettelse af forbundne brugere, og som styrer tilvejebringelsen af Acrobat Sign-licensen.

Virksomheder med flere administratorkonsoller kan installere Acrobat Sign fra mere end én. Du skal identificere den korrekte Admin Console, hvor du vil oprette API-forbindelsen og den tekniske kontobruger.

Du bør inspicere hver organisation for at afgøre, hvilken der skal indeholde den tekniske konto.

  1. Vælg organisationen.
  2. Vælg Produkter fra den øverste skinne af muligheder.
  3. Kig efter Adobe Sign – Enterprise -produktkortet med det tilgængelige API-flag.

I forbindelse med dette dokument kalder vi det for din licens Admin Console. Her er organisationen, hvor:

  • Du definerer den administrator- eller udviklerbruger, der skal forbinde API'en.
  • Din tekniske kontobruger oprettes og administreres.
Produktkort for Tech-konto

Organisationer, der bruger fødereret brugeradministration, skal de-synkronisere den fødererede løsning for at oprette en bruger uden for det fødererede miljø.

For at gøre dette skal du inspicere hver organisation for at finde ud af, hvilken der styrer de domæner, der aktiverer det fødererede tillidsforhold. Flere Admin Consoles kan have tillid til et domæne, men kun én kontrollerer det aktivt.

  1. Vælg organisationen
  2. Vælg Indstillinger fra den øverste skinne af indstillinger.
  3. Vælg Identitet fra venstre skinne af indstillinger.
  4. Hvis der er mapper på listen med typen som Federated ID og Status er betroet, skal du klikke på den række, som mappen er på, for at få vist ejerorganisationen.
Naviger til identitet

Ejerorganisationen er den korrekte Admin Console til at manipulere dine Federated ID-synkroniseringskontroller.

  • Der er en mail til konsoladministratoren, hvis du ikke har adgang i øjeblikket.

Hvis typen er Federated ID, og Status er Primær, skal du klikke på mappenavnet for at åbne mappeindstillingerne.

Aktivt domæne

Vælg fanen Synkroniser på siden Indstillinger, som åbner IDP-synkroniseringsoplysningerne.

I forbindelse med dette dokument vil vi kalde dette din Federated synkronisér Admin Console.

Mappeindstillinger – fanen synkronisér

Note

Hvis du ikke ser fanen synkronisér, har din konto muligvis en Global Admin Console, som du ikke har adgang til.

Du skal kontakte dine interne Adobe-administratorer for at få adgang.

Organisationer, der

  • bruger User Sync Tool (UST) til at synkronisere brugere automatisk mellem Adobe og deres Active Directory
  • tillader ikke, at brugere tilføjes eller oprettes manuelt i Acrobat Sign,

skal oprette en gruppe med "undtagelse" for alle Teknisk konto-bruger-id'er. Alle bruger-id'er til tekniske konti skal have deres primære gruppe defineret som undtagelsesgruppen for at sikre, at de ikke er deaktiveret og ikke får fjernet deres licens af den automatiske brugersynkronisering.

Undtagelsesgruppen skal konfigureres som undtaget fra synkroniseringen i UST-konfigurationen.

I de tilfælde, hvor Adobe hoster UST'en på vegne af kundens organisation, skal kundeadministratoren fortælle, hvad gruppenavnet er, til deres succesmanager, teknisk konto-manager eller kontorepræsentant, så de kan samarbejde med Adobe Customer Solutions-teamet om at sikre, at denne gruppe er undtaget fra synkroniseringen.

Oversigt

Oprettelse af en teknisk konto er en proces med flere trin, der kræver adgang på administratorniveau til Adobe Acrobat Console og administratormyndighed på kontoniveau til Acrobat Sign.

Processen kræver, at administratoren:

  1. Aktiver administrator- eller udvikleradgang for brugeren, der opretter den tekniske konto.
    • Brugeren skal være administrator eller udvikler for at kunne konfigurere de indstillinger, der opretter den tekniske konto.
  2. Opret et nyt projekt på Adobe Developer Console (Adobe.io).
    • Projektet er det nødvendige miljø til at holde offentligt/privat nøglepar og adgangstoken, der muliggør den tekniske kontos funktionalitet.
  3. Opret eller upload et offentligt/privat nøglepar og generer en adgangstoken.
    • Når du genererer adgangstokenen, oprettes det tekniske kontobruger-id i Adobe Admin Console, og det udfyldes i Acrobat Sign-systemet.
  4. (Valgfrit) Opret en ny gruppe i Acrobat Sign-systemet.
    • Oprettelse af en dedikeret gruppe til den tekniske kontos bruger-id giver mulighed for en meget stram konfiguration af aftaleegenskaberne, der kan være for strenge eller forskellige fra andre gruppekonfigurationer.
  5. Giv bruger-id'et for den tekniske konto i Acrobat Sign rettighed som administrator på gruppeniveau.
  6. Opret en ny Federated-bruger i Adobe Admin Console.
    • Dette opretter en bruger-mail med dit domæne som proxy for den tekniske kontos bruger-id, når det sendes, og resulterer i en mailadresse, der er korrekt tilskrevet til din virksomhed.
  7. Del Federated-brugerens konto med den tekniske konto.
    • Bruger-id'et for den tekniske konto genereres i Licensing Admin Console med en adobe.com-mailadresse. Ved at dele Federated-brugerens konto giver du det tekniske bruger-id adgang til at sende på vegne af Federated-bruger-id'et, og dermed får modtagerne adgang til et mere menneskevenligt navn/mail-adresse.

    Når det er gennemført, kan API'en konfigureres til at bruge den tekniske konto (via adgangskode) til at oprette og sende aftaler på vegne af en centraliseret bruger.

Gør det muligt for brugere at få adgang til udviklerkonsollen

Før du kan tilføje en ny teknisk konto, skal brugeren først føjes til produktprofilen Adobe Acrobat Sign Solutions – Enterprise (i dinLicensing Admin Consolel) som administrator eller udvikler.

  1. Klik på linket Adobe Acrobat Sign Solutions – Enterprise i venstre skinne eller produkter.

  2. Vælg standardproduktprofilen for Acrobat Sign-tjenesten.

    Vælg produktprofil

  3. Siden Tilføj brugere til dette produkt åbnes:

    • Vælg fanen Administrator eller fanen Udvikler.

  4. Angiv mailadressen for den bruger, du vil give adgang.

  5. Klik på Tilføj administrator/Udvikler.

    Tilføj udvikler

  6. Angiv mailadressen for den bruger, du vil give adgang.

  7. Indtast for- og efternavn.

  8. Gem, når du er færdig.

    Angiv udvikleroplysninger

Opret et nyt projekt på Adobe.io-konsollen

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

    • Hvis du tilhører flere Admin Console-forekomster, skal du sikre dig, at du har forbindelse til den forekomst, der stemmer overens med din Licensing Admin Console ved at klikke på pil ned i vinduets øverste højre hjørne.
    Admin Console-forekomster

  2. Vælg Opret nyt projekt.

    Opret et nyt projekt

  3. Det nye projekt vises på fanen Projekter på konsollen.

    Brug et øjeblik på at navngive dit projekt ved at klikke på knappen Rediger projekt.

    • Angiv et navn dine kollegaer vil forstå
    • Giv en kort beskrivelse
    • Gem redigeringerne
    Rediger projektet

  4. Vælg det nye projekt (under fanen Projekter) for at åbne det til konfiguration.

    På siden Kom i gang:

    1. Vælg Føj til projekt
    2. Vælg API fra rullemenuen
    Tilføj API

  5. På siden Tilføj en API:

    1. Vælg Document Cloud-filteret
    2. Vælg Acrobat Sign
    3. Klik på Næste.
    Vælg Acrobat Sign

Opret en ny JSON-webtoken

Du har mulighed for at generere et nyt offentligt/privat nøglepar eller uploade din offentlige nøgle. Vælg den løsning, der passer bedst til dine behov:

  1. Vælg Generér et nøglepar.

  2. Klik på Generér nøglepar.

    Generér nøglepar

  3. Når nøgleparret er oprettet, bliver du bedt om at gemme den private nøgle i dit lokale system.

    Den offentlige nøgle er tilgængelig til at kopiere fra grænsefladen:

    Offentlig nøgle

  4. Vælg Næste.

  1. Vælg Upload din offentlige nøgle.

  2. Træk dit offentlige nøglecertifikat til uploadfeltet.

  3. Vælg Næste.

    Upload din offentlige nøgle

    Din uploadede offentlige nøgle vises på siden Konfigurer API. Du kan kopiere det herfra.

    Du kan uploade yderligere nøgler eller generere nye nøgler efter behov.

  4. Vælg Næste, når alle dine nøgler er tilføjet.

Vælg produktprofilen

Siden Konfigurer API opdateres for at vise den/de produktprofil( er), der er tilgængelig for din konto. Du kan have en eller flere, afhængigt af de profiler, der er tilgængelige på din konto.

  1. Markér afkrydsningsfeltet for dine standardløsninger til Adobe Acrobat Sign – Enterprise.
  2. Gem konfigureret API , når du er klar.
Gem konfigureret API

Generer en adgangstoken

Når du har gemt, oprettes den tekniske konto, og du vender tilbage til projektets startside.

I afsnittet Generér adgangstoken er der et inputfelt til din private nøgle.

  1. Indsæt den private nøgle, du genererede/uploadede tidligere, i feltet Privat nøgle.

  2. Vælg Generer token.

  3. Efter et øjeblik opdateres feltet Privat nøgle for at få vist adgangstokenet.

  4. Kopier og gem adgangstoken.

    Generér adgangstokenet

  5. Længere nede på samme side har du adgang til:

    • Klient-id
    • Klient hemmelig
    • Teknisk konto-id
    • Teknisk konto-mail
    • Organisations-id

    Kopier og gem den tekniske kontos mail.

    Gem Teknisk konto-mailen

  1. Klon følgende lager: https://github.com/AdobeDocs/adobeio-auth/tree/stage/JWT/samples/adobe-jwt-java

  2. I filen config.properties skal du angive de tekniske kontooplysninger:

    • Apikey
    • Teknisk konto-id
    • Orgid
    • Hemmelig
    • expirationTime
    • metascopes
    • key_path
    • imshost
    • imsExchange 

  3. Opbevar secret.key i DER-format inde i målmappen. 

Overvej at oprette en unik gruppe i Acrobat Sign til programmet

Acrobat Sign-grupper giver mulighed for detaljeret konfiguration af modtagerens sikkerheds- og oplevelsesindstillinger (samt arbejdsgange, skabeloner, rapportering osv.)

Hvis du ønsker at isolere det tekniske konto bruger-id i deres egen gruppe:

  1. Log på Acrobat Sign som administrator på kontoniveau.

  2. Gå til fanen Grupper i administratormenuen.

  3. Klik på plusikonet for at oprette en ny gruppe.

  4. Angiv et intuitivt navn for gruppen (måske det samme navn som projektet).

  5. Gem gruppen.

  6. (Valgfrit) Åbn den nye gruppe, og konfigurer de nødvendige indstillinger for programmet.

    Opret en gruppe

Note

Hvis din organisation

  • bruger User Sync Tool (ust) til automatisk at synkronisere brugere mellem Adobe og din Active Directory
  • ikke tillader, at brugere tilføjes eller oprettes manuelt i Acrobat Sign

skal du oprette en undtagelsesgruppe, der skal være primær gruppe for alle bruger-id'er til tekniske konti.

Navnet på gruppen føjes til din UST-konfiguration for at sikre, at synkroniseringsprocessen ikke påvirker bruger-id'erne, hvilket kan deaktivere dem eller fjerne deres rettigheder fjernet.

Giv det tekniske konto-bruger-id rettighed som gruppeadministrator i Acrobat Sign

Det tager et par minutter for den nyoprettede techacct.adobe.com-bruger at blive genereret i Acrobat Sign-systemet.

  1. Log på din Acrobat Sign-konto som administrator på kontoniveau.

  2. Gå til fanen Brugere i administratormenuen.

  3. Søg efter den nye techacct.adobe.com-mailadresse (kopieret fra projektets startside).

  4. Klik på brugeren og vælg Rediger brugerdetaljer.

    Rediger brugerdetaljer

  5. Klik på plusikonet i afsnittet Gruppemedlemskab og tilføj programmets gruppe til brugerens profil.

  6. Vælg programmets gruppe, og klik på linket Markér som primær.

  7. Markér afkrydsningsfeltet for at markere bruger-id'et som Gruppeadministrator.

  8. (Valgfrit) Fjern den tekniske konto fra Standard-gruppen.

  9. Klik på Gem, når du er færdig.

    Gem brugerindstillingerne

Opret en Svar til-bruger/mail

Det er problematisk at sende aftaler ved hjælp af det bruger-id/den mail, der er knyttet til den tekniske konto, fordi mailen ikke er inden for dit virksomhedsdomæne.

Sådan løser du problemet:

  • Der skal oprettes et nyt fødereret bruger-id i Licensing Admin Console.
  • Det tekniske bruger-id skal deles med det nye fødererede bruger-id (via forudgående kontodeling).

Når API-opkaldene er konfigurerede, skal de konfigureres til at bruge den tekniske kontotoken som værdien Autorisering og bruger-id'et eller e-mailen for det delte bruger-id som x-på-vegne-af-bruger-værdien.

Opret et nyt fødereret bruger-id

Før du opretter det nye bruger-id, skal du identificere en mailadresse, der kan bruges til indgående svar/spørgsmål fra dine modtagere.

Sådan opretter du det nye bruger-id:

  1. Log på din (Federated Sync) Admin Console som administrator.

  2. Gå til Indstillinger → identitet

    Vælg en mappe for at oprette den nye bruger.

    Aktivt domæne

  3. Vælg fanen Synkronisér.

  4. Vælg Gå til Indstillinger, og klik på Aktivér redigering.

    Når redigering er aktiveret, tillader din Adobe Admin Console kun redigeringer af brugerdataene i Admin Console. Din IdP er ikke opdateret med redigeringerne.

    Mappeindstillinger – fanen synkronisér

    Note

    Redigering forbliver kun aktiveret i en time, eller indtil den deaktiveres manuelt.

    Teknisk konto

  5. Log på din Licensing Admin Console (hvis du arbejder med flere Admin Consoles).

  6. Gå til: Brugere → Tilføj bruger.

  7. Konfigurer dit nye bruger-id med:

    • Mail eller brugernavn: Brug den mailadresse, som du ønsker at indhente svar på fra dine modtagere.
    • Id-type: Fødereret ID
    • Fornavn/efternavn: Denne værdi bruges i Acrobat Sign-systemet og afspejles i revisionsrapporten. Brug en værdi, der giver kontekst. f.eks.: Human Resources
    • SSO-brugernavn: Brug den samme mailværdi.
    • Land/område: Vælg det land eller det område, der passer bedst til din virksomhed.
    • Vælg det Acrobat Sign-produkt/den Acrobat Sign-profil, som det tekniske bruger-id er knyttet til.
    • Indstil brugerrollen til Bruger.

    Klik på Gem, når du er færdig.

    Teknisk konto

  8. Log igen ind på Federated Sync Admin Console for at aktivere synkroniseringen af dine IdP-data.

  9. Gå tilbage til Indstillinger → Identitet → {Directory} → Synkronisér → Gå til Indstillinger.

    Klik på Deaktiver redigering for at genaktivere synkronisering af data med din IdP.

  10. Dit nye bruger-id genereres automatisk i Acrobat Sign-systemet.

Del den tekniske konto med det nye federated bruger-id

For at få adgang til indholdet for et bruger-id, kan du logge på 

  1. Log på Acrobat Sign som administrator på kontoniveau.

  2. Gå til fanen Brugere i administratormenuen.

  3. Klik på den nye bruger og Rediger brugerdetaljer.

  4. Vælg Delingsstatus i menuen til venstre.

    Sørg for, at fanen Brugers konto delt med er valgt.

  5. Vælg fanen Delt med bruger øverst på siden Delingsstatus.

  6. Del det nye bruger-id's konto med den tekniske konto

    1. Klik på plusikonet i øverste højre række for at åbne vælgergrænsefladen.
    2. Klik på ikonet med tre linjer til højre for søgefeltet.
    3. Udvid den gruppe, hvor bruger-id'et for den tekniske konto er placeret.
    4. Klik på plusikonet ved siden af den tekniske kontos bruger-id for at vælge det.
    5. Markér Ekstra tilladelse for at tillade Afsendelse.
    6. Klik på Gem.
    Teknisk konto

Test din nye tekniske konto

Sådan kontrollerer du, at din adgangskode fungerer korrekt:

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

  2. Vælg metoden GET /brugere.

  3. I feltet Autorisation:

    1. Indtast ordet Bearer efterfulgt af et mellemrum
    2. Indsæt adgangskoden
    3. Klik på Prøv det!
    Prøv det!

  4. Svarbrødteksten vender tilbage med en liste over brugerne i kontoen og en svarkode på 200:

    Svarbrødtekst

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

  2. Vælg metoden POST /users/{userId}/views.

  3. I feltet Autorisation:

    1. Indtast ordet Bearer efterfulgt af et mellemrum.
    2. Indsæt adgangskoden.

  4. I userId-feltet skal du indtaste mig.

  5. Klik på linket Færdiggør modelskema.

  6. Klik i det gule felt for at overføre skemaet til feltet UserViewInfo.

  7. Rediger feltet UserViewInfo:

    • Som værdien navnindtast ALLE,
    • autoLoginUser-værdien skal ændres til sand.

  8. Klik påPrøv det!

    Konfigurer API for adgangstoken

    Feltet for den returnerede Svartekst indeholder URL-adressen, der skal bruges til at logge på som bruger:

    Kopiér adgangs-URL'en

  9. Kopiér URL'en og indsæt den i en browser.

  10. Du bedes om at bekræfte login.

    Klik på Ja.

    Bekræft login.

Test afsendelse af en aftale ved hjælp af den tekniske konto på vegne af det nye bruger-id via API

  1. Hent et transientDocumentId eller vær klar med en anden metode til at vedhæfte en fil.

  2. Gå til API-metoderne: https://secure.na1.adobesign.com/public/docs/restapi/v6#!/agreements/createAgreement

  3. I feltet Autorisation:

    1. Indtast ordet Bearer efterfulgt af et mellemrum
    2. Indsæt den tekniske kontos adgangstoken
    3. Indsæt mailadressen for det nye bruger-id i x-på-vegne-af-bruger-feltet
    4. Udfyld resten af aftaleinformationen med transientDocumentId, navnet på aftalen, signaturtype og tilstand.
    5. Klik på Prøv det!
    Prøv det!

  4. Log på Acrobat Sign på som det nye bruger-id, og gå til fanen Administrer.

  5. Når du gennemgår aftalerevisionsloggen, vil du se, at aftalen blev sendt af den tekniske konto på vegne af det nye bruger-id.

Gennemgå det indhold, der genereres på vegne af det nye bruger-id, via Acrobat Sign-grænsefladen

Når den tekniske konto opretter en aftale på vegne af Federated bruger-id, offentliggøres aftalen på Federated bruger-id's Administrer-side.

Det er på Federated bruger-id'ets side Administrer, at du kan se og administrere aftalen.

Aftale sendt på vegne af brugeren

Adobe Sign-logo

Strømlin dit arbejde med Acrobat Sign
Administrer og underskriv dokumenter online hurtigt og nemt.

Åbn appen
Åbn appen

Foregående

Flyt en bruger fra en Admin Console-organisation til en anden

Næste

Opret tjenestekonti for at sende aftaler under en funktionel enhed

Lær

card-link-icon

Lær med trinvise videoselvstudier og praktisk vejledning direkte i appen.

Fællesskab

card-link-icon

Deltag i diskussioner, find svar, lær af eksperter, og del din viden.

Adobe-startside

card-link-icon

Få adgang til dine foretrukne Creative Cloud-apps, tjenester, filhåndtering m.m.