Provider OAuth gestiti

Usa questa referenza per controllare le impostazioni e gli ambiti del provider quando registri un server MCP esterno o crei una connessione HTTP.

Azure Databricks offre flussi OAuth gestiti per i provider di strumenti API selezionati. Non è necessario registrare l'app OAuth o gestire le credenziali. Azure Databricks consiglia OAuth gestito per lo sviluppo e il test. Se i casi d'uso di produzione richiedono la generazione di credenziali OAuth personalizzate, vedere la documentazione dei provider per altre informazioni.

Requisiti

Crea in Unity Catalog una connessione HTTP con il tipo di autenticazione OAuth User to Machine Per User e seleziona il tuo provider dal menu a discesa OAuth Provider. Per i passaggi dettagliati, vedere Creare una connessione al servizio esterno.

Servizi con supporto OAuth gestito

Le integrazioni seguenti usano le credenziali OAuth che Azure Databricks gestisce e archivia in modo sicuro nel back-end. Il provider richiede a ogni utente di autorizzare il primo utilizzo.

Provider Note di configurazione Ambiti supportati Description
Google Drive API Nessuno https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/documents.readonly https://www.googleapis.com/auth/spreadsheets.readonly offline_access Accesso per leggere e scrivere ai file di Google Drive accessibili dall'utente, inclusi Google Docs e Google Sheets, oltre alla condivisione, ai commenti e alla gestione dei file.
Gmail API Nessuno https://www.googleapis.com/auth/gmail.modify offline_access Accesso in lettura e scrittura a messaggi, conversazioni, bozze ed etichette di Gmail.
Google Calendar API Nessuno https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/calendar.events offline_access Accesso in sola lettura ai calendari di Google Calendar e alle informazioni sulla disponibilità, oltre all'accesso in lettura e scrittura agli eventi.
Microsoft 365 API Nessuno Vedi gli ambiti di Microsoft 365. Accesso in lettura e scrittura tramite Microsoft Graph ai file di SharePoint e OneDrive, alla posta e al calendario di Outlook e alle chat, ai canali e alle riunioni di Microsoft Teams.
Glean Richiede l'host. Il percorso di base è configurabile (per impostazione predefinita è /mcp/default). mcp Accedere a strumenti di ricerca, chat, documenti e agenti di Glean enterprise.
GitHub Utilizza i permessi di GitHub App invece degli scope OAuth. Il campo di scopo OAuth non viene utilizzato. Indice: Leggere e scrivere; Questioni: Leggi e scrivi; Pull request: Lettura e scrittura; Metadati: Lettura; Membri: Read; Progetti: Leggi Accesso per lettura e scrittura ai contenuti del repository GitHub, ai problemi e alle pull request; accesso per lettura ai membri dell'organizzazione e ai dati del progetto.
Atlassian Nessuno read:jira-work read:page:confluence read:space:confluence read:comment:confluence read:hierarchical-content:confluence search:jira-work search:confluence read:me read:account write:jira-work write:page:confluence offline_access Accesso in lettura e scrittura ai ticket di Jira e alle pagine di Confluence; ricerca nei contenuti di Jira e Confluence.
Slack Nessuno search:read.public search:read.private search:read.mpim search:read.im search:read.files search:read.users channels:history groups:history mpim:history im:history canvases:read users:read users:read.email chat:write canvases:write channels:read groups:read im:read mpim:read channels:write groups:write im:write mpim:write reactions:read reactions:write Cerca messaggi, file, canali, canvas e utenti su Slack; leggi la cronologia e i dettagli di canali, gruppi, MPIM e DM; pubblica messaggi e scrivi tele elettive; crea e gestisci conversazioni; leggi e aggiungi reazioni.

Se Azure Databricks aggiunge un ambito a un provider dopo che un utente ha autorizzato la connessione, la connessione di quell'utente non riceve automaticamente il nuovo ambito. L'utente deve riconnettersi prima di poter utilizzare le funzionalità che necessitano del nuovo ambito.

Ambiti di Microsoft 365

Il provider API Microsoft 365 si collega tramite la Microsoft API Graph. Le tabelle sottostanti descrivono lo scopo di ogni permesso (ambito) Microsoft Graph che Azure Databricks richiede, raggruppato per il contenuto Microsoft 365 supportato dall'ambito.

Gli scope definiscono il set massimo di azioni che la connessione può tentare per conto dell'utente. I contenuti a cui una connessione può accedere dipende ancora da come la tua organizzazione configura la connessione e dai permessi Microsoft 365 dell'utente che accede. Gli scope che terminano in .All sono permessi a livello organizzativo che tipicamente richiedono il consenso di un amministratore Microsoft 365 per conto dell'organizzazione; l'accesso effettivo dipende comunque dal modello di permessi della connessione e dai permessi dell'utente accedente.

Gli ambiti elencati qui sono rappresentativi e possono cambiare. L'insieme esatto degli ambiti richiesti per una connessione viene visualizzato nella schermata di consenso di Microsoft quando l'utente si connette.

La seguente tabella elenca gli ambiti per i file SharePoint e OneDrive:

Scope Purpose
Sites.Read.All Leggere gli elementi in tutte le collezioni dei siti affinché un collegamento possa cercare siti SharePoint.
Sites.ReadWrite.All Leggi e scrivi elementi in tutte le collezioni del sito.
Files.Read.All Leggi tutti i file a cui l'utente connesso può accedere.

La tabella seguente elenca gli ambiti di applicazione per Microsoft Teams:

Scope Purpose
Chat.Read Leggi i messaggi della chat dell'utente connesso.
Channel.ReadBasic.All Leggi i nomi dei canali e le descrizioni a cui l'utente connesso può accedere.
ChannelMessage.Read.All Leggi i messaggi nei canali a cui l'utente connesso può accedere.
ChatMessage.Send Invia messaggi in chat per conto dell'utente connesso.
ChannelMessage.Send Invia messaggi nel canale per conto dell'utente connesso.
Team.ReadBasic.All Leggi i nomi e le descrizioni dei team a cui l'utente connesso può accedere.

La tabella seguente elenca gli ambiti per la posta di Outlook:

Scope Purpose
Mail.Read Leggi la posta dell'utente connesso.
Mail.Read.Shared Leggi la posta a cui l'utente accedente può accedere, incluse cassette condivise e delegate.
Mail.ReadWrite Leggi e scrivi la posta dell'utente connesso.
Mail.Send Invia email come utente connesso.

La tabella seguente elenca gli ambiti per Calendar:

Scope Purpose
Calendars.Read Leggi gli eventi nei calendari dell'utente connesso.
Calendars.Read.Shared Leggi gli eventi nei calendari a cui l'utente connesso può accedere, inclusi i calendari condivisi.
Calendars.ReadWrite Leggi e scrivi gli eventi nei calendari dell'utente connesso.

La seguente tabella elenca gli ambiti delle riunioni online:

Scope Purpose
OnlineMeetingTranscript.Read.All Leggi le trascrizioni delle riunioni online degli utenti registrati.
OnlineMeetingAiInsight.Read.All Leggi gli approfondimenti generati dall'IA, come le note delle riunioni, dalle riunioni online dell'utente che ha effettuato l'accesso.
OnlineMeetingArtifact.Read.All Leggi gli artefatti, ad esempio i report di partecipazione, dalle riunioni online dell'utente connesso.
OnlineMeetingRecording.Read.All Leggi le registrazioni delle riunioni online dell'utente connesso.

La seguente tabella elenca gli ambiti per identità e autenticazione:

Scope Purpose
User.Read Leggi il profilo dell'utente connesso per identificarlo.
User.ReadBasic.All Leggi i profili base di altri utenti per capire le persone citate nei contenuti.
offline_access Mantieni la connessione con un token di refresh così l'utente non deve riautenticarsi su ogni richiesta.
openid Fai accedere l'utente con OpenID Connect.
profile Leggi il profilo base dell'utente durante l'accesso.
email Leggi l'indirizzo email dell'utente durante l'accesso.

Se necessario, aggiungere all’elenco degli elementi consentiti i seguenti URI di reindirizzamento utilizzati da OAuth gestito:

Cloud URI di reindirizzamento
AWS https://oregon.cloud.databricks.com/api/2.0/http/oauth/redirect
Azure https://westus.azuredatabricks.net/api/2.0/http/oauth/redirect
GCP https://us-central1.gcp.databricks.com/api/2.0/http/oauth/redirect

Per i provider OAuth gestiti con un server Model Context Protocol (MCP) pubblicato, come Glean, GitHub, Atlassian e Slack, Azure Databricks può gestire le credenziali OAuth quando si registra il server come MCP Service. Vedi Server MCP esterni.