Questa pagina è stata tradotta dall'API Cloud Translation.

Autenticazione API Looker

Per eseguire qualsiasi operazione con l'API Looker, devi prima eseguire l'autenticazione. I passaggi da seguire dipendono dall'utilizzo o meno di un SDK.

Autenticazione con un SDK

Questo è il metodo consigliato per l'autenticazione dell'API:

Crea le credenziali API nella pagina Utenti della sezione Amministrazione dell'istanza di Looker. Se non sei un amministratore di Looker, chiedi all'amministratore di Looker di creare le credenziali API per te.

Le credenziali API sono sempre associate a un account utente Looker. Le richieste API vengono eseguite "come" l'utente associato alle credenziali API. Le chiamate all'API restituiranno solo i dati che l'utente è autorizzato a visualizzare e modificheranno solo ciò che l'utente è autorizzato a modificare.
Le credenziali API che hai generato includono un ID client e un client secret. Dovrai fornirli all'SDK. Le istruzioni per eseguire questa operazione sono disponibili nella documentazione dell'SDK.

L'SDK si occuperà quindi di ottenere i token di accesso necessari e di inserirli in tutte le richieste API successive.

Autenticazione senza un SDK

L'autenticazione API con un SDK è il metodo consigliato. Per eseguire l'autenticazione senza un SDK:

Crea le credenziali API nella pagina Utenti della sezione Amministrazione dell'istanza di Looker. Se non sei un amministratore di Looker, chiedi all'amministratore di Looker di creare le credenziali API per te.

Le credenziali API sono sempre associate a un account utente Looker. Le richieste API vengono eseguite "come" l'utente associato alle credenziali API. Le chiamate all'API restituiranno solo i dati che l'utente è autorizzato a visualizzare e modificheranno solo ciò che l'utente è autorizzato a modificare.
Ottieni un token di accesso OAuth 2.0 a breve termine chiamando l'endpoint login dell'API. Dovrai fornire le credenziali API generate nel passaggio 1, che includono un ID client e un client secret.
Inserisci il token di accesso nell'intestazione di autorizzazione HTTP delle richieste dell'API Looker. Un esempio di richiesta all'API Looker con un'intestazione di autorizzazione potrebbe avere il seguente aspetto:
```
GET /api/4.0/user HTTP/1.1
Host: test.looker.com
Date: Wed, 19 Oct 2023 12:34:56 -0700
Authorization: token mt6Xc8jJC9GfJzKBQ5SqFZTZRVX8KY6k49TMPS8F
```

Il token di accesso OAuth 2.0 può essere utilizzato in più richieste API finché non scade o non viene invalidato chiamando l'endpoint logout. Le richieste API che utilizzano un token di accesso scaduto non andranno a buon fine con una risposta HTTP 401 Authorization Required.

Interazione dell'API con le impostazioni di accesso utente

L'autenticazione dell'API Looker è completamente indipendente dall'accesso utente di Looker. I protocolli di autenticazione utente, come i passcode monouso (OTP, 2FA) e l'autenticazione della directory (LDAP, SAML e così via), non si applicano all'autenticazione dell'API Looker.

Di conseguenza, l'eliminazione delle informazioni di un utente da un protocollo di autenticazione utente non comporta l'eliminazione delle relative credenziali API. L'utilizzo delle procedure descritte nella pagina della documentazione Eliminare le informazioni personali dell'utente rimuove tutti i dati personali di un utente da Looker, impedendogli di accedere, anche tramite l'API.

Gestione delle credenziali API

A un singolo account utente di Looker possono essere associati più insiemi di credenziali API.
Le credenziali API possono essere create ed eliminate senza influire sullo stato dell'account utente.
L'eliminazione di un account utente di Looker invalida tutte le credenziali API associate all'account utente.
L'API secret client deve essere mantenuto privato. Evita di archiviare i secret client API nel codice sorgente o in altri luoghi che possono essere visti da molte persone.
In produzione, evita di utilizzare le credenziali API associate agli account amministratore di Looker. Crea account utente con privilegi minimi specificamente per le attività API (spesso chiamati "account di servizio") e crea credenziali API su questi account. Concedi solo le autorizzazioni necessarie per le attività dell'API previste.

Autenticazione HTTPS

Anche se utilizzi un SDK client per occuparti dei dettagli di autenticazione, potresti essere curioso di sapere come funziona l'autenticazione dell'API Looker. Per dettagli di basso livello sull'autenticazione, consulta Come eseguire l'autenticazione all'API Looker su GitHub.

Autenticazione tramite OAuth

Looker può utilizzare il protocollo Cross-Origin Resource Sharing (CORS) per consentire alle applicazioni web di effettuare chiamate all'API Looker dall'esterno del dominio di un'istanza di Looker. Per informazioni sulla configurazione dell'autenticazione CORS, consulta la pagina della documentazione Autenticazione dell'API Looker tramite OAuth.