Mattermost notification plugin

Mattermost notification plugin#

This Baculais Web plugin enables to send the Bacularis event messages to the Mattermost chat service.

The plugin supports the following event types:

  • INFO - information message

  • WARNING - warning message

  • ERROR - error message

It supports the following message categories:

  • Config - actions on Bacula configuration like saving, creating or removing Bacula resources.

  • Aplication - actions like adding, editing or removing users, roles, API hosts and others.

  • Action - actions possible to run by users like running backup or restore and others.

  • Security - security issues like log in actions, log in failed or 2FA failed.

In the message content the plugin provides te following keyword placeholders:

  • %service - service name. It is static text Bacularis.

  • %user - user that performs current action

  • %type - message type (INFO, WARNING, ERROR).

  • %category - message category (Config, Application, Action, Security)

  • %address - user source IP address

  • %date - message date and time

  • %title - message title

  • %content - message body

Plugin parameters

  • webhook_url - Mattermost webhook URL

  • channel - overwrites the channel where the messages will be sent

  • username - overwrites the Mattermost username that is author of the posted messages

  • icon_url - overwrites the mattermost username profile picture (ex. https://my.addr/icon.jpg)

  • icon_emoji - overwrites the mattermost username profile picture by emoji (ex. :smiley:)

  • type - post type (starts with custom_)

  • props - set properties in JSON format

  • priority - set priority of the message

  • content - set format of the content (keywords available)

  • msg_types - message types (INFO, WARNING, ERROR)

  • msg_categories - message categories (Config, Application, Action, Security)

Example plugin settings:

../../_images/bacularis_plugin_mattermost.png