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:

  1. 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).
  2. Comece em 70 e só desça para MEDIUM quando o time der conta.
  3. 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.