Adobe Acrobat Sign

Adobe Acrobat Sign Hjelp

Åpne i Web
Adobe Hjelpesenter
Hjelp for Adobe Acrobat Sign
Adobe Hjelpesenter
Hjelp for Adobe Acrobat Sign

Opprett tekniske konti for å sende avtaler via API

Sist oppdatert 1. des. 2023

Tekniske Adobe Acrobat Sign-kontoer

Tekniske Acrobat Sign-kontoer er en løsning for å gi kontoer på bedriftsnivå mulighet til å kjøre programmer sine under autoriteten til en bruker-ID som er eksplisitt generert for dette formålet (i motsetning til å bruke administratorens personlige bruker-ID).

Tekniske kontoer er tilgjengelige for bedriftskunder (via Adobe Developers Console) I ETLA-kjøpsplanen som administrerer kontoen via Adobe Admin Console.

Produktkortet for teknisk kontotilgang finnes på fanen med Produkter i Admin Console under tilbudsnavnet Adobe Acrobat Sign-løsninger – Enterprise (Se etter flagget med tilgjengelig API):

Produktkort for teknisk konto

Notat

Prosessen nedenfor beskriver bruken av tekniske kontoer gjennom en API-løsning. Organisasjoner som ønsker å gjøre det mulig for brukere å sende avtaler manuelt på vegne av en sentralisert part, henviser til dokumentet for å sette opp tekniske kontoer gjennom manuell tilkobling.

Forutsetninger

Hvis du vil aktivere en teknisk konto, må Acrobat Sign-kontoen:

  • Ha ETLA-tjeneste på Enterprise-nivå
  • Administrere brukere i Adobe Admin Console*
  • Ha avansert kontodeling aktivert

* Merknad om Adobe Admin Console

Adobe Admin Console gir et rammeverk for brukeradministrasjon og lisensallokering. De fleste kunder har bare én Admin Console.

Noen kunder med komplekse krav til bruker-/lisensiering kan imidlertid ha flere administratorkonsoller, noe som kan bli forvirrende i en prosess som opprettelse av tekniske kontoer, der én administratorkonsoll kan styre den føderale brukeradministrasjonen, og en annen administrerer Acrobat Sign-lisensiering.

Hvis du vet at du har flere kontoer eller ikke er sikker, kan du lese følgende:

Problemet med flere Admin-konsoller er å sikre at du er i riktig konsoll for handlingene du prøver å utføre.

Slik finner du ut om du har flere administratorkonsoller:

1. Logg på Admin Console.

2. Klikk på organisasjonens navn øverst til høyre i konsollen.

Hvis du har en rullegardinmeny med flere organisasjoner, har du flere Admin Console.

Rullegardinmeny for Admin Console-organisasjon

Hvis du bare har én Admin Console, opprettes og lisensieres operasjoner i samme organisasjon. Du trenger ikke å bekymre deg for å bytte mellom konsoller.

Hvis du har flere Admin Console, kan du bruke litt tid på å finne ut hvilken organisasjon som administrerer opprettelse av fødererte brukere, og hvilken som styrer klargjøringen av Acrobat Sign-lisensene.

Bedrifter med flere Admin Console kan distribuere Acrobat Sign fra mer enn én. Du må identifisere riktig Admin Console der du vil opprette API-tilkoblingen og den tekniske kontobrukeren.

Du bør inspisere hver organisasjon for å finne ut hvilken som skal inneholde den tekniske kontoen.

  1. Velg organisasjon.
  2. Velg Produkter fra den øverste listen over alternativer.
  3. Se etter Adobe Sign – Enterprise-produktkortet med tilgjengelig API-flagg.

I forbindelse med dette dokumentet kaller vi dette din din lisensgivende Admin Console. Dette er organisasjonen hvor:

  • Du definerer administratoren eller utvikleren som skal koble til API-en.
  • Brukeren av den tekniske kontoen din opprettes og administreres.
Produktkort for teknisk konto

Organisasjoner som bruker føderert brukeradministrasjon, må desynkronisere den fødererte løsningen for å opprette en bruker utenfor det fødererte miljøet.

Du må inspisere hver organisasjon for å finne ut hvilken som kontrollerer domenene som aktiverer det føderale tillitsforholdet. Flere administratorkonsoller kan klarere et domene, men bare én kontrollerer det aktivt.

  1. Velg organisasjonen
  2. Velg Innstillinger fra den øverste skinnen med alternativer.
  3. Velg Identitet fra venstre skinne med alternativer.
  4. Hvis det er kataloger som er oppført med typen Federated ID og status er klarert, klikker du raden som katalogen er på for å eksponere eierorganisasjonen.
Gå til identitet

Eierorganisasjonen er den riktige Admin Console til å manipulere dine Federated ID-synkroniseringskontroller.

  • En e-post er oppgitt for konsolladministratoren hvis du ikke har tilgang for øyeblikket.

Hvis typen er Federated ID og statusen er aktiv, klikker du PÅ navnet på katalogen for å åpne kataloginnstillingene.

Aktivt domene

På innstillingssiden velger du fanen med Synkronisering, som åpner IDP-synkroniseringsinformasjonen.

I forbindelse med dette dokumentet vil vi kalle dette din Federated Sync Admin Console.  

Kataloginnstillinger – synkroniseringsfane

Notat

Hvis du ikke ser en synkroniseringsfane, kan det hende at kontoen har en global administratorkonsoll som du ikke har tilgang til.

Du må kontakte idin interne Adobe-administratorer for å få tilgang.

Organisasjoner som

  • bruker User Sync Tool (UST) til å synkronisere brukere automatisk mellom Adobe og deres Active Directory
  • ikke tillat at brukere legges til eller opprettes manuelt i Acrobat Sign  

må opprette en «unntak»-gruppe for alle bruker-ID-er for tekniske kontoer. Alle bruker-ID-er for tekniske kontoer må ha sin primære gruppe definert som den unntatte gruppen for å sikre at de ikke er deaktivert og ikke har lisensen fjernet av den automatiske brukersynkroniseringen.

Unntaksgruppen må konfigureres som unntatt fra synkroniseringen i UST-konfigurasjonen.

I tilfeller der Adobe er vert for UST på vegne av kundens organisasjon, må kundeadministratoren kommunisere gruppenavnet til suksessansvarlig, teknisk kontoadministrator eller kontorepresentant, slik at de kan samarbeide med Adobe Customer Solutions-teamet for å sikre at denne gruppen er unntatt fra synkroniseringen.

Oversikt

Oppretting av en teknisk konto er en flertrinnsprosess som krever tilgang på administratornivå til Adobe Acrobat Console og administratormyndighet på kontonivå i Acrobat Sign.

Prosessen krever at administrator:

  1. Aktiverer administrator- eller utviklertilgang for brukeren som oppretter den tekniske kontoen.
    • Brukeren må være administrator eller utvikler for å konfigurere innstillingene som oppretter den tekniske kontoen.
  2. Oppretter et nytt prosjekt på Adobe Developer Console (Adobe.io).
    • Prosjektet er det nødvendige miljøet for å holde det offentlige/private nøkkelparet og tilgangstokenet som muliggjør funksjonaliteten til den tekniske kontoen.
  3. Oppretter eller laster opp et offentlig/privat nøkkelpar og generer et tilgangstoken.
    • Når du genererer tilgangstokenet, opprettes bruker-ID-en for den tekniske kontoen i Adobe Admin Console, og den fylles ut i Acrobat Sign-systemet.
  4. (Valgfritt) Oppretter en ny gruppe i Acrobat Sign-systemet.
    • Opprettelse av en dedikert gruppe for bruker-ID-en for den tekniske kontoen tillater en svært stram konfigurasjon av avtaleegenskapene som kan være for streng eller forskjellig fra andre gruppekonfigurasjoner.
  5. Legge til bruker-ID for den tekniske kontoen i Acrobat Sign som administrator på gruppenivå.
  6. Opprett en ny Federated-bruker i Adobe Admin Console.
    • Dette oppretter en bruker-e-post med domenet ditt til proxy for den tekniske kontoens bruker-ID når du sender, og gir en e-postadresse som er riktig tilskrevet firmaet ditt.
  7. Del Federated-brukerens konto med den tekniske kontoen.
    • Bruker-ID-en for den tekniske kontoen genereres i den lisensgivende Admin Console med en e-postadresse for adobe.com. Ved å dele Federated-brukerens konto, gir du tilgang til den tekniske kontoens bruker-ID for å sende på vegne av Federated-bruker-ID, og gir dermed et mer menneskevennlig navn/e-postadresse til mottakerne.

    Når det er fullført, kan API-en konfigureres til å bruke den tekniske kontoen (via tilgangskode) til å opprette og sende avtaler på vegne av en sentralisert bruker.

Gjør det mulig for brukere å få tilgang til utviklerkonsollen

Før du kan legge til en ny teknisk konto, må brukeren først legges til i produktprofilen for Adobe Acrobat Sign Solutions – Enterprise (i lisensadministrasjonskonsollen) som administrator eller utvikler.

  1. Klikk på koblingen med Adobe Acrobat Sign Solutions – Enterprise i venstre skinne eller i produktene.

  2. Velg standardproduktprofilen for Acrobat Sign-tjenesten.

    Velg produktprofil

  3. Legg til brukere på denne produktsiden åpnes:

    • Velg enten fanen med Admin eller Utvikler.

  4. Oppgi e-postadressen til brukeren du vil gi tilgang.

  5. Klikk på Legg til administrator/utvikler.

    Legg til utvikler

  6. Oppgi e-postadressen til brukeren du vil gi tilgang.

  7. Skriv inn for- og etternavn.

  8. Lagre når du er ferdig.

    Angi utviklerinformasjon

Opprett et nytt prosjekt på Adobe.io-konsollen

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

    • Hvis du tilhører flere Admin Console-forekomster, må du kontrollere at du er koblet til forekomsten som justeres med lisensieringsadminkonsollen, ved å klikke på nedpilen øverst til høyre i vinduet.
    Admin Console-forekomster

  2. Velg Opprett nytt prosjekt.

    Opprett et nytt prosjekt

  3. Det nye prosjektet vises på fanen med Prosjekter i konsollen.

    Bruk et øyeblikk på å navngi prosjektet ved å klikke på Rediger prosjekt-knappen.

    • Gi et navn medarbeiderne dine forstår
    • Gi en kort beskrivelse
    • Lagre redigeringene
    Rediger prosjektet

  4. Velg det nye prosjektet (i fanen med Prosjekter) for å åpne det for konfigurasjon.

    På siden med Kom i gang:

    1. Velg Legg til i prosjekt
    2. Velg API fra nedtrekksmenyen
    Legg til API

  5. På siden med Legg til et API:

    1. Velg Document Cloud-filteret
    2. Velg Acrobat Sign
    3. Klikk på Neste.
    Velg Acrobat Sign

Opprett en ny JSON Web Token

Du har muligheten til å generere et nytt offentlig/privat nøkkelpar eller laste opp din offentlige nøkkel. Velg det alternativet som passer best for dine behov:

  1. Velg Generer et nøkkelpar.

  2. Klikk på Generer nøkkelpar.

    Generer nøkkelpar

  3. Når nøkkelparet er opprettet, blir du bedt om å lagre den private nøkkelen i det lokale systemet.

    Den offentlige nøkkelen er tilgjengelig for kopiering fra grensesnittet:

    Offentlig nøkkel

  4. Velg Neste.

  1. Velg Last opp offentlig nøkkel.

  2. Dra det offentlige nøkkelsertifikatet til opplastingsfeltet.

  3. Velg Neste.

    Last opp offentlig nøkkel

    Din opplastede offentlige nøkkel vises på siden med Konfigurer API. Du kan kopiere det herfra.

    Du kan laste opp flere nøkler, eller generere nye nøkler etter behov.

  4. Velg Neste når alle nøklene dine er lagt til.

Velg produktprofil

Siden med Konfigurer API oppdateres for å vise produktprofilen(e) som er tilgjengelig for kontoen din. Du kan ha én eller flere, avhengig av profilene som er tilgjengelige for kontoen din.

  1. Velg avmerkingsboksen for standard Adobe Acrobat Sign Solutions – Enterprise.
  2. Lagre konfigurert API når du er klar.
Lagre konfigurert API

Generer en tilgangstoken

Når den er lagret opprettes den tekniske kontoen, og du returneres til prosjektets hjemmeside.

I delen med Generer tilgangstoken er det et inndatafelt for den private nøkkelen. 

  1. Lim inn den private nøkkelen du genererte/lastet opp tidligere i feltet med Privat nøkkel.

  2. Velg generer token.

  3. Etter et øyeblikk oppdateres feltet med Privat nøkkel for å vise tilgangstokenet.

  4. Kopier og lagre tilgangstokenet.

    Generer tilgangstokenet

  5. Lenger ned på samme side har du tilgang til:

    • Klient-ID
    • Klienthemmelighet
    • Teknisk konto-ID
    • E-post for teknisk konto
    • Organisasjons-ID

    Kopier og lagre e-postadressen for den tekniske kontoen.

    Lagre e-posten for teknisk konto

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

  2. I filen config.properties angir du den tekniske kontoinformasjonen:

    • Apikey
    • Tekniskkontoid
    • Orgid
    • Hemmelighet
    • utløpsTid
    • metaomfang
    • key_path
    • imshost
    • imsExchange 

  3. Lagre secret.key i DER-format i målmappen.

Vurder å generere en unik gruppe i Acrobat Sign for programmet

Acrobat Sign-grupper gir mulighet for detaljert konfigurasjon av sikkerhets- og opplevelsesinnstillingene for mottakeren (samt arbeidsflyter, maler, rapportering osv.)

Hvis du vil isolere den tekniske kontoens bruker-ID i sin egen gruppe:

  1. Logg på Acrobat Sign som kontoadministrator.

  2. Gå til fanen med Grupper i administratormenyen.

  3. Klikk på pluss-ikonet for å opprette en ny gruppe

  4. Skriv inn et intuitivt navn for gruppen (kanskje det samme navnet som prosjektet).

  5. Lagre gruppen.

  6. (Valgfritt) Åpne den nye gruppen og konfigurer innstillingene som trengs for programmet.

    Opprette en gruppe

Notat

Hvis organisasjonen din er

  • ved hjelp av User Sync Tool (UST) for å automatisk synkronisere brukere mellom Adobe og Active Directory
  • ikke tillate at brukere legges til eller opprettes manuelt i Acrobat Sign

du må opprette en unntaksgruppe som primærgruppe for alle bruker-ID-er for tekniske kontoer.

Navnet på gruppen legges til i UST-konfigurasjonen for å sikre at synkroniseringsprosessen ikke påvirker bruker-ID-ene, slik at de blir deaktivert eller får rettighetene fjernet.

Rettigheter for bruker-ID-en for den tekniske kontoen som gruppeadministrator i Acrobat Sign

Vent et par minutter for den nyopprettede techacct.adobe.com-brukeren å bli generert i Acrobat Sign-systemet.

  1. Logg på Acrobat Sign-kontoen som kontonivåadministrator.

  2. Gå til fanen med Brukere i administratormenyen.

  3. Søk etter den nye techacct.adobe.com e-postadressen (kopiert fra prosjektets hjemmeside).

  4. Klikk på brukeren, og velg Rediger brukerdetaljer.

    Rediger brukerdetaljer

  5. Klikk på pluss-ikonet i delen med Gruppemedlemskap og legg til programmets gruppe i brukerens profil.

  6. Velg programmets gruppe, og klikker du på koblingen Merk som primær.

  7. Merk av i boksen for å flagge bruker-ID-en som gruppeadministrator.

  8. (Valgfritt) Fjern den tekniske kontoen fra standardgruppen.

  9. Klikk på Lagre når du er ferdig.

    Lagre profilinnstillingene

Opprett en svar-til bruker/e-post

Sending av avtaler ved hjelp av bruker-ID/e-post knyttet til den tekniske kontoen er problematisk på grunn av at e-posten ikke er innenfor bedriftsdomenet ditt.

For å løse dette problemet:

  • Det må opprettes en ny føderert bruker-ID i lisengivende Admin Console.
  • Den tekniske kontoens bruker-ID må deles med den nye fødererte bruker-ID-en (via forhåndsdeling av konto).

Når API-kallene er konfigurert, må de konfigureres til å bruke det tekniske kontotokenet som autorisasjonsverdien , og bruker-ID-en eller e-posten til den delte bruker-ID-en som x-på-vegne-av-bruker-verdien.

Opprett en ny føderert bruker-ID

Før du oppretter den nye bruker-ID-en, må du identifisere en e-postadresse som kan brukes til innkommende svar/spørsmål fra mottakerne.

Slik oppretter du den nye bruker-ID-en:

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

  2. Gå til: Innstillinger → Identitet

    Velg en katalog for å opprette den nye brukeren.

    Aktivt domene

  3. Velg fanen med Synkronisering.

  4. Velg Gå til Innstillinger og klikk på Aktiver redigering.

    Når redigering er aktivert, tillater Adobe Admin Console kun redigering av brukerdata i Admin Console. IdP-en din oppdateres ikke med redigeringene.

    Kataloginnstillinger – synkroniseringsfane

    Notat

    Redigeringer forbli aktivert i bare én time, eller til manuelt deaktivert.

    Teknisk konto

  5. Logg på din lisensierende Admin Console (hvis du arbeider med flere Admin Console).

  6. Gå til: Brukere → Legg til bruker.

  7. Konfigurer den nye bruker-ID-en med:

    • E-post eller brukernavn: Bruk e-postadressen du vil bruke til å registrere svar på e-poster fra mottakerne dine.
    • ID-type: Federated ID
    • Fornavn/etternavn: Denne verdien brukes i Acrobat Sign-systemet og gjenspeiles i revisjonsrapporten. Bruk en verdi som gir kontekst. f.eks.: Personale
    • SSO-brukernavn: Bruk samme e-postverdi.
    • Land/område: Velg riktig land eller område for bedriften din.
    • Velg Acrobat Sign-produktet/-profilen som den tekniske bruker-ID-en er knyttet til.
    • Angi brukerrollen til Bruker.

    Klikk på Lagre når du er ferdig.

    Teknisk konto

  8. Logg på Federated Sync Admin Console igjen for å aktivere synkronisering av IdP-data.

  9. Gå tilbake til Innstillinger → Identitet → {Directory} → Synkronisering → Gå til Innstillinger.

    Klikk på Deaktiver redigering for å aktivere synkronisering av data med IdP på nytt.

  10. Din nye bruker-ID vil automatisk bli generert i Acrobat Sign-systemet.

Del den tekniske kontoen med den nye fødererte bruker-ID-en

For å få tilgang til innholdet for en bruker-ID kan du logge på, 

  1. Logg på Acrobat Sign som en kontoadministrator.

  2. Gå til fanen med Brukere i admin-menyen.

  3. Enkeltklikk på den nye brukeren, og Rediger brukerdetaljer.

  4. Velg Delingsstatus i venstre meny.

    Kontroller at fanen med Brukerens konto er delt med er valgt.

  5. Velg fanen med Delt med bruker øverst på Delingsstatus-siden.

  6. Del den nye bruker-ID-kontoen med den tekniske kontoen

    1. Klikk på plussikonet øverst til høyre for å åpne velgergrensesnittet.
    2. Klikk på ikonet med tre linjer til høyre for søkeboksen.
    3. Utvid gruppen der bruker-ID-en for den tekniske kontoen befinner seg.
    4. Klikk plussikonet ved siden av bruker-ID-en for den tekniske kontoen for å velge det.
    5. Merk av for Tilleggstillatelse for å tillate sending.
    6. Klikk på Lagre.
    Teknisk konto

Test den nye tekniske kontoen

For å teste at tilgangskoden fungerer som den skal:

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

  2. Velg metoden HENT/brukere.

  3. I autorisasjonsfeltet:

    1. Skriv inn ordet Bærer etterfulgt av et mellomrom
    2. Lim inn tilgangskoden
    3. Klikk på Prøv det!
    Test det!

  4. Svarorganet kommer tilbake med en liste over brukerne i kontoen og en svarkode på 200:

    Responsorgan

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

  2. Velg POST /users/{userId}/views-metoden.

  3. I autorisasjonsfeltet:

    1. Skriv inn ordet Bearer etterfulgt av et mellomrom.
    2. Lim inn tilgangskoden.

  4. Skriv inn meg i bruker-ID-feltet.

  5. Klikk på koblingen Komplett modellskjema.

  6. Klikk i det gule feltet for å overføre skjemaet til UserViewInfo-feltet.

  7. Rediger UserViewInfo-feltet:

    • Oppgi ALLE i navneverdien.
    • For autoLoginUser-verdien endrer du den til sann.

  8. Klikk på Prøv den!

    Konfigurer API for tilgangstoken

    Det returnerte feltet for svarinnhold inneholder nettadressen som trengs for å logge på som brukeren:

    Kopier tilgangsnettadressen

  9. Kopier nettadressen og lim den inn i en nettleser.

  10. Du vil bli utfordret til å bekrefte innloggingen.

    Klikk på Ja.

    Bekrefte pålogging.

Test sending av en avtale ved hjelp av den tekniske kontoen på vegne av den nye bruker-ID-en via API

  1. Få en transientDocumentId eller ha en annen metode for å legge til en klar fil.

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

  3. I autorisasjonsfeltet:

    1. Skriv inn ordet Bearer etterfulgt av et mellomrom
    2. Lim inn tilgangstokenet
      for den tekniske kontoen
    3. Oppgi e-postadressen til den nye bruker-ID-en i feltet x-på-vegne-av-bruker
    4. Fyll ut resten av avtalenInfo med transientDocumentId, navnet på avtalen, signaturtype og tilstand.
    5. Klikk på Prøv den!
    Test det!

  4. Logg på Acrobat Sign med den nye bruker-ID-en, og gå til fanen med Behandle.

  5. Ved gjennomgang av avtalerevisjonsloggen, ser du at avtalen ble sendt av den tekniske kontoen på vegne av den nye bruker-ID-en.

Se gjennom innholdet som genereres på vegne av den nye bruker-ID-en via Acrobat Sign-grensesnittet

Når den tekniske kontoen oppretter en avtale på vegne av Federated bruker-ID, publiseres avtalen på Behandle-siden til Federated bruker-ID.

På siden med Behandle Federated bruker-ID-er kan du vise og administrere avtalen.

Avtale sendt på vegne av brukeren

Logo for Adobe Sign

Effektiviser arbeidet ditt med Acrobat Sign
Behandle og signer dokumenter på nettet raskt og enkelt.

Åpne applikasjonen
Åpne applikasjonen

Forrige

Flytt en bruker fra en Admin Console-organisasjon til en annen

Neste

Opprett tjenestekontoer for å sende avtaler under en funksjonell enhet

Opplæring

card-link-icon

Lær med trinnvise opplæringsvideoer og praktisk veiledning direkte i applikasjonen.

Fellesskap

card-link-icon

Delta i diskusjoner, finn svar, lær av eksperter og del kunnskapen din.

Adobe-startsiden

card-link-icon

Få tilgang til de Creative Cloud-appene og -tjenestene du liker best, samt filbehandling og annet.