Configuration des notifications

Options de remise de notifications

Vous pouvez recevoir des notifications pour l’activité sur votre entreprise aux emplacements suivants.

• Boîte de réception des notifications dans l’interface web votre entreprise
• Un client e-mail qui utilise une adresse e-mail vérifiée, qui peut également se synchroniser avec la boîte de réception des notifications sur votre entreprise

Avantages de la boîte de réception de notifications

La boîte de réception des notifications sur votre entreprise inclut des options de triage conçues spécifiquement pour vos flux de notifications GitHub, y compris des options pour :

• Trier plusieurs notifications à la fois.
• Marquer les notifications terminées avec la mention Terminé et les supprimer de votre boîte de réception. Pour visualiser toutes vos notifications marquées Terminé, utilisez la requête is:done.
• Enregistrer une notification pour l’examiner ultérieurement. Les notifications enregistrées sont indiquées dans votre boîte de réception et sont conservées indéfiniment. Pour visualiser toutes vos notifications enregistrées, utilisez la requête is:saved.
• Se désinscrire et supprimer une notification de votre boîte de réception.
• Obtenir un aperçu du problème, de la demande de tirage ou de la discussion d’équipe d’où provient la notification sur votre entreprise à partir de la boîte de réception des notifications.
• Voir une des raisons les plus récentes pour laquelle vous recevez une notification dans votre boîte de réception avec une étiquette reasons.
• Créer des filtres personnalisés pour se concentrer sur différentes notifications quand vous le souhaitez.
• Regrouper des notifications dans votre boîte de réception en fonction du dépôt ou de la date pour obtenir une vue d’ensemble rapide avec moins de changements de contexte.

Avantages de l’utilisation d’un client de messagerie pour les notifications

L’un des avantages offerts par l’utilisation d’un client de messagerie est que toutes vos notifications peuvent être conservées indéfiniment, en fonction de la capacité de stockage de votre client de messagerie. Vos notifications de boîte de réception ne sont conservées que pendant cinq mois sur GitHub sauf si vous les avez marquées comme Enregistré. Les notifications Enregistré sont conservées indéfiniment. Pour plus d’informations sur la stratégie de rétention de votre boîte de réception, consultez « À propos des notifications ».

L’envoi de notifications à votre client de messagerie vous permet également de personnaliser votre boîte de réception en fonction des paramètres de votre client de messagerie, qui peuvent inclure des étiquettes personnalisées ou codées en couleur.

Les notifications par e-mail offrent également une flexibilité quant aux types de notifications que vous recevez, et vous permettent de choisir différentes adresses e-mail pour les mises à jour. Par exemple, vous pouvez envoyer certaines notifications pour un dépôt à une adresse e-mail personnelle vérifiée. Pour plus d’informations sur les options de personnalisation d’e-mail, consultez « Personnalisation de vos notifications par e-mail ».

À propos des notifications de participation et de surveillance

Lorsque vous surveillez un dépôt, vous vous abonnez aux mises à jour relatives à l’activité dans ce dépôt. De même, lorsque vous surveillez les discussions d’une équipe spécifique, vous vous abonnez à toutes les mises à jour de conversation sur la page de cette équipe. Pour plus d’informations, consultez « À propos des discussions d’équipe ».

Pour voir les dépôts que vous surveillez, accédez à votre page de surveillance. Pour plus d’informations, consultez « Gestion des abonnements pour l’activité sur GitHub ».

Configuration des notifications

Vous pouvez configurer des notifications pour un dépôt dans la page du dépôt ou dans votre page de surveillance.

À propos des notifications personnalisées

Vous pouvez personnaliser les notifications pour un dépôt. Par exemple, vous pouvez choisir d’être averti uniquement lorsque des mises à jour d’un ou plusieurs types d’événements (problèmes, demandes de tirage, mises en production, alertes de sécurité ou discussions) se produisent dans un dépôt, ou ignorer toutes les notifications d’un dépôt. Pour plus d’informations, consultez « Configuration de vos paramètres de surveillance pour un dépôt spécifique » ci-dessous.

Participation à des conversations

Chaque fois que vous commentez une conversation ou que quelqu’un @mentions votre nom d’utilisateur, vous participez à une conversation. Par défaut, vous êtes automatiquement abonné à une conversation lorsque vous y participez. Vous pouvez vous désabonner manuellement d’une conversation à laquelle vous avez participé en cliquant sur Se désabonner dans le problème ou la demande de tirage, ou via l’option Se désabonner dans la boîte de réception des notifications.

Pour les conversations que vous surveillez ou auxquelles vous participez, vous pouvez choisir si vous souhaitez recevoir des notifications par e-mail ou via la boîte de réception des notifications sur votre entreprise. Pour plus d’informations, consultez « Configuration des notifications ».

Par exemple :

• Si vous ne souhaitez pas que les notifications soient envoyées à votre e-mail, désélectionnez e-mail pour les notifications de participation et de surveillance.
• Si vous souhaitez recevoir des notifications par e-mail lorsque vous avez participé à une conversation, vous pouvez sélectionner e-mail sous « Participation ».

Si vous n’activez pas les notifications de participation ou de surveillance pour le web, votre boîte de réception de notifications n’aura aucune mise à jour.

Personnalisation de vos notifications par e-mail

Une fois que vous aurez activé les notifications par e-mail, votre entreprise vous enverra des notifications sous forme d’e-mails multipart contenant à la fois des copies HTML et en texte brut du contenu. Le contenu de notification par e-mail inclut tout Markdown, @mentionsemojis, lien de hachage et autres, qui apparaissent dans le contenu d’origine sur votre entreprise. Si vous souhaitez uniquement afficher le texte dans l’e-mail, vous pouvez configurer votre client de messagerie de façon à afficher uniquement la copie en texte brut.

Choisissez une adresse e-mail par défaut à laquelle vous souhaitez envoyer des mises à jour pour les conversations que vous surveillez ou auxquelles vous participez. Vous pouvez également spécifier pour quelle activité sur votre entreprise vous souhaitez recevoir des mises à jour à l’aide de votre adresse e-mail par défaut. Par exemple, choisissez si vous souhaitez recevoir des mises à jour à votre adresse e-mail par défaut pour les éléments suivants :

• Commentaires sur les problèmes et les demandes de tirage
• Révisions des demandes de tirage (pull requests)
• Poussées (push) de demandes de tirage
• Vos propres mises à jour, par exemple lorsque vous ouvrez, commentez ou fermez un problème ou une demande de tirage

En fonction de l’organisation propriétaire du dépôt, vous pouvez également envoyer des notifications à différentes adresses e-mail. Votre organisation peut exiger que l’adresse e-mail soit vérifiée pour un domaine spécifique. Pour plus d’informations, consultez « Configuration des notifications ».

Vous pouvez également envoyer des notifications pour un dépôt spécifique à une adresse e-mail. Pour plus d’informations, consultez « À propos des notifications par e-mail pour les envois (push) vers votre référentiel ».

Vous recevez uniquement des e-mails de notification si vous avez choisi de recevoir des notifications par e-mail dans vos paramètres de notification.

Filtrage des notifications par e-mail

Chaque notification par e-mail envoyée par votre entreprise contient des informations d’en-tête. Les informations d’en-tête de chaque e-mail sont cohérentes. Vous pouvez donc les utiliser dans votre client de messagerie pour filtrer ou transférer toutes les notifications GitHub ou certains types de notifications GitHub.

Si vous pensez recevoir des notifications qui ne vous appartiennent pas, examinez les en-têtes X-GitHub-Recipient et X-GitHub-Recipient-Address. Ces en-têtes indiquent qui est le destinataire prévu. En fonction de votre configuration de messagerie, vous pouvez recevoir des notifications destinées à un autre utilisateur.

Les notifications par e-mail de votre entreprise contiennent les informations d’en-tête suivantes :

En-tête	Information
Adresse From	Cette adresse sera toujours « l’adresse e-mail sans réponse configurée par votre administrateur de site ».
ChampTo	Ce champ se connecte directement au thread.
Adresse Cc	GitHub AE vous Cc si vous êtes abonné à une conversation. La deuxième adresse e-mail Cc correspond à la raison de notification. Le suffixe de ces raisons de notification est basé sur l’adresse e-mail no-reply configurée par l’administrateur de votre site. Les raisons de notification possibles sont les suivantes : assign : vous avez été affecté à un problème ou à une demande de tirage. author : vous avez créé un problème ou une demande de tirage. ci_activity : une exécution de flux de travail GitHub Actions que vous avez déclenchée a été terminée. comment : vous avez commenté un problème ou une demande de tirage. manual : une mise à jour a été effectuée à un problème ou une demande de tirage auquel vous vous êtes abonné manuellement. mention : vous avez été mentionné dans un problème ou une demande de tirage. push : quelqu’un a commité dans une demande de tirage à laquelle vous êtes abonné. review_requested : vous ou une équipe dont vous êtes membre avez été invité à réviser une demande de tirage. security_alert : GitHub a détecté une vulnérabilité dans un dépôt pour lequel vous recevez des alertes. state_change : une demande de tirage ou un problème auquel vous êtes abonné a été fermé ou ouvert. subscribed : une mise à jour a eu lieu dans un dépôt que vous surveillez. team_mention : une équipe dont vous êtes membre a été mentionnée dans un problème ou une demande de tirage. your_activity : vous avez ouvert, commenté ou fermé un problème ou une demande de tirage.
Champmailing list	Ce champ identifie le nom du dépôt et son propriétaire. Le format de cette adresse est toujours <repository name>.<repository owner>.[hostname].
ChampX-GitHub-Severity	Les notifications par e-mail des Dependabot alerts qui affectent un ou plusieurs dépôts incluent le champ d’en-tête X-GitHub-Severity. Vous pouvez utiliser la valeur du champ d’en-tête X-GitHub-Severity pour filtrer les notifications par e-mail des Dependabot alerts. Les niveaux de gravité possibles sont les suivants : low moderate high critical Pour plus d’informations, consultez « À propos des alertes Dependabot ».

Choix de vos paramètres de notification

1. Dans le coin supérieur droit de n’importe quelle page, cliquez sur . 1. Dans la barre latérale à gauche, sous la liste des dépôts, utilisez la liste déroulante « Gérer les notifications » pour cliquer sur Paramètres de notification.
2. Dans la page des paramètres de notifications, choisissez la façon dont vous recevez des notifications quand :
   • Des mises à jour ont lieu dans les dépôts ou les discussions d’équipe que vous surveillez ou dans une conversation à laquelle vous participez. Pour plus d’informations, consultez « À propos des notifications de participation et de surveillance ».
   • Vous accédez à un nouveau dépôt ou vous avez rejoint une nouvelle équipe. Pour plus d’informations, consultez Surveillance automatique.
   • Il existe de nouvelles Dependabot alerts dans votre dépôt. Pour plus d’informations, consultez « Options de notification des Dependabot alerts ».
   • De nouvelles clés de déploiement sont ajoutées à des dépôts appartenant à des organisations dont vous êtes propriétaire. Pour plus d’informations, consultez « Options de notification des alertes d’organisation ».

Surveillance automatique

Par défaut, chaque fois que l’accès à un nouveau dépôt vous est accordé, vous commencez automatiquement à surveiller ce dépôt. Chaque fois que vous rejoignez une nouvelle équipe, vous êtes automatiquement abonné aux mises à jour et vous recevez des notifications lorsque cette équipe est @mentioned. Si vous ne souhaitez pas être abonné automatiquement, vous pouvez désélectionner les options de surveillance automatique dans vos paramètres de notification.

Si l’option « Surveiller automatiquement les dépôts » est désactivée, vous ne surveillerez pas automatiquement vos propres dépôts. Vous devez accéder à votre page de dépôt et choisir l’option de surveillance.

Pour plus d’informations, consultez « Configuration des notifications ».

Configuration de vos paramètres de surveillance pour un dépôt spécifique

Vous pouvez choisir de surveiller ou non un dépôt spécifique. Vous pouvez également choisir d’être notifié uniquement de certains types d’événements tels que problèmes, demandes de tirage, mises en production, alertes de sécurité ou discussions (si c’est activé pour le dépôt) ou d’ignorer complètement un dépôt.

1. Dans votre entreprise, accédez à la page principale du dépôt.

2. Dans le coin supérieur droit, sélectionnez le menu déroulant « Watch » pour cliquer sur une option de surveillance.

   L’option Personnalisé vous permet de personnaliser davantage les notifications afin d’être averti uniquement lorsque des événements spécifiques se produisent dans le dépôt, en plus de la participation et de @mentions. Si vous sélectionnez « Problèmes », vous serez averti et abonné aux mises à jour de chaque problème (y compris ceux qui existaient avant la sélection de cette option) dans le dépôt. Si vous êtes @mentioned dans une demande de tirage dans ce dépôt, vous recevrez également des notifications pour cela, et vous serez abonné aux mises à jour de cette demande de tirage spécifique, en plus d’être averti des problèmes.

Choix de l’emplacement où les notifications par e-mail de votre organisation sont envoyées

Si vous appartenez à une organisation, vous pouvez choisir le compte e-mail auquel vous souhaitez envoyer les notifications pour l’activité de l’organisation. Par exemple, si vous appartenez à une organisation pour le travail, vous souhaiterez peut-être que vos notifications soient envoyées à votre adresse e-mail professionnelle plutôt qu’à votre adresse personnelle.

Vous recevez uniquement des e-mails de notification si vous avez choisi de recevoir des notifications par e-mail dans vos paramètres de notification.

1. Dans le coin supérieur droit de n’importe quelle page, cliquez sur . 1. Dans la barre latérale à gauche, sous la liste des dépôts, utilisez la liste déroulante « Gérer les notifications » pour cliquer sur Paramètres de notification.

2. Sous « E-mail de notification par défaut », sélectionnez l’adresse e-mail à laquelle vous souhaitez recevoir les notifications.

   

3. Cliquez sur Enregistrer.

Personnalisation des routes de messagerie par organisation

Si vous êtes membre de plusieurs organisations, vous pouvez configurer chacune d’elles de façon à envoyer des notifications à n’importe laquelle de les adresses e-mail de votre compte.

1. Dans le coin supérieur droit de n’importe quelle page, cliquez sur . 1. Dans la barre latérale à gauche, sous la liste des dépôts, utilisez la liste déroulante « Gérer les notifications » pour cliquer sur Paramètres de notification.

2. Sous « Routage personnalisé », recherchez le nom de votre organisation dans la liste.

   

3. Cliquez sur Modifier en regard de l’adresse e-mail que vous souhaitez modifier.

   

4. Sélectionnez l’une de vos adresses e-mail vérifiées, puis cliquez sur Enregistrer.

   

Options de notification des Dependabot alerts

Les options de notification pour votre compte d’utilisateur sont disponibles sur https://github.com/settings/notifications. Vous pouvez configurer les paramètres de notification pour chaque dépôt, dans les paramètres de surveillance du dépôt.

Vous pouvez choisir la méthode de remise des notifications, ainsi que la fréquence à laquelle elles sont envoyées. Par défaut, si le propriétaire de votre entreprise a configuré l-e-mail pour les notifications sur votre instance, vous recevez des Dependabot alerts:

• Dans votre boîte de réception : sous forme de notifications web. Une notification web est envoyée lorsque Dependabot est activé pour un dépôt, lorsqu’un nouveau fichier manifeste est commité dans le dépôt et lorsqu’une nouvelle vulnérabilité avec un niveau de gravité critique ou élevé est détectée (option Sur GitHub ).
• Par e-mail : un e-mail est envoyé lorsque Dependabot est activé pour un dépôt, lorsqu’un nouveau fichier manifeste est commité dans le dépôt et lorsqu’une nouvelle vulnérabilité avec un niveau de gravité critique ou élevé est détectée (option E-mail).
• Dans l’interface utilisateur : un avertissement s’affiche dans les vues de fichiers et de code de votre dépôt s’il existe des dépendances non sécurisées (option Alerte d’interface utilisateur).
• Sur la ligne de commande : des avertissements s’affichent sous forme de rappels lorsque vous poussez (push) vers des dépôts avec des dépendances non sécurisées (option CLI).

Vous pouvez personnaliser la façon dont vous êtes averti concernant les Dependabot alerts. Par exemple, vous pouvez recevoir un e-mail de synthèse hebdomadaire récapitulant les alertes concernant jusqu’à 10 de vos dépôts à l’aide des options Envoyer par e-mail un résumé des vulnérabilités et Synthèse hebdomadaire des e-mails de sécurité.

Pour plus d’informations sur les méthodes de remise de notification disponibles, et pour obtenir des conseils sur l’optimisation de vos notifications pour Dependabot alerts, consultez « Configuration de notifications pour les alertes Dependabot ».

Options de notification des alertes d’organisation

Si vous êtes propriétaire d’une organisation, vous recevez des notifications par e-mail par défaut lorsque les membres de l’organisation ajoutent de nouvelles clés de déploiement aux dépôts au sein de l’organisation. Vous pouvez vous désabonner de ces notifications. Dans la page des paramètres de notification, sous « Alertes d’organisation », désélectionnez E-mail.