SOC de pobre na AWS: GuardDuty, Security Hub e alerta no Discord ou Teams
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á, esper
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.
Originally published by Dev.to Security. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.