Skip to main content
Non è necessario OAuth per utilizzare la Public API. Per un’integrazione privata lato server, inizi con una chiave API con ambito limitato e segua la guida introduttiva. Scelga le credenziali client OAuth quando la Sua policy di sicurezza richiede token di accesso di breve durata oppure la Sua piattaforma di integrazione supporta già tale flusso. Entrambe le opzioni utilizzano un account di servizio. Un account di servizio è l’identità dell’integrazione, non un terzo metodo di autenticazione.

​
Come si combinano i vari elementi

Crei un account di servizio per ogni integrazione. Scelga una chiave API o un client OAuth per tale account; non è necessario utilizzare entrambi i metodi in ogni richiesta API. Nessuna delle due credenziali può superare i permessi correnti dell’account. La guida introduttiva utilizza l’autenticazione Basic. Per le chiavi API è supportato anche un header Bearer; l’uso di tale header non significa che sia necessario un client OAuth.

​
Scelga una chiave API per un’integrazione semplice

Utilizzi una chiave API per i Suoi job pianificati, script di reportistica, pipeline di dati o altri servizi backend quando un segreto archiviato nel Suo secret manager è adatto ai Suoi requisiti di sicurezza.
  • Effettui richieste autenticate direttamente; non è necessario alcuno scambio di token.
  • Selezioni solo i permessi di cui il carico di lavoro ha bisogno e imposti una scadenza.
  • Esegua la rotazione della chiave utilizzando la relativa finestra di sovrapposizione oppure la revochi immediatamente se è stata esposta.
Un’integrazione basata su chiave API non richiede un client OAuth. Inizi con la guida introduttiva, quindi consulti Chiavi API per la creazione e la rotazione.

​
Scelga OAuth per token di accesso di breve durata

Utilizzi le credenziali client OAuth per un servizio backend confidenziale quando la Sua organizzazione richiede token di accesso con scadenza oppure uno strumento di integrazione prevede il grant client_credentials.
  1. Crei un client OAuth con ambito limitato per l’account di servizio.
  2. Autentichi il client presso l’endpoint dei token della Sua area geografica utilizzando il metodo di autenticazione del client fornito durante la configurazione.
  3. Invii il token di accesso ottenuto con le Sue richieste API. Ottenga un nuovo token prima che quello corrente scada.
OAuth aggiunge alla Sua integrazione l’acquisizione dei token e la gestione della scadenza. Il segreto del client richiede comunque un’archiviazione e una rotazione sicure; i token di breve durata non eliminano tale responsabilità. Le credenziali client non utilizzano token di aggiornamento: autentichi nuovamente il client per ottenere un nuovo token di accesso. L’accesso OAuth deve essere abilitato per la Sua organizzazione. Se non è abilitato, utilizzi una chiave API oppure contatti il Supporto di Living Security in merito alle Sue esigenze. Per la creazione del client, i segreti visualizzabili una sola volta, la revoca e il ripristino, consulti Credenziali client OAuth.

​
Mantenga le credenziali sul Suo backend

Le chiavi API degli account di servizio e i segreti client OAuth devono essere conservati in un archivio di segreti lato server. Non li inserisca nel codice del browser, nelle app mobili, nel controllo del codice sorgente o nei log. Una credenziale di account di servizio agisce come il carico di lavoro; non effettua l’accesso di una persona né fornisce un flusso di consenso del cliente. Con entrambi i metodi utilizzi l’host API regionale della Sua organizzazione. Cambiare metodo di autenticazione non modifica l’URL della risorsa, la versione dell’API né i permessi richiesti da un’operazione.