Contas, regiões e webhooks são placeholders.
O cenário
Empresa pequena, <N> contas AWS, nenhum SIEM e nenhum analista olhando console. O GuardDuty até está ligado em uma conta, mas os findings ficam lá, esperando alguém abrir a página.
O que a gente quer é simples:
- GuardDuty e Security Hub ligados em todas as contas e regiões, administrados de uma conta de segurança.
- Tudo agregado numa região só.
- Finding grave (severidade 7 ou mais) vira mensagem no canal do time em menos de 5 minutos.
Custo de ferramenta de terceiro: zero.
Contas:
- Gerenciamento da Organization:
<ACCOUNT_ID_MGMT> - Segurança (administradora delegada):
<ACCOUNT_ID_SEGURANCA> - Região de agregação:
sa-east-1
Passo 1: GuardDuty com administrador delegado
Na conta de gerenciamento, delegue a administração para a conta de segurança. O GuardDuty é regional, então repita para cada região que você usa (ou todas, que é o recomendado):
export AWS_PROFILE="<PERFIL_MGMT>" for R in sa-east-1 us-east-1; do aws guardduty enable-organization-admin-account \ --region "$R" --admin-account-id "<ACCOUNT_ID_SEGURANCA>" done Na conta de segurança, ligue o auto-enable para todas as contas da Organization, atuais e futuras:
export AWS_PROFILE="<PERFIL_SEGURANCA>" for R in sa-east-1 us-east-1; do DET=$(aws guardduty list-detectors --region "$R" --query 'DetectorIds[0]' --output text) aws guardduty update-organization-configuration --region "$R" \ --detector-id "$DET" --auto-enable-organization-members ALL done Proteções adicionais (S3, EKS, Runtime, Malware) são cobradas à parte. Comece pelo básico e ligue as outras conforme o ambiente.
Passo 2: Security Hub e agregação
Na conta de gerenciamento:
export AWS_PROFILE="<PERFIL_MGMT>" aws securityhub enable-organization-admin-account \ --region sa-east-1 --admin-account-id "<ACCOUNT_ID_SEGURANCA>" Na conta de segurança, agregue todas as regiões em sa-east-1:
export AWS_PROFILE="<PERFIL_SEGURANCA>" aws securityhub create-finding-aggregator --region sa-east-1 \ --region-linking-mode ALL_REGIONS aws securityhub update-organization-configuration --region sa-east-1 \ --auto-enable --auto-enable-standards DEFAULT Em organizações maiores, vale olhar a configuração central do Security Hub (
--organization-configuration ConfigurationType=CENTRAL), que gerencia padrões e controles por política. Para começar, a configuração local acima resolve.
Com isso, findings do GuardDuty de todas as contas e regiões chegam no Security Hub da conta de segurança em sa-east-1. Um ponto único para o alerta.
Passo 3: guardar o webhook com segurança
Webhook é segredo: quem tem a URL posta no seu canal. Nada de deixar em variável de ambiente da Lambda em texto puro.
aws ssm put-parameter --region sa-east-1 \ --name /seguranca/webhook-alertas \ --type SecureString \ --value "<URL_DO_WEBHOOK>" Passo 4: a Lambda
Python puro, sem dependência externa. Funciona com Discord e com Microsoft Teams (Workflows), escolhendo pelo formato.
"""Encaminha findings graves do Security Hub para Discord ou Teams.""" import json import os import urllib.request import boto3 SSM = boto3.client("ssm") PARAM = os.environ.get("WEBHOOK_PARAM", "/seguranca/webhook-alertas") FORMATO = os.environ.get("FORMATO", "discord") # discord ou teams SEV_MINIMA = float(os.environ.get("SEVERIDADE_MINIMA", "70")) _webhook_cache = None def webhook_url(): global _webhook_cache if _webhook_cache is None: resp = SSM.get_parameter(Name=PARAM, WithDecryption=True) _webhook_cache = resp["Parameter"]["Value"] return _webhook_cache def montar_texto(f): sev = f.get("Severity", {}) recurso = (f.get("Resources") or [{}])[0] return ( f"**[{sev.get('Label', '?')}] {f.get('Title', 'sem titulo')}**\n" f"Conta: `{f.get('AwsAccountId', '?')}` | Regiao: `{f.get('Region', '?')}`\n" f"Recurso: `{recurso.get('Type', '?')}` `{recurso.get('Id', '?')}`\n" f"Origem: {f.get('ProductName', '?')}\n" f"{(f.get('Description') or '')[:500]}" ) def payload(texto): if FORMATO == "teams": return {"text": texto} return {"content": texto[:1990]} def enviar(texto): req = urllib.request.Request( webhook_url(), data=json.dumps(payload(texto)).encode("utf-8"), headers={"Content-Type": "application/json"}, method="POST", ) with urllib.request.urlopen(req, timeout=10) as resp: return resp.status def handler(event, context): findings = event.get("detail", {}).get("findings", []) enviados = 0 for f in findings: if f.get("Severity", {}).get("Normalized", 0) < SEV_MINIMA: continue if f.get("Workflow", {}).get("Status") == "SUPPRESSED": continue enviar(montar_texto(f)) enviados += 1 print(json.dumps({"recebidos": len(findings), "enviados": enviados})) return {"enviados": enviados} No Security Hub, Severity.Normalized vai de 0 a 100. 70 ou mais corresponde a HIGH e CRITICAL.
Role da Lambda (perm-lambda-alertas.json), com o mínimo:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "LerWebhook", "Effect": "Allow", "Action": "ssm:GetParameter", "Resource": "arn:aws:ssm:sa-east-1:<ACCOUNT_ID_SEGURANCA>:parameter/seguranca/webhook-alertas" }, { "Sid": "Logs", "Effect": "Allow", "Action": ["logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents"], "Resource": "arn:aws:logs:sa-east-1:<ACCOUNT_ID_SEGURANCA>:*" } ] } Se o parâmetro usar uma chave KMS própria, inclua kms:Decrypt nela. Com a chave padrão aws/ssm, não precisa.
Trust policy (trust-lambda.json):
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "lambda.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } Deploy:
aws iam create-role --role-name lambda-alertas-seguranca \ --assume-role-policy-document file://trust-lambda.json aws iam put-role-policy --role-name lambda-alertas-seguranca \ --policy-name alertas --policy-document file://perm-lambda-alertas.json zip alertas.zip alertas.py aws lambda create-function --region sa-east-1 \ --function-name alertas-seguranca \ --runtime python3.12 \ --handler alertas.handler \ --zip-file fileb://alertas.zip \ --role "arn:aws:iam::<ACCOUNT_ID_SEGURANCA>:role/lambda-alertas-seguranca" \ --timeout 30 \ --environment 'Variables={FORMATO=discord,SEVERIDADE_MINIMA=70}' Passo 5: a regra do EventBridge
Padrão do evento (padrao-findings.json). Filtra já no EventBridge para não acordar a Lambda à toa:
{ "source": ["aws.securityhub"], "detail-type": ["Security Hub Findings - Imported"], "detail": { "findings": { "Severity": { "Label": ["HIGH", "CRITICAL"] }, "Workflow": { "Status": ["NEW"] }, "RecordState": ["ACTIVE"] } } } aws events put-rule --region sa-east-1 \ --name alertas-seguranca-graves \ --event-pattern file://padrao-findings.json aws lambda add-permission --region sa-east-1 \ --function-name alertas-seguranca \ --statement-id eventbridge-alertas \ --action lambda:InvokeFunction \ --principal events.amazonaws.com \ --source-arn "arn:aws:events:sa-east-1:<ACCOUNT_ID_SEGURANCA>:rule/alertas-seguranca-graves" aws events put-targets --region sa-east-1 \ --rule alertas-seguranca-graves \ --targets "Id=lambda,Arn=arn:aws:lambda:sa-east-1:<ACCOUNT_ID_SEGURANCA>:function:alertas-seguranca" Passo 6: testar de verdade
O GuardDuty gera findings de exemplo. Eles chegam no Security Hub e devem aparecer no canal:
DET=$(aws guardduty list-detectors --region sa-east-1 --query 'DetectorIds[0]' --output text) aws guardduty create-sample-findings --region sa-east-1 \ --detector-id "$DET" \ --finding-types "CryptoCurrency:EC2/BitcoinTool.B!DNS" Em poucos minutos, a mensagem tem que estar no Discord. Se não chegou:
aws logs tail /aws/lambda/alertas-seguranca --region sa-east-1 --since 15m Evitando fadiga de alerta
Em uma semana o canal vira ruído se você não cuidar. Três práticas:
- Suprima o que é aceito, com regra de automação do Security Hub marcando o finding como
SUPPRESSED(por exemplo, um scanner de vulnerabilidade autorizado que sempre gera o mesmo finding). - Comece em 70 e só desça para
MEDIUMquando o time der conta. - Todo alerta precisa de dono. Se ninguém reage, ele não serve pra nada.
Não é um SOC 24x7. Mas é a diferença entre descobrir o minerador em 5 minutos ou na fatura do mês seguinte.