Este producto no es compatible con el sitio de Datadog seleccionado. ().

Descripción general

La Protección de aplicaciones y API (AAP) incluye un conjunto de reglas de detección preconfiguradas que tienen como objetivo detectar intentos de ataque, vulnerabilidades encontradas por atacantes y abusos de lógica de negocio que afectan a sus sistemas de producción.

Sin embargo, hay situaciones en las que es posible que desee personalizar una regla según su entorno o carga de trabajo. Por ejemplo, es posible que desee personalizar una regla de detección que detecte a los usuarios que realizan acciones confidenciales desde una ubicación geográfica donde su empresa no opera.

Otro ejemplo es personalizar una regla para excluir un escáner de Security interno. AAP detecta su actividad como se espera. Sin embargo, es posible que no desee recibir notificaciones de su escaneo recurrente.

En estas situaciones, se puede crear una regla de detección personalizada para excluir dichos eventos. Esta guía le muestra cómo crear una regla de detección personalizada para AAP.

Regla de detección de abuso de lógica de negocio

AAP ofrece reglas preconfiguradas para detectar el abuso de lógica de negocio (por ejemplo, restablecer una contraseña mediante fuerza bruta). Esas reglas requieren agregar información de lógica de negocio a las trazas.

Los SDK de Datadog recientes intentan detectar y enviar eventos de inicio de sesión y registro de usuario automáticamente sin necesidad de modificar el código. Si es necesario, puede optar por no participar en el seguimiento automático de eventos de actividad del usuario.

Puede filtrar las reglas e identificar qué lógica de negocio comenzar a hacer un seguimiento. Además, puede usar estas reglas como modelo para crear reglas personalizadas basadas en su propia lógica de negocio.

Consulte la sección a continuación para ver cómo configurar sus reglas.

Configuración

Para personalizar una regla de detección preconfigurada, primero debe clonar una regla existente. Navegue a sus Reglas de detección y seleccione una regla. Desplácese hasta la parte inferior de la regla y haga clic en el botón Clone Rule. Esto ahora le permite editar la regla existente.

Defina una consulta AAP

Construya una consulta AAP usando la misma sintaxis de consulta que en AAP Trace Explorer. Por ejemplo, cree una consulta para hacer un seguimiento de inicios de sesión exitosos desde fuera de los Estados Unidos: @appsec.security_activity:business_logic.users.login.success -@actor.ip_details.country.iso_code:US.

Opcionalmente, defina un conteo único y una agrupación de señales. Cuente el número de valores únicos observados para un atributo en un marco de tiempo determinado. El group-by definido genera una señal para cada valor de group-by. Por lo general, el group-by es una entidad (como usuario, IP o servicio). El group-by también se usa para unir las consultas.

Use la sección de vista previa para ver qué trazas de AAP coinciden con la consulta de búsqueda. También puede agregar consultas adicionales con el botón Add Query.

Unión de consultas

Unir consultas para abarcar un marco de tiempo puede aumentar la confianza o la gravedad de la Señal de Seguridad. Por ejemplo, para detectar un ataque exitoso, se pueden correlacionar tanto los activadores exitosos como los fallidos para un servicio.

Las consultas se correlacionan mediante el uso de un valor group by. El valor group by es normalmente una entidad (por ejemplo, IP o Service), pero puede ser cualquier atributo.

Por ejemplo, cree consultas opuestas que busquen la misma actividad business_logic.users.login.success, pero añada consultas de ruta HTTP opuestas para intentos exitosos y fallidos:

Consulta 1: @appsec.security_activity:business_logic.users.login.success @actor.ip_details.country.iso_code:US.

Consulta 2: @appsec.security_activity:business_logic.users.login.success -@actor.ip_details.country.iso_code:US.

En este caso, las consultas unidas técnicamente mantienen el mismo valor de atributo: el valor debe ser el mismo para que se cumpla la incidencia. Si un valor group by no existe, la incidencia nunca se cumplirá. Se genera una señal de seguridad para cada valor group by único cuando se cumple una incidencia.

Excluir actividad benigna con consultas de supresión

En el campo Only generate a signal if there is a match, tiene la opción de ingresar una consulta para que solo se genere un activador cuando se cumpla un valor.

En el campo This rule will not generate a signal if there is a match, tiene la opción de ingresar consultas de supresión para que no se genere un activador cuando se cumplan los valores. Por ejemplo, si un servicio está activando una señal, pero la acción es benigna y ya no desea que se generen señales desde este servicio, cree una consulta que excluya service.

Establecer una incidencia de regla

Activador

Los casos de regla, como successful login > 0, se evalúan como declaraciones de incidencia. Por lo tanto, la primera incidencia que coincida genera la señal. Cree una o varias incidencias de regla y haga clic en el área gris junto a ellas para arrastrar y manipular su orden.

Un caso de regla contiene operaciones lógicas (>, >=, &&, ||) para determinar si se debe generar una señal según los conteos de eventos en las consultas definidas previamente.

Nota: La etiqueta de la consulta debe preceder al operador. Por ejemplo, a > 3 está permitido; 3 < a no está permitido.

Proporcione un nombre para cada incidencia de regla. Este nombre se añade al nombre de la regla cuando se genera una señal.

Gravedad y notificación

In the Set severity to dropdown menu, select the appropriate severity level (INFO, LOW, MEDIUM, HIGH, CRITICAL).

In the Add notify section, click Add Recipient to optionally configure notification targets.

You can also create notification rules to avoid manual edits to notification preferences for individual detection rules.

Ventanas de tiempo

An evaluation window is specified to match when at least one of the cases matches true. This is a sliding window and evaluates cases in real time.

After a signal is generated, the signal remains “open” if a case is matched at least once within the keep alive window. Each time a new event matches any of the cases, the last updated timestamp is updated for the signal.

A signal closes once the time exceeds the maximum signal duration, regardless of the query being matched. This time is calculated from the first seen timestamp.

Haga clic en Add Case para agregar casos adicionales.

Nota: El evaluation window debe ser menor o igual que el keep alive y el maximum signal duration.

Diga lo que está sucediendo

  1. Enter a Rule name. The name appears in the detection rules list view and the title of the security signal.
  2. In the Rule message section, use notification variables and Markdown to customize the notifications sent when a signal is generated.
  3. Use the Tag resulting signals dropdown menu to add tags to your signals. For example, security:attack or technique:T1110-brute-force.
    • Note: the tag security is special. This tag is used to classify the security signal. The recommended options are: attack, threat-intel, compliance, anomaly, and data-leak.

Utilice el menú desplegable Tag resulting signals para agregar etiquetas a sus señales. Por ejemplo, attack:sql-injection-attempt.

Nota: La etiqueta security es especial. Esta etiqueta se utiliza para clasificar la señal de seguridad. Las opciones recomendadas son: attack, threat-intel, compliance, anomaly y data-leak.

Lecturas adicionales