Allgemein

Benachrichtigungen sind sehr nützlich, um bei bestimmten Ereignissen auf dem Laufenden zu bleiben. Sie können zum Beispiel eine E-Mail- oder Slack-Benachrichtigung konfigurieren, die jedes Mal gesendet wird, wenn ein Geheimnis eingesehen wurde. Die Benachrichtigung enthält die ID und die Beschreibung des Geheimnisses sowie einige Details zum Betrachter, wie die IP-Adresse.

Benachrichtigungsarten

Sie können Benachrichtigungen konfigurieren, die über folgende Kanäle zugestellt werden:

  • E-Mail
  • Slack
  • Webhook (HTTP POST)

Ereignistypen

Sie können Benachrichtigungen für die folgenden Ereignisse konfigurieren:

  • Geheimnis erstellt
  • Geheimnis angesehen
  • Geheimnis abgelaufen

E-Mail-Benachrichtigungen

E-Mail-Benachrichtigungen können unter Benachrichtigungen > E-Mail konfiguriert werden. Im Moment ist es nicht möglich, mehrere Empfänger für die E-Mails zu haben.

Der Abschnitt Status der Seite zeigt an, wann die letzte Benachrichtigungs-E-Mail gesendet wurde.

Slack-Benachrichtigungen

Slack-Benachrichtigungen können unter Benachrichtigungen > Slack konfiguriert werden.

Slack-Benachrichtigungen verwenden die eingehenden Webhooks von Slack. Sie können mehr über diese Funktion in der Dokumentation von Slack lesen.

Der Abschnitt Status auf der Seite zeigt an, wann die letzte Benachrichtigung gesendet wurde und ob sie erfolgreich war.

Webhook-Benachrichtigungen

Webhook-Benachrichtigungen können unter Benachrichtigungen > Webhook konfiguriert werden.

Webhook-Benachrichtigungen können verwendet werden, um Benachrichtigungen an jede Anwendung mit eingehender HTTP-API zu senden.

Die folgende JSON-Nutzlast wird als POST-Anfrage gesendet, wenn der Webhook ausgeführt wird. Der Content-Type der Anfrage ist auf application/json eingestellt.

{
  event_type:"eines von secret_created, secret_viewed, secret_expired",
  secret_id:"die ID des Geheimnisses",
  created_at:"Zeitstempel, zu dem das Geheimnis erstellt wurde",
  description:"Beschreibung des Geheimnisses, falls festgelegt",
  viewed_at: "Zeitstempel, zudem das Geheimnis angesehen wurde, falls angesehen",
  viewed_by_ip: "IP-Adresse des Abgerufenen, falls abgerufen",
  viewed_by_user_agent: "HTTP-Benutzer-Agent des Betrachters, falls angesehen",
  expires_at: "Zeitstempel, zu dem das Geheimnis abläuft, falls festgelegt",
  expired:"ein boolescher Wert, der angibt, ob das Geheimnis abgelaufen ist"
}

Der Abschnitt Status der Seite zeigt an, wann die letzte Benachrichtigung gesendet wurde und ob sie erfolgreich war.