Skip to content

InsightConnect

You can set up Wallarm to send notifications to InsightConnect when the following events are triggered:

  • Hits detected except for:

  • System related:

    • User changes (newly created, deleted, role change)
    • Integration changes (disabled, deleted)
    • Application changes (newly created, deleted, name change)

  • Vulnerabilities detected, all by default or only for the selected risk level(s) - high, medium or low.

  • Rules and triggers changed (creating, updating, or deleting the rule or trigger)

  • Scope (exposed assets) changed: updates in hosts, services, and domains

  • On an hourly basis, you can get a notification with the number of requests processed during the previous hour

Setting up integration

First, generate and copy an API key as follows:

  1. Open the InsightConnect's UI → Settings → API Keys page and click New User Key.

  2. Enter an API key name (e.g. Wallarm API) and click Generate.

  3. Copy the generated API key.

  4. Go to Wallarm UI → Integrations in the US or EU cloud and click InsightConnect.

  5. Paste the API key that you copied before into the API key field.

Secondly, generate and copy an API URL as follows:

  1. Go back to the InsightConnect's UI, open the Automation → Workflows page and create a new workflow for the Wallarm notification.

  2. When asked to choose a trigger, choose the API Trigger.

  3. Copy the generated URL.

  4. Go back to Wallarm UI → InsightConnect configuration and paste the API URL that you copied before into the API URL field.

Thirdly, finish the setup in Wallarm UI:

  1. Enter an integration name.

  2. Choose event types to trigger notifications. If the events are not chosen, then notifications will not be sent.

  3. Test the integration and make sure the settings are correct.

  4. Click Add integration.

InsightConnect integration

Testing integration

Integration testing allows checking configuration correctness, availability of the Wallarm Cloud, and the notification format. To test the integration, you can use the button Test integration when creating or editing the integration.

The integration is tested as follows:

  • Test notifications with the prefix [Test message] are sent to the selected system.

  • Test notifications cover the following events (each in a single record):

    • New user in the company account
    • Newly detected hit
    • Newly discovered IP in the company scope
    • New trigger in the company account
    • Newly discovered security vulnerability

  • Test notifications include test data.

Test InsightConnect message:

Test InsightConnect notification

Updating integration

To update the settings of active integration:

  1. Go to Wallarm Console → Integrations in the US or EU Cloud.

  2. Open an active integration.

  3. Make required changes and click Save.

Disabling integration

To stop sending reports and notifications temporarily, you can disable the integration:

  1. Go to Wallarm Console → Integrations in the US or EU Cloud.

  2. Open an active integration and click Disable.

To re-enable sending reports and notifications, open the disabled integration and click Enable.

Disabling the integration is the system event. If you receive system notifications, messages about disabled integration will be sent to the configured system.

Deleting integration

To stop sending reports and notifications permanently, you can delete the integration. Deleting an integration cannot be undone. The integration will be removed from the list permanently.

  1. Go to Wallarm Console → Integrations in the US or EU Cloud.

  2. Open integration and click Delete.

  3. Confirm the action.

Deleting the integration is the system event. If you receive system notifications, messages about deleted integration will be sent to the configured system.