Docs - Notifications

Général

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 comprend l'identifiant et la description du secret, ainsi que certains détails sur le spectateur, comme l'adresse IP.

Types de notification

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

  • Email
  • Slack
  • Webhook (HTTP POST)

Types d'événements

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

  • Secret créé
  • Le secret vu
  • Secret expiré

Notifications par courrier électronique

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

Le Statut de la page indique la date d'envoi du dernier courriel de notification.

Notifications Slack

Les notifications Slack peuvent être configurées à l'adresse suivante Notifications > Slack.

Les notifications Slack utilisent les webhooks entrants de Slack. Pour en savoir plus sur cette fonctionnalité, consultez le site Documentation de Slack.

Le Statut la section 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 à l'adresse suivante Notifications > Webhook.

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

Les éléments suivants JSON sera envoyé sous la forme d'un POST lorsque le webhook est exécuté. La demande Content-Type est fixé à application/json.

      {
        event_type: "one of secret_created, secret_viewed, secret_expired",
        secret_id: "the ID of the secret",
        created_at: "timestamp when the secret was created",
        description: "description of the secret, if set",
        viewed_at: "timestamp when the secret was viewed, if viewed",
        viewed_by_ip: "IP address of the viewed, if viewed",
        viewed_by_user_agent: "HTTP User Agent of the viewer, if viewed",
        expires_at: "timestamp when the secret expires, if set",
        expired: "a boolean indicating if the secret has expired"
      }
    

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