Saltar al contenido

¿Cómo uso EventBridge con un tema de Amazon SNS para configurar notificaciones por correo electrónico personalizadas para los resultados de Security Hub?

5 minutos de lectura
0

Quiero usar Amazon EventBridge con un tema de Amazon Simple Notification Service (Amazon SNS) para configurar notificaciones de correo electrónico personalizadas para AWS Security Hub.

Descripción corta

La siguiente resolución muestra cómo configurar Amazon EventBridge con Amazon SNS para recibir notificaciones de Security Hub. Según la regla de EventBridge, Amazon SNS envía una notificación a la dirección de correo electrónico suscrita al tema cuando se produce el evento. Una función de AWS Lambda crea un mensaje de alerta personalizado con un formato mejorado.

Resolución

Creación de un tema y una suscripción de SNS

Sigue estos pasos:

  1. Abre la consola de Amazon SNS.
  2. En el panel de navegación, elige Temas.
  3. Elige Crear tema.
  4. En la sección Detalles, en Tipo, elige Estándar.
  5. En Nombre, introduce el nombre de tu política.
  6. Elige Crear tema.
  7. En el tema creado, elige Crear suscripción.
  8. En Tema ARN, selecciona el nombre de recurso de Amazon (ARN) del tema que creaste si no se rellena automáticamente.
  9. En Protocolo, selecciona Correo electrónico.
  10. En Punto de enlace, introduce la dirección de correo electrónico en la que quieras recibir las notificaciones de SNS.
  11. Selecciona Crear suscripción.
    Importante: Debes confirmar la suscripción en el correo electrónico de confirmación enviado al suscriptor para que la suscripción pase de estado PendingConfirmation a Confirmado.
  12. (Opcional) También puedes crear una suscripción autenticada que impida cancelar la suscripción en relación con tu tema.

Creación de una función de Lambda

Sigue estos pasos:

  1. Abre la consola de Lambda.
  2. En el panel de navegación, selecciona Funciones.
  3. Selecciona Crear función.
  4. Selecciona Crear desde cero.
  5. En Nombre de la función, introduce un nombre para la función.
  6. Elige Versión ejecutable y, a continuación, Python 3.14.
  7. En Arquitectura, selecciona x86_64.
  8. Expande Cambiar el rol de ejecución predeterminado.
  9. En Rol de ejecución, selecciona Crear un nuevo rol a partir de las plantillas de políticas de AWS.
  10. En Nombre de rol, introduce un nombre para el rol.
  11. En Plantilla de política, elige la política de publicación de Amazon SNS.
  12. Selecciona Crear función.
  13. Introduce el siguiente código en la sección Código fuente:
import json
import boto3

sns = boto3.client('sns')

def lambda_handler(event, context):

    #Extract details from JSON event
    detailType= event["detail-type"]
    region = event["region"]
    accountId = event["account"]

    #Security Hub Insight Results
    if (detailType == "Security Hub Insight Results"):

        action = event["detail"]["actionDescription"]

        message = "Alert: %s in %s for account: %s\n Action description: %s" % (detailType, region,accountId,action)

    elif  ("Security Hub Findings" in detailType):

        finding = event["detail"]["findings"][0]
        findingTime = finding["FirstObservedAt"]
        findingType = finding["Types"][0]
        findingDescription = finding["Description"]
        remediation = finding["Remediation"]["Recommendation"]["Text"]

        #Security Hub Findings - Custom finding
        if(detailType == "Security Hub Findings - Custom"):
            complianceStatus = finding["Compliance"]["Status"]
            severity = finding["Severity"]["Label"]
            remediationUrl = finding["Remediation"]["Recommendation"]["Url"]

            message = "Alert: %s in %s for account: %s\n\nFinding regarding: [%s] %s\n Severity: %s\nDescription: %s\nFirst observed at: %s\n%s: %s" % (detailType, region, accountId, complianceStatus, findingType,
            severity, findingDescription, findingTime, remediation, remediationUrl)

        #Security Hub Findings - Imported finding
        else:
            message = "Alert: %s in %s for account: %s\n\nFinding regarding: %s\nFirst observed at: %s\nRemediation recommendation: %s" % (detailType, region, accountId, findingDescription,findingTime, remediation)

    #AWS API Call via CloudTrail finding
    elif (detailType == "AWS API Call via CloudTrail"):

        time = event["detail"]["eventTime"]
        eventName = event["detail"]["eventName"]
        requestParameters = event["detail"]["requestParameters"]

        message = "Alert: %s in %s for account: %s at time: %s\n\n Event: %s \n Request parameters: %s" % (detailType, region, accountId, time, eventName, requestParameters)


    #If the event doesn't match any of the above, return the event    
    else:
        message = str(event)

    response = sns.publish(
            TopicArn = "arn:aws:sns:eu-west-1:111122233333:your-arn",
            Message = message
            )

    return {
      'statusCode': 200,
      'body': json.dumps('Success!')
}

Nota: Sustituye arn:aws:sns:eu-west-1:111122233333:your-arn por el ARN de tus temas. Selecciona Desplegar.

Creación y configuración de la regla de EventBridge

Sigue estos pasos:

  1. Abre la consola de EventBridge.
  2. En el panel de navegación, selecciona Reglas y, a continuación, selecciona Crear regla.
  3. Introduce un nombre para la regla y, a continuación, selecciona Siguiente.
  4. En Método de creación, selecciona Usar formulario de patrón.
  5. En Origen del evento, selecciona Servicios de AWS.
  6. En servicio de AWS, selecciona Security Hub.
  7. En **Tipo de evento **, selecciona Todos los eventos y, a continuación, elige Siguiente.
    Nota: También puedes configurar alertas para eventos específicos en lugar de para todos los eventos.
  8. En Tipos de objetivo, selecciona Servicio de AWS.
  9. En Seleccionar un objetivo, elige Función de Lambda.
  10. En Función, elige la función que creaste anteriormente y, a continuación, elige Siguiente.
  11. En la página Configurar etiquetas, elige Siguiente.
  12. Elige Crear regla.

Recepción de una notificación personalizada

Cuando se producen los eventos configurados, recibirás un correo electrónico de notificación personalizado de no-reply@sns.amazonaws.com.

Los eventos predeterminados de Security Hub se reformatean en un formato personalizado que es más legible.

Ejemplo de mensaje de resultado de Security Hub Insight

Predeterminado:

{"version": "0", "id": "ac844908-d14e-05b1-4b7b-836d85110e26", "detail-type": "Security Hub Insight Results", "source": "aws.securityhub", "account": "123456789012", "time": "2019-04-11T21:31:57Z", "region": "us-east-1", "resources": ["arn:aws:securityhub:us-east-1:123456789012:action/custom/slackMessaging"], "detail": {"actionName": "SendToSlack", "actionDescription": "Send Findings to Slack", "insightName": "5. AWS users with the most suspicious activity", "insightArn": "arn:aws:securityhub:::insight/securityhub/default/9", "resultType": "ResourceAwsIamAccessKeyUserName", "insightResults": [{"Admin": 7}, {"DenySlr_UI_User": 1}]}}

Personalizado:

Alerta: Security Hub Insight da como resultado us-east-1 para la cuenta: 123456789012

Descripción de la acción: Envío de los resultados a Slack

Nota: Puedes editar el mensaje para cada tipo de resultado de seguridad para tu caso de uso.

Información relacionada

¿Cómo puedo configurar las reglas de EventBridge para que GuardDuty envíe notificaciones de SNS personalizadas para tipos de resultados de servicios específicos?

Tutorial: uso de transformadores de entrada para personalizar lo que EventBridge transfiere al objetivo del evento

¿Por qué mi regla de EventBridge no invocó mi función de Lambda?