PagerDuty + Lacework Integration Benefits
- Extend Lacework Events to route to the correct people, at the correct time that fits your existing business processes using PagerDuty triage, escalations, and workflows.
- One-way event notification forwards from Lacework to PagerDuty.
- Lacework Alert Routing and Alert Rules settings allow you to configure which events and severities to receive and which resource groups and event categories you want events for. They grant complete control of the alert channels forwarded to PagerDuty.
How it Works
Lacework events that arise from anomaly detection, compliance, vulnerabilities, or configured rule definitions send an event to a service in PagerDuty. Events from Lacework can either trigger a new incident on the corresponding PagerDuty service or be grouped as alerts into an existing incident. For additional information about incidents and alerts, see https://support.pagerduty.com/docs/incidents and https://support.pagerduty.com/docs/alerts.
Requirements
- PagerDuty integrations require an Admin base role for account authorization. If you do not have this role, contact an Admin or Account Owner within your organization to configure the integration.
- Lacework requires an integration key, and alerts and incidents must be enabled. Integration keys are generated by creating a new service or by creating a new integration for an existing service.
Support
If you need help with this integration, contact support@lacework.net.
Integration Setup
In PagerDuty
Follow these steps to integrate with a PagerDuty service:
- From the Configuration menu, select Services.
- Add an integration to a service through one of the following methods:
- Add your integration to an existing service—Click the name of the service where you want to add the integration. Then select the Integrations tab and click New Integration.
- Create a new service for your integration—In the Configuring Services and Integrations documentation, follow the procedure outlined in the Create a New Service section by selecting Lacework as the Integration Type in the Integration Type section.
- Enter an Integration Name in the format
monitoring-tool-service-name
(e.g., Lacework-Cloud-Security) and select Lacework from the Integration Type menu. Click Add Integration to save your new integration.
This redirects you to the service’s Integrations tab.An integration key is generated on this screen. Save this key in a safe location because it will be used when you configure the integration with Lacework in the next section.
In Lacework
After you have your PagerDuty integration key, return to the Lacework Console and complete the following steps:
- Log in to the Lacework Console with a Lacework user that has administrative privileges.
- From the Settings menu, select Alert Channels (under Alert Routing).
- Click + Create New.
- Under Channel Type, select PagerDuty, select Next.
- Name the channel (e.g., PagerDuty-something).
- Add your integration key.
- Click Save.
Locate the new PagerDuty alert channel.
Notice that the status check reads “Integration Check Pending.”Click Test Integration and it will indicate “success.”
From the PagerDuty console, confirm that an incident was triggered with the subject “This is a test Message.”When complete, click Alert Rules and configure your required alert routing details/options by leveraging the alert channel you just created.
Disable the PagerDuty Alert Channel
Follow these steps to disable the PagerDuty alert channel in the Lacework Console.
- Log in to the Lacework Console with a Lacework user that has administrative privileges.
- From the Settings menu, select Alert Channels (under Alert Routing).
- Locate the desired PagerDuty alert channel.
- In the Status column, click the green Enabled status to change it to Disabled.
Uninstall the PagerDuty Alert Channel
Follow these steps to uninstall the PagerDuty alert channel from the Lacework Console.
- Log in to the Lacework Console with a Lacework user that has administrative privileges.
- From the Settings menu, select Alert Channels (under Alert Routing).
- Select the desired PagerDuty alert channel checkbox and click Delete (trash icon).
Create a Lacework PagerDuty Alert Channel Using Terraform
For organziations using Terraform to manage their environments, Lacework maintains the Terraform Provider for Lacework which enables configuration of Lacework Alert Channels using automation.
If you are new to the Lacework Terraform Provider, or Lacework Terraform Modules, read the Terraform for Lacework Overview to learn the basics on how to configure the provider and more.
For a complete list of custom Terraform resources to manage alert channels in Lacework, see Managing Alert Channels with Terraform.
# Configure PagerDuty Alert Channel in Lacework resource "lacework_alert_channel_pagerduty" "critical" { name = "Forward Critical Alerts" integration_key = "1234abc8901abc567abc123abc78e012" }
Additional information on the lacework_alert_channel_pagerduty
resource can be found on the Terraform Registry.