An Azure service that offers file shares in the cloud.
For Azure Files, share-level Azure RBAC alone is often not enough to upload files.
If access is through SMB with Microsoft Entra or AD credentials, both of these must be in place:
- Share-level permission
-
Storage File Data SMB Share Contributorallows read, write, and delete. -
Storage File Data SMB Share Elevated Contributoralso allows modify-ACLs.
-
- File and directory permissions (NTFS ACLs)
- Without NTFS permissions on the share/root folder, uploads can fail even when the RBAC role is assigned.
Also note:
- Share-level permission changes usually take effect within 30 minutes, and sometimes longer.
- If default share-level permissions are also configured for all authenticated identities, the effective permission is the higher of the default permission and the explicit RBAC assignment.
If the upload is being done with OAuth/REST tools such as Storage Explorer and the error is 403 AuthorizationPermissionMismatch, assign Storage File Data Privileged Contributor at the storage account or file share scope. That role bypasses existing file/directory ACLs and grants read, write, delete, and modify-ACLs access to Azure Files data.
To verify and fix:
- In Azure portal, go to the file share.
- Open Access Control (IAM).
- Confirm the role is assigned at the correct scope.
- If using Entra ID/OAuth upload, assign
Storage File Data Privileged Contributor. - If using SMB identity-based access, configure the required NTFS ACLs on the root folder and target folders.
- Wait for RBAC propagation, then try the upload again.
If the issue is specifically SMB authentication/authorization, Debug-AzStorageAccountAuth can be used to check RBAC assignment and file access.
- Assign share-level permissions for Azure file shares
- Assign share-level permissions for Azure file shares
- Assign share-level permissions for Azure file shares
- Access Azure file shares by using Microsoft Entra ID with Azure Files OAuth over REST
- users cannot upload documents to blob storage file share - Microsoft Q&A Using EntraID and OAUTH
- Troubleshoot Azure Files identity-based authentication and authorization issues (SMB)