Comment ajouter Confluence à Dropbox Dash

Mis à jour Jun 03, 2025

Cet article décrit une fonctionnalité proposée à tous les clients Dropbox Dash.

Vous pouvez ajouter le compte Atlassian Confluence de votre entreprise à Dropbox Dash pour pouvoir accéder à vos pages, espaces et blogs et les rechercher par titre et métadonnées directement dans Dash. Vous pouvez également trouver des réponses aux questions sur votre contenu et utiliser Dash Assist pour discuter et créer du nouveau contenu pour les espaces, les pages et les blogs.

Remarques :

Dash ne peut prendre en charge que les comptes Confluence avec un seul site. Si vous avez plusieurs sites Confluence, Dash n’ingérera pas correctement vos données Confluence.
Si une page Confluence passe de l’état public à restreint, les utilisateurs qui y avaient accès peuvent toujours voir le contenu de cette page dans Dash jusqu’à la mise à jour des autorisations lors de la prochaine synchronisation complète, qui a généralement lieu dans les 24 heures.

Présentation de la configuration

Étape 1 : créez un compte de service administrateur avec le rôle Administrateur d’organisation dans Confluence.

Étape 2 : ajoutez Confluence à Dash à l’aide de l’une des deux méthodes d’authentification prises en charge. Découvrez comment sélectionner la bonne méthode pour votre équipe.

Méthode de la clé API
Méthode OAuth

Comment créer un compte de service administrateur dans Confluence

Pour ajouter Confluence à Dash, un administrateur Confluence doit authentifier et autoriser une intégration au niveau de l’entreprise entre Confluence et Dash. Pour améliorer la sécurité et éviter les problèmes liés à l’intégration de Confluence et de Dash (par exemple, si un administrateur quitte l’entreprise), il est recommandé de créer un compte de service administrateur non humain dans Confluence pour cette intégration.

Remarques :

Le nom de compte de service recommandé est « svc-dropboxdash-atlassian-confluence ».
Avant de créer un compte Confluence pour le compte de service utilisé avec Dash, assurez-vous qu’il existe une adresse e-mail pour « svc-dropboxdash-atlassian-confluence », comme « svc-dropboxdash-atlassian-confluence@nom_domaine_entreprise.com ». Cette adresse e-mail sera utilisée pour se connecter et recevoir des messages afin de terminer la configuration du compte Dropbox.
En savoir plus sur les conventions et recommandations d’appellation des comptes de service.

Pour créer un compte de service administrateur dans Confluence, vous devez :

Inviter un compte de service sur Confluence.
- Effectuez cette étape si votre compte de service n’est pas automatiquement ajouté à votre site Confluence. S’il est ajouté automatiquement, passez à l’étape 2.
Ajouter le rôle d’administrateur de l’organisation au compte de service.

Comment inviter un compte de service sur Confluence

Remarques :

Si le compte de service que vous avez créé n’est pas automatiquement ajouté à votre site Confluence, suivez ces étapes.
Elles peuvent différer légèrement de ce que les administrateurs voient dans la vue Administration d’Atlassian, en fonction de votre version d’Atlassian. En savoir plus sur l’invitation d’utilisateurs à partir de l’administration Atlassian.

Connectez-vous à l’administration Atlassian en utilisant vos identifiants d’administrateur.
Cliquez sur Répertoire.
Cliquez sur Inviter des utilisateurs.
Saisissez l’adresse e-mail de l’utilisateur du compte de service dans le champ Inviter par adresse e-mail….
Sélectionnez l’accès au produit : Confluence Software
Cliquez sur Inviter des utilisateurs.
- Vous serez redirigé vers la page d’administration Atlassian pour les utilisateurs et devriez voir « svc-dropboxdash-atlassian-confluence » en tant qu’utilisateur invité.
Ouvrez le compte de messagerie de l’utilisateur « svc-dropboxdash-atlassian-confluence » et recherchez l’invitation à rejoindre Confluence.
Cliquez sur Accepter l’invitation.
Dans la fenêtre contextuelle, saisissez « svc-dropboxdash-atlassian-confluence » dans le champ Nom complet.
Saisissez un nouveau mot de passe dans le champ Mot de passe.
- Notez le mot de passe dans un endroit sûr, comme votre coffre-fort de mots de passe.
Cliquez sur Continuer.
Il vous sera demandé de sélectionner le rôle qui décrit le mieux le travail de votre équipe. Sélectionnez une option appropriée dans le menu déroulant, puis cliquez sur Terminer.

Remarque : l’étendue d’accès et de contrôle du compte de service doit être limitée à Confluence. Si vous avez plusieurs produits Atlassian, vous devez définir les rôles de produit pour ceux qui ne sont pas spécifiques à Confluence sur Aucun.

Comment ajouter le rôle d’administrateur de l’organisation au compte de service

Connectez-vous à l’administration Atlassian en utilisant vos identifiants d’administrateur.
Cliquez sur Répertoire > Utilisateurs.
Recherchez le compte de service, puis cliquez sur son avatar ou sur Afficher les détails.
Cliquez sur Plus d’actions () en haut de la page, puis sélectionnez Attribuer un rôle d’administrateur de l’organisation.
Cliquez sur Attribuer le rôle pour confirmer.

Une fois que vous avez configuré votre compte de service, vous devez choisir la méthode d’authentification que vous souhaitez utiliser pour ajouter Confluence à Dash.

Comment sélectionner la bonne méthode d’authentification

La méthode de la clé API n’est disponible que si votre site Atlassian a été migré vers la nouvelle expérience de gestion des utilisateurs. Découvrez comment vérifier si vous utilisez la nouvelle expérience de gestion des utilisateurs.
- Remarque : si vous n’avez pas effectué la migration, contactez l’assistance Atlassian pour plus d’informations.
Si votre site n’a pas été migré vers la nouvelle expérience de gestion des utilisateurs d’Atlassian, vous devez utiliser la méthode OAuth.
- Remarque : vous devez définir la visibilité par défaut de l’e-mail dans vos paramètres sur public pour utiliser OAuth. Découvrez comment configurer la confidentialité de votre adresse e-mail. Il s’agit d’une exigence pour les applications installées (comme Dash) afin d’accéder aux données d’autorisation.

Méthode 1 : méthode de la clé API

Remarque : les clés API sont valables pendant un an par défaut. Vous pourriez devoir les renouveler et rétablir la connexion Dash après cette période.

Pour utiliser cette méthode d’authentification, créez une clé API et une clé API d’organisation :

Découvrez comment créer une clé API.
Découvrez comment créer une clé API d’organisation.
- Sélectionnez les champs d’application suivants lors de la création d’une clé API d’organisation. En savoir plus sur les champs d’application disponibles.

Champ d’application	Description	Documentation
read:classification-levels:admin	Lire les niveaux de classification	Obtenir tous les niveaux de classification par orgId, Obtenir un niveau de classification
read:domains:admin	Lire les domaines	API de domaines
read:policies:admin	Lire les politiques	Obtenir une politique unique, Obtenir la liste des politiques, Valider une politique
read:tokens:admin	Lire les clés et les jetons API	Obtenir tous les jetons API dans une organisation, Obtenir le nombre de jetons API dans une organisation, Obtenir le nombre de clés API dans une organisation, Obtenir toutes les clés API dans une organisation

Ajouter Confluence à Dash

Connectez-vous à dash.ai avec vos identifiants d’administrateur.
Cliquez sur votre avatar (votre photo de profil ou vos initiales) en bas à gauche.
Sélectionnez Interface d’administration.
Cliquez sur Dash dans la barre latérale de gauche.
Cliquez sur Applications.
Cliquez sur l’onglet Plus d’applications.
Cliquez sur Ajouter à droite de Confluence.
Sélectionnez Clé API.
Saisissez le sous-domaine :
- Le sous-domaine est l’URL de votre site Confluence sans https:// (par exemple, exempleequipe1.atlassian.net)
Saisissez la clé API générée dans la section ci-dessus.
Saisissez l’adresse e-mail du compte de service que vous avez créé dans la section précédente.
Saisissez la clé API de l’organisation générée dans la section précédente.
Cliquez sur Suivant.
Cliquez sur OK.
Cliquez sur l’onglet Vos applications.

Vous devriez maintenant voir Confluence.

Méthode 2 : méthode OAuth

Remarques :

Pour configurer Confluence à l’aide d’OAuth, vous devez définir la visibilité par défaut de l’e-mail dans vos paramètres sur public. Découvrez comment configurer la confidentialité de votre adresse e-mail et pourquoi cette opération est sécurisée. Il s’agit d’une exigence pour les applications installées (comme Dash) afin d’accéder aux données d’autorisation.
Les autorisations sur les données ingérées peuvent ne pas être complètes avec la méthode OAuth si la visibilité par défaut de l’e-mail n’est pas définie sur public ou si des utilisateurs individuels remplacent les paramètres de visibilité de l’e-mail sur leur compte Atlassian.
Si vous choisissez d’ajouter Confluence à Dash à l’aide de la méthode OAuth, vous devez accorder les autorisations d’API suivantes :
- Accéder au contenu de Confluence et le synchroniser, même lorsque vous n’êtes pas en ligne : cette autorisation est nécessaire pour ingérer et maintenir à jour le contenu de la page Confluence, y compris lorsque vous n’êtes pas connecté activement.
- Rechercher et afficher un aperçu du contenu de Confluence : cette autorisation active la fonctionnalité de recherche et affiche les aperçus, les résumés et les métadonnées (comme les dernières informations mises à jour) dans les résultats.
- Afficher les métadonnées au niveau de l’espace et de la page : cette autorisation est utilisée pour afficher l’espace auquel une page appartient et les informations associées au niveau de l’espace.
- Respecter les autorisations des utilisateurs et des groupes : ces autorisations garantissent que seuls les utilisateurs disposant des droits d’accès appropriés peuvent consulter certains contenus, en fonction de leur identité et de leur adhésion à un groupe.
- Suivre les modifications d’autorisation pour que les résultats restent exacts : cette autorisation permet à Dash de détecter les modifications d’accès au contenu, de sorte que le contenu obsolète est supprimé de la recherche.
- Accéder aux tâches et aux propriétés personnalisées dans Confluence : cette autorisation permet d’ingérer des éléments spécifiques à Confluence, tels que des tâches ou des propriétés au niveau de la page que votre organisation peut utiliser.

Ajouter Confluence à Dash

Connectez-vous à dash.ai avec vos identifiants d’administrateur.
Cliquez sur votre avatar (votre photo de profil ou vos initiales) en bas à gauche.
Sélectionnez Interface d’administration.
Cliquez sur Dash dans la barre latérale de gauche.
Cliquez sur Applications.
Cliquez sur l’onglet Plus d’applications.
Cliquez sur Ajouter à droite de Confluence.
Sélectionnez OAuth, puis cliquez sur Démarrer.
Cliquez sur Suivant.
Suivez les étapes de connexion Atlassian avec votre compte de service svc-dropboxdash-confluence, puis cliquez sur Accepter.
- Remarque : si vous avez besoin d’une authentification multifacteur (MFA) pour les comptes de votre environnement, il se peut que vous soyez invité à fournir une authentification supplémentaire associée au compte de service.
Cliquez sur OK.
Cliquez sur l’onglet Vos applications.