Skip to content

Commit 00159d9

Browse files
authored
Document SFTP limitations regarding ACLs
Added information about default and extended ACLs not being supported by SFTP, including a workaround for permission issues.
1 parent 072abf5 commit 00159d9

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

articles/storage/blobs/secure-file-transfer-protocol-known-issues.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,14 @@ To learn more, see [SFTP permission model](secure-file-transfer-protocol-support
7171

7272
- There's a 2-minute time out for idle or inactive connections. OpenSSH will appear to stop responding and then disconnect. Some clients reconnect automatically.
7373

74+
### Default ACLs and extended ACLs
75+
76+
SFTP doesn't currently support **default ACLs** or **extended ACLs** (ACL entries beyond the POSIX `user::`, `group::`, and `other::` entries, such as named users or named groups).
77+
78+
If any directory in the access path (including the user's home directory) has default ACLs or extended ACLs set, SFTP operations can fail with `Permission denied`, even when the connecting user isn't referenced by those ACL entries.
79+
80+
**Workaround:** Remove default ACLs and any extended ACL entries from all directories in the SFTP access path (including the user's home directory) so that only POSIX `user::`, `group::`, and `other::` entries remain before attempting the SFTP operation again.
81+
7482
## Other
7583

7684
- For performance issues and considerations, see [SSH File Transfer Protocol (SFTP) performance considerations in Azure Blob storage](secure-file-transfer-protocol-performance.md).

0 commit comments

Comments
 (0)