Access control entries
Access Control Entries (ACEs) define permissions, inheritance, and access rights for files and directories. ACEs help interpret and manage file system access through Access Control Lists (ACLs). This is especially relevant in SMB environments.
Each ACL entry of a file system object contains Access ACE in the following format:
security_principal:access_right/inheritance_information/permissions
Access control entries
If the AD\Domain Users group has Modify permissions applicable to This folder, subfolders, and files on Windows, the ACL contains the following ACE:
AD\Domain Users:ALLOWED/OI|CI/CHANGE
An ACE contains the following parts:
- Security principal
- The security principal is the user, group, or Security Identifier (SID) the permissions in the ACL are applied to.
- Access right
- Defines if access to an object is granted or denied. The value can be
ALLOWEDorDENIED. - Inheritance information
-
The following values exist:
Table 1. Inheritance settings Value Description Maps to OIObject Inherit
This folder and files
CIContainer Inherit
This folder and subfolders
IOInherit Only
The ACE does not apply to the current file or directory
IDInherited
The ACE was inherited from the parent directory
Additionally, the values can be combined as follows:
Table 2. Inheritance settings combinations Value combinations Maps to the Windows Applies tosettingOI|CIThis folder, subfolders, and files
OI|CI|IOSubfolders and files only
CI|IOSubfolders only
OI|IOFiles only
- Permissions
-
This value can be either a hex value that represents one or more Windows permissions or an
smbcaclsalias:- A hex value that represents one or more Windows permissions.
The following table displays the advanced Windows permissions and their corresponding value in hex format:
Table 3. Windows permissions and their corresponding smbcacls value in hex format Windows permissions Hex values Full control
0x001F01FFTraverse folder / execute file
0x00100020List folder / read data
0x00100001Read attributes
0x00100080Read extended attributes
0x00100008Create files / write data
0x00100002Create folders / append data
0x00100004Write attributes
0x00100100Write extended attributes
0x00100010Delete subfolders and files
0x00100040Delete
0x00110000Read permissions
0x00120000Change permissions
0x00140000Take ownership
0x00180000Multiple permissions can be combined as a single hex value by using the bit-wise
ORoperation. - An
smbcaclsalias. The following table displays the available aliases:Table 4. Existing smbcacls aliases and their corresponding Windows permission smbcaclsaliasMaps to Windows permission RRead
READRead & execute
WSpecial:
- Create files / write data
- Create folders / append data
- Write attributes
- Write extended attributes
- Read permissions
DDelete
PChange permissions
OTake ownership
XTraverse / execute
CHANGEModify
FULLFull control
Note You can combine single-letter aliases when you set permissions. For example, you can set
RDto apply the Windows permissionReadandDelete. However, you can neither combine multiple non-single-letter aliases nor combine aliases and hex values.
- A hex value that represents one or more Windows permissions.