{"id":13821229,"url":"https://github.com/Signiant/aws-iam-slack-notifer","last_synced_at":"2025-05-16T12:33:00.505Z","repository":{"id":49579463,"uuid":"104936690","full_name":"Signiant/aws-iam-slack-notifer","owner":"Signiant","description":"Notifies slack when an IAM policy is created, changed or assigned to a role","archived":false,"fork":false,"pushed_at":"2021-06-13T17:04:19.000Z","size":187,"stargazers_count":33,"open_issues_count":2,"forks_count":6,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-20T11:43:10.060Z","etag":null,"topics":["aws","aws-lambda","iam","iam-policy","slack"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Signiant.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-26T20:53:46.000Z","updated_at":"2022-09-07T19:12:04.000Z","dependencies_parsed_at":"2022-09-12T16:04:12.315Z","dependency_job_id":null,"html_url":"https://github.com/Signiant/aws-iam-slack-notifer","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Signiant%2Faws-iam-slack-notifer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Signiant%2Faws-iam-slack-notifer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Signiant%2Faws-iam-slack-notifer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Signiant%2Faws-iam-slack-notifer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Signiant","download_url":"https://codeload.github.com/Signiant/aws-iam-slack-notifer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254530639,"owners_count":22086651,"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":["aws","aws-lambda","iam","iam-policy","slack"],"created_at":"2024-08-04T08:01:18.127Z","updated_at":"2025-05-16T12:32:55.490Z","avatar_url":"https://github.com/Signiant.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# aws-iam-policy-slack-notifer\nNotifies slack when an IAM policy is created, changed or assigned to a role\n\n[![Build Status](https://travis-ci.org/Signiant/aws-iam-slack-notifer.svg?branch=master)](https://travis-ci.org/Signiant/aws-iam-slack-notifer)\n\n# Purpose\nNotifies a slack channel when an AWS IAM policy is manipulated\n\n# Sample Output\n\n![Sample Slack Posts](https://raw.githubusercontent.com/Signiant/aws-iam-slack-notifer/master/images/slack-sample.jpg)\n\n# Installing and Configuring\n\n## Slack Setup\nBefore installing anything to AWS, you will need to configure a \"bot\" in Slack to handle the posts for you.  To do this:\n* In Slack, choose _Manage Apps_ -\u003e _Custom Integrations_ -\u003e _Bots_\n  * Add a new bot configuration\n  * username: aws-iam-notifier\n  * Copy the API Token.\n  * Don't worry about other parameters - the notifier over-rides them anyway\n\n## AWS Setup\n* Grab the latest Lambda function zip from [Releases](https://github.com/Signiant/aws-iam-slack-notifer/releases)\n* Create a new cloudformation stack using the template in the cfn folder\n\nThe stack asks for the function zip file location in S3, the slack API Key and the slack channel to post notifications to. Once the stack is created, a cloudwatch event is created to subscribe the lambda function to several IAM events around policy manipulation.\n\n## Filtering Slack Alerts\n\nUsing some optional environment variables defined on the Lambda function, you can also exclude certain Slack notifications for specific policy manipultation events.  Set the following variables on the function to `0` if you wish to exclude these events from notifying Slack:\n\n* CREATE_POLICY_NOTIFY\n* CREATE_POLICY_VERSION_NOTIFY\n* ATTACH_GROUP_POLICY_NOTIFY  /  DETACH_GROUP_POLICY_NOTIFY\n* ATTACH_USER_POLICY_NOTIFY  / DETACH_USER_POLICY_NOTIFY\n* ATTACH_ROLE_POLICY_NOTIFY  /  DETACH_ROLE_POLICY_NOTIFY\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSigniant%2Faws-iam-slack-notifer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSigniant%2Faws-iam-slack-notifer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSigniant%2Faws-iam-slack-notifer/lists"}