Monitor the reputation of your mail server IPs with ease.
- Monitor your server IP reputation on common block lists
- Specify the IPs with AWS SES or env variable
- Export findings to PagerDuty alerts and more
- Easily extendable plugin architecture
- Ready to use terraform modules for AWS
# Create lambda resources
module "monitor" {
source = "github.com/trustedshops-public/mail-blocklist-monitor//terraform/modules/lambda?ref=<version>"
environment_variables = {
LOG_LEVEL = "INFO"
MAX_CLASSIFICATION = "yellow"
EXPORTER_PAGERDUTY_ENABLED = "true"
EXPORTER_PAGERDUTY_INTEGRATION_KEY = local.pagerduty_integration_key
# just pull ips from ses in the example
IP_PROVIDER_SES_REGIONS = "eu-central-1,eu-west-1"
}
create_cloudwatch_alarm = true
}
# Execute lambda every day
module "cron" {
source = "github.com/trustedshops-public/mail-blocklist-monitor//terraform/modules/cron?ref=<version>"
lambda_arn = module.monitor.lambda_arn
lambda_function_name = module.monitor.lambda_function_name
}See monitor/README.md for all configuration environment variables
- Download the latest binary for your supported platform from GitHub releases
- Configure the monitor using environment variables (see monitor/README.md) for
more details
- Make sure
ENVIRONMENTis set tostandalone
- Make sure
- Execute the binary with crontab, manually etc
There are some paid tools out there or even some board resources for some providers. But none satisfied our needs so we built a small customizable solution to make monitoring easy and effortless. It integrates well with PagerDuty and requires no maintenance.
This project consists of two parts:
- monitor: Go application (to be run in AWS Lambda or standalone) with plugin architecture that checks again block lists, getting IPs from sources and exporting to targets (e. g. PagerDuty incidents).
- terraform modules: Terraform modules to easily deploy the monitor using AWS Serverless ecosystem.
The monitor is built using a plugin architecture. So if you need additional sources, targets and exporters feel free to create a PR or fork to customize to match your demands.
| Name | Version |
|---|---|
| Go | 1.20+ |
| terraform | 1.3+ |
| pre-commit | * |
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent