Brukerveiledning Avbryt

Opprett tekniske konti for å sende avtaler via API

 

Veiledning for Adobe Acrobat Sign

Nyheter

Kom i gang

Administrer

Sende, signere og behandle avtaler

Avanserte avtalefunksjoner og arbeidsflyter

Integrere med andre produkter

Acrobat Sign-utvikler

Kundestøtte og feilsøking

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

Merk:

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:

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:

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

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

Merk:

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

    Merk:

    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. Velg metoden HENT/brukere.

  2. I autorisasjonsfeltet:

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

  3. Svarorganet kommer tilbake med en liste over brukerne i kontoen og en svarkode 200:

    Responsorgan

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

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

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

Få hjelp raskere og enklere

Ny bruker?