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

Esta página describe cómo configurar App and API Protection para Kubernetes a fin de configurar automáticamente los ingress proxies y gateways de Kubernetes compatibles para ejecutar el descubrimiento de API, la detección de amenazas y el bloqueo en línea en el borde de la infraestructura.

Descripción general

App and API Protection para Kubernetes configura automáticamente los ingress proxies y gateways compatibles en su clúster de Kubernetes para habilitar el monitoreo de seguridad de aplicaciones. Esto elimina la necesidad de una configuración manual del proxy y proporciona una cobertura de seguridad para toda la API sin modificar servicios individuales ni implementar rastreadores en toda su flota de aplicaciones.

¿Qué realiza la configuración automática?

App and API Protection para Kubernetes utiliza un controlador de Kubernetes (que se ejecuta en el Datadog Cluster Agent) que:

  • Detecta automáticamente los proxies compatibles en su clúster
  • Configura los proxies para enrutar el tráfico a través de un procesador de seguridad de aplicaciones externo
  • Habilita la detección de amenazas para todo el tráfico que pasa a través de su capa de entrada
  • Simplifica las operaciones mediante la configuración centralizada con Helm

Proxies compatibles

Para obtener la lista de proxies compatibles y los pasos de configuración específicos para cada proxy, consulte la página de configuración.

Limitaciones

Modo sidecar

  • Requiere Datadog Cluster Agent 7.80.2 o posterior
  • Cada pod de gateway ejecuta su propia instancia de procesador, lo que aumenta el uso de recursos por pod

Modo externo

  • Requiere Datadog Cluster Agent 7.80.2 o posterior
  • El procesador de seguridad debe implementarse y escalarse manualmente
  • El servicio implementado puede requerir una política de red adecuada:
    • Desde los pods de proxy en el puerto de servicio
    • Hacia el Datadog Agent para trazas

Compatibilidad de proxy

Requisitos previos

Antes de habilitar App and API Protection para Kubernetes, verifique que tenga:

Cómo funciona

App and API Protection para Kubernetes admite dos modos de implementación:

  • Modo sidecar (predeterminado): El procesador de Application Security se ejecuta como un contenedor sidecar inyectado directamente en cada pod de gateway. No se necesita una implementación de procesador por separado, y el procesador se escala automáticamente con sus pods de gateway.
  • Modo externo: Una única implementación centralizada del procesador de Application Security sirve a todo el tráfico de gateway en su clúster. Utilice este modo cuando desee administrar un procesador compartido para todo el clúster.

Para configurar el modo sidecar predeterminado, consulte Configurar el modo sidecar. Para implementar un procesador centralizado en su lugar, consulte Configurar el modo externo.

Configure el modo sidecar

En el modo sidecar, el procesador de seguridad se ejecuta como un contenedor inyectado directamente en cada pod de gateway. El Datadog Cluster Agent maneja la inyección automáticamente, por lo que no necesita una implementación o servicio de procesador independiente.

Cuándo usar el modo sidecar

  • Prefiere no administrar un despliegue y servicio de procesador independiente
  • Desea que el procesador esté ubicado junto con cada pod de gateway

Configuración

Agregue lo siguiente a su values.yaml. No se necesitan valores processor.service.* porque el inyector maneja el despliegue del procesador automáticamente.

datadog:
  appsec:
    injector:
      enabled: true
      # mode defaults to "sidecar" when omitted

Instale o actualice el gráfico de Helm de Datadog (versión 3.153 o posterior):

helm upgrade -i datadog-agent datadog/datadog -f values.yaml

Esta opción requiere la versión 1.31.0 o posterior de Datadog Operator.

Configure el inyector en la sección spec.features.appsec.injector de su recurso DatadogAgent. El modo sidecar es el predeterminado, por lo que habilitar el inyector es suficiente:

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  features:
    appsec:
      injector:
        enabled: true

Aplique la configuración:

kubectl apply -f datadog-agent.yaml

Referencia de configuración de sidecar

Todos los parámetros de sidecar están disponibles como valores de Helm anidados bajo datadog.appsec.injector.sidecar o como campos DatadogAgent bajo spec.features.appsec.injector.sidecar (versión 1.31.0 o posterior de Datadog Operator):

sidecar.image
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.image
Tipo: Cadena
Predeterminado: ghcr.io/datadog/dd-trace-go/service-extensions-callout
Descripción: Imagen del contenedor sidecar
sidecar.imageTag
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.imageTag
Tipo: Cadena
Predeterminado: v2.6.0
Descripción: Etiqueta de imagen del contenedor sidecar
sidecar.port
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.port
Tipo: Entero
Predeterminado: 8080
Descripción: Puerto de escucha gRPC para el procesador sidecar
sidecar.healthPort
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.healthPort
Tipo: Entero
Predeterminado: 8081
Descripción: Puerto de verificación de estado para el procesador sidecar
sidecar.bodyParsingSizeLimit
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.bodyParsingSizeLimit
Tipo: Entero
Predeterminado: 0
Descripción: Tamaño máximo del cuerpo de la solicitud en bytes a procesar. 0 deshabilita el procesamiento del cuerpo. Use -1 para deshabilitar el parseo del cuerpo por completo.
sidecar.resources.requests.cpu
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.resources.requests.cpu
Tipo: Cadena
Predeterminado: 10m
Descripción: Solicitud de CPU para el contenedor sidecar
sidecar.resources.requests.memory
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.resources.requests.memory
Tipo: Cadena
Predeterminado: 128Mi
Descripción: Solicitud de memoria para el contenedor sidecar
sidecar.resources.limits.cpu
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.resources.limits.cpu
Tipo: Cadena
Predeterminado: ""
Descripción: Límite de CPU para el contenedor sidecar (opcional)
sidecar.resources.limits.memory
Campo de Datadog Operator: spec.features.appsec.injector.sidecar.resources.limits.memory
Tipo: Cadena
Predeterminado: ""
Descripción: Límite de memoria para el contenedor sidecar (opcional)

Configure el modo externo

En el modo externo, usted implementa un procesador de Application Security único y centralizado que atiende todo el tráfico de gateway en su clúster. El Datadog Cluster Agent configura automáticamente sus proxies compatibles para dirigir el tráfico a este procesador.

Arquitectura

  • Despliegue del procesador de Application Security: Usted implementa un procesador de Application Security centralizado como un despliegue de Kubernetes con un servicio asociado.
  • Detección automática de proxies: El controlador hace un seguimiento de los recursos de proxies compatibles en su clúster utilizando informers de Kubernetes.
  • Configuración automática: Cuando se detectan proxies, el controlador crea la configuración de proxy necesaria para dirigir el tráfico al servicio del procesador de seguridad.
  • Procesamiento de tráfico: Los gateways dirigen el tráfico al procesador de seguridad a través del servicio de Kubernetes para su análisis de seguridad.

Beneficios

  • Eficiente en recursos: Un único procesador compartido maneja el tráfico de todos los gateways
  • Gestión centralizada: Una implementación para hacer un seguimiento, escalar y configurar
  • Infraestructura como código: Gestione la configuración a través de valores de Helm
  • No invasivo: No se requieren cambios en el código de la aplicación
  • Escalable: Agregue nuevos gateways sin configuración adicional

Paso 1: Implemente el procesador de seguridad

Implemente el servicio del procesador de seguridad, el cual analiza el tráfico reenviado desde sus gateways. Para obtener detalles de implementación específicos del proxy, consulte la documentación de configuración de su proxy.

Ejemplo de implementación:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: datadog-aap-extproc-deployment
  namespace: datadog
spec:
  replicas: 2
  selector:
    matchLabels:
      app: datadog-aap-extproc
  template:
    metadata:
      labels:
        app: datadog-aap-extproc
    spec:
      containers:
      - name: datadog-aap-extproc-container
        image: ghcr.io/datadog/dd-trace-go/service-extensions-callout:v2.4.0
        ports:
        - name: grpc
          containerPort: 443
        - name: health
          containerPort: 80
        env:
        # Use the address of the datadog agent service in your cluster
        - name: DD_AGENT_HOST
          value: "datadog-agent.datadog.svc.cluster.local"

        - name: DD_SERVICE_EXTENSION_TLS
          value: "false"
        readinessProbe:
          httpGet:
            path: /
            port: health
          initialDelaySeconds: 5
          periodSeconds: 10
        livenessProbe:
          httpGet:
            path: /
            port: health
          initialDelaySeconds: 15
          periodSeconds: 20
---
apiVersion: v1
kind: Service
metadata:
  name: datadog-aap-extproc-service
  namespace: datadog
spec:
  ports:
  - name: grpc
    port: 443
    targetPort: grpc
  selector:
    app: datadog-aap-extproc
  type: ClusterIP

Aplique el manifiesto:

kubectl apply -f datadog-aap-extproc-service.yaml

Paso 2: Habilite la configuración automática

Apunte el Datadog Cluster Agent a su servicio de procesador de seguridad usando Helm o el Datadog Operator.

Nota: El nombre del servicio del procesador (datadog-aap-extproc-service) debe coincidir con el servicio que implementó en el Paso 1.

Esta opción requiere la versión 1.31.0 o posterior de Datadog Operator.

Configure el inyector en la sección spec.features.appsec.injector de su recurso DatadogAgent. El nombre del servicio del procesador es obligatorio y debe coincidir con su servicio de procesador de seguridad:

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  features:
    appsec:
      injector:
        enabled: true
        mode: external
        processor:
          service:
            name: datadog-aap-extproc-service  # Required: must match your security processor service name
            namespace: datadog

Aplique la configuración:

kubectl apply -f datadog-agent.yaml

Configure App and API Protection para Kubernetes usando valores de Helm. Agregue lo siguiente a su values.yaml:

datadog:
  appsec:
    injector:
      enabled: true
      mode: "external"
      processor:
        service:
          name: datadog-aap-extproc-service  # Required: must match your security processor service name
          namespace: datadog                 # Must match the namespace where the service is deployed

Instale o actualice el gráfico de Helm de Datadog (versión 3.153 o posterior):

helm upgrade -i datadog-agent datadog/datadog -f values.yaml

Paso 3: Verifique la instalación

Verifique que el Cluster Agent haya detectado sus proxies:

kubectl logs -n datadog deployment/datadog-cluster-agent | grep appsec

Verifique la configuración de proxy

Verifique que el controlador haya creado los recursos de configuración de proxy para su proxy. Para comandos de verificación específicos del proxy, consulte la documentación de configuración de su proxy.

El Datadog Cluster Agent genera eventos para cada operación que resulta en fallo o éxito realizada en el clúster.

Pruebe el procesamiento de tráfico

Envíe solicitudes a través de su puerta de enlace y verifique que aparezcan en la interfaz de usuario de App and API Protection de Datadog:

  1. Navegue a Security > Application Security en Datadog.
  2. Busque señales de seguridad del tráfico de su puerta de enlace.
  3. Verifique que la detección de amenazas esté activa.

Referencia de configuración

Nota: Las anotaciones agent.datadoghq.com/appsec.* están obsoletas en la versión 1.31.0 de Datadog Operator y se eliminan en la versión 1.32.0. En su lugar, configure el inyector en spec.features.appsec.injector. Las dos fuentes son mutuamente excluyentes: cuando se establece spec.features.appsec.injector, las anotaciones se ignoran por completo, incluso para los campos que el CRD deja sin establecer, así que migre toda la configuración en un solo paso.

Opciones de configuración automática

enabled
Campo de Datadog Operator: spec.features.appsec.injector.enabled
Tipo: Booleano
Predeterminado: false
Descripción: Habilitar o deshabilitar la integración
mode
Campo de Datadog Operator: spec.features.appsec.injector.mode
Tipo: Cadena
Predeterminado: ""; cuando está vacío, el valor predeterminado es sidecar
Descripción: Modo de inyección: "sidecar" o "external"
autoDetect
Campo de Datadog Operator: spec.features.appsec.injector.autoDetect
Tipo: Booleano
Predeterminado: true
Descripción: Detectar y configurar automáticamente los proxies admitidos
proxies
Campo de Datadog Operator: spec.features.appsec.injector.proxies
Tipo: Matriz de cadenas
Predeterminado: []
Descripción: Lista manual de tipos de proxy a configurar. Para obtener valores válidos, consulte la página de configuración.
processor.service.name
Campo de Datadog Operator: spec.features.appsec.injector.processor.service.name
Tipo: Cadena
Predeterminado: Ninguno
Descripción: Requerido. Nombre del servicio de seguridad de Kubernetes
processor.service.namespace
Campo de Datadog Operator: spec.features.appsec.injector.processor.service.namespace
Tipo: Cadena
Predeterminado: De forma predeterminada, el espacio de nombres es aquel donde se ejecuta el Cluster Agent
Descripción: Espacio de nombres donde se despliega el servicio del procesador de seguridad
processor.address
Campo de Datadog Operator: spec.features.appsec.injector.processor.address
Tipo: Cadena
Predeterminado: {service.name}.{service.namespace}.svc
Descripción: Anulación de la dirección completa del servicio
processor.port
Campo de Datadog Operator: spec.features.appsec.injector.processor.port
Tipo: Entero
Predeterminado: 443
Descripción: Puerto del servicio del procesador de seguridad

Actualización desde el modo externo

Si está actualizando desde una versión anterior que utilizaba el modo externo, el modo predeterminado ha cambiado a sidecar. Para seguir usando el modo externo, configure explícitamente mode: "external" en sus valores de Helm:

datadog:
  appsec:
    injector:
      enabled: true
      mode: "external"
      processor:
        service:
          name: datadog-aap-extproc-service
          namespace: datadog

Exclusión de recursos específicos

Puede excluir recursos específicos de Gateway o GatewayClass de la configuración automática agregando una etiqueta:

apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: my-gateway
  namespace: my-namespace
  labels:
    appsec.datadoghq.com/enabled: "false"  # Exclude this gateway from automatic configuration
spec:
  # ... gateway configuration

Los recursos con la etiqueta appsec.datadoghq.com/enabled: "false" son ignorados. Esto es útil cuando desea:

  • Configurar manualmente gateways específicos
  • Deshabilitar temporalmente la protección de aplicaciones y API para realizar pruebas
  • Excluir ciertos gateways del monitoreo de seguridad

Nota: De forma predeterminada, todos los recursos están incluidos. Solo se excluyen los recursos con la etiqueta establecida explícitamente en "false".

Solución de problemas

Todos los errores se registran como eventos de Kubernetes. Busque eventos en el Gateway o GatewayClass que desea instrumentar.

La configuración automática no detecta proxies

Síntoma: No se crean recursos de configuración de proxy.

Soluciones:

  • Verifique que autoDetect esté configurado en true o que los proxies estén especificados manualmente
  • Verifique los registros del Cluster Agent para ver mensajes de detección de proxy
  • Verifique que sus proxies estén instalados y tengan los recursos de Kubernetes esperados (Gateway, GatewayClass)
  • Intente especificar manualmente los tipos de proxy usando el parámetro proxies

Configuración de proxy no creada

Síntoma: El controlador está en ejecución pero faltan recursos de configuración.

Soluciones:

  • Verifique los registros del Agent de clúster en busca de errores de permisos RBAC
  • Verifique que la cuenta de servicio del Agent de clúster tenga permisos para crear los recursos de configuración de proxy
  • Verifique que el servicio del procesador exista y sea accesible
  • Verifique si existen políticas o filtros conflictivos

Tráfico no procesado

Síntoma: No aparecen eventos de seguridad en la interfaz de usuario de Datadog.

Soluciones:

  • Verifique que la implementación del procesador de seguridad esté en ejecución: kubectl get pods -n datadog -l app=datadog-aap-extproc
  • Busque registros de advertencia en sus proxies inversos relacionados con esta parte de la configuración.
  • Verifique los registros del procesador en busca de errores de conexión: kubectl logs -n datadog -l app=datadog-aap-extproc
  • Verifique que el servicio del procesador esté configurado correctamente y sea resoluble
  • Pruebe la conectividad desde los pods de puerta de enlace al servicio del procesador
  • Verifique que Remote Configuration esté habilitado en su Datadog Agent

Problemas de conexión del procesador de seguridad

Síntoma: Las puertas de enlace no pueden comunicarse con el procesador de seguridad.

Soluciones:

  • Verifique que el nombre del servicio del procesador y el espacio de nombres coincidan con su configuración
  • Verifique si hay reglas de NetworkPolicy que bloqueen el tráfico entre espacios de nombres
  • Pruebe la resolución de DNS desde los pods de gateway: nslookup datadog-aap-extproc-service.datadog.svc.cluster.local
  • Verifique que la configuración del puerto del procesador coincida con la definición del servicio

Errores de permisos de RBAC

Síntoma: Los registros del Agent de clúster muestran errores de permiso denegado.

Soluciones:

  • Verifique que el clúster Agent ClusterRole incluya permisos para:
    • gateway.networking.k8s.io/gateways
    • gateway.networking.k8s.io/gatewayclasses
  • Verifique que el ClusterRoleBinding haga referencia a la cuenta de servicio correcta
  • Asegúrese de estar utilizando la versión más reciente del Helm Chart o del Operador de Datadog.

Lecturas adicionales