Guida utente Annulla

Creare account tecnici per inviare accordi tramite API

Guida di Adobe Acrobat Sign

Novità

Introduzione

Amministrazione

Inviare, firmare e gestire gli accordi

Funzionalità e flussi di lavoro avanzati per gli accordi

Integrazione con altri prodotti

Acrobat Sign per sviluppatori

Supporto e risoluzione dei problemi

Account tecnici Adobe Acrobat Sign

Gli account tecnici di Acrobat Sign consentono di abilitare gli account Enterprise ad eseguire le loro applicazioni mediante un ID utente generato esplicitamente a tale scopo (anziché utilizzare l’ID utente personale dell’amministratore).

Gli account tecnici sono disponibili per i clienti Enterprise (tramite Adobe Developers Console) nel piano di acquisto ETLA che gestiscono il loro account tramite Adobe Admin Console.

La scheda prodotto per l’accesso all’account tecnico si trova sulla scheda Prodotti in Admin Console sotto il nome dell’offerta Adobe Acrobat Sign Solutions - Enterprise (cerca la dicitura API disponibile):

Schede di prodotto Account tecnico

Nota:

Il processo seguente descrive come usare gli account tecnici tramite una soluzione API. Le organizzazioni che desiderano consentire agli utenti di inviare manualmente gli accordi per conto di una parte centralizzata possono consultare il documento sulla configurazione degli account tecnici mediante connessione manuale.

Prerequisiti

Per abilitare un account tecnico, l’account Acrobat Sign deve:

  • disporre di un servizio di ETLA di livello Enterprise;
  • gestire gli utenti mediante Adobe Admin Console;*
  • aver abilitato la condivisione account avanzata.

* Nota su Adobe Admin Console

Adobe Admin Console fornisce un framework per la gestione degli utenti e l’assegnazione delle licenze. La maggior parte dei clienti ha una sola istanza di Admin Console.

Tuttavia, alcuni clienti con requisiti complessi di utenti/licenze possono avere più istanze di Admin Console, il che può creare confusione in un processo come la creazione di account tecnici, ad esempio se ne viene usata una per gestire gli utenti federati e un’altra per gestire le licenze di Acrobat Sign.

Se hai più account o in caso di dubbi, leggi quanto segue:

Panoramica

La creazione di un account tecnico è un processo in più passaggi che richiede l’accesso a livello di amministratore ad Adobe Acrobat Console e l’autorizzazione di amministratore a livello di account in Acrobat Sign.

Per tale processo, l’amministratore deve effettuare le seguenti operazioni:

  1. Abilitare l’accesso come amministratore o sviluppatore per l’utente che crea l’account tecnico.
    • Per configurare le impostazioni necessarie per creare l’account tecnico, l’utente deve essere un amministratore o sviluppatore.
  2. Creare un nuovo progetto in Adobe Developer Console (Adobe.io).
    • Tale progetto è l’ambiente richiesto per contenere la coppia di chiavi pubblica/privata e il token di accesso che abilita la funzionalità dell’account tecnico.
  3. Creare o caricare una coppia di chiavi pubblica/privata e generare un token di accesso.
    • La generazione del token di accesso crea l’ID utente dell’account tecnico in Adobe Admin Console e lo inserisce nel sistema Acrobat Sign.
  4. (Facoltativo) Creare un nuovo gruppo nel sistema Acrobat Sign.
    • La creazione di un gruppo dedicato per l’ID utente dell’account tecnico consente una configurazione molto ristretta delle proprietà dell’accordo che potrebbe essere troppo rigida o diversa da altre configurazioni di gruppo.
  5. Assegnare all’ID utente dell’account tecnico in Acrobat Sign le autorizzazioni da amministratore a livello di gruppo.
  6. Creare un nuovo utente federato in Adobe Admin Console.
    • In questo modo, viene creato un indirizzo e-mail dell’utente con il tuo dominio che funge da proxy per l’ID utente dell’account tecnico durante l’invio, fornendo un indirizzo e-mail correttamente associato alla tua azienda.
  7. Condividere l’account utente federato con l’account tecnico.
    • L’ID utente dell’account tecnico viene generato nell’istanza Admin Console per licenze con un indirizzo e-mail adobe.com. Condividendo l’account utente federato, concedi l’accesso all’ID utente dell’account tecnico da inviare per conto dell’ID utente federato, fornendo così un nome e un indirizzo e-mail più intuitivi per i destinatari.

    Al termine, l’API può essere configurata per utilizzare l’account tecnico (tramite codice di accesso) per creare e inviare accordi per conto di un utente centralizzato.

Consentire agli utenti di accedere a Developers Console

Prima di poter aggiungere un nuovo account tecnico, l’utente deve essere aggiunto al profilo di prodotto Adobe Acrobat Sign Solutions - Enterprise (nell’istanza Admin Console per licenze) come Amministratore o Sviluppatore.

  1. Fai clic sul collegamento Adobe Acrobat Sign Solutions - Enterprise nella barra a sinistra o nei prodotti.

  2. Seleziona il profilo di prodotto predefinito per il servizio Acrobat Sign.

    Seleziona il profilo di prodotto

  3. Viene aperta la pagina Aggiungi utenti a questo prodotto:

    • Seleziona la scheda Amministratore o Sviluppatore.
  4. Immetti l’indirizzo e-mail dell’utente a cui desideri concedere l’accesso.

  5. Fai clic su Aggiungi amministratore/sviluppatore.

    Aggiungi sviluppatore

  6. Immetti l’indirizzo e-mail dell’utente a cui desideri concedere l’accesso.

  7. Immetti il nome e il cognome.

  8. Al termine, fai clic su Salva.

    Immetti i dati dello sviluppatore

Creare un nuovo progetto nella console Adobe.io

  1. Passa a https://console.adobe.io.

    • Gli utenti che appartengono a più istanze di Admin Console, devono assicurarsi di essere connessi all’istanza allineata ad Admin Console per licenze facendo clic sulla freccia giù nell’angolo in alto a destra della finestra.
    Istanze di Admin Console

  2. Seleziona Crea un nuovo progetto.

    Crea un nuovo progetto

  3. Il nuovo progetto viene visualizzato sulla scheda Progetti della console.

    Prenditi un minuto per nominare il progetto facendo clic sul pulsante Modifica progetto.

    • Assegna un nome comprensibile per i tuoi colleghi
    • Fornisci una breve descrizione
    • Salva le modifiche
    Modifica il progetto

  4. Seleziona il nuovo progetto (nella scheda Progetti) per aprirlo per la configurazione.

    Sulla pagina Introduzione:

    1. Seleziona Aggiungi al progetto
    2. Dall‘elenco a discesa, seleziona API.
    Aggiungi API

  5. Sulla pagina Aggiungi un’API:

    1. Seleziona il filtro Document Cloud
    2. Seleziona Acrobat Sign
    3. Fai clic su Avanti
    Seleziona Acrobat Sign

Crea un nuovo JSON Web Token

È possibile generare una nuova coppia di chiavi pubblica/privata oppure caricare la chiave pubblica. Scegli l’opzione più adatta alle tue esigenze:

Seleziona il profilo di prodotto

La pagina Configura API si aggiorna per visualizzare i profili di prodotto disponibili per il tuo account. È possibile averne uno o più a seconda dei profili disponibili per il tuo account.

  1. Seleziona la casella di controllo per Adobe Acrobat Sign Solutions predefinito - Enterprise.
  2. Salva API configurata quando è pronta.
Salva API configurata

Generare un token di accesso

Una volta salvato, l’account tecnico viene creato e vieni riportato alla pagina Home del progetto.

Nella sezione Genera token di accesso, è presente un campo di inserimento per la chiave privata.

  1. Incolla la chiave privata che hai generato/caricato in precedenza nel campo Chiave privata.

  2. Seleziona Genera token.

  3. Dopo qualche istante, il campo Chiave privata viene aggiornato per visualizzare il token di accesso.

  4. Copia e salva il token di accesso.

    Genera il token di accesso

  5. Nella parte inferiore della stessa pagina, puoi accedere a:

    • ID client
    • Segreto client
    • ID account tecnico
    • E-mail account tecnico
    • ID organizzazione

    Copia e salva l‘E-mail account tecnico.

    Salva l‘e-mail dell’account tecnico

Valuta la generazione di un gruppo univoco in Acrobat Sign per l’applicazione

I gruppi di Acrobat Sign consentono di configurare in modo dettagliato le impostazioni di sicurezza ed esperienza per il destinatario (nonché flussi di lavoro, modelli, creazione di report e così via).

Per isolare l’ID utente dell’account tecnico nel proprio gruppo:

  1. Accedi ad Acrobat Sign come amministratore a livello di account.

  2. Passa alla scheda Gruppi nel menu di amministrazione.

  3. Fai clic sull’icona + (più) per creare un nuovo gruppo.

  4. Immetti un nome intuitivo per il gruppo (magari lo stesso nome del Progetto).

  5. Salva il gruppo.

  6. (Facoltativo) Apri il nuovo gruppo e configura le impostazioni necessarie per l’applicazione.

    Creare un gruppo

Nota:

Se la tua organizzazione

  • utilizza lo strumento User Sync Tool (UST) per sincronizzare automaticamente gli utenti tra Adobe e Active Directory
  • non consentendo di aggiungere o creare manualmente gli utenti in Acrobat Sign,

devi creare un gruppo di eccezioni come gruppo principale per tutti gli ID utente dell’account tecnico.

Il nome del gruppo viene aggiunto alla configurazione dello strumento UST per garantire che il processo di sincronizzazione non influisca sugli ID utente, disattivandoli o rimuovendone l’autorizzazione.

Privilegia l’ID utente dell’account tecnico come amministratore del gruppo in Acrobat Sign

Attendi qualche minuto perché il nuovo utente techact.adobe.com venga generato nel sistema Acrobat Sign.

  1. Accedi al tuo account Acrobat Sign come amministratore a livello di account.

  2. Passa alla scheda Utenti del menu di amministrazione.

  3. Cerca il nuovo indirizzo e-mail techact.adobe.com (copiato dalla pagina Home del progetto).

  4. Fai clic sull’utente e seleziona Modifica dettagli utente.

    Modifica dettagli utente

  5. Fai clic sull’icona più (+) nella sezione Iscrizione al gruppo e aggiungi il gruppo dell’applicazione al profilo dell’utente.

  6. Seleziona il gruppo dell’applicazione e fai clic su Contrassegna come collegamento principale.

  7. Seleziona la casella per contrassegnare l’ID utente come Amministratore del gruppo.

  8. (Facoltativo) Rimuovi l’account tecnico dal gruppo Predefinito.

  9. Al termine, fai clic su Salva.

    Salvare le impostazioni del profilo

Crea un e-mail o utente Rispondi a

L’invio di accordi utilizzando l’ID utente o l’e-mail associato all’account tecnico può generare problemi poichéa l’e-mail non rientra nel dominio aziendale.

Per risolvere questo problema:

  • È necessario creare un nuovo ID utente federato in Admin Console per licenze.
  • L’ID utente dell’account tecnico deve essere condiviso con il nuovo ID utente federato (tramite condivisione account avanzata).

Una volta configurate, le chiamate API devono essere configurate per utilizzare il token dell’account tecnico come valore di Autorizzazione e l’ID utente o l’e-mail dell’ID utente condiviso come valore X per conto dell'utente.

Creare un nuovo ID utente federato

Prima di creare il nuovo ID utente, è necessario identificare un indirizzo e-mail che può essere utilizzato per le risposte e le domande in entrata dei destinatari.

Per creare il nuovo ID utente:

  1. Accedi come amministratore a Admin Console (sincronizzazione federata).

  2. Passa a: Impostazioni → Identità

    Seleziona una directory per creare il nuovo utente.

    Dominio attivo

  3. Seleziona la scheda Sincronizzazione.

  4. Seleziona Vai a Impostazioni e fai clic su Abilita modifica.

    Quando la modifica è attivata, Adobe Admin Console consente di modificare i dati degli utenti solo in Admin Console. Il tuo IdP non viene aggiornato con le modifiche.

    Impostazioni della directory - Scheda Sincronizzazione

    Nota:

    La modifica rimane abilitata solo per un’ora o finché non viene disattivata manualmente.

    Account tecnico

  5. Accedi ad Admin Console per licenze (se lavori con più istanze di Admin Console).

  6. Passa a: Utenti → Aggiungi utente.

  7. Configura il nuovo ID utente con:

    • E-mail o nome utente: utilizza l’indirizzo e-mail con cui desideri acquisire le e-mail di risposta dai destinatari.
    • Tipo di ID: Federated ID
    • Nome/cognome: questo valore viene utilizzato nel sistema Acrobat Sign e viene riportato nel report di audit. Usa un valore che fornisca contesto, ad esempio: Risorse umane
    • Nome utente SSO: usa lo stesso valore e-mail.
    • Paese/Area geografica: seleziona il paese o l’area geografica appropriata per la tua azienda.
    • Seleziona il prodotto/profilo Acrobat Sign a cui è associato l’ID utente tecnico.
    • Imposta il ruolo degli utenti su Utente.

    Al termine fai clic su Salva.

    Account tecnico

  8. Accedi di nuovo ad Admin Console per sincronizzazione federata per abilitare la sincronizzazione dei dati IdP.

  9. Torna a Impostazioni → Identità → {Directory} → Sincronizzazione → Vai alle Impostazioni.

    Fai clic su Disabilita modifica per abilitare nuovamente la sincronizzazione dei dati con il tuo IdP.

  10. Il nuovo ID utente verrà generato automaticamente nel sistema Acrobat Sign.

Condividere l’account tecnico con il nuovo ID utente federato

Per ottenere l’accesso al contenuto per un ID utente a cui puoi accedere:

  1. Accedi ad Acrobat Sign come amministratore dell’account.

  2. Passa alla scheda Utenti nel menu di amministrazione.

  3. Fai clic sul nuovo utente e Modifica i dettagli utente.

  4. Seleziona Stato condivisione nel menu a sinistra.

    Assicurati che la scheda Account utente condiviso con sia selezionata.

  5. Seleziona la scheda Condiviso con utente nella parte superiore della pagina Stato condivisione.

  6. Condividi l’account del nuovo ID utente con l’account tecnico.

    1. Fai clic sull’icona più (+) nella riga in alto a destra per aprire l’interfaccia del selettore.
    2. Fai clic sull’icona con le tre lineete a destra della casella di ricerca.
    3. Espandi il gruppo in cui si trova l’ID utente dell’account tecnico.
    4. Fai clic sull’icona + (più) accanto all’ID utente dell’account tecnico per selezionarlo.
    5. Verifica l’Autorizzazione aggiuntiva per consentire l’invio.
    6. Fai clic su Salva.
    Account tecnico

Verifica il nuovo account tecnico

Per verificare che il codice di accesso funzioni correttamente:

  1. Seleziona il metodo GET/users.

  2. Nel campo Autorizzazione:

    1. Digita la parola Bearer seguita da uno spazio
    2. Incolla il Codice di accesso
    3. Fai clic su Prova
    Prova

  3. Il corpo della risposta restituirà un elenco degli utenti nell’account e un Codice risposta di 200:

    Corpo della risposta

Prova a inviare un accordo utilizzando l’account tecnico per conto del nuovo ID utente tramite API

  1. Ottieni un transientDocumentId o utilizza un altro metodo per allegare un file pronto.

  2. Nel campo Autorizzazione:

    1. Digita la parola Bearer seguita da uno spazio
    2. Incolla il Token di accesso
      dell’account tecnico
    3. Nel campo x per conto dell’utente, inserisci l’indirizzo e-mail del nuovo ID utente
    4. Completa il resto di AgreementInfo con transientDocumentId, nome dell’accordo, tipo di firma e stato.
    5. Fai clic su Prova
    Prova

  3. Accedi ad Acrobat Sign come nuovo ID utente e passa alla scheda Gestisci.

  4. Esaminando il registro di audit dell’accordo, potrai notare che l’accordo è stato inviato dall’account tecnico per conto del nuovo ID utente.

Verifica il contenuto generato per conto del nuovo ID utente tramite l’interfaccia di Acrobat Sign

Quando l’account tecnico crea un accordo per conto dell’ID utente federato, l’accordo viene pubblicato nella pagina Gestisci dell’ID utente federato.

Nella pagina Gestisci dell’ID utente federato puoi visualizzare e gestire l’accordo.

Accordo inviato per conto dell’utente

Ottieni supporto in modo più facile e veloce

Nuovo utente?