The current implementation has a number of well-known problems. This post outlines the planned rework.
Problems:
- delayed delivery - waiting for hourly cron
- test notifications missing - fire on demand
- form reconfiguration - single unified card
- lack of modern integrations - slack integration
- unclear handling of edge cases - deleted user, non existing view/filter
Questions:
- do we need robust editor as we have for policy content?
- are we letting users to have multiple delivery methods? Slack + Email?
- in first version do we want to upload files (reports) into Slack?
- what audit/logging do we need (sent, failed)?
- removing free-hand email as a recipient?
Slack integration
- Feature idea - Slack interactions (mark as reviewed, mark as read)
This will probably be another delivery method alongside existing Email and Webhooks.
A new “Slack” section under Settings where user configures the workspace connection once:
- Incoming Webhook URL
- Default Channel - the fallback channel (e.g.
#grc-alerts) - Test button - sends a test message to the default channel to confirm the connection works.
- Dissconect button
- single button add to slack
- approve the requested permissions
- eramba receives a Bot Token scoped to that workspace. The token is stored per eramba instance. This works identically for cloud and self-hosted deployments — the only requirement is that the eramba instance has outbound access to
api.slack.com
Notification modal
- user will have another delivery method Slack
- if this is enabled, on recipients card there will be additional method where usr can select channel OR custom roles AND Users/Groups
- Mapping of Users - this will msot probably be done by emails
- The notification body field is reused as the Slack message text. Macros work exactly as they do for email
- Recipients and email body will be on the same page to follow writing an email design
Test notification button
The goal is to let users see exactly how a notification will look before saving it - with the body, macros, and chosen delivery method all rendered the way the recipient will see them.
- Lives in the notification edit modal, with a quick-action shortcut from the bottom drawer
- Requires picking a test item (e.g. a specific risk, control, asset) so macros resolve to real values. If no item is selected, fall back to placeholders.
- Works for all delivery methods - Email, Slack, Webhook
- Open question: does the test fire to the actual configured recipients, or only to the user clicking the button (or to a free-hand address entered in the modal)?
Attachment for item triggered notification
Both filter and report
Item-triggered notifications should be able to ship a report alongside the message body.
- Item/Section report
- Supported on both delivery methods - attached to the email, uploaded into the Slack channel
- Configured per notification, on the same page as recipients and body
- Open question: size / format limits?
Remove awareness type of notifications
- Reason: low usage, hard to understand, hard to explain
- Existing awareness notifications remain active for now - full removal is TBD
- No direct replacement planned
- What will happen with already setup notification
Change hardcoded values to slider
It would be nice to finally remove the hardcoded values (30, -10, +1, +10, etc.) and replace them with a slider.
Name of the attached files
For example, a report attached to a notification should have the same name as the report has in the system.
Triggering notifications immediately
Users don’t want to wait for cron.
