Dev.to Security 🔐 Cybersecurity 👁 0 📖 5 min read

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:

  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.

📰 Read the original article on Dev.to Security

Originally published by Dev.to Security. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.