Utiliser l'application GitHub dans Google Chat

Avec l'application GitHub, vous pouvez recevoir des notifications sur les événements GitHub, comme les problèmes, demandes d'extraction et commentaires.

Avant de commencer

Pour utiliser l'application GitHub dans Chat :

• Vous devez obtenir l'autorisation de votre administrateur Google Workspace pour installer des applications.
• Ajoutez l'application à Chat. Découvrez comment rechercher des applications et les ajouter à Chat.
• Vous devez disposer d'un compte GitHub.
• Vous devez installer l'application Google Chat pour votre dépôt GitHub.

Comprendre les mécanismes d'authentification des applications GitHub et OAuth

Cette section décrit les particularités et les modèles opérationnels des applications GitHub et OAuth, qui constituent les principaux mécanismes permettant aux services tiers d'intégrer les ressources GitHub et d'y accéder. Il est essentiel de bien comprendre ces différences pour maintenir un niveau de sécurité optimal dans une organisation.

1. Analyse comparative : principales différences

Les principales différences entre les deux modèles résident dans l'identité utilisée pour l'accès (le principal) et le mécanisme qui régit l'autorisation des ressources.

Attribut	Application GitHub (connexion recommandée)	Application OAuth (ancienne connexion)
Identité du principal	Agit en tant qu'identité d'application indépendante, distincte de tout utilisateur, ou au nom de l'utilisateur accordant l'autorisation, selon le cas d'utilisation.	Agit au nom de l'utilisateur accordant l'autorisation, en héritant de ses droits d'accès.
Modèle d'autorisation	Autorisations précises (recommandé) : utilise le principe du moindre privilège, qui permet d'accéder à des dépôts et à des types de ressources spécifiques. Par exemple : accès en lecture aux métadonnées uniquement.	Niveaux d'accès étendus : l'accès est défini par des niveaux étendus, comme l'octroi de l'accès à toutes les ressources visibles par l'utilisateur accordant l'autorisation.
Durée de validité des identifiants	Jetons à durée de vie limitée : les jetons d'accès ont une durée de vie limitée (généralement une heure) et doivent être renouvelés fréquemment, ce qui réduit considérablement les risques en cas de compromission.	Jetons de longue durée : les jetons d'accès restent actifs jusqu'à ce qu'ils soient révoqués manuellement par l'utilisateur, ce qui représente un risque d'exposition prolongée.
Exigences concernant l'installation	L'application doit être installée par un administrateur ou un propriétaire de l'organisation, ce qui permet d'établir un lien formel avec le compte ou l'organisation. L'utilisateur doit autoriser l'application à agir en son nom.	Un utilisateur individuel doit autoriser l'application en associant l'accès directement à son identité.

Pour obtenir une documentation plus complète, consultez Différences entre les applications GitHub et les applications OAuth.

2. Recommandation

Conformément aux bonnes pratiques de sécurité, le mécanisme d'authentification de l'application GitHub est recommandé pour toutes les intégrations tierces et organisationnelles. Ce modèle applique le principe du moindre privilège et utilise des identifiants robustes à durée limitée, ce qui permet de maintenir un niveau de sécurité et de stabilité opérationnelle plus élevé que le modèle d'autorité déléguée des applications OAuth.

Installez l'application Google Chat pour les dépôts GitHub.

Configurer l'application GitHub dans Chat

1. Ouvrez Chat.
2. Ouvrez un message privé avec l'application ou accédez à un espace contenant l'application.
3. Pour ouvrir la fenêtre de configuration, cliquez sur Se connecter.
4. Cliquez sur Configurer l'accès Se connecter à GitHub.
5. Suivez la procédure de connexion, puis fermez le pop-up.
6. Pour mettre à jour la boîte de dialogue Chat, cliquez sur Actualiser.
7. Sous Ajouter des dépôts, saisissez le nom du dépôt GitHub pour lequel vous souhaitez recevoir des notifications.
8. Cochez les cases correspondant aux événements pour lesquels vous souhaitez recevoir des notifications.
9. Cliquez sur Enregistrer.

Remarque : Vous devez configurer les notifications dans chaque espace auquel vous ajoutez l'application. L'application envoie des notifications à tous les espaces dont elle est membre.

Migrer d'une application OAuth (ancienne connexion) vers une application GitHub (recommandé)

Pour migrer votre connexion actuelle de l'ancienne méthode d'authentification de l'application OAuth vers la méthode recommandée de l'application GitHub :

1. Ouvrez Chat.
2. Ouvrez un message privé ou un espace avec l'application GitHub.
3. Dans le champ du message, cliquez sur Outils Google Workspace .
4. Dans la liste des commandes, sélectionnez GitHub Reauthorize (Réautorisation GitHub).
5. Pour procéder à la migration et à la réautorisation, suivez les instructions à l'écran dans la boîte de dialogue Chat.

Utiliser l'application GitHub dans des espaces

Pour utiliser l'application dans les espaces, vous devez utiliser @mention ou /mention dans chaque message et dans les réponses aux messages de l'application.

Utiliser @mention ou /mention confirme que vous avez envoyé le message à l'application et non aux autres membres de l'espace.

1. Ouvrez l'application Chat .
2. Dans un espace, saisissez @github ou /github suivi de la commande.
   • Lorsque vous mentionnez @github ou /github, le message est envoyé à l'application et non aux autres membres de l'espace.

Modifier les paramètres de l'application

Dans les espaces, seule la personne qui a ajouté l'application peut modifier les paramètres.

1. Ouvrez Chat.
2. Ouvrez un message privé avec l'application ou accédez à un espace contenant l'application.
3. Pour ouvrir les paramètres actuels de l'application, saisissez /github_settings.
4. Modifiez les paramètres si nécessaire.
5. Cliquez sur Enregistrer.

Si vous supprimez l'application d'un espace, les paramètres de l'application sont supprimés.

En savoir plus sur les commandes de l'application GitHub dans Chat

Dans le champ de message d'un message privé ou d'un espace avec l'application GitHub dans Chat, vous pouvez utiliser :

• Des commandes à barre oblique :
  • /github_settings : ouvre la boîte de dialogue des paramètres.
  • /github_reminders : configurez et modifiez des rappels planifiés pour les demandes d'extraction ouvertes personnelles ou d'équipe.
  • /github_subscribe : permet de s'abonner à un <repoURL> ou <owner/repo> GitHub.
  • /github_openIssue : ouvre un nouveau problème GitHub.
  • /github_logout : vous déconnecte de votre compte GitHub.
  • /github_help : affiche le message d'aide.
  • /github_feedback : envoyez des commentaires sur l'application GitHub.
• Des commandes rapides : pour accéder aux commandes rapides, cliquez sur Outils Google Workspace .
  • GitHub Connect (Connexion GitHub) : affiche un message avec les options "Sign in" (Connexion) et "Legacy Sign in" (Ancienne connexion).
  • GitHub Reauthorize (Réautorisation GitHub) : vous permet de passer à une nouvelle méthode de connexion.

Pour obtenir la liste complète des commandes compatibles :

1. Sur votre ordinateur, ouvrez Chat.
2. Ouvrez un message privé ou accédez à un espace où l'application GitHub est installée.
3. Saisissez /github_help.

Résoudre les problèmes liés à l'application GitHub dans Chat

Si un message d'erreur s'affiche lorsque vous vous abonnez aux notifications en temps réel

Application GitHub

Pour configurer les notifications en temps réel dans des espaces :

1. Dans votre navigateur, accédez aux paramètres de votre profil GitHub.
2. Sous "Intégrations", cliquez sur Applications Applications OAuth autorisées.
   • Une fois que vous avez associé l'application GitHub dans Google Chat, Google Chat s'affiche dans la liste des applications autorisées.
3. Installez l'application Google Chat pour le dépôt GitHub.
   • Vous pouvez également demander au propriétaire de l'organisation ou du dépôt de procéder à l'installation.
4. Attendez la fin de l'installation.
5. Dans Google Chat, ouvrez un message privé ou un espace contenant l'application GitHub.
6. Dans le champ du message, saisissez /github_subscribe [organisation/dépôt] ou /github_settings pour créer un abonnement.

Application OAuth

Pour configurer les notifications en temps réel dans des espaces, vous devez :

• être propriétaire de l'organisation du dépôt proposé.
• Autorisez l'application dans l'organisation GitHub.
  1. Dans votre navigateur, accédez aux paramètres de votre profil GitHub.
  2. Sous "Intégrations", cliquez sur Applications Applications OAuth autorisées.
     • Une fois que vous avez associé l'application GitHub dans Google Chat, "Google Chat" apparaît dans la liste des applications autorisées.
  3. Accordez à l'application l'accès à l'organisation à laquelle vous souhaitez accéder.

Si vous recevez trop de notifications de l'application GitHub

1. Dans le champ du message, saisissez /github_settings.
2. Pour modifier les paramètres de notification de votre dépôt, cliquez sur Paramètres de notification.
3. Pour filtrer les notifications, cliquez sur la flèche vers le bas à côté de chaque type de notification.
   • Cela affiche des options supplémentaires pour filtrer les notifications.
4. Cochez les cases correspondant aux notifications souhaitées.
5. Cliquez sur Enregistrer.

Si vous n'êtes pas @mentionné dans les rappels planifiés

Pour être mentionné dans les rappels planifiés, vous devez avoir associé votre compte Google Chat à votre compte GitHub.

1. Dans le champ du message, saisissez /github_settings.
2. Pour associer votre compte :
   1. Dans le pop-up, cliquez sur Configurer l'accès Se connecter à GitHub.
   2. Connectez-vous à votre compte GitHub.
   3. Autorisez l'application.
3. Dans le message que vous recevez de l'application GitHub, sélectionnez Planifier des rappels pour votre équipe.
4. Dans le pop-up :
   1. Cliquez sur Créer un rappel.
   2. Configurez les paramètres des rappels.
   3. Cliquez sur Enregistrer.

Si vous ne recevez pas de rappels avec l'application GitHub

Dans le dépôt à partir duquel vous souhaitez recevoir des rappels, vérifiez l'installation de l'application Google Chat pour GitHub.

_{Google, Google Workspace et les marques et logos associés sont des marques de Google LLC. Tous les autres noms de sociétés et de produits sont des marques des sociétés auxquelles ils sont associés.}