Brugerhåndbog Annuller

Opret tekniske konti for at sende aftaler via API

 

Adobe Acrobat Sign-håndbog

Nyheder

Kom godt i gang

Administrer

Send, underskriv og administrer aftaler

Avancerede aftalefunktioner og arbejdsforløb

Integrer med andre produkter

Acrobat Sign-udvikler

Support og fejlfinding

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

Bemærk:

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:

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:

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

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

Bemærk:

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

    Bemærk:

    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. Vælg metoden GET /brugere.

  2. I feltet Autorisation:

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

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

    Svarbrødtekst

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

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

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

Få hjælp hurtigere og nemmere

Ny bruger?