Comment connecter GitHub à Dropbox Dash

Pour accéder à votre contenu GitHub et le rechercher directement dans Dash, vous pouvez ajouter votre compte GitHub à Dropbox Dash. 

L’authentification OAuth est nécessaire pour garantir que Dash ne récupère que les informations pertinentes pour vos données, vous donnant ainsi un contrôle total sur ce à quoi Dash peut accéder. Dash respecte scrupuleusement le modèle OAuth, ce qui signifie qu’il n’accède qu’aux données auxquelles vous avez spécifiquement autorisé l’accès.

Configuration requise

Pour ajouter GitHub à Dropbox Dash, assurez-vous de répondre aux exigences suivantes :

• Approbation de l’administrateur : l’application Dash doit être installée sur votre ou vos organisations GitHub et activée par votre administrateur dans Dash.
  •  Si GitHub ne figure pas dans vos applications ou si vous ne voyez pas les résultats d’un dépôt spécifique, contactez votre administrateur.
• Autorisation : vous devez autoriser Dash dans GitHub.
• Compte actif : vous devez disposer d’un compte actif sur GitHub.

Fonctionnalités d’intégration

Pour GitHub, Dash collecte les informations suivantes : 

• Dépôts : Dash recueille des informations comme le titre, le contenu et l’horodatage, afin de pouvoir rechercher ces éléments.
• Labels : Dash recueille le nom des labels pour améliorer les fonctionnalités de recherche.
• Membres : Dash recueille le nom des membres pour améliorer les fonctionnalités de recherche avec les données des personnes.
• Pages : Dash recueille le titre et le contenu, afin de pouvoir rechercher ces éléments et améliorer les fonctionnalités de recherche.
• Pull Requests : Dash recueille des informations comme le titre, le contenu et l’horodatage, afin de pouvoir rechercher ces éléments.
• Sorties : Dash recueille le nom et le contenu des sorties de nouvelles versions, afin de pouvoir rechercher ces éléments.
• Tags : Dash recueille le nom des tags pour améliorer les fonctionnalités de recherche.

Autorisations de l’API

Lorsque vous ajoutez Github à Dropbox Dash, ce dernier demande les autorisations suivantes :

•  Vérifier votre identité GitHub : permet à Dash d’accéder à votre profil public GitHub. Cette autorisation est requise par GitHub pour pouvoir s’intégrer à Dash.
• Savoir à quelles ressources vous pouvez accéder : permet à Dash de déterminer les ressources auxquelles vous pouvez accéder et auxquelles l’application peut également accéder. Dash peut ainsi s’assurer que vous pouvez accéder au contenu approprié sur GitHub. Cette autorisation est requise par GitHub pour pouvoir s’intégrer à Dash.
• Agir en votre nom : requis par GitHub pour pouvoir s’intégrer à Dash.

En savoir plus sur l’autorisation des applications GitHub.

Fonctionnement de la synchronisation de contenu

• La synchronisation du contenu démarre dès que vous vous connectez. La première synchronisation peut prendre plusieurs heures, mais vous pouvez commencer à effectuer des recherches pendant qu’elle est en cours.
• Dash effectue une synchronisation complète de votre contenu GitHub toutes les 24 heures.

Comment ajouter votre compte GitHub à Dropbox Dash ?

Pour connecter GitHub à Dropbox Dash :

1. Connectez-vous à dash.ai.
2. Cliquez sur Applications en bas de la barre latérale gauche.
3. Localisez GitHub dans la liste des applications.
4. Cliquez sur ① (ajouter) à droite de GitHub.
5. Saisissez vos identifiants de connexion ou sélectionnez un compte à connecter à Dash.
6. Vérifiez les autorisations demandées, puis cliquez sur Autoriser.

Comment supprimer votre compte GitHub de Dropbox Dash

1. Connectez-vous à dash.ai.
2. Cliquez sur Applications en bas de la barre latérale gauche.
3. Localisez GitHub dans la liste des applications.
4. Cliquez sur ① (plus d’options) à droite de GitHub.
5. Cliquez sur Dissocier.
6. Cliquez sur Dissocier dans la fenêtre contextuelle.

• Remarque : vous pouvez reconnecter l’application à tout moment.

Comment vérifier vos applications connectées ?

Pour vérifier les applications connectées à Dropbox Dash :

1. Connectez-vous à dash.ai.
2. Cliquez sur Applications en bas de la barre latérale gauche.

Vous verrez une liste des applications que vous avez ajoutées dans la section Ajoutées, ainsi que leur état de connexion.

Administrateurs : comment ajouter GitHub pour votre équipe ?

Étape 1 : installez l’application Dash sur la ou les organisations GitHub de votre choix.

Étape 2 : activez GitHub dans l’interface d’administration de Dash.

Étape 1 : comment installer l’application Dash sur votre ou vos organisations GitHub

1. Connectez-vous à GitHub pour installer l’application Dash sur votre ou vos organisations.
   • Utilisez ce lien : Installer l’application Dash.
   • Votre nom d’utilisateur doit être votre rôle de propriétaire de l’organisation.
2. Si vous avez plusieurs organisations, sélectionnez celle à laquelle vous souhaitez que Dash accède.
   • Si vous souhaitez que les utilisateurs de Dash puissent ingérer des données à partir de dépôts dans différentes organisations, vous devez installer l’application dans chaque organisation.
   • Assurez-vous d’être connecté avec votre rôle de propriétaire de l’organisation, car il se peut que l’on vous demande de vous reconnecter. 
3. Sélectionnez les dépôts auxquels Dash peut accéder : Tous les dépôts ou Uniquement les dépôts sélectionnés. Si vous choisissez Uniquement les dépôts sélectionnés, choisissez les dépôts dans le menu déroulant.

4. Cliquez sur Installer et autoriser pour ajouter Dash à votre ou vos organisations GitHub.

• Même si vous installez notre application GitHub avec succès, GitHub vous redirigera vers une page « Échec de la connexion », car GitHub utilise la même URL de redirection après l’installation, même en cas de succès de l’opération. 
• Si vous êtes propriétaire d’une organisation et que vous venez de terminer l’installation, vous pouvez ignorer le message en toute sécurité.

5. Pour confirmer que Dash a été installé avec succès, accédez à Applications tierces, puis à Applications GitHub. 

Étape 2 : comment activer GitHub dans l’interface d’administration de Dash

1. Connectez-vous à dash.ai avec vos identifiants d’administrateur.
2. Cliquez sur votre avatar (votre photo de profil ou vos initiales) en bas à gauche.
3. Sélectionnez Interface d’administration.
4. Cliquez sur ①Applications.
5. Cliquez sur l’onglet Plus d’applications. 
6. Cliquez sur Ajouter à droite de GitHub.
7. Cliquez sur Activer GitHub dans la fenêtre contextuelle.

Vous verrez une notification indiquant que GitHub a été activé.