{"id":29019622,"url":"https://github.com/senora-dev/terraform-aws-sns","last_synced_at":"2026-02-02T03:35:44.241Z","repository":{"id":301180769,"uuid":"1003171574","full_name":"Senora-dev/terraform-aws-sns","owner":"Senora-dev","description":"This Terraform module creates an Amazon SNS (Simple Notification Service) topic with optional subscriptions and policies.","archived":false,"fork":false,"pushed_at":"2025-06-25T14:49:42.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T15:30:16.269Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Senora-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-16T18:27:32.000Z","updated_at":"2025-06-25T14:38:15.000Z","dependencies_parsed_at":"2025-06-25T15:43:04.759Z","dependency_job_id":null,"html_url":"https://github.com/Senora-dev/terraform-aws-sns","commit_stats":null,"previous_names":["senora-dev/terraform-aws-sns"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Senora-dev/terraform-aws-sns","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Senora-dev%2Fterraform-aws-sns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Senora-dev%2Fterraform-aws-sns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Senora-dev%2Fterraform-aws-sns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Senora-dev%2Fterraform-aws-sns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Senora-dev","download_url":"https://codeload.github.com/Senora-dev/terraform-aws-sns/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Senora-dev%2Fterraform-aws-sns/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261977540,"owners_count":23239367,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-26T00:31:22.887Z","updated_at":"2026-02-02T03:35:44.187Z","avatar_url":"https://github.com/Senora-dev.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS SNS Terraform Module\n\nThis Terraform module creates an Amazon SNS (Simple Notification Service) topic with optional subscriptions and policies.\n\n## Features\n\n- Create SNS topics (standard or FIFO)\n- Configure topic policies\n- Add multiple subscriptions with filter policies\n- Support for various subscription protocols (email, SMS, HTTP/HTTPS, Lambda, etc.)\n- Tagging support\n\n## Usage\n\n### Basic Usage\n\n```hcl\nmodule \"sns\" {\n  source = \"Senora-dev/sns/aws\"\n\n  name         = \"my-topic\"\n  display_name = \"My Topic\"\n}\n```\n\n### Complete Usage\n\n```hcl\nmodule \"sns\" {\n  source = \"path/to/module\"\n\n  name         = \"my-topic\"\n  display_name = \"My Topic\"\n  fifo_topic   = false\n\n  create_topic_policy = true\n  topic_policy = jsonencode({\n    Version = \"2012-10-17\"\n    Statement = [\n      {\n        Effect = \"Allow\"\n        Principal = {\n          Service = \"cloudwatch.amazonaws.com\"\n        }\n        Action = [\n          \"SNS:Publish\"\n        ]\n        Resource = \"*\"\n      }\n    ]\n  })\n\n  subscriptions = {\n    email = {\n      protocol = \"email\"\n      endpoint = \"user@example.com\"\n    }\n    lambda = {\n      protocol = \"lambda\"\n      endpoint = \"arn:aws:lambda:us-east-1:123456789012:function:my-function\"\n      filter_policy = {\n        event_type = [\"ALARM\", \"OK\"]\n      }\n    }\n  }\n\n  tags = {\n    Environment = \"production\"\n    Project     = \"my-project\"\n  }\n}\n```\n\n## Requirements\n\n| Name | Version |\n|------|---------|\n| terraform | \u003e= 0.13.0 |\n| aws | \u003e= 3.0 |\n\n## Inputs\n\n| Name | Description | Type | Default | Required |\n|------|-------------|------|---------|:--------:|\n| name | The name of the SNS topic | string | - | yes |\n| display_name | The display name for the SNS topic | string | null | no |\n| fifo_topic | Boolean indicating whether or not to create a FIFO topic | bool | false | no |\n| content_based_deduplication | Boolean indicating whether or not to enable content-based deduplication for FIFO topics | bool | false | no |\n| kms_master_key_id | The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK | string | null | no |\n| tags | A map of tags to add to all resources | map(string) | {} | no |\n| create_topic_policy | Whether to create a topic policy | bool | false | no |\n| topic_policy | The fully-formed AWS policy as JSON | string | null | no |\n| subscriptions | Map of subscriptions to create | map(object) | {} | no |\n\n### Subscription Object\n\n```hcl\n{\n  protocol              = string\n  endpoint              = string\n  filter_policy         = optional(map(list(string)))\n  raw_message_delivery  = optional(bool, false)\n}\n```\n\n## Outputs\n\n| Name | Description |\n|------|-------------|\n| topic_arn | The ARN of the SNS topic |\n| topic_name | The name of the SNS topic |\n| topic_id | The ID of the SNS topic |\n| subscription_arns | Map of subscription ARNs |\n\n## Examples\n\n- [Basic Example](examples/basic/main.tf) - Creates a simple SNS topic\n- [Complete Example](examples/complete/main.tf) - Creates an SNS topic with policies and subscriptions\n\n## Notes\n\n1. For FIFO topics, the topic name must end with `.fifo`\n2. When using filter policies, make sure the subscription protocol supports it\n3. The `topic_policy` should be a valid JSON string containing the IAM policy\n4. For Lambda subscriptions, make sure to grant the necessary permissions to the Lambda function\n\n## License\n\nMIT Licensed. See LICENSE for full details. \n\n## Maintainers\n\nThis module is maintained by [Senora.dev](https://senora.dev). ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsenora-dev%2Fterraform-aws-sns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsenora-dev%2Fterraform-aws-sns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsenora-dev%2Fterraform-aws-sns/lists"}