Skip to content

Commit f2ad681

Browse files
author
Mark Dalton Gray
committed
additional information added for MDE behavior
1 parent b0870b6 commit f2ad681

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

articles/operator-nexus/howto-set-up-defender-for-cloud-security.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@ The required permission is ```Microsoft.Security/mdeOnboardings/read```. This pe
6666

6767
> [!IMPORTANT]
6868
> The user or identity creating the role assignment must have the ```Microsoft.Authorization/roleAssignments/write``` permission at the subscription level.
69+
> Executing the the commands to show the principal ID object ID requires the Microsoft Entra role assignment of Directory Reader or equivalent.
6970
7071
Below is an example bash script using the az CLI for granting the nc-platform-extension identity the ability to onboard the MDE agent on your behalf.
7172

@@ -104,7 +105,6 @@ PRINCIPAL_ID=$(az k8s-extension show \
104105
--cluster-type connectedClusters \
105106
--query "identity.principalId" \
106107
--output tsv)
107-
108108
echo "Extension Principal ID: $PRINCIPAL_ID"
109109

110110
# 5. Show the full service principal object
@@ -134,6 +134,13 @@ az role assignment create \
134134
echo "Done. Security Reader role assignment created"
135135
```
136136

137+
In the event the required permissions are not granted, the MDE onboarding reconcilliation logic will continue to attempt to onboard the MDE agent on your behalf until the permissions are granted. When the permissions are granted, the MDE onboarding reconcilliation logic during the next rotation will complete successfully with no additional action required.
138+
139+
Reconcilliation of the MDE onboarding status is an exponential backoff process. The first retry attempt will be made after 10 minutes, the second after 20 minutes, and the third after 40 minutes. If three failures occur, the MDE onboarding reconcilliation logic will wait 10 minutes before attempting to onboard the MDE agent again (which will restart the exponential backoff process).
140+
141+
> [!IMPORTANT]
142+
> MDE Agent reconilliation runs independently on each of the baremetal machines in the cluster. As such the exact time it takes to onboard the MDE agent on all baremetal machines in the cluster will vary depending on the number of baremetal machines in the cluster and the initial time of the first onboarding attempt.
143+
137144
### Operator Nexus-specific requirement for enabling Defender for Endpoint
138145

139146
> [!IMPORTANT]

0 commit comments

Comments
 (0)