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

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

  1. If your Java service already has APM tracing set up and running, then skip to service configuration.
  2. If your Java 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 Java library to monitor and secure your Java service. The library integrates seamlessly with your existing application without requiring code changes.

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

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

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

Requisitos previos

  • Sistema operativo Linux
  • Aplicación Java
  • Privilegios de root o sudo
  • Systemd (para la gestión de servicios)
  • Su clave de API de Datadog
  • Datadog Java SDK (consulte los requisitos de versión aquí)

1. Instale el Datadog Agent

Instale el Datadog Agent siguiendo las instrucciones de configuración para hosts Linux.

2. Habilite la supervisión de App and API Protection

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.

Habilite manualmente la supervisión de App and API Protection

Descargue la versión más reciente de la biblioteca de Java de Datadog:

wget -O dd-java-agent.jar 'https://dtdg.co/latest-java-tracer'

Inicie su aplicación Java con el Datadog Agent y Protección de aplicaciones y API habilitados mediante propiedades del sistema:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.appsec.enabled=true -Ddd.service=<MY_SERVICE> -Ddd.env=<MY_ENV> -jar path/to/app.jar

Establezca las variables de entorno requeridas e inicie su aplicación Java:

export DD_APPSEC_ENABLED=true
export DD_SERVICE=<YOUR_SERVICE_NAME>
export DD_ENV=<YOUR_ENVIRONMENT>

java -javaagent:/path/to/dd-java-agent.jar -jar path/to/app.jar

Para deshabilitar APM Tracing mientras mantiene habilitada App and API Protection, debe establecer la variable de APM Tracing en false.

Inicie su aplicación Java con el Datadog Agent y Protección de aplicaciones y API habilitados mediante propiedades del sistema:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.appsec.enabled=true -Ddd.apm.tracing.enabled=false -Ddd.service=<MY_SERVICE> -Ddd.env=<MY_ENV> -jar path/to/app.jar

Establezca las variables de entorno requeridas e inicie su aplicación Java:

export DD_APPSEC_ENABLED=true
export DD_APM_TRACING_ENABLED=false
export DD_SERVICE=<YOUR_SERVICE_NAME>
export DD_ENV=<YOUR_ENVIRONMENT>

java -javaagent:/path/to/dd-java-agent.jar -jar path/to/app.jar

3. Ejecute su aplicación

Inicie su aplicación Java con la configuración anterior.

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

Solución de problemas

Si encuentra problemas al configurar la Protección de aplicaciones y API para su aplicación Java, consulte la guía de solución de problemas de Protección de aplicaciones y API de Java.

Lecturas adicionales