Documentazione sulle notifiche

Generale

Le notifiche sono molto utili per rimanere aggiornati su determinati eventi. Ad esempio, è possibile configurare l'invio di una notifica via e-mail o Slack ogni volta che un segreto viene visualizzato. La notifica include l'ID e la descrizione del segreto e anche alcuni dettagli del visualizzatore, come l'indirizzo IP.

Tipi di notifica

È possibile configurare le notifiche da inviare tramite:

  • Email
  • Slack
  • Webhook (HTTP POST)

Tipi di evento

È possibile configurare le notifiche per i seguenti eventi:

  • Segreto creato
  • Segreto visualizzato
  • Segreto scaduto

Notifiche via e-mail

Le notifiche via e-mail possono essere configurate in Notifiche > Email. Al momento non è possibile avere più destinatari per le e-mail.

Il Stato la sezione della pagina mostra quando è stata inviata l'ultima e-mail di notifica.

Notifiche di Slack

Le notifiche di Slack possono essere configurate in Notifiche > Slack.

Le notifiche di Slack utilizzano i webhook in entrata di Slack. Per saperne di più su questa funzione, visitate il sito Documentazione di Slack.

Il Stato la sezione della pagina mostra quando è stata inviata l'ultima notifica e se è andata a buon fine.

Notifiche webhook

Le notifiche Webhook possono essere configurate su Notifiche > Webhook.

Le notifiche Webhook possono essere utilizzate per inviare notifiche a qualsiasi applicazione con API HTTP in entrata.

Il seguente JSON sarà inviato come un file POST quando viene eseguito il webhook. La richiesta Content-Type è impostato su 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"
      }
    

Il Stato la sezione della pagina mostra quando è stata inviata l'ultima notifica e se è andata a buon fine.