Aller au contenu principal

Slack

Ce notifier peut envoyer des messages à un canal Slack pour les événements du cycle de vie des incidents (depuis Internal Monitoring et/ou Public Monitoring) ainsi que pour les alertes de honeytoken.

Vous pouvez connecter Slack selon deux modes :

  • Incident thread (Recommandé) : installe l'application Slack GitGuardian sur votre workspace via OAuth. Chaque événement concernant un incident est regroupé dans un seul fil de discussion, afin que votre canal ne soit pas submergé et que l'historique complet d'un incident reste au même endroit.
    ⚠️ Pas encore disponible, bientôt disponible.
  • Webhook : rapide à configurer. Chaque événement est publié sous la forme d'un nouveau message distinct.

Configurer avec le mode Incident thread​

  1. Ouvrez la configuration du notifier Slack, sélectionnez votre Team, puis choisissez Incident thread au lieu de Webhook. 1

  2. Sous Workspace, sélectionnez Add new pour connecter un workspace Slack. Si un workspace est déjà connecté, passez à l'étape 4. 2

  3. Vous êtes redirigé vers Slack pour installer l'application GitGuardian Notifier. Examinez les permissions demandées, consultez vos canaux et les informations de votre workspace, et publiez des messages dans les canaux que vous choisissez, puis sélectionnez Allow. 3

  4. De retour dans GitGuardian, sélectionnez le Workspace que vous venez de connecter et le Channel où vous souhaitez que les alertes soient publiées, puis sélectionnez Next. 4

  5. Dans l'onglet Events, nommez le notifier et sélectionnez les événements Internal monitoring, Public monitoring et Honeytoken auxquels vous souhaitez vous abonner, puis sélectionnez Submit.
    5

  6. Une fois le notifier enregistré, ouvrez le menu de sa ligne (⋮) et sélectionnez Send test message pour confirmer que l'application peut publier dans le canal avant de vous y fier. 6

remarque

Désinstaller l'application GitGuardian de votre workspace Slack (depuis les paramètres d'applications de Slack) rompt également l'intégration du côté de GitGuardian. La configuration de votre notifier signale alors le workspace comme déconnecté ; répétez les étapes de connexion ci-dessus pour le reconnecter.

Configurer avec le mode Webhook​

  1. Rendez-vous sur Slack API : Create an App.

  2. Créez une nouvelle application pour GitGuardian. 1

  3. Activez la fonctionnalité Incoming Webhooks. 2

  4. Générez un nouveau webhook.
    3

  5. Copiez l'URL du webhook générée.
    4

  6. Collez l'URL du webhook dans la section d'intégration Slack des paramètres de votre dashboard GitGuardian. 5

    Configuration au niveau de l'équipe :

    • Free workspace : vous ne pouvez configurer les alertes que sur la « All-incidents team ».
    • Growth ou Enterprise workspace : vous pouvez configurer l'intégration sur n'importe quelle équipe :
      • Créez-la au sein de la « All-incidents team » pour recevoir des notifications pour tous les incidents du workspace.
      • Créez-la au sein d'une équipe spécifique pour ne recevoir des notifications que pour les incidents de cette équipe.

    Cela peut être fait directement depuis la page d'intégration ou depuis la page de l'équipe.

  7. Sélectionnez les événements auxquels vous souhaitez vous abonner et que vous souhaitez recevoir.

Événements​

Vous pouvez vous abonner aux événements suivants depuis GitGuardian Internal Monitoring et/ou GitGuardian Public Monitoring (si votre workspace et votre équipe ont accès à Public Monitoring) :

NomDescription
New incident detectedUn nouvel incident a été détecté.
New occurrence detectedUne nouvelle occurrence a été détectée pour cet incident.
Incident Validity changedLa validité a été mise à jour pour cet incident.
Incident status changeDéclenché lorsque le statut d'un incident est mis à jour.
    Incident resolvedCet incident a été résolu.
    Incident ignoredCet incident a été ignoré.
    Incident reopenedCet incident a été rouvert.
    Incident regressionUne nouvelle occurrence a été détectée par le scan en temps réel d'une source connectée pour un incident précédemment marqué comme résolu (manuellement ou par l'auto-résolveur).
    Incident Severity changedLa sévérité a été mise à jour pour cet incident.
Risk score updated (plans Growth et Enterprise)Le score de risque a été mis à jour pour cet incident. Non envoyé pour les incidents publics sur les workspaces où l'analyse par agents est activée.
Incident assignmentsDéclenché lorsqu'un incident est assigné, réassigné ou désassigné.
    Incident assignedCet incident a été assigné à un utilisateur.
    Incident reassignedCet incident a été réassigné à un autre utilisateur.
    Incident unassignedUn utilisateur a été désassigné de cet incident.
Incident accessDéclenché lorsque l'accès d'un utilisateur à un incident change.
    Incident access grantedL'accès à cet incident a été accordé à un utilisateur.
    Incident access revokedL'accès à cet incident a été révoqué pour un utilisateur.
Publicly sharedDéclenché lorsque le lien de partage public d'un incident change.
    Incident shared publiclyUn utilisateur a généré un lien de partage public pour cet incident.
    Incident unshared publiclyUn utilisateur a désactivé le lien de partage public pour cet incident.
MessagesDéclenché lorsqu'un nouveau message est ajouté à un incident.
    Feedback submittedUn feedback a été soumis pour cet incident.
    New comment on an incidentUne nouvelle note a été créée pour cet incident.

Filtrer les notifications par critères d'incident​

Vous pouvez définir des règles de filtrage afin que ce notificateur n'envoie des notifications que pour les incidents correspondant aux critères que vous choisissez — par severity, score de risque ML, validité, type de secret ou tags GitGuardian, à la fois sur les incidents d'internal monitoring et de public monitoring. Le score de risque est l'exception : il n'est pas disponible sur les incidents publics si l'analyse par agents est activée pour le workspace. Si vous ne définissez aucune règle, tous les incidents sont notifiés (comportement par défaut).

Consultez Filtrer les notifications par critères d'incident pour la liste complète des critères et des remarques importantes sur le moment d'envoi des notifications.