---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "wiz_integration_aws_sns Resource - terraform-provider-wiz"
subcategory: ""
description: |-
  Integrations are reusable, generic connections between Wiz and third-party platforms like Slack, Google Chat, and Jira that allow data from Wiz to be passed to your preferred tool.
---

# wiz_integration_aws_sns (Resource)

Integrations are reusable, generic connections between Wiz and third-party platforms like Slack, Google Chat, and Jira that allow data from Wiz to be passed to your preferred tool.

## Example Usage

```terraform
# Provision an AWS SNS integration with a specified role
resource "wiz_integration_aws_sns" "specified_role_all_projects" {
  name                      = "test-terraform-001"
  aws_sns_topic_arn         = "arn:aws:sns:us-east-1:123456789012:RemediationTopic"
  aws_sns_access_method     = "ASSUME_SPECIFIED_ROLE"
  aws_sns_customer_role_arn = "arn:aws:iam::123456789012:role/RemediationRole"
}

# Provision and AWS SNS integration with the connector role
resource "wiz_integration_aws_sns" "connector_role_all_projects" {
  name                  = "test-terraform-003"
  aws_sns_topic_arn     = "arn:aws:sns:us-east-1:123456789012:RemediationTopic"
  aws_sns_access_method = "ASSUME_CONNECTOR_ROLE"
  aws_sns_connector_id  = "ab48ad5e-44fb-48f8-9899-24ee4ed974c1"
}

# Provision and AWS SNS integration that uses the connector role role for a specified project
resource "wiz_integration_aws_sns" "specified_role_single_project" {
  name                  = "test-terraform-004"
  aws_sns_topic_arn     = "arn:aws:sns:us-east-1:981012938874:Wiz-Remediation-Issues-Topic"
  aws_sns_access_method = "ASSUME_CONNECTOR_ROLE"
  aws_sns_connector_id  = "ef0bd8a5-165b-4498-b5d7-19871f762c21"
  scope                 = "Selected Project"
  project_id            = "1091ae77-116a-56cf-990e-db2f4f691f66"
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `aws_sns_access_method` (String) The access method this integration should use. 
    - Allowed values: 
        - ASSUME_CONNECTOR_ROLE
        - ASSUME_SPECIFIED_ROLE
- `name` (String) The name of the integration.

### Optional

- `aws_sns_connector_id` (String) Required if and only if accessMethod is ASSUME_CONNECTOR_ROLE, this should be a valid existing AWS connector ID from which the role ARN will be taken.
    - Conflicts with `[aws_sns_customer_role_arn]`.
- `aws_sns_customer_role_arn` (String) Required if and only if accessMethod is ASSUME_SPECIFIED_ROLE, this is the role that should be assumed, the ExternalID of the role must be your Wiz Tenant ID (a GUID).
    - Conflicts with `[aws_sns_connector_id]`.
- `aws_sns_topic_arn` (String) The SNS Topic Arn.
- `project_id` (String) The project this action is scoped to.
- `scope` (String) Scoping to a selected Project makes this Integration accessible only to users with global roles or Project-scoped access to the selected Project. Other users will not be able to see it, use it, or view its results. Integrations restricted to global roles cannot be seen or used by users with Project-scoped roles. 
    - Allowed values: 
        - Selected Project
        - All Resources
        - All Resources, Restrict this Integration to global roles only

    - Defaults to `All Resources, Restrict this Integration to global roles only`.

### Read-Only

- `created_at` (String) Identifies the date and time when the object was created.
- `id` (String) Identifier for this object.