Skip to content

Commit 78a63a7

Browse files
authored
Update reliability-defender-devops.md
1 parent 1311142 commit 78a63a7

1 file changed

Lines changed: 28 additions & 24 deletions

File tree

articles/reliability/reliability-defender-devops.md

Lines changed: 28 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -12,66 +12,70 @@ CustomerIntent: As a cloud architect/engineer, I need general guidance reliabili
1212

1313
# Reliability in Defender for DevOps
1414

15-
This article describes reliability support in [Defender for DevOps](../defender-for-cloud/defender-for-devops-introduction.md), which includes [cross-region recovery and business continuity](#cross-region-disaster-recovery-and-business-continuity). For a more detailed overview of reliability in Azure, see [Azure reliability](/azure/architecture/framework/resiliency/overview).
15+
This article describes reliability support in [Microsoft Defender for Cloud DevOps security features](../defender-for-cloud/defender-for-devops-introduction.md), which includes [cross-region recovery and business continuity](#cross-region-disaster-recovery-and-business-continuity). For a more detailed overview of reliability in Azure, see [Azure reliability](/azure/architecture/framework/resiliency/overview).
16+
17+
This article is specific to recover in the case of a region outage. If you are looking to move your existing DevOps connector to a new region, please see [Common questions about Defender for DevOps](https://learn.microsoft.com/azure/defender-for-cloud/faq-defender-for-devops#can-i-migrate-the-connector-to-a-different-region-)
1618

1719

1820
## Cross-region disaster recovery and business continuity
1921

2022
[!INCLUDE [introduction to disaster recovery](includes/reliability-disaster-recovery-description-include.md)]
2123

22-
Defender for DevOps supports single-region disaster recovery. As such, a multi-region disaster recovery process simply implements [that single-region disaster recovery process outlined in this document](#single-region-disaster-recovery-process).
24+
Microsoft Defender for Cloud DevOps security supports single-region disaster recovery. As such, a multi-region disaster recovery process simply implements the [single-region disaster recovery process outlined in this document](#single-region-disaster-recovery-process).
2325

2426

2527
### Supported regions
2628

27-
Defender for DevOps is only supported in the following regions:
28-
29-
| Americas | Europe | Asia Pacific |
30-
| ----- |----|--|
31-
| Canada Central (Coming soon)| North Europe | Australia East|
32-
|Central US |Sweden Central | East Asia (Coming soon)|
33-
| East US |UK South| Japan East (Coming soon)|
34-
|West US (Coming soon)|UK West (Coming soon) ||
35-
|| West Europe||
29+
For regions that support DevOps security in Defender for Cloud, see [DevOps security region support](https://learn.microsoft.com/azure/defender-for-cloud/devops-support#cloud-and-region-support).
3630

3731

3832
### Single-region disaster recovery process
3933

40-
The single region disaster recovery process for Defender for DevOps is based on the [Shared Responsibility model](/azure/security/fundamentals/shared-responsibility), and so includes both customer and Microsoft procedures.
34+
The single region disaster recovery process for DevOps security features is based on the [Shared Responsibility model](/azure/security/fundamentals/shared-responsibility), and so includes both customer and Microsoft procedures.
4135

4236
#### Customer responsibility
4337

44-
When a region goes down, your configurations for the connector of that region is lost. Lost configurations include customer tokens, auto discovery configurations, and ADO annotations configurations. To recover, you'll need to recreate a new connector in a new region.
38+
When a region goes down, your configurations for the connector of that region is lost. Lost configurations include customer tokens, auto discovery configurations, and ADO annotations configurations.
4539

46-
>[!TIP]
47-
>You can use an existing connector in the new region, as long as it's authenticated to have access to the Source Code Management (SCM) organizations of the old connector.
40+
To request recovery of a connector created in a downed region:
4841

49-
To create a new connector in a new region:
42+
1. Create a new connector in a new region. See onboarding documentation for [Azure DevOps](https://learn.microsoft.com/azure/defender-for-cloud/quickstart-onboard-devops), [GitHub](https://learn.microsoft.com/azure/defender-for-cloud/quickstart-onboard-github), and/or [GitLab](https://learn.microsoft.com/azure/defender-for-cloud/quickstart-onboard-gitlab).
43+
>[!NOTE]
44+
>You can use an existing connector in the new region, as long as it's authenticated to have access to the scope of DevOps resources in the old connector.
5045
51-
1. Copy the Resource ID of the old connector of the region that has the outage.
46+
1. Open a new support request to release ownership of the DevOps resources from the old connector.
47+
1. In Azure portal, navigate to Help + Support
48+
1. Fill out the form:
49+
1. Issue type: `Technical`
50+
1. Service type: `Microsoft Defender for Cloud`
51+
1. Summary: "Region outage - DevOps Connector recovery"
52+
1. Problem type: `Onboarding and Settings`
53+
1. Problem subtype: `DevOps security`
5254

53-
1. Open a ticket on Defender for DevOps to release ownership of the Source Code Management (SCM) organizations of the old connector. You can specify specific organizations or all organizations.
55+
1. Copy the Resource ID of the new and old DevOps connectors. This information is available in Azure Resource Graph. ResourceID format:
5456

55-
1. Once the old SCM organizations have been released and new entities appear for the new connector, recreate the annotation configuration if needed.
57+
```
58+
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{connectorName}
5659
60+
1. Once the DevOps resources have been released from the old connector and appear for the new connector, [reconfigure the pull request annotations](https://learn.microsoft.com/azure/defender-for-cloud/enable-pull-request-annotations) as needed.
5761
>[!NOTE]
58-
>The time it takes to recreate the annotation configuration is proportional for how long it takes for the new connector to discover all the SCM organizations.
62+
>The time it takes to reconfigure the pull request annotation configuration is proportional for how long it takes for the new connector to discover all the DevOps resources.
5963
60-
1. When the old region recovers from the outage, the new connector is made primary and you can safely delete the old connector.
64+
1. The new connector will be made primary. When the region recovers from the outage, you can safely delete the old connector.
6165
6266
6367
6468
#### Microsoft responsibility
6569
66-
When a region goes down and you have established the new connector, Microsoft recreates all alerts, recommendations, and Security Graph (SG) entities from the old connector into the new connector.
70+
When a region goes down and you have established the new connector, Microsoft recreates all alerts, recommendations, and Cloud Security Graph entities from the old connector into the new connector.
6771
6872
>[!IMPORTANT]
69-
> Microsoft doesn't recreate history for some functionalities, such as container mapping data from previous runs, alerts data more than one week old, and IaC mapping history data.
73+
> Microsoft doesn't recreate history for some functionalities, such as container mapping data from previous runs, alerts data more than one week old, and infrastructure as code (IaC) mapping history data.
7074
7175
7276
#### Test your disaster recovery process
7377
74-
To test your disaster recovery process, you can simulate a lost connector by deleting your primary connector.
78+
To test your disaster recovery process, you can simulate a lost connector by creating a second connector and following the support steps above.
7579
7680
## Next steps
7781

0 commit comments

Comments
 (0)