Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.
GitHub AE est actuellement en version limitée.

Configuration des notifications

Choisissez le type d’activité sur GitHub pour lequel vous voulez recevoir des notifications et comment vous voulez que ces mises à jour soient délivrées.

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

Conseil : si vous recevez des notifications par e-mail et web, vous pouvez synchroniser automatiquement leur état lu ou non lu afin que les notifications web soient automatiquement marquées comme lues une fois que vous avez lu les notifications par e-mail correspondantes. Pour activer cette synchronisation, votre client de messagerie doit pouvoir afficher les images depuis l’adresse e-mail no-replyde votreGitHub AE nom d’hôte.

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 ».

Capture d’écran des options de notifications de participation et de surveillance

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.

Remarque : Vous ne recevrez que des notifications par e-mail si la prise en charge des e-mails sortants est activée dans votre entreprise. Pour plus d’informations, contactez votre administrateur de site.

Conseil : si vous recevez des notifications par e-mail et web, vous pouvez synchroniser automatiquement leur état lu ou non lu afin que les notifications web soient automatiquement marquées comme lues une fois que vous avez lu les notifications par e-mail correspondantes. Pour activer cette synchronisation, votre client de messagerie doit pouvoir afficher les images depuis l’adresse e-mail no-replyde votreGitHub AE nom d’hôte.

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êteInformation
Adresse FromCette adresse sera toujours « l’adresse e-mail sans réponse configurée par votre administrateur de site ».
ChampToCe champ se connecte directement au thread.
Adresse CcGitHub 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 listCe 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-SeverityLes 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 . Notification indiquant tout message non lu 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. Capture d’écran de la page « Notifications ». Un menu déroulant intitulé « Gérer les notifications » est mis en évidence avec un encadré orange.
  2. Dans la page des paramètres de notifications, choisissez la façon dont vous recevez des notifications quand :

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.

Options de surveillance automatique

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. Options de surveillance dans un menu déroulant pour un dépôt

    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. Options de surveillance personnalisées dans un menu déroulant pour un dépôt 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 . Notification indiquant tout message non lu 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. Capture d’écran de la page « Notifications ». Un menu déroulant intitulé « Gérer les notifications » est mis en évidence avec un encadré orange.

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

    Capture d’écran de la liste déroulante d’adresse e-mail de notification par défaut

  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 . Notification indiquant tout message non lu 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. Capture d’écran de la page « Notifications ». Un menu déroulant intitulé « Gérer les notifications » est mis en évidence avec un encadré orange.

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

    Liste d’organisations et d’adresses e-mail

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

    Modification des adresses e-mail d’une organisation

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

    Changement de votre adresse e-mail par organisation

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).

Remarque : les notifications par e-mail et web sont les suivantes :

  • par référentiel lorsque Dependabot est activé sur le référentiel ou lorsqu’un nouveau fichier manifeste est validé dans le référentiel.

  • par organisation lorsqu’une nouvelle vulnérabilité est découverte.

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.