lacework.AlertChannelWebhook
Explore with Pulumi AI
You can use this resource to create a custom webhook that receives Lacework alert notifications from a Lacework alert channel and forwards those alerts to a third-party application.
Note: If the third-party application receiving the HTTP POST request requires an API token, enter the API token as part of the URL eg. https://webhook.com?api-token=123
To find more information about the alert payload, see the Lacework support documentation.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as lacework from "@pulumi/lacework";
const opsCritical = new lacework.AlertChannelWebhook("opsCritical", {webhookUrl: "https://webhook.com?api-token=123"});
import pulumi
import pulumi_lacework as lacework
ops_critical = lacework.AlertChannelWebhook("opsCritical", webhook_url="https://webhook.com?api-token=123")
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/lacework/v2/lacework"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := lacework.NewAlertChannelWebhook(ctx, "opsCritical", &lacework.AlertChannelWebhookArgs{
WebhookUrl: pulumi.String("https://webhook.com?api-token=123"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Lacework = Pulumi.Lacework;
return await Deployment.RunAsync(() =>
{
var opsCritical = new Lacework.AlertChannelWebhook("opsCritical", new()
{
WebhookUrl = "https://webhook.com?api-token=123",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.lacework.AlertChannelWebhook;
import com.pulumi.lacework.AlertChannelWebhookArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var opsCritical = new AlertChannelWebhook("opsCritical", AlertChannelWebhookArgs.builder()
.webhookUrl("https://webhook.com?api-token=123")
.build());
}
}
resources:
opsCritical:
type: lacework:AlertChannelWebhook
properties:
webhookUrl: https://webhook.com?api-token=123
Create AlertChannelWebhook Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new AlertChannelWebhook(name: string, args: AlertChannelWebhookArgs, opts?: CustomResourceOptions);
@overload
def AlertChannelWebhook(resource_name: str,
args: AlertChannelWebhookArgs,
opts: Optional[ResourceOptions] = None)
@overload
def AlertChannelWebhook(resource_name: str,
opts: Optional[ResourceOptions] = None,
webhook_url: Optional[str] = None,
alert_channel_webhook_id: Optional[str] = None,
enabled: Optional[bool] = None,
name: Optional[str] = None,
test_integration: Optional[bool] = None)
func NewAlertChannelWebhook(ctx *Context, name string, args AlertChannelWebhookArgs, opts ...ResourceOption) (*AlertChannelWebhook, error)
public AlertChannelWebhook(string name, AlertChannelWebhookArgs args, CustomResourceOptions? opts = null)
public AlertChannelWebhook(String name, AlertChannelWebhookArgs args)
public AlertChannelWebhook(String name, AlertChannelWebhookArgs args, CustomResourceOptions options)
type: lacework:AlertChannelWebhook
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args AlertChannelWebhookArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args AlertChannelWebhookArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args AlertChannelWebhookArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AlertChannelWebhookArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AlertChannelWebhookArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var alertChannelWebhookResource = new Lacework.AlertChannelWebhook("alertChannelWebhookResource", new()
{
WebhookUrl = "string",
AlertChannelWebhookId = "string",
Enabled = false,
Name = "string",
TestIntegration = false,
});
example, err := lacework.NewAlertChannelWebhook(ctx, "alertChannelWebhookResource", &lacework.AlertChannelWebhookArgs{
WebhookUrl: pulumi.String("string"),
AlertChannelWebhookId: pulumi.String("string"),
Enabled: pulumi.Bool(false),
Name: pulumi.String("string"),
TestIntegration: pulumi.Bool(false),
})
var alertChannelWebhookResource = new AlertChannelWebhook("alertChannelWebhookResource", AlertChannelWebhookArgs.builder()
.webhookUrl("string")
.alertChannelWebhookId("string")
.enabled(false)
.name("string")
.testIntegration(false)
.build());
alert_channel_webhook_resource = lacework.AlertChannelWebhook("alertChannelWebhookResource",
webhook_url="string",
alert_channel_webhook_id="string",
enabled=False,
name="string",
test_integration=False)
const alertChannelWebhookResource = new lacework.AlertChannelWebhook("alertChannelWebhookResource", {
webhookUrl: "string",
alertChannelWebhookId: "string",
enabled: false,
name: "string",
testIntegration: false,
});
type: lacework:AlertChannelWebhook
properties:
alertChannelWebhookId: string
enabled: false
name: string
testIntegration: false
webhookUrl: string
AlertChannelWebhook Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The AlertChannelWebhook resource accepts the following input properties:
- Webhook
Url string - The URL of your webhook that will receive the HTTP POST.
- Alert
Channel stringWebhook Id - Enabled bool
- The state of the external integration. Defaults to
true
. - Name string
- The Alert Channel integration name.
- Test
Integration bool - Whether to test the integration of an alert channel upon creation and modification
- Webhook
Url string - The URL of your webhook that will receive the HTTP POST.
- Alert
Channel stringWebhook Id - Enabled bool
- The state of the external integration. Defaults to
true
. - Name string
- The Alert Channel integration name.
- Test
Integration bool - Whether to test the integration of an alert channel upon creation and modification
- webhook
Url String - The URL of your webhook that will receive the HTTP POST.
- alert
Channel StringWebhook Id - enabled Boolean
- The state of the external integration. Defaults to
true
. - name String
- The Alert Channel integration name.
- test
Integration Boolean - Whether to test the integration of an alert channel upon creation and modification
- webhook
Url string - The URL of your webhook that will receive the HTTP POST.
- alert
Channel stringWebhook Id - enabled boolean
- The state of the external integration. Defaults to
true
. - name string
- The Alert Channel integration name.
- test
Integration boolean - Whether to test the integration of an alert channel upon creation and modification
- webhook_
url str - The URL of your webhook that will receive the HTTP POST.
- alert_
channel_ strwebhook_ id - enabled bool
- The state of the external integration. Defaults to
true
. - name str
- The Alert Channel integration name.
- test_
integration bool - Whether to test the integration of an alert channel upon creation and modification
- webhook
Url String - The URL of your webhook that will receive the HTTP POST.
- alert
Channel StringWebhook Id - enabled Boolean
- The state of the external integration. Defaults to
true
. - name String
- The Alert Channel integration name.
- test
Integration Boolean - Whether to test the integration of an alert channel upon creation and modification
Outputs
All input properties are implicitly available as output properties. Additionally, the AlertChannelWebhook resource produces the following output properties:
- Created
Or stringUpdated By - Created
Or stringUpdated Time - Id string
- The provider-assigned unique ID for this managed resource.
- Intg
Guid string - Org
Level bool - Type
Name string
- Created
Or stringUpdated By - Created
Or stringUpdated Time - Id string
- The provider-assigned unique ID for this managed resource.
- Intg
Guid string - Org
Level bool - Type
Name string
- created
Or StringUpdated By - created
Or StringUpdated Time - id String
- The provider-assigned unique ID for this managed resource.
- intg
Guid String - org
Level Boolean - type
Name String
- created
Or stringUpdated By - created
Or stringUpdated Time - id string
- The provider-assigned unique ID for this managed resource.
- intg
Guid string - org
Level boolean - type
Name string
- created_
or_ strupdated_ by - created_
or_ strupdated_ time - id str
- The provider-assigned unique ID for this managed resource.
- intg_
guid str - org_
level bool - type_
name str
- created
Or StringUpdated By - created
Or StringUpdated Time - id String
- The provider-assigned unique ID for this managed resource.
- intg
Guid String - org
Level Boolean - type
Name String
Look up Existing AlertChannelWebhook Resource
Get an existing AlertChannelWebhook resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: AlertChannelWebhookState, opts?: CustomResourceOptions): AlertChannelWebhook
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
alert_channel_webhook_id: Optional[str] = None,
created_or_updated_by: Optional[str] = None,
created_or_updated_time: Optional[str] = None,
enabled: Optional[bool] = None,
intg_guid: Optional[str] = None,
name: Optional[str] = None,
org_level: Optional[bool] = None,
test_integration: Optional[bool] = None,
type_name: Optional[str] = None,
webhook_url: Optional[str] = None) -> AlertChannelWebhook
func GetAlertChannelWebhook(ctx *Context, name string, id IDInput, state *AlertChannelWebhookState, opts ...ResourceOption) (*AlertChannelWebhook, error)
public static AlertChannelWebhook Get(string name, Input<string> id, AlertChannelWebhookState? state, CustomResourceOptions? opts = null)
public static AlertChannelWebhook get(String name, Output<String> id, AlertChannelWebhookState state, CustomResourceOptions options)
resources: _: type: lacework:AlertChannelWebhook get: id: ${id}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Alert
Channel stringWebhook Id - Created
Or stringUpdated By - Created
Or stringUpdated Time - Enabled bool
- The state of the external integration. Defaults to
true
. - Intg
Guid string - Name string
- The Alert Channel integration name.
- Org
Level bool - Test
Integration bool - Whether to test the integration of an alert channel upon creation and modification
- Type
Name string - Webhook
Url string - The URL of your webhook that will receive the HTTP POST.
- Alert
Channel stringWebhook Id - Created
Or stringUpdated By - Created
Or stringUpdated Time - Enabled bool
- The state of the external integration. Defaults to
true
. - Intg
Guid string - Name string
- The Alert Channel integration name.
- Org
Level bool - Test
Integration bool - Whether to test the integration of an alert channel upon creation and modification
- Type
Name string - Webhook
Url string - The URL of your webhook that will receive the HTTP POST.
- alert
Channel StringWebhook Id - created
Or StringUpdated By - created
Or StringUpdated Time - enabled Boolean
- The state of the external integration. Defaults to
true
. - intg
Guid String - name String
- The Alert Channel integration name.
- org
Level Boolean - test
Integration Boolean - Whether to test the integration of an alert channel upon creation and modification
- type
Name String - webhook
Url String - The URL of your webhook that will receive the HTTP POST.
- alert
Channel stringWebhook Id - created
Or stringUpdated By - created
Or stringUpdated Time - enabled boolean
- The state of the external integration. Defaults to
true
. - intg
Guid string - name string
- The Alert Channel integration name.
- org
Level boolean - test
Integration boolean - Whether to test the integration of an alert channel upon creation and modification
- type
Name string - webhook
Url string - The URL of your webhook that will receive the HTTP POST.
- alert_
channel_ strwebhook_ id - created_
or_ strupdated_ by - created_
or_ strupdated_ time - enabled bool
- The state of the external integration. Defaults to
true
. - intg_
guid str - name str
- The Alert Channel integration name.
- org_
level bool - test_
integration bool - Whether to test the integration of an alert channel upon creation and modification
- type_
name str - webhook_
url str - The URL of your webhook that will receive the HTTP POST.
- alert
Channel StringWebhook Id - created
Or StringUpdated By - created
Or StringUpdated Time - enabled Boolean
- The state of the external integration. Defaults to
true
. - intg
Guid String - name String
- The Alert Channel integration name.
- org
Level Boolean - test
Integration Boolean - Whether to test the integration of an alert channel upon creation and modification
- type
Name String - webhook
Url String - The URL of your webhook that will receive the HTTP POST.
Import
A Lacework Webhook Alert Channel integration can be imported using a INT_GUID
, e.g.
$ pulumi import lacework:index/alertChannelWebhook:AlertChannelWebhook ops_critical EXAMPLE_1234BAE1E42182964D23973F44CFEA3C4AB63B99E9A1EC5
-> Note: To retrieve the INT_GUID
from existing integrations in your account, use the
Lacework CLI command lacework alert-channel list
. To install this tool follow
this documentation.
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- lacework lacework/terraform-provider-lacework
- License
- Notes
- This Pulumi package is based on the
lacework
Terraform Provider.