Crea e gestisci chiavi di integrazione per autenticare le richieste API.
Adobe Acrobat Sign le chiavi di integrazione sono credenziali a lunga durata utilizzate per autenticare le richieste API. Consentono alle app e alle integrazioni di agire per conto di un Utente senza richiedere Accedi ripetuti. Questo abilita l'automazione, la comunicazione da sistema a sistema e l'integrazione con piattaforme esterne.
Le chiavi di integrazione ereditano le autorizzazioni dell'Utente che le crea. Gli ambiti selezionati durante la creazione definiscono a cosa può accedere la chiave, rendendo importante concedere solo le autorizzazioni necessarie per l'integrazione.
accesso e disponibilità
- Le chiavi di integrazione sono disponibili solo per gli account Enterprise.
- Il collegamento Chiave di integrazione si trova in API Acrobat Sign > Informazioni API.
- Se il collegamento Chiave di integrazione non è visibile, la funzionalità non è abilitata per l'account.
- Contatta il supporto Acrobat Sign per richiedere l'accesso.
Come funzionano le chiavi di integrazione
- Le chiavi di integrazione autenticano le richieste API senza richiedere l'interazione dell'Utente.
- Ogni chiave rappresenta l'Utente che l'ha creata ed eredita le autorizzazioni di quell'Utente.
- Gli ambiti definiscono il Valore tonale di accesso concesso alla chiave.
- Le chiavi sono persistenti e possono essere utilizzate in più app.
- Le chiavi possono essere revocate in qualsiasi momento per interrompere immediatamente l'accesso API.
Chiavi di integrazione vs OAuth
- Le chiavi di integrazione forniscono autenticazione API diretta e sono comunemente utilizzate per integrazioni server-to-server e flussi di lavoro legacy.
- OAuth fornisce accesso delegato autorizzato dall'Utente e supporta controlli di sicurezza più forti, inclusa la scadenza del token e il consenso con ambito.
- Le chiavi di integrazione sono ancora supportate per le integrazioni esistenti e i flussi di lavoro server-to-server.
- Utilizza OAuth quando possibile, specialmente per nuove integrazioni o quando sono richiesti accesso a Valore tonale Utente e controlli di sicurezza.
Ciclo di vita e comportamento
- Le chiavi vengono create con un insieme definito di ambiti.
- Il nome della chiave e gli ambiti non possono essere modificati dopo la creazione.
- Le chiavi rimangono valide fino a 10 anni, o fino a quando non vengono revocate.
- La revoca di una chiave disattiva immediatamente l'autenticazione API per qualsiasi app che la utilizza.
- È necessario creare una nuova chiave per sostituire quella revocata.
Best practice
- Archivia le chiavi di integrazione in modo sicuro e trattale come credenziali.
- Limita gli ambiti solo alle autorizzazioni necessarie.
- Usa chiavi separate per app o ambienti diversi.
- Revoca le chiavi che non sono più necessarie.
- Ruota le chiavi periodicamente per ridurre il rischio.
Gestire le chiavi di integrazione
Usa le seguenti attività per gestire le chiavi di integrazione:
Semplifica il tuo lavoro con Acrobat Sign
Gestisci e firma documenti online in modo semplice e veloce.
