Configuration >> Notifications
Notifications
The Notifications section enables administrators to configure how they receive alerts about important events. Here, you can set up and manage various alerting channels such as email servers, Slack channels, and other integrations. By connecting these channels, you ensure that designated users or teams are promptly informed when policies are triggered or notable activities occur, allowing for swift response and improved oversight.
Email Notifications
To enable notifications via Email, use the SMTP Server Configuration
Enable Integration
Use the toggle switch at the top to enable or disable the SMTP Server integration.
Smarthost
A smarthost is an external mail server that relays outgoing email messages on behalf of your application. Instead of sending emails directly to recipients, your application forwards them to the smarthost, which then handles delivery.
Mail Server and Credentails
- Smarthost: The hostname and port of the outgoing mail server used to send alert emails (e.g.,
smtp.example.com:587). - Username: The username required to authenticate with the mail server. Smarthosts typically require authentication.
- Password: The password associated with the username.
- Require TLS: (toggle) Some servers require TLS (Transport Layer Security encryption) for secure communications. If your smarthost supports TLS, we recommend enabling this option.
Default Email Addresses
- From Address: The return address for outgoing alert messages. This address must be associated with the credentials used for the smarthost. Example: Google Workspace instructions
- Default Recipient Address: The default email recipient for alerts. Individual alerts can be sent to any email address, or group of addresses, as configured in Policy.
Save Configuration
After configuring the integration and message templates, click Save Changes to apply your settings.
Test Message
After saving the configuration, you can use the Send Test Message button to have Shield send a message using the new credentials.
Slack
Slack Notifications
To enable notifications via Slack, use the Slack Configuration
Enable Integration
Use the toggle switch at the top to enable or disable the Slack integration.
Webhook
- Webhook URL: The URL provided by Slack when you set up the incoming webhook integration.
A Slack webhook URL is a special internet address generated by Slack when you set up the integration. This URL acts as a secure endpoint that Nullafi Shield can use to post messages. Shield can trigger alerts, notifications, or updates that appear instantly in your chosen Slack workspace. Webhook URLs are secret and should be kept private to prevent unauthorized access to your Slack channels. See the Slack Documentation for more instructions on setting up a webhook.
Default Channel and Username
- Default Chennel: The default Slack channel for alerts. Individual alerts can be sent to any channel, or group of channels, as configured in Policy.
- Username: The Username that will appear as the 'sender' for alerts in Slack.
Save Configuration
After configuring the integration and message templates, click Save Changes to apply your settings.
Test Message
After saving the configuration, you can use the Send Test Message button to have Shield send a message using the new configuration.
Microsoft Teams
Teams Notifications
To enable notifications via Microsoft Teams, use the Teams Configuration
Enable Integration
Use the toggle switch at the top to enable or disable the Teams integration.
Webhook
- URL: The URL provided by Teams when you set up the incoming webhook integration.
Microsoft Teams allows you to use Incoming Webhooks to post messages from external applications like Nullafi Shield into Teams channels. A Teams webhook URL is a special internet address generated by Microsoft when you set up the integration. This URL acts as a secure endpoint that Nullafi Shield can use to post messages. Webhook URLs are secret and should be kept private to prevent unauthorized access to your Teams channels. See the Teams Documentation for more instructions on setting up a webhook.
Save Configuration
After configuring the integration and message templates, click Save Changes to apply your settings.
Test Message
After saving the configuration, you can use the Send Test Message button to have Shield send a message using the new configuration.
Generic Webhooks
Webhook Notifications
To enable notifications via any webhook, use the Webhook Configuration
Enable Integration
Use the toggle switch at the top to enable or disable the Teams integration.
Webhook
- URL: The URL provided by your application when you set up the incoming webhook integration.
A generic webhook integration is a simple way for applications to communicate automatically. When a specific event occurs in the source application (Nullafi Shield), it sends a request to a pre-configured URL (the webhook endpoint) of the target application. This request contains data about the event in JSON format. The receiving application can then process this data and perform actions without any manual intervention. Webhooks are widely used for real-time integrations because they are lightweight, event-driven, and easy to set up, requiring only a URL and basic configuration.
Save Configuration
After configuring the integration and message templates, click Save Changes to apply your settings.
Test Message
After saving the configuration, you can use the Send Test Message button to have Shield send a message using the new configuration.