Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Les MCP fournis par Databricks pour des services externes, tels que system.ai.github et system.ai.slack, appellent des applications tierces. La plupart fonctionnent dès que chaque utilisateur termine une connexion OAuth unique. Certains exigent également qu’un administrateur configure d’abord l’application tierce ou le réseau de votre espace de travail.
Cette page traite de la configuration de l’administrateur et de la vérification de conformité à effectuer avant d’activer un MCP fourni par Databricks. Elle est distincte du Login OAuth par utilisateur que chaque utilisateur effectue avant son premier appel, et des scopes OAuth demandés par chaque MCP.
Examiner les exigences de conformité
Avant d’activer un MCP fourni par Databricks, examinez l’application tierce qu’il appelle et confirmez que l’application et votre usage prévu répondent aux exigences de votre organisation, y compris aux exigences de conformité.
Les MCP fournis par Databricks envoient des requêtes, y compris les données qu’elles contiennent, vers des applications tierces. Certaines transmettent les requêtes au serveur MCP propre à l'application tierce, comme Slack, GitHub et Atlassian. D'autres fonctionnent sur Azure Databricks et appellent l'API de l'application tierce, comme Google Drive, Gmail et Google Calendar. Dans les deux cas, l’application tierce traite ces données selon ses propres conditions, incluant ses politiques de conformité, de conservation des données et de résidence. Les données que l’application tierce retourne sont accessibles à l’agent et au modèle qu’il utilise.
Les outils peuvent également effectuer des actions dans l’application tierce avec les permissions de l’utilisateur connecté, comme envoyer des messages ou créer des pull requests. Pour limiter ce qu’un MCP peut faire, choisissez les outils qu’il expose et appliquez les politiques de service.
- Pour l’application tierce ou l’API que chaque MCP invoque, voir Services externes.
- Pour les autorisations demandées par chaque MCP, voir Fournisseurs OAuth gérés.
- Pour limiter qui peut utiliser un MCP, voir Partager un MCP. Pour limiter les destinations externes que les MCP peuvent atteindre, voir Destinations externes.
Configuration générale
Les étapes suivantes s’appliquent à chaque MCP fourni par Databricks. Complétez chacune d’elles correspondant à votre espace de travail et à la configuration de votre application tierce.
Autoriser l’accès sortant depuis votre espace de travail
Les MCP acheminent leurs requêtes sortantes via le plan de calcul serverless de votre espace de travail. Si votre espace de travail utilise le contrôle de sortie sans serveur avec accès restreint, ajoutez le nom de domaine complet (FQDN) de chaque serveur MCP à la liste des domaines autorisés de la politique. Pour les étapes et la manière de trouver la destination de chaque service, voir Workspace to external MCP server.
Autoriser Databricks dans l’application tierce
Si votre organisation limite le trafic entrant vers l'application tierce à un ensemble autorisé d'adresses IP, comme une liste IP d'une organisation GitHub, ajoutez les IP sortantes sans serveur Azure Databricks pour le cloud et la région de votre espace de travail à la liste des autorisations de l'application afin qu'elle accepte les appels d'Azure Databricks. Pour obtenir la liste des adresses IP, consultez les adresses IP et les domaines des services et ressources Azure Databricks. Pour en savoir plus sur la mise en réseau sortante serverless d’Azure Databricks, voir Configurer un pare-feu pour l’accès au calcul serverless.
Configuration supplémentaire d’applications tierces
Deux groupes d’administrateurs contrôlent la possibilité pour les utilisateurs de se connecter à un connecteur et ce que la connexion peut faire :
- Administrateurs fournisseurs : Les administrateurs Slack, Google Workspace, Microsoft Entra ID ou GitHub de votre organisation décident si les utilisateurs peuvent autoriser l'application et quelles permissions elle obtient, comme les scopes OAuth ou l'accès aux dépôts GitHub. Ce ne sont souvent pas vos administrateurs Azure Databricks.
-
Administrateurs Azure Databricks : Les utilisateurs disposant du
MANAGEprivilège sur le MCP d'un connecteur décident quels outils sont disponibles et qui peut les appeler. Voir Gouverner un MCP.
Si un fournisseur bloque la connexion ou limite ce à quoi un connecteur peut accéder, partagez les étapes pour ce fournisseur avec son administrateur. Après que l’administrateur ait approuvé l’application, déconnectez-vous du connecteur et reconnectez-vous pour obtenir les autorisations approuvées. Voir Gérer la connexion du fournisseur.
Approuver l’application Databricks Genie sur Slack
Si votre espace de travail Slack nécessite l’approbation de l’application, l’écran de connexion Slack avertit que l’application est probablement bloquée. Slack peut aussi supprimer des autorisations qu’un administrateur n’a pas approuvées. Par exemple, la connexion réussit, mais le connecteur ne peut pas envoyer de messages.
Un propriétaire d’espace de travail Slack ou un gestionnaire d’application doit approuver l’application Databricks Genie :
- Dans Slack, cliquez sur Admin dans la barre latérale.
- Sélectionnez Applications et flux de travail pour ouvrir le Slack Marketplace.
- Cliquez sur Parcourir, puis recherchez et sélectionnez Databricks Genie.
- Examinez les autorisations demandées et cliquez sur Approuver. L’autorisation Envoyer des messages au nom de l’utilisateur (
chat:write) permet aux utilisateurs d’envoyer des messages via le connecteur.
Si un utilisateur a déjà demandé l’application, le propriétaire de l’espace de travail ou le gestionnaire de l’application peut approuver la demande en attente à la place. Consultez la fonction Gérer l’approbation de l’application pour votre espace de travail.
Lorsque Azure Databricks ajoute une permission au connecteur, Slack demande à nouveau l’approbation. Tant que la nouvelle autorisation n’est pas approuvée, la connexion échoue ou Slack retire la nouvelle permission.
Lorsque vous vous reconnectez, vérifiez les actions que Databricks Genie peut effectuer sur l’écran de connexion à Slack. La liste devrait inclure l’envoi de messages. Si le connecteur ne peut toujours pas envoyer de messages, demandez à un administrateur du Metastore ou à un autre utilisateur avec MANAGE ON system.ai.slack de vérifier ses outils :
-
Dans Unity Gateway, sélectionnez MCP et ouvrez
system.ai.slack. - Dans Aperçu, cliquez sur Edit tools.
- Vérifiez que les outils qui envoient des messages sont sélectionnés, puis cliquez sur Enregistrer les modifications.
Voir Choisir les outils disponibles.
Autoriser les connecteurs dans Google Workspace
Si la connexion Google affiche une erreur d’accès bloqué ou indique que la politique de votre administrateur bloque l’application, votre administrateur Google Workspace restreint quelles applications tierces peuvent accéder aux données Google. Les connecteurs Google Drive, Gmail et Google Agenda utilisent la même application Google OAuth, donc une configuration couvre les trois.
Un administrateur de Google Workspace disposant du privilège administrateur des paramètres de service doit configurer l’application :
- Dans la console d’administration Google, accédez à Sécurité>Contrôle des accès et des données>.
- Cliquez sur Gérer l’accès à l’application.
- Dans Applications configurées, cliquez sur Configurer une nouvelle application.
- Saisissez l’identifiant
645306276512-s5jbhbhff6irpdq1fpt2f21pcrf4agqs.apps.googleusercontent.comclient, cliquez sur Rechercher, puis cliquez sur l’application dans les résultats de recherche. - Pour Portée, laissez l’unité organisationnelle principale sélectionnée pour configurer l’accès à tous les utilisateurs, ou cliquez sur Sélectionner unités d’organisation pour choisir des unités organisationnelles spécifiques. Cliquez sur Continuer.
- Pour Accès aux données Google, sélectionnez De confiance. Pour n’autoriser que les scopes demandés par les connecteurs, sélectionnez plutôt Données Google spécifiques et ajoutez les scopes répertoriés dans Fournisseurs OAuth gérés. Cliquez sur Continuer.
- Vérifiez les paramètres et cliquez sur Terminer.
L’application apparaît dans la liste des applications configurées avec le niveau d’accès que vous avez sélectionné. Voir « Contrôler quelles applications accèdent aux données de Google Workspace ».
Approuver les autorisations Microsoft 365
Le connecteur Microsoft 365 demande toutes ses autorisations Microsoft Graph en une seule demande de consentement. Certains, comme ChannelMessage.Read.All et OnlineMeetingTranscript.Read.All, nécessitent le consentement de l’administrateur. Tant qu’un administrateur n’a pas donné son consentement pour l’organisation, les utilisateurs voient Approbation de l’administrateur requise et ne peuvent pas se connecter. Pour la liste complète, voir étendues Microsoft 365.
Un administrateur Microsoft Entra ID pouvant accorder un consentement à l’échelle du locataire, tel qu’un administrateur d’application cloud ou un administrateur d’application, consent une fois pour tous :
-
Dans Unity Gateway, sélectionnez MCP et ouvrez
system.ai.microsoft_365. - Cliquez sur Login et connectez-vous avec le compte administrateur.
- Sélectionnez Consentir au nom de votre organisation, puis cliquez sur Accepter.
Les autres utilisateurs peuvent alors se connecter sans qu’il soit demandé le consentement. Lorsque Azure Databricks ajoute une permission, un administrateur doit à nouveau donner son consentement. Pour en savoir plus sur le consentement administrateur, consultez Accorder le consentement administrateur à l’échelle du locataire à une application dans la documentation Microsoft.
Pour limiter ce que le connecteur peut faire, un utilisateur disposant de MANAGE sur system.ai.microsoft_365 peut retirer ses outils d’écriture. Voir Choisir les outils disponibles. Cela ne change pas les permissions sur l’écran de consentement.
Activez l’accès en écriture sur GitHub et l’accès aux dépôts privés
Par défaut, le connecteur GitHub (system.ai.github) ne peut lire que les dépôts publics. Pour accéder aux dépôts privés, ou effectuer des modifications telles que la validation de fichiers ou la création d’issues et de pull requests, le propriétaire du dépôt ou un administrateur de l’organisation GitHub doit :
Installez l’application connecteur GitHub Databricks et accordez-lui l’accès aux dépôts requis.
Si l'organisation utilise une liste d’autorisation d’IP, ajoutez les IP sortantes serverless Azure Databricks pour le cloud et la région de votre espace de travail.
Après l’installation de l’application, les utilisateurs peuvent travailler avec les dépôts accordés via le connecteur, dans leurs propres autorisations GitHub.