Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 63 additions & 2 deletions content/en/security/code_security/iast/setup/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,7 @@
Before setting up Runtime Code Analysis (IAST), ensure the following prerequisites are met:

1. **Datadog Agent Installation:** The Datadog Agent is installed and configured for your application's operating system or container, cloud, or virtual environment.
2. **Datadog APM Configuration:** Datadog APM is configured for your application or service, and web traces (`type:web`) are being received by Datadog.
3. **Supported Tracing Library:** The Datadog Tracing Library used by your application or service supports Runtime Code Analysis (IAST) capabilities for the language of your application or service. For more details, see the **Compatibility Requirements** section below.
2. **Supported Tracing Library:** The Datadog Tracing Library used by your application or service supports Runtime Code Analysis (IAST) capabilities for the language of your application or service. For more details, see the **Compatibility Requirements** section below.

## Using Datadog Tracing Libraries

Expand Down Expand Up @@ -87,6 +86,34 @@
]
```

#### APM Tracing disabled

Check warning on line 89 in content/en/security/code_security/iast/setup/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.headings

'APM Tracing disabled' should use sentence-style capitalization.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### APM Tracing disabled
#### APM tracing disabled


To disable APM tracing while keeping IAST enabled, you must set the APM tracing variable to false.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To disable APM tracing while keeping IAST enabled, you must set the APM tracing variable to false.
To disable APM tracing while keeping IAST enabled, you must set the `DD_APM_TRACING_ENABLED` variable to false.


{{< tabs >}}
{{% tab "Using system properties" %}}

Start your Java application with the Datadog agent and IAST enabled using system properties:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Start your Java application with the Datadog agent and IAST enabled using system properties:
Start your Java application with the Datadog Agent and IAST enabled using system properties:


```bash
java -javaagent:/path/to/dd-java-agent.jar -Ddd.iast.enabled=true -Ddd.apm.tracing.enabled=false -Ddd.service=<MY_SERVICE> -Ddd.env=<MY_ENV> -jar path/to/app.jar
```
{{% /tab %}}

{{% tab "Using environment variables" %}}

Set the required environment variables:

```Dockerfile
DD_IAST_ENABLED=true
DD_APM_TRACING_ENABLED=false
DD_SERVICE=<YOUR_SERVICE_NAME>
DD_ENV=<YOUR_ENVIRONMENT>
```
{{% /tab %}}
{{< /tabs >}}


[1]: https://github.com/DataDog/dd-trace-java/releases
[2]: /security/code_security/iast/setup/
[3]: /security/code_security/iast/setup/
Expand Down Expand Up @@ -199,6 +226,18 @@
ENV DD_IAST_ENABLED=true
```

#### APM Tracing disabled

Check warning on line 229 in content/en/security/code_security/iast/setup/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.headings

'APM Tracing disabled' should use sentence-style capitalization.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### APM Tracing disabled
#### APM tracing disabled


To disable APM tracing while keeping IAST enabled, you must set the APM tracing variable to false.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To disable APM tracing while keeping IAST enabled, you must set the APM tracing variable to false.
To disable APM tracing while keeping IAST enabled, you must set the `DD_APM_TRACING_ENABLED` variable to false.


```Dockerfile
DD_IAST_ENABLED=true
DD_APM_TRACING_ENABLED=false
DD_SERVICE=<YOUR_SERVICE_NAME>
DD_ENV=<YOUR_ENVIRONMENT>
```


To see Runtime Code Analysis (IAST) in action, browse your service and find code-level vulnerabilities in the [Vulnerability Explorer][4].

{{< img src="/security/application_security/Code-Level-Vulnerability-Details-New.mp4" alt="Video showing Code Vulnerabilities" video="true" >}}
Expand Down Expand Up @@ -280,6 +319,17 @@
]
```

#### APM Tracing disabled

Check warning on line 322 in content/en/security/code_security/iast/setup/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.headings

'APM Tracing disabled' should use sentence-style capitalization.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### APM Tracing disabled
#### APM tracing disabled


To disable APM tracing while keeping IAST enabled, you must set the APM tracing variable to false.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To disable APM tracing while keeping IAST enabled, you must set the APM tracing variable to false.
To disable APM tracing while keeping IAST enabled, you must set the `DD_APM_TRACING_ENABLED` variable to false.


```Dockerfile
DD_IAST_ENABLED=true
DD_APM_TRACING_ENABLED=false
DD_SERVICE=<YOUR_SERVICE_NAME>
DD_ENV=<YOUR_ENVIRONMENT>
```

[1]: https://github.com/DataDog/dd-trace-js/blob/master/MIGRATING.md
[2]: /security/code_security/iast/setup/nodejs/
[3]: /security/code_security/iast/setup/
Expand Down Expand Up @@ -357,6 +407,17 @@
]
```

#### APM Tracing disabled

Check warning on line 410 in content/en/security/code_security/iast/setup/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.headings

'APM Tracing disabled' should use sentence-style capitalization.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### APM Tracing disabled
#### APM tracing disabled


To disable APM tracing while keeping IAST enabled, you must set the APM tracing variable to false.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To disable APM tracing while keeping IAST enabled, you must set the APM tracing variable to false.
To disable APM tracing while keeping IAST enabled, you must set the `DD_APM_TRACING_ENABLED` variable to false.


```Dockerfile
DD_IAST_ENABLED=true
DD_APM_TRACING_ENABLED=false
DD_SERVICE=<YOUR_SERVICE_NAME>
DD_ENV=<YOUR_ENVIRONMENT>
```

#### Third-Party Library Compatibility Note

Runtime Code Analysis (IAST) modifies Python code at runtime. This could cause conflicts with other third-party Python libraries that perform similar code transformations, particularly with the following, though not limited to them:
Expand Down
Loading