Skip to content

Commit b979223

Browse files
authored
Update Azure Mentions in Code Security Documentation (#32425)
* sast home page * sast setup page * static SCA setup * static SCA home page * Dev tool integrations * dev tool description update * ide and pr comments
1 parent 70e4a18 commit b979223

File tree

7 files changed

+21
-107
lines changed

7 files changed

+21
-107
lines changed

content/en/security/code_security/dev_tool_int/_index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ disable_toc: false
44

55
---
66

7-
{{< whatsnext desc="You can integrate Code Security with several types of tools and receive real-time feedback on the quality and security of your code as it's written." >}}
7+
{{< whatsnext desc="You can integrate Code Security with several types of tools throughout the developer workflow. Pull request comments and gates require setup of Datadog's integrations with your source code provider(s)." >}}
88
{{< nextlink href="/security/code_security/dev_tool_int/github_pull_requests/" >}}Pull Requests Comments
99
{{< /nextlink >}}
10-
{{< nextlink href="/pr_gates/" >}}PR Gates{{< /nextlink >}}
11-
{{< nextlink href="/security/code_security/dev_tool_int/ide_plugins/" >}}Datadog IDE Plugins for Code Security{{< /nextlink >}}
10+
{{< nextlink href="/pr_gates/" >}}Pull Request Gates{{< /nextlink >}}
11+
{{< nextlink href="/security/code_security/dev_tool_int/ide_plugins/" >}}IDE Plugins{{< /nextlink >}}
1212
{{< nextlink href="/security/code_security/dev_tool_int/git_hooks/" >}}Git Hooks{{< /nextlink >}}
1313
{{< /whatsnext >}}

content/en/security/code_security/dev_tool_int/ide_plugins/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ disable_toc: false
88

99
## Overview
1010

11-
[Code Security][1] integrates directly with integrated development environment (IDE) tools to provide real-time feedback on the quality and security of your first-party code as it's being written.
11+
[Code Security][1] integrates directly with integrated development environment (IDE) tools to provide real-time feedback on the security and quality of your code. IDE integrations are supported for SAST, SCA, and IAST.
1212

1313
{{< whatsnext desc="See the documentation for information about the following integrations:">}}
1414
{{< nextlink href="developers/ide_plugins/idea/#static-analysis" >}}<u>JetBrains IDEs</u>: IntelliJ IDEA, GoLand, PyCharm, WebStorm, and PhpStorm{{< /nextlink >}}

content/en/security/code_security/dev_tool_int/pull_request_comments/_index.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ You can configure PR comments at the organization or repository level in [Reposi
2626
**Note**: PR comments are not PR checks. To set up checks, see [Quality Gates][10].
2727

2828
## Prerequisites
29-
- You must have the Datadog source code integration for your provider enabled. PR comments are supported for [GitHub][2], [GitLab][8], and Azure DevOps repositories ([in Preview][9]).
29+
- You must have the Datadog source code integration for your provider enabled. PR comments are supported for [GitHub][2], [GitLab][8], and [Azure DevOps][9] repositories.
3030
- Your repositories must have the relevant Code Security product(s) enabled. To enable Code Security in-app, navigate to the [**Code Security** Settings page][4].
3131

3232
## Set up pull request comments
@@ -77,16 +77,16 @@ If you already have a GitHub App connected to Datadog, update it. Otherwise, cre
7777
{{% /tab %}}
7878
{{% tab "GitLab" %}}
7979

80-
See the [GitLab Source Code][8] setup instructions to connect GitLab to Datadog.
80+
See the [GitLab Source Code][8] setup instructions to connect GitLab repositories to Datadog.
8181

8282
[8]: /integrations/gitlab-source-code/
8383

8484
{{% /tab %}}
8585
{{% tab "Azure DevOps" %}}
8686

87-
Azure DevOps for Code Security is in Preview. [Request access to join the Preview][9].
87+
See the [Azure Source Code][8] setup instructions to connect Azure repositories to Datadog.
8888

89-
[9]: https://www.datadoghq.com/product-preview/azure-devops-integration-code-security/
89+
[9]: https://docs.datadoghq.com/integrations/azure-devops-source-code/#source-code-functionality
9090

9191
{{% /tab %}}
9292
{{< /tabs >}}
@@ -135,7 +135,7 @@ When configuring PR comments, you can:
135135
[6]: /security/code_security/static_analysis/github_actions/
136136
[7]: https://app.datadoghq.com/security/configuration/code-security/settings
137137
[8]: /integrations/gitlab-source-code/
138-
[9]: https://www.datadoghq.com/product-preview/azure-devops-integration-code-security/
138+
[9]: https://docs.datadoghq.com/integrations/azure-devops-source-code/#source-code-functionality
139139
[10]: /quality_gates/?tab=staticanalysis#setup
140140

141141

content/en/security/code_security/software_composition_analysis/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Datadog SCA uses a curated proprietary database. The database is sourced from Op
2323
{{% security-products/sca-supported-lang %}}
2424

2525
SCA supports both static and runtime dependency detection:
26-
- For **static detection**, you can scan from your CI/CD pipelines or from Datadog's infrastructure. See [static setup][1] to get started.
26+
- For **static detection**, you can scan your repositories from your CI/CD pipelines or directly from Datadog's infrastructure. See [static setup][1] to get started.
2727
- For **runtime detection**, you can enable SCA on services instrumented with Datadog APM. See [runtime setup][2] to get started.
2828

2929
## Search and filter results

content/en/security/code_security/software_composition_analysis/setup_static/_index.md

Lines changed: 3 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -91,56 +91,14 @@ See the [GitLab source code setup instructions][1] to connect GitLab to Datadog.
9191
{{% /tab %}}
9292
{{% tab "Azure DevOps" %}}
9393

94-
<div class="alert alert-danger">
95-
Repositories from Azure DevOps are supported in closed Preview. Your Azure DevOps organizations must be connected to a Microsoft Entra tenant. <a href="https://www.datadoghq.com/product-preview/azure-devops-integration-code-security/">Join the Preview</a>.
96-
</div>
97-
98-
Before you can begin installation, request access to the closed Preview using the form above. After being granted access, see the following instructions to complete the setup process.
99-
100-
**Note:** Azure DevOps Server is not supported.
101-
102-
### Create and register a Microsoft Entra app
103-
If you are an admin in your Azure portal, you can configure Entra apps to connect your tenant to Datadog.
104-
105-
1. Navigate to [Code Security setup][1].
106-
2. In **Activate scanning for your repositories**, click **Manage Repositories**.
107-
3. Select **CI Pipelines**.
108-
4. Select the scan types you want to use.
109-
5. Select **Azure DevOps** as your source code management provider.
110-
6. If this is your first time connecting an Azure DevOps organization to Datadog, click **Connect Azure DevOps Account**.
111-
7. When connecting a Microsoft Entra tenant for the first time you will need to go to your [Azure Portal][2] to register a new application. During this creation process, ensure the following:
112-
1. You select **Accounts in this organizational directory only (Datadog, Inc. only - Single tenant)** as the account type.
113-
2. Set the redirect URI to **Web** and paste the URI given to you in the instructions.
114-
8. Copy the values for **Application (client) ID** and **Directory (tenant) ID** and paste them into Datadog.
115-
9. In the Azure Portal for your app registration, navigate to **Manage > Certificates & secrets** and switch to **Client secrets**.
116-
10. Click **New client secret** and create a secret with your desired description and expiration values.
117-
11. Copy and paste the string in the **Value** column for your new secret, paste it into Datadog, and click **Create Configuration** to complete connecting your Entra tenant to Datadog.
118-
13. Add one or more Azure DevOps organizations by pasting the organization slug into Datadog and then adding your Service Principal as a user by going to **Organization settings > Users > Add users**.
119-
1. Your Service Principal will need the **Basic** access level and at least the **Project Contributor** security group.
120-
14. Click **Submit Organization**.
121-
122-
### Configure project service hooks
123-
124-
To enable all Code Security features in Azure DevOps, you'll need to use a [Datadog API key][3] to configure service hooks for your projects.
125-
126-
First, set your environment variables (note: the Datadog UI will fill these values out for you):
127-
```shell
128-
export AZURE_DEVOPS_TOKEN="..." # Client Secret Value
129-
export DD_API_KEY="..." # Datadog API Key
130-
```
131-
132-
Then, replace the placeholders in the script below with your [Datadog Site][5] and Azure DevOps organization name to configure the necessary service hooks on your organization's projects:
133-
```shell
134-
curl https://raw.githubusercontent.com/DataDog/azdevops-sci-hooks/refs/heads/main/setup-hooks.py > setup-hooks.py && chmod a+x ./setup-hooks.py
135-
./setup-hooks.py --dd-site="<dd-site>" --az-devops-org="<org-name>"
136-
```
94+
**Note:** Your Azure DevOps integrations must be connected to a Microsoft Entra tenant. Azure DevOps Server is **not** supported.
13795

138-
Click [here][4] to see our CLI that automates this process.
96+
See the [Azure source code setup instructions][4] to connect Azure DevOps repositories to Datadog.
13997

14098
[1]: https://app.datadoghq.com/security/configuration/code-security/setup
14199
[2]: https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
142100
[3]: https://app.datadoghq.com/organization-settings/api-keys
143-
[4]: https://github.com/DataDog/azdevops-sci-hooks
101+
[4]: /integrations/azure-devops-source-code/#setup
144102
[5]: /getting_started/site/
145103

146104
{{% /tab %}}

content/en/security/code_security/static_analysis/_index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ To get started, go to the [**Code Security** setup page][12] or see the [Setup d
3838
## Integrate into the development lifecycle
3939

4040
### Source code management
41-
{{< whatsnext desc="During code reviews, Datadog can automatically flag Static Code Analysis violations in pull requests by adding inline review comments on the relevant line(s) of code. When applicable, Datadog also provides suggested fixes that can be applied directly in the pull request." >}}
41+
{{< whatsnext desc="During code reviews, Datadog can automatically flag Static Code Analysis violations in pull requests by adding inline review comments on the relevant line(s) of code. This is supported for GitHub, GitLab, and Azure DevOps repositories (cloud-hosted). When applicable, Datadog also provides suggested fixes that can be applied directly in the pull request." >}}
4242
{{< nextlink href="static_analysis/github_pull_requests" >}}Pull Requests{{< /nextlink >}}
4343
{{< /whatsnext >}}
4444

@@ -65,7 +65,7 @@ Click on a violation to open a side panel that contains information about the sc
6565

6666
The content of the violation is shown in tabs:
6767

68-
- **Details**: A description of the violation and the lines of code that caused it. To see the offending code snippet, configure the relevant source code integration for your provider (GitHub[4], GitLab[5]).
68+
- **Details**: A description of the violation and the lines of code that caused it. To see the offending code snippet, configure the relevant source code integration for your provider ([GitHub][4], [GitLab][5], Azure[6]).
6969
- **Remediation**: One or more code fixes that can resolve the violation, with options for remediation.
7070
- **Event**: JSON metadata regarding the violation.
7171

@@ -74,7 +74,7 @@ For a subset of SAST vulnerabilities, Bits AI can review the context of the find
7474

7575
For each finding, you can provide Bits AI with feedback on its assessment.
7676

77-
{{% collapse-content title="Supported advisories" level="h4" expanded=true id="id-for-anchoring" %}}
77+
{{% collapse-content title="Supported CWEs" level="h4" expanded=true id="id-for-anchoring" %}}
7878
False positive filtering is supported for the following CWEs:
7979
- [CWE-89: SQL Injection](https://cwe.mitre.org/data/definitions/89.html)
8080
- [CWE-78: OS Command Injection](https://cwe.mitre.org/data/definitions/78.html)
@@ -192,4 +192,4 @@ If you believe a specific violation is a false positive, you can flag it as a fa
192192
[13]: https://docs.datadoghq.com/security/code_security/static_analysis/#link-results-to-datadog-services-and-teams
193193
[14]: /account_management/teams/
194194
[15]: /integrations/github/#connect-github-teams-to-datadog-teams
195-
195+
[16]: /integrations/azure-devops-source-code/

content/en/security/code_security/static_analysis/setup/_index.md

Lines changed: 4 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,6 @@ algolia:
2020
To set up Datadog SAST in-app, navigate to [**Security** > **Code Security**][1].
2121

2222
## Select where to run Static Code Analysis scans
23-
2423
### Scan with Datadog-hosted scanning
2524

2625
You can run Datadog Static Code Analysis (SAST) scans directly on Datadog infrastructure. Supported repository types include:
@@ -64,64 +63,21 @@ When installing a GitHub App, the following permissions are required to enable c
6463
{{% /tab %}}
6564
{{% tab "GitLab" %}}
6665

67-
See the [GitLab source code setup instructions][1] to connect GitLab to Datadog. Both GitLab.com and Self-Managed instances are supported.
66+
See the [GitLab source code setup instructions][1] to connect GitLab repositories to Datadog. Both GitLab.com and Self-Managed instances are supported.
6867

6968
[1]: /integrations/gitlab-source-code/#setup
7069

7170
{{% /tab %}}
7271
{{% tab "Azure DevOps" %}}
7372

74-
<div class="alert alert-danger">
75-
Repositories from Azure DevOps are supported in closed Preview. Your Azure DevOps organizations must be connected to a Microsoft Entra tenant. <a href="https://www.datadoghq.com/product-preview/azure-devops-integration-code-security/">Join the Preview</a>.
76-
</div>
77-
78-
Before you can begin installation, request access to the closed Preview using the form above. After being granted access, see the following instructions to complete the setup process.
79-
80-
**Note:** Azure DevOps Server is not supported.
81-
82-
### Create and register a Microsoft Entra app
83-
If you are an admin in your Azure portal, you can configure Entra apps to connect your tenant to Datadog.
84-
85-
1. Go to [Code Security setup][1].
86-
2. In **Activate scanning for your repositories**, click **Manage Repositories**.
87-
3. Select **CI Pipelines**.
88-
4. Select the scan types you want to use.
89-
5. Select **Azure DevOps** as your source code management provider.
90-
6. If this is your first time connecting an Azure DevOps organization to Datadog, click **Connect Azure DevOps Account**.
91-
7. When connecting a Microsoft Entra tenant for the first time you will need to go to your [Azure Portal][2] to register a new application. During this creation process, ensure the following:
92-
1. You select **Accounts in this organizational directory only (Datadog, Inc. only - Single tenant)** as the account type.
93-
2. Set the redirect URI to **Web** and paste the URI given to you in the instructions.
94-
8. Copy the values for **Application (client) ID** and **Directory (tenant) ID** and paste them into Datadog.
95-
9. In the Azure Portal for your app registration, navigate to **Manage > Certificates & secrets** and switch to **Client secrets**.
96-
10. Click **New client secret** and create a secret with the description and expiration values you want to use.
97-
11. Copy and paste the string in the **Value** column for your new secret.
98-
12. Paste the secret into Datadog and click **Create Configuration** to complete the connection between your Entra tenant and Datadog.
99-
13. Add one or more Azure DevOps organizations by pasting the organization slug into Datadog and then adding your Service Principal as a user by going to **Organization settings > Users > Add users**.
100-
1. Your Service Principal will need the **Basic** access level and at least the **Project Contributor** security group.
101-
14. Click **Submit Organization**.
102-
103-
### Configure project service hooks
104-
105-
To enable all Code Security features in Azure DevOps, you'll need to use a [Datadog API key][3] to configure service hooks for your projects.
106-
107-
First, set your environment variables (note: the Datadog UI will fill these values out for you):
108-
```shell
109-
export AZURE_DEVOPS_TOKEN="..." # Client Secret Value
110-
export DD_API_KEY="..." # Datadog API Key
111-
```
112-
113-
Then, replace the placeholders in the script below with your [Datadog Site][5] and Azure DevOps organization name to configure the necessary service hooks on your organization's projects:
114-
```shell
115-
curl https://raw.githubusercontent.com/DataDog/azdevops-sci-hooks/refs/heads/main/setup-hooks.py > setup-hooks.py && chmod a+x ./setup-hooks.py
116-
./setup-hooks.py --dd-site="<dd-site>" --az-devops-org="<org-name>"
117-
```
73+
**Note:** Your Azure DevOps integrations must be connected to a Microsoft Entra tenant. Azure DevOps Server is **not** supported.
11874

119-
Click [here][4] to see our CLI that automates this process.
75+
See the [Azure source code setup instructions][4] to connect Azure DevOps repositories to Datadog.
12076

12177
[1]: https://app.datadoghq.com/security/configuration/code-security/setup
12278
[2]: https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
12379
[3]: https://app.datadoghq.com/organization-settings/api-keys
124-
[4]: https://github.com/DataDog/azdevops-sci-hooks
80+
[4]: /integrations/azure-devops-source-code/#setup
12581
[5]: /getting_started/site/
12682

12783
{{% /tab %}}

0 commit comments

Comments
 (0)