Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dod-iac/terraform-aws-notify-slack-kms

Terraform module which creates SNS topic and Lambda function which sends notifications to Slack with KMS keys pre-configured
https://github.com/dod-iac/terraform-aws-notify-slack-kms

kms lambda slack sns terraform terraform-module

Last synced: 14 days ago
JSON representation

Terraform module which creates SNS topic and Lambda function which sends notifications to Slack with KMS keys pre-configured

Host: GitHub
URL: https://github.com/dod-iac/terraform-aws-notify-slack-kms
Owner: dod-iac
License: mit
Created: 2021-06-14T21:07:27.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2021-06-14T21:12:27.000Z (over 3 years ago)
Last Synced: 2024-11-11T07:29:09.569Z (2 months ago)
Topics: kms, lambda, slack, sns, terraform, terraform-module
Language: HCL
Homepage: https://registry.terraform.io/modules/dod-iac/notify-slack-kms/aws/latest
Size: 9.77 KB
Stars: 1
Watchers: 5
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        
# Terraform AWS Notify Slack

## Description

Terraform module which creates SNS topic and Lambda function which sends notifications to Slack with KMS keys pre-configured

See the original [notify-slack](https://registry.terraform.io/modules/terraform-aws-modules/notify-slack/aws/latest) for more details.

## Usage

``` hcl

module "notify_slack" {

  source = "dod-iac/notify-slack-kms/aws"

  version = "1.0.0"

  ssm_namespace = "/project-app"

}

```

Using AWS SSM Parameter Store you will need to create these variables:

* `/project-app/notify_slack_webhook_url`

* `/project-app/notify_slack_channel`

* `/project-app/notify_slack_username`

* `/project-app/notify_slack_emoji` (without `:` symbols)

The variable `/project-app/notify_slack_webhook_url` should be the webhook url where the SNS topic will post.

The URL uses a KMS key to encode it so the lambda function doesn't expose the value.

## Requirements

| Name | Version |

|------|---------|

|  [terraform](#requirement\_terraform) | >= 0.13 |

|  [aws](#requirement\_aws) | ~> 3.0 |

|  [template](#requirement\_template) | ~> 2.2 |

## Providers

| Name | Version |

|------|---------|

|  [aws](#provider\_aws) | ~> 3.0 |

## Modules

| Name | Source | Version |

|------|--------|---------|

|  [cloudwatch\_kms\_key](#module\_cloudwatch\_kms\_key) | dod-iac/cloudwatch-kms-key/aws | ~> 1.0.0 |

|  [notify\_slack](#module\_notify\_slack) | terraform-aws-modules/notify-slack/aws | ~> 4.14 |

|  [slack\_alerts](#module\_slack\_alerts) | terraform-aws-modules/sns/aws | ~> 2.0 |

|  [sns\_kms\_key](#module\_sns\_kms\_key) | dod-iac/sns-kms-key/aws | n/a |

## Resources

| Name | Type |

|------|------|

| [aws_kms_alias.notify_slack_webhook_url](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/kms_alias) | resource |

| [aws_kms_ciphertext.notify_slack_webhook_url](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/kms_ciphertext) | resource |

| [aws_kms_key.notify_slack_webhook_url](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/kms_key) | resource |

| [aws_caller_identity.current](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/caller_identity) | data source |

| [aws_iam_policy_document.notify_slack_webhook_url_policy_doc](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/iam_policy_document) | data source |

| [aws_partition.current](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/partition) | data source |

| [aws_ssm_parameter.notify_slack_channel](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/ssm_parameter) | data source |

| [aws_ssm_parameter.notify_slack_emoji](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/ssm_parameter) | data source |

| [aws_ssm_parameter.notify_slack_username](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/ssm_parameter) | data source |

| [aws_ssm_parameter.notify_slack_webhook_url](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/ssm_parameter) | data source |

## Inputs

| Name | Description | Type | Default | Required |

|------|-------------|------|---------|:--------:|

|  [cloudwatch\_log\_group\_retention\_in\_days](#input\_cloudwatch\_log\_group\_retention\_in\_days) | Specifices the number of days to retain logs from cloudwatch | `number` | `90` | no |

|  [name](#input\_name) | A unique name for the module | `string` | `"sns"` | no |

|  [ssm\_namespace](#input\_ssm\_namespace) | The namespace for AWS SSM | `string` | n/a | yes |

|  [tags](#input\_tags) | tags for resources | `map` | `{}` | no |

## Outputs

| Name | Description |

|------|-------------|

|  [slack\_kms\_key\_id](#output\_slack\_kms\_key\_id) | The KMS Key to encrypt Slack Webhook URLs |

|  [sns\_topic\_arn](#output\_sns\_topic\_arn) | The ARN of the SNS topic |