A cloud-based identity and access management service for securing user authentication and resource access
New Entra-only users and groups accessing Azure Files over SMB with Microsoft Entra Kerberos must have both:
- Correct share-level permissions (Azure RBAC on the file share), and
- Correct Windows ACLs (NTFS-style permissions) on folders and files.
In an Entra-only setup with Microsoft Entra Kerberos as the identity source, ACL behavior and tools differ from the previous hybrid AD DS setup:
- Verify the identity source and supported ACL tools
When the storage account uses Microsoft Entra Kerberos as the identity source:- For cloud-only identities, Windows ACLs must be configured via Azure portal or PowerShell (RestSetAcls). Windows File Explorer and
icaclsare not supported for cloud-only identities. - For hybrid identities, File Explorer or
icaclscan be used only if there is unimpeded connectivity to AD DS. In an Entra-only environment without AD DS, use the Azure portal orRestSetAclsinstead.
“For cloud-only identities, you must use the Azure portal or PowerShell. Windows File Explorer and icacls aren't currently supported for cloud-only identities.”
“If you configure Microsoft Entra Kerberos as the identity source for your storage account, you can configure Windows ACLs for each Entra user or group by using the Azure portal. This method works for both hybrid and cloud-only identities only when Microsoft Entra Kerberos is the identity source.” - For cloud-only identities, Windows ACLs must be configured via Azure portal or PowerShell (RestSetAcls). Windows File Explorer and
- Confirm share-level permissions for new Entra users/groups
Even if ACLs are set in Manage access on folders, access will fail or appear inconsistent if the user/group does not have share-level permissions:- Assign the appropriate Azure Files data role (for SMB access) at the file share or storage account scope to the new Entra users/groups.
- The documentation notes that when identity-based access is enabled, share-level permissions must be assigned per share before NTFS ACLs apply:
“When you enable identity-based access, for each share you must assign which users and groups have access to that particular share. Once a user or group is allowed access to a share, Windows ACLs (also called NTFS permissions) on individual files and directories take over.”
- Set ACLs from the correct place and verify inheritance
In the Azure portal for the file share:- Use Browse → select the folder → Manage access.
- Add the new Entra user/group, then edit permissions.
- Ensure the Applies to setting is correctly set (for example, This folder, subfolders and files).
- Save the ACL.
If inheritance is not taking effect for new identities but works for older ones, check for:“To set an ACL for a file or directory, right-click the file or directory, and then select Manage access… Edit the permissions… Deny always takes precedence over Allow when both are set. When neither is set, default permissions are inherited.”
- Any explicit Deny entries on subfolders/files for those new users/groups (or for groups they belong to). Deny overrides Allow and will block access even when inheritance is configured.
- Existing ACLs on subfolders that were set before migration and may not include the new identities. Inheritance might have been broken on those subfolders, so new ACEs at the parent are not flowing down.
- Use RestSetAcls for bulk or corrective ACL application
If many folders/files are affected or inheritance is inconsistent, use theRestSetAclsPowerShell module to:- Apply a consistent root ACL that includes the new Entra groups/users with the desired rights.
- Ensure the ACL is applied recursively to all subfolders and files.
“If you need to assign ACLs in bulk to cloud-only users, use the RestSetAcls PowerShell module to automate the process by using the Azure Files REST API. This module doesn't require network connectivity to Active Directory.”
- Ensure all identities are Entra-synced when using Entra Kerberos
For Microsoft Entra Kerberos, ACL enforcement depends on identities being present in Entra:
Old users/groups that were present before migration may have ACLs that still work because they are recognized identities. New Entra-only users/groups must be referenced correctly in ACLs via the portal or“If you're using Microsoft Entra Kerberos to authenticate hybrid identities, the hybrid identities must be synced to Microsoft Entra ID for ACLs to be enforced.”
RestSetAclsso that their SIDs are included in the Kerberos ticket and evaluated correctly. - Check for MFA/Conditional Access blocking access
If Microsoft Entra Kerberos is used and Conditional Access MFA policies apply to the storage account app, access to Azure Files can fail in ways that look like permission issues. Ensure the storage account’s service principal is excluded from MFA policies:“Microsoft Entra Kerberos doesn't support using MFA to access Azure file shares configured with Microsoft Entra Kerberos. You must exclude the Microsoft Entra app representing your storage account from your MFA conditional access policies… If you don't exclude MFA policies from the storage account app, you can't access the file share.”
Summary of practical steps:
- Confirm the storage account uses Microsoft Entra Kerberos as the identity source.
- Ensure each new Entra user/group has the correct share-level role on the file share.
- In the Azure portal, on the target folder, use Manage access to add the new user/group and set Applies to: This folder, subfolders and files, then save.
- Inspect subfolders/files for broken inheritance or explicit Deny ACEs; correct them via the portal or
RestSetAclswith recursive application. - For large trees, use RestSetAcls to re-apply ACLs consistently.
- Verify Conditional Access/MFA is not blocking access to the storage account app.
References:
- Enable Microsoft Entra Kerberos authentication for hybrid and cloud-only identities on Azure Files
- Configure directory-level and file-level permissions for Azure file shares
- Configure a cloud trust between on-premises AD DS and Microsoft Entra ID for accessing Azure Files
- Troubleshoot Azure Files identity-based authentication and authorization issues (SMB)