You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Troubleshoot common issues when your Azure File Sync deployment is configured to use managed identities.
4
4
ms.service: azure-file-storage
5
5
ms.topic: troubleshooting
6
-
ms.date: 07/22/2025
6
+
ms.date: 07/31/2025
7
7
author: khdownie
8
8
ms.author: kendownie
9
9
---
@@ -101,7 +101,7 @@ Cloud endpoint:
101
101
- Storage Sync Service managed identity must be a member of the **Storage File Data Privileged Contributor** role on an Azure file share.
102
102
103
103
Server endpoint:
104
-
-Register server managed identity must be a member of the **Storage File Data Privileged Contributor** role on an Azure file share.
104
+
-Registered server managed identity must be a member of the **Storage File Data Privileged Contributor** role on an Azure file share.
105
105
106
106
When you run the `Set-AzStorageSyncServiceIdentity` cmdlet or create new cloud and server endpoints, these permissions are granted. If these permissions are removed, operations fail with the errors listed in the following section.
> The `-Name` parameter is the name of the server endpoint. It's a GUID, not the friendly name that's displayed in the Azure portal. To get the server endpoint name, run the [Get-AzStorageSyncServerEndpoint](/powershell/module/az.storagesync/get-azstoragesyncserverendpoint) cmdlet.
171
171
172
-
173
172
### Sync Session fails with the ECS_E_AUTH_IDENTITY_NOT_FOUND error
174
173
175
174
The `ECS_E_AUTH_IDENTITY_NOT_FOUND` error occurs when the server's managed identity used to communicate with the Azure File Sync service has changed, but the Azure File Sync service is still expecting the previous one, causing authentication to fail.
@@ -181,24 +180,24 @@ This issue often occurs in the following situations:
181
180
- Azure Arc resource deletion and recreation.
182
181
- Turning off and then re-enabling the system-assigned managed identity on an Azure virtual machine.
183
182
184
-
When the managed identity changes, the File Sync agent tries to use the new identity, but the Azure File Sync service is still configured to authorize the previous one. This mismatch causes requests to fail with the `ECS_E_AUTH_IDENTITY_NOT_FOUND` error.
183
+
When the managed identity changes, the File Sync agent tries to use the new identity, but the Azure File Sync service is still configured to authorize the previous one. This mismatch causes requests to fail and return the `ECS_E_AUTH_IDENTITY_NOT_FOUND` error.
185
184
186
185
To resolve this issue:
187
186
188
-
First, ensure the server is configured to use a managed identity.
187
+
Make sure that the server is configured to use a managed identity.
189
188
190
-
You can verify this by:
191
-
-Checking the **Settings** > **Managed identities** details in your storage sync service, or
192
-
-Running the following PowerShell command:
189
+
To verify this configuration:
190
+
-Check the **Settings** > **Managed identities** details in your storage sync service, or
> This error can occur whether the server is using managed identity (MI) or certificate-based authentication, so confirming the identity type is important.
199
196
197
+
> [!NOTE]
198
+
> This error can occur whether the server is using managed identity (MI) or certificate-based authentication. Therefore, it's important to verify the identity type.
200
199
201
-
If the server is using managed identity and the identity has changed, run the following command to update the server registration:
200
+
If the server uses managed identity and the identity was changed, run the following command to update the server registration:
0 commit comments