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

You can enable App and API Protection for .NET services with the following setup options:

  1. If your .NET service already has APM tracing set up and running, then skip to service configuration.
  2. If your .NET service doesn't have APM tracing set up, you can easily enable App and API Protection with Datadog's Automatic Installation.
  3. Otherwise, continue reading the manual setup instructions below.

Overview

App and API Protection leverages the Datadog .NET library to monitor and secure your .NET service. The library integrates seamlessly with your existing application without requiring code changes.

For detailed compatibility information, including supported DOTNET versions, frameworks, and deployment environments, see .NET Compatibility Requirements.

This guide explains how to set up App and API Protection (AAP) for .NET applications. The setup involves:

  1. Installing the Datadog Agent.
  2. Enabling App and API Protection monitoring.
  3. Running your .NET application with the Datadog Agent.
  4. Verifying the setup.

Requisitos previos

  • Clúster de Kubernetes
  • Aplicación de .NET en contenedores con Docker
  • kubectl configurado para acceder a tu clúster
  • Helm (recomendado para la instalación del Agent )
  • Tu clave de API Datadog
  • Biblioteca de rastreo de .NET de Datadog (consulta los requisitos de la versión)

1. Instalación del Datadog Agent

Instala el Datadog Agent siguiendo las instrucciones de instalación de Kubernetes.

2. Activación de la monitorización de la protección de aplicaciones y de API

Automatically enabling App and API Protection through Remote Configuration

You can enable services with remote configuration on your services dashboard. Check the box for the service you want to enable App and API Protection for under Activate on your APM services.

Activación manual de la monitorización de la protección de aplicaciones y de API

Asegúrate de que tu archivo de Docker incluya la biblioteca de .NET de Datadog:

# Download and install Datadog .NET Tracer
ENV DD_TRACE_VERSION=3.20.0
RUN curl -sSL https://github.com/DataDog/dd-trace-dotnet/releases/download/v${DD_TRACE_VERSION}/datadog-dotnet-apm-${DD_TRACE_VERSION}.linux-x64.tar.gz \
    | tar -xz -C /opt/datadog

# Set environment variables for Datadog automatic instrumentation
ENV CORECLR_ENABLE_PROFILING=1 \
    CORECLR_PROFILER="{846F5F1C-F9AE-4B07-969E-05C26BC060D8}" \
    CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so \
    DD_DOTNET_TRACER_HOME=/opt/datadog \

Actualiza tu despliegue de Kubernetes para incluir las variables de entorno necesarias:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: your-dotnet-app
spec:
  template:
    spec:
      containers:
      - name: your-dotnet-app
        image: your-dotnet-app-image
        env:
        - name: DD_APPSEC_ENABLED
          value: "true"
        - name: DD_SERVICE
          value: "<MY_SERVICE>"
        - name: DD_ENV
          value: "<MY_ENV>"

Para desactivar el rastreo de APM mientras se mantienes activada la protección de aplicaciones y de API, debes configurar la variable de rastreo de APM en false.

Actualiza tu despliegue de Kubernetes para incluir las variables de entorno necesarias:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: your-dotnet-app
spec:
  template:
    spec:
      containers:
      - name: your-dotnet-app
        image: your-dotnet-app-image
        env:
        - name: DD_APPSEC_ENABLED
          value: "true"
        - name: DD_APM_TRACING_ENABLED
          value: "false"
        - name: DD_SERVICE
          value: "<MY_SERVICE>"
        - name: DD_ENV
          value: "<MY_ENV>"

3. Ejecuta tu aplicación

Aplica tu despliegue actualizado:

kubectl apply -f your-deployment.yaml

4. Verify setup

To verify that App and API Protection is working correctly:

  1. Send some traffic to your application
  2. Check the Application Signals Explorer in Datadog
  3. Look for security signals and vulnerabilities

Solucionar problemas

Si tienes problemas al configurar la protección de aplicaciones y de API para tu aplicación de .NET, consulta la Guía de solución de problemas de la protección de aplicaciones y de API de .NET.

Referencias adicionales