Add AAP to the Envoy integration

Author: e-n-0

envoy/README.md

@@ -6,6 +6,49 @@ This check collects distributed system observability metrics from [Envoy][1].
 
 ## Setup
 
+## Security
+
+### Overview
+
+[Datadog App & API Protection][30] extends visibility and inline threat mitigation to your Envoy proxy instance.
+
+With this integration, you can detect and block attacks—such as API abuse, business logic exploitation, and code-layer threats—right at the edge of your cloud infrastructure.
+
+Key Benefits:
+- **Inline threat detection and blocking** at the load balancer using Datadog Security Signals
+- **Real-time insights** into application-layer attacks with traces and logs in one unified view
+- **Edge enforcement** against OWASP API threats, credential stuffing, injection attacks, and more
+
+### Installation
+
+The installation process requires a different approach than enabling this integration.
+
+#### Envoy
+
+The installation instructions are available in the [Enabling App & API Protection for Envoy][31] documentation.
+
+#### Istio
+
+The installation instructions are available in the [Enabling App and API Protection for Istio][32] documentation.
+
+### Validation
+
+To validate App & API Protection threat detection, send known attack patterns to your load balancer. For example, you can trigger the Security Scanner Detected rule by running the following curl script:
+
+```sh
+for ((i=1;i<=250;i++)); 
+do
+    # Target existing service's routes
+    curl https://your-load-balancer-url/existing-route -A dd-test-scanner-log;
+
+    # Target non existing service's routes
+    curl https://your-load-balancer-url/non-existing-route -A dd-test-scanner-log;
+done
+```
+
+A few minutes after enabling the service extension and sending known attack patterns, threat information will appear in the Application Signals Explorer.
+
+
 ### Installation
 
 The Envoy check is included in the [Datadog Agent][2] package, so you don't need to install anything else on your server.
@@ -215,3 +258,6 @@ Need help? Contact [Datadog support][16].
 [16]: https://docs.datadoghq.com/help/
 [17]: https://docs.datadoghq.com/integrations/openmetrics/
 [18]: https://github.com/DataDog/integrations-core/blob/7.33.x/envoy/datadog_checks/envoy/data/conf.yaml.example
+[30]: https://docs.datadoghq.com/security/application_security/
+[31]: https://docs.datadoghq.com/security/application_security/setup/standalone/envoy/
+[32]: https://docs.datadoghq.com/security/application_security/setup/standalone/istio/

envoy/manifest.json

@@ -18,6 +18,7 @@
       "Supported OS::Windows",
       "Supported OS::macOS",
       "Category::Network",
+      "Category::Security",
       "Submitted Data Type::Metrics",
       "Submitted Data Type::Logs",
       "Offering::Integration"