Généralités

Les notifications sont très utiles pour se tenir au courant de certains événements. Par exemple, vous pouvez configurer l'envoi d'un courriel ou d'une notification Slack chaque fois qu'un secret a été consulté. La notification inclut l'ID et la description du secret, ainsi que certains détails sur le spectateur, comme l'adresse IP.

Types de notifications

Vous pouvez configurer les notifications pour qu'elles soient envoyées par :

  • Courriel
  • Slack
  • Webhook (HTTP POST)

Types d'événements

Vous pouvez configurer des notifications pour les événements suivants :

  • Secret créé
  • Secret consulté
  • Secret expiré

Notifications par courriel

Les notifications par courrier électronique peuvent être configurées dans Notifications > Courrier électronique. Pour l'instant, il n'est pas possible d'avoir plusieurs destinataires pour les courriels.

La section Statut de la page indique quand le dernier courriel de notification a été envoyé.

Notifications Slack

Les notifications Slack peuvent être configurées dans Notifications > Slack.

Les notifications Slack utilisent les webhooks entrants de Slack. Vous pouvez en savoir plus sur cette fonctionnalité dans la documentation de Slack.

La section Statut de la page indique quand la dernière notification a été envoyée et si elle a abouti.

Notifications par webhook

Les notifications Webhook peuvent être configurées dans Notifications > Webhook.

Les notifications Webhook peuvent être utilisées pour envoyer des notifications à toute application disposant d'une API HTTP entrante.

La charge utile JSON suivante sera envoyée en tant que requête POST lorsque le webhook est exécuté. Le Content-Type de la requête est défini sur application/json.

{
  event_type :"one of secret_created, secret_viewed, secret_expired",
  secret_id :"l'identifiant du secret",
  created_at :"date de création du secret",
  description :"description du secret, le cas échéant",
  viewed_at : "date à laquellele secret a été consulté, s'il a été consulté",
  viewed_by_ip : "adresse IP de la personne qui a consulté le secret, si elle l'a fait",
  viewed_by_user_agent : "Agent utilisateur HTTP de la personne qui a consulté le secret, si elle l'a fait",
  expires_at :"date d'expiration du secret, si elle est définie",
  expired : "un booléen indiquant si le secret a expiré"
}

La section " Statut " de la page indique quand la dernière notification a été envoyée et si elle a abouti.