Gérer l'intégration des tableaux de bord et des Genie Agent

Cette page explique comment les administrateurs du Workspace peuvent gérer les options d'intégration pour les tableaux de bord AI/BI et les agents Genie.

Quels types d'intégration pouvez-vous faire ?

Vous pouvez intégrer en toute sécurité des tableaux de bord et des agents Genie dans des sites web et applications externes.

Intégration de tableaux de bord

Vous pouvez intégrer des tableaux de bord de les manières suivantes :

• **Intégration de base Databricks :** les auteurs de tableaux de bord peuvent générer du code d'intégration iframe à l'aide de la boîte de dialogue **Partager**. Les administrateurs de workspace peuvent gérer les domaines, le cas échéant, approuvés pour l'hébergement d'un tableau de bord intégré. L'intégration de tableau de bord nécessite que les utilisateurs aient activé les cookies tiers. Les administrateurs de workspace doivent activer l'intégration dans le workspace et définir la liste des domaines éligibles. Voir intégration basique de tableau de bord.

• Intégration pour les utilisateurs externes : (Aperçu public) Vous pouvez configurer une application externe pour s'authentifier auprès de Databricks avec un Service Principal et accéder à un tableau de bord. Les utilisateurs qui peuvent accéder à votre application externe peuvent accéder au tableau de bord. En option, vous pouvez filtrer les données présentées dans le tableau de bord en fonction de l'utilisateur qui y accède. Les administrateurs de Workspace doivent configurer l’application externe pour utiliser le Service Principal et les jetons OAuth requis pour l’authentification. Voir Qu’est-ce que l’incorporation pour les utilisateurs externes ?.

Pour en savoir plus sur les options d'intégration de tableaux de bord disponibles, consultez Intégrer un tableau de bord.

Intégration du Genie Agent

• **Intégration d'iframe Genie Agent :** les auteurs de Genie Agent peuvent générer le code d'intégration d'iframe à partir de la boîte de dialogue **Partager**. Les utilisateurs qui ont accès à l’application d’intégration peuvent envoyer des invites et afficher les résultats sans modifier la configuration de l’espace. Les administrateurs de Workspace doivent définir les surfaces autorisées pour l'intégration avant que les auteurs puissent partager un Genie Agent de cette manière. Consultez Intégrer un Genie Agent dans une application externe et Contrôler les destinations d'intégration autorisées.

Contrôlez les destinations d'intégration autorisées

L'intégration d'un tableau de bord ou d'un Genie Agent nécessite que le site web externe soit explicitement autorisé. Pour ajouter des destinations d'intégration autorisées à votre Workspace :

1. Cliquez sur votre nom d'utilisateur dans la barre supérieure du workspace Databricks et sélectionnez **Paramètres**.

2. Cliquez sur Sécurité .

3. Faites défiler jusqu’à la section Accès externe .

4. Dans la section Intégrer les tableaux de bord , utilisez le menu déroulant pour définir la politique d'intégration pour votre Workspace. Ce paramètre s'applique aux tableaux de bord et aux Agents Genie.

   Il existe trois options de politique :

   • **Autoriser** : les tableaux de bord et les agents Genie peuvent être intégrés dans n'importe quel domaine.
   • Autoriser les domaines approuvés : Les tableaux de bord et les Agents Genie ne peuvent être intégrés que dans les sites qui correspondent à la liste approuvée.
   • Refuser : Les tableaux de bord et les agents Genie ne peuvent pas être intégrés dans un domaine quelconque.

Si vous sélectionnez Autoriser les domaines approuvés , veuillez suivre les instructions suivantes pour gérer votre liste de domaines approuvés :

1. Cliquez sur Gérer à côté de Tableaux de bord intégrés .
2. Saisissez un domaine dans le champ de texte de la boîte de dialogue Approved domain . Cliquez sur Add domain après chaque entrée.
3. Cliquez sur Enregistrer .

remarque

Pour intégrer votre tableau de bord ou votre Genie Agent dans un site Google, vous devez autoriser plusieurs domaines appartenant à et utilisés par Google en plus de l’adresse associée à votre site particulier. Les sites requis sont :

• sites.google.com
• www.gstatic.com
• *.googleusercontent.com

Conseils pour définir les domaines et les routes approuvés

Pour spécifier les hôtes autorisés, utilisez la grammaire définie dans la documentation de la politique de sécurité du contenu du W3C. Les exemples de cette section illustrent certains modèles courants.

Autoriser les sous-domaines

Pour autoriser tous les sous-domaines pour un domaine donné, utilisez un symbole générique (*) avant le nom de domaine. Les exemples suivants utilisent *.databricks.com comme domaine d'échantillon.

• **Correspondances :** Tout sous-domaine

  • some.databricks.com
  • app.databricks.com
  • anything.databricks.com

• Ne correspond pas : Tout ce qui a un domaine différent.

  • another-databricks.com
  • app-databricks.com

Étapes suivantes

• Configurer l'intégration de base : Configurez l'intégration pour les utilisateurs avec des comptes Databricks qui peuvent se connecter directement pour afficher les tableaux de bord. Voir Intégration de base des tableaux de bord.
• Configurer l’embedding pour les utilisateurs externes : configurez l’embedding pour les utilisateurs externes afin de permettre aux utilisateurs sans compte Databricks d’accéder aux tableaux de bord via l’authentification Service Principal. Voir Qu’est-ce que l’embedding pour les utilisateurs externes ?.
• Intégrer un Genie Agent : Découvrez comment les auteurs d'espace peuvent générer du code d'intégration iframe et l'ajouter à une application externe. Voir Intégrer un Genie Agent dans une application externe.
• Créer et publier des tableaux de bord : Apprenez à créer, configurer et publier des tableaux de bord AI/BI pour l'intégration. Voir Tableaux de bord.
• **Gérer les paramètres de sécurité du Workspace :** Configurez des paramètres de sécurité et des contrôles d'accès supplémentaires pour votre Workspace. Voir Gérer votre workspace.