Webhook Notifications

You can have goshs send notifications using webhooks. The following webhook providers are supported:

  • Discord
  • Mattermost
  • Slack

Use the following combination of arguments to use webhooks:

Webhook options:
  -W,  --webhook            Enable webhook support                      (default: false)
  -Wu, --webhook-url        URL to send webhook requests to
  -We, --webhook-events     Comma separated list of events to notify
                            [all, upload, delete, download, view, webdav,
                            sftp, smb, dns, smtp, verbose]              (default: all)
  -Wp, --webhook-provider   Webhook provider
                            [Discord, Mattermost, Slack]                (default: Discord)

An example for Discord would be:

goshs -W -Wu https://discord.com/api/webhooks/<id>/<secret>

Another example for Slack would be:

goshs -W -Wu https://hooks.slack.com/services/<id>/<id>/<id> -Wp Slack

You can control which events you want to get notified for. For example use -We upload,delete to be notified about upload and deletion events only. all includes all events except verbose. So verbose messages will only be sent if you specify verbose alongside any other event type.

The following table describes all available event types:

Event Description
upload A file was uploaded
delete A file was deleted
download A file was downloaded
view A directory listing was viewed
webdav A WebDAV operation was performed
sftp An SFTP operation was performed
smb An NTLM hash was captured by the SMB server
dns A DNS query was received by the DNS server
smtp An email was received by the SMTP server
verbose Verbose log messages (not included in all)
all All events except verbose