https://github.com/neilkuan/cdk-events-notify
Provides you to trigger Lambda Function push notifications Slack when you discover Console Login event or switch role event through Cloudtrail.
https://github.com/neilkuan/cdk-events-notify
event lambda line-notify slack
Last synced: 23 days ago
JSON representation
Provides you to trigger Lambda Function push notifications Slack when you discover Console Login event or switch role event through Cloudtrail.
- Host: GitHub
- URL: https://github.com/neilkuan/cdk-events-notify
- Owner: neilkuan
- License: apache-2.0
- Created: 2020-11-06T08:43:57.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-05-08T00:33:11.000Z (about 2 months ago)
- Last Synced: 2026-05-08T02:48:32.617Z (about 2 months ago)
- Topics: event, lambda, line-notify, slack
- Language: Python
- Homepage: https://constructs.dev/packages/cdk-events-notify/v/0.3.76?lang=typescript
- Size: 10.3 MB
- Stars: 13
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://badge.fury.io/js/cdk-events-notify)
[](https://badge.fury.io/py/cdk-events-notify)
# cdk-events-notify
`cdk-events-notify` is an AWS CDK Construct Library that provides you know who login in your aws console.
## Why
It's just a small feature at the moment,
Provides you to trigger Lambda Function push notifications to Slack when you discover Console Login event or switch role event through Cloudtrail.
> Welcome to contribute another event notify case you want.
## Overview
### Now support
- Slack ([webhooks](https://api.slack.com/messaging/webhooks#posting_with_webhooks))
> **Breaking Change**: Line Notify support has been removed since [#2663](https://github.com/neilkuan/cdk-events-notify/pull/2663). Line Notify service was officially shut down by LINE on 2025-03-31, so this library now supports Slack only. If you need Line Notify functionality, please pin to a version prior to this change.
## You need enable one `Management events` in your account.
> more see https://aws.amazon.com/tw/cloudtrail/pricing/
## Install
```bash
// for CDKv2
npm install cdk-events-notify
or
npm install cdk-events-notify@latest
```
## Usage
```ts
import * as cdk from 'aws-cdk-lib';
import { EventNotify } from 'cdk-events-notify';
const app = new cdk.App();
const stack = new cdk.Stack(app, 'integ-stack', { env });
new EventNotify(stack, 'SlackEventNotify', {
slack: {
slackChannelName: 'your-channel-name',
slackWebhookUrl: 'https://hooks.slack.com/services/xxx/xxx/xxx',
},
});
```
### To deploy
```bash
cdk deploy
```
### To destroy
```bash
cdk destroy
```
### Finally
- slack
## More about EventBridge and Lambda
- [EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/aws-events.html)
- [Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)
> Note: Event Bridge can not cross region , if you console sign in not the cdk-events-notify region will not get the evnet in cloudtrail see this [docs](https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html#cloudtrail-integration_signin-regions)
## :clap: Supporters
[](https://github.com/neilkuan/cdk-events-notify/stargazers)
[](https://github.com/neilkuan/cdk-events-notify/network/members)