Impostazioni amministratore - Gestisci client OAuth

In Looker, gli amministratori possono utilizzare la pagina Gestisci client OAuth per gestire l'accesso OAuth 2.0 basato sull'identità per le applicazioni esterne senza creare chiavi API o utilizzare Explorer API. Questo documento descrive come abilitare le applicazioni preconfigurate, registrare client OAuth personalizzati e gestire la revoca dei token.

La pagina Manage OAuth Clients (Gestisci client OAuth) si trova nella sezione Authentication (Autenticazione) del pannello Admin (Amministrazione) di Looker. Fornisce un'interfaccia centralizzata per concedere l'accesso a strumenti per sviluppatori come l'interfaccia a riga di comando di Looker, i client Model Context Protocol (MCP) degli agenti AI e i connettori di business intelligence (BI).

Nota: se disponi di un'autorizzazione che fornisce l'accesso solo a determinate pagine del pannello di amministrazione, ad esempio manage_schedules, manage_themes o see_admin, ma non disponi del ruolo di amministratore, la pagina o le pagine descritte qui potrebbero non essere visibili nel pannello di amministrazione.

Requisiti

Per accedere alla pagina Gestisci client OAuth e gestirla, devono essere soddisfatti i seguenti requisiti:

• La tua istanza di Looker deve essere ospitata da Looker. Le istanze di Looker ospitate dal cliente non sono supportate.
• Devi disporre del ruolo di amministratore nell'istanza di Looker.

Panoramica

La pagina Gestisci client OAuth organizza le applicazioni client in due schede:

• Libreria di applicazioni: un catalogo di applicazioni OAuth preconfigurate e gestite da Looker, tra cui client Model Context Protocol (MCP) di agenti AI, connettori di business intelligence (BI) e strumenti per sviluppatori.
• Client personalizzati: un'interfaccia di gestione per la registrazione e la configurazione delle tue applicazioni client OAuth personalizzate con URI di reindirizzamento di callback personalizzabili e controlli degli accessi di gruppo.

Una barra di ricerca nella parte superiore della pagina ti consente di filtrare le applicazioni in entrambe le schede in tempo reale.

Scheda Libreria delle applicazioni

La scheda Libreria di applicazioni contiene i client OAuth preconfigurati gestiti da Looker. Ti consigliamo di controllare prima la scheda Libreria di applicazioni prima di creare un client personalizzato. Se lo strumento che vuoi connettere è già preconfigurato nella libreria, puoi attivarlo senza registrare un nuovo client personalizzato, a meno che non ti serva un URI o una porta di reindirizzamento diversi.

La libreria delle applicazioni include client preconfigurati per le seguenti integrazioni:

• Client MCP degli agenti AI: Cursor, VS Code, Claude Code, Claude Desktop, ChatGPT, Gemini CLI, Cline, Windsurf, Antigravity e l'estensione Looker per VS Code.
• Connettori BI: Fogli connessi, Data Studio, Tableau Desktop, Microsoft Power BI e Microsoft Excel.
• Strumenti per sviluppatori: interfaccia a riga di comando di Looker.

Attivazione e disattivazione delle applicazioni della libreria

Ogni applicazione client preconfigurata nella libreria delle applicazioni ha un'opzione Attiva:

• Attiva: attiva l'opzione per consentire agli utenti di autenticarsi in Looker da quell'applicazione client utilizzando OAuth.
• Disattiva: disattiva l'opzione per bloccare le richieste di autorizzazione da quell'applicazione client. La disattivazione di un'applicazione revoca e invalida immediatamente tutti i token OAuth attivi emessi per gli utenti per l'applicazione in questione.

Nota: le applicazioni preconfigurate nella Libreria applicazioni non possono essere eliminate. Possono essere solo attivate o disattivate.

L'ID client di ogni applicazione client preconfigurata viene visualizzato nella riga corrispondente. Puoi copiare l'ID client per utilizzarlo nelle configurazioni lato client, ma l'ID client per le applicazioni della libreria è immutabile e non può essere modificato.

Sincronizzazione con la pagina Connettori BI

Lo stato di attivazione dei connettori BI (tra cui Fogli connessi, Data Studio, Tableau Desktop, Microsoft Power BI e Microsoft Excel) viene sincronizzato automaticamente tra la pagina Gestisci client OAuth e la pagina Connettori BI:

• La modifica dello stato di attivazione di un connettore BI nella pagina Gestisci client OAuth aggiorna automaticamente il connettore corrispondente nella pagina Connettori BI.
• La modifica dello stato di attivazione di un connettore BI nella pagina Connettori BI aggiorna automaticamente lo stato nella pagina Gestisci client OAuth.

Nota: la pagina Connettori BI rimane disponibile per la configurazione dell'impostazione in uscita Abilita il link rapido a Fogli connessi.

URI di reindirizzamento e configurazioni delle porte dinamiche

Looker richiede che gli URI di reindirizzamento OAuth corrispondano esattamente ai valori registrati e non supporta gli URI di reindirizzamento con caratteri jolly.

• Connettori BI standard: utilizza URI di reindirizzamento preconfigurati e immutabili che corrispondono agli endpoint di autenticazione ufficiali del servizio.
• Agenti AI e client MCP: alcuni strumenti AI utilizzano porte locali dinamiche o temporanee per impostazione predefinita quando avviano un reindirizzamento OAuth (ad esempio Claude Code o Cline). Per supportare questi strumenti, Looker preregistra una porta predefinita fissa per ogni client della libreria (ad esempio, la porta 8080 per Claude Code e Cline o la porta 7777 per Gemini CLI).

Per utilizzare un client di libreria preconfigurato che richiede una porta fissa, scegli una delle seguenti opzioni:

1. Configura il client in modo che utilizzi la porta statica preregistrata: nelle impostazioni dell'applicazione client o nei flag di avvio, specifica la porta preregistrata (ad esempio, esegui Claude Code con --callback-port 8080).
2. Registra un client personalizzato: se vuoi utilizzare una porta diversa o un URL di callback personalizzato, registra un nuovo client nella scheda Client personalizzati con l'URI di reindirizzamento che preferisci.

Scheda Client personalizzati

La scheda Client personalizzati consente di registrare e amministrare applicazioni client OAuth 2.0 personalizzate per strumenti interni, integrazioni proprietarie o applicazioni di terze parti non disponibili nella Libreria delle applicazioni.

Registrazione di un client OAuth personalizzato

Per registrare un nuovo client OAuth personalizzato, segui questi passaggi:

1. Nel pannello Admin (Amministrazione), vai alla sezione Authentication (Autenticazione) e seleziona Manage OAuth Clients (Gestisci client OAuth).
2. Seleziona la scheda Client personalizzati.
3. Fai clic su Add New (Aggiungi nuovo).
4. Nel riquadro laterale, compila i seguenti campi:
   • ID client: inserisci un identificatore di stringa univoco per la tua applicazione. L'ID client non può iniziare con com.looker., che è riservato alle applicazioni gestite da Looker.
   • Nome client: inserisci un nome visualizzato descrittivo per l'applicazione.
   • Descrizione (facoltativa): inserisci una breve descrizione che spieghi lo scopo dell'applicazione.
   • URI di reindirizzamento: inserisci uno o più URI di callback autorizzati (ad esempio https://mycompany.com/oauth/callback o http://localhost:8080/callback). Puoi inserire più URI di reindirizzamento per supportare ambienti o porte diversi.
   • (Facoltativo) Limita a ID gruppo: inserisci l'ID numerico di un gruppo di utenti di Looker. Se viene specificato un ID numerico, solo gli utenti che appartengono a quel gruppo possono autorizzare e autenticarsi in Looker utilizzando questa applicazione.
5. Fai clic su Aggiungi per creare il client personalizzato.

Visualizzazione dei dettagli del cliente

Per visualizzare informazioni dettagliate su qualsiasi applicazione client personalizzata, segui questi passaggi:

1. Nella scheda Clienti personalizzati, fai clic sull'icona con il simbolo di spunta chevron_right nella riga del cliente nella tabella.
2. Si apre un riquadro laterale che mostra il nome del client, l'ID client, la descrizione, l'elenco completo degli URI di reindirizzamento autorizzati e, se configurate, le limitazioni dell'ID gruppo.

Modifica di un client personalizzato

Per aggiornare un'applicazione client OAuth personalizzata esistente, segui questi passaggi:

1. Nella scheda Custom Clients (Client personalizzati), individua l'applicazione client e fai clic sull'icona edit Edit (Modifica) nella riga corrispondente.

2. Nel riquadro laterale di modifica, aggiorna i campi Nome client, Descrizione, URI di reindirizzamento o Limita a ID gruppo in base alle tue esigenze.

   Nota: il campo ID client non può essere modificato dopo la registrazione. Se devi modificare l'ID client, elimina il client e registratene uno nuovo.

3. Fai clic su Update (Aggiorna) per salvare le modifiche.

Eliminazione di un client personalizzato

Per rimuovere un'applicazione client OAuth personalizzata:

1. Nella scheda Client personalizzati, individua l'applicazione client e fai clic sull'icona delete Elimina (cestino) nella riga corrispondente.
2. Nella finestra di dialogo di conferma, fai clic su Elimina.

Avviso: l'eliminazione di un client personalizzato rimuove definitivamente la registrazione del client da Looker e invalida immediatamente tutti i codici di autorizzazione OAuth, i token di accesso e i token di aggiornamento attivi emessi per l'applicazione.

Annullamento della convalida dei token e sicurezza

Per mantenere la sicurezza nelle applicazioni connesse, Looker applica automaticamente la revoca dei token. Quando un amministratore elimina un'applicazione client personalizzata o disabilita un'applicazione nella scheda Libreria di applicazioni o Client personalizzati, Looker revoca immediatamente tutti i token di aggiornamento OAuth attivi che sono stati emessi per tutti gli utenti per quell'applicazione. Tutti i codici di autorizzazione associati all'applicazione vengono invalidati definitivamente.

Nota: Nel caso di eliminazione o disabilitazione di un'applicazione, non è possibile generare nuovi token di accesso e tutti i token di accesso già emessi scadranno entro 60 minuti.

Se un utente o un'applicazione tenta di connettersi utilizzando credenziali revocate, Looker nega l'autorizzazione e restituisce un errore che indica che il client OAuth non è stato trovato o non è abilitato.