Examples of jcifs.smb.ACE

jcifs.smb.ACE
An Access Control Entry (ACE) is an element in a security descriptor such as those associated with files and directories. The Windows OS determines which users have the necessary permissions to access objects based on these entries.
To fully understand the information exposed by this class a description of the access check algorithm used by Windows is required. The following is a basic description of the algorithm. For a more complete description we recommend reading the section on Access Control in Keith Brown's "The .NET Developer's Guide to Windows Security" (which is also available online).
Direct ACEs are evaluated first in order. The SID of the user performing the operation and the desired access bits are compared to the SID and access mask of each ACE. If the SID matches, the allow/deny flags and access mask are considered. If the ACE is a "deny" ACE and any of the desired access bits match bits in the access mask of the ACE, the whole access check fails. If the ACE is an "allow" ACE and all of the bits in the desired access bits match bits in the access mask of the ACE, the access check is successful. Otherwise, more ACEs are evaluated until all desired access bits (combined) are "allowed". If all of the desired access bits are not "allowed" the then same process is repeated for inherited ACEs.
For example, if user WNET\alice tries to open a file with desired access bits 0x00000003 (FILE_READ_DATA | FILE_WRITE_DATA) and the target file has the following security descriptor ACEs:
```
 Allow WNET\alice     0x001200A9  Direct Allow Administrators 0x001F01FF  Inherited Allow SYSTEM         0x001F01FF  Inherited 
```
the access check would fail because the direct ACE has an access mask of 0x001200A9 which doesn't have the FILE_WRITE_DATA bit on (bit 0x00000002). Actually, this isn't quite correct. If WNET\alice is in the local Administrators group the access check will succeed because the inherited ACE allows local Administrators both FILE_READ_DATA and FILE_WRITE_DATA access.

  private static final String GLOBAL_NAMESPACE = "global";
  private static final String LOCAL_NAMESPACE = "local";


  public void testACLForFileLevelAClOnly() throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("user1", AclScope.USER);
    ACE [] fileAces = {fileAce};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.getURL()).andReturn(new URL("file","host","file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

    verify(fileAce);
  }


  public void testACLForShareLevelAclOnly () throws IOException {
    SmbFileDelegate smbFile = createNiceMock(SmbFileDelegate.class);
    ACE shareAce = createACE("user2", AclScope.USER);
    ACE [] shareAces = {shareAce};
    expect(smbFile.getShareSecurity(true)).andReturn(shareAces);
    expect(smbFile.getURL()).andReturn(new URL("file","host","file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

    verify(shareAce);
  }


  public void testACLForShareLevelGroupAclOnly () throws IOException {
    SmbFileDelegate smbFile = createNiceMock(SmbFileDelegate.class);
    ACE shareAce = createACE("accountants", AclScope.GROUP);
    ACE [] shareAces = {shareAce};
    expect(smbFile.getShareSecurity(true)).andReturn(shareAces);
    expect(smbFile.getURL()).andReturn(new URL("file","host","file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

    verify(smbFile);
  }


  public void testACLForDomainNameStrippedOff () throws IOException {
    SmbFileDelegate smbFile = createNiceMock(SmbFileDelegate.class);
    ACE shareAce = createACE("domain\\accountants", AclScope.GROUP);
    ACE [] shareAces = {shareAce};
    expect(smbFile.getShareSecurity(true)).andReturn(shareAces);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

    verify(smbFile);
  }


  public void testACLForPresenceOfDenyShareLevelACE () throws IOException {
    SmbFileDelegate smbFile = createNiceMock(SmbFileDelegate.class);
    ACE shareAce = createACE("John Doe", AclScope.USER, AclAccess.DENY);
    ACE [] shareAces = {shareAce};
    expect(smbFile.getShareSecurity(true)).andReturn(shareAces);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

    verify(smbFile);
  }


  public void testACLForPresenceOfDenyFileLevelACE () throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("accountants", AclScope.GROUP, AclAccess.DENY);
    ACE [] fileAces = {fileAce};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

  }


  public void testACLForSAMLTypeACL () throws IOException {
    SmbFileDelegate smbFile = createNiceMock(SmbFileDelegate.class);
    String samlAceFormat = AclFormat.USER_AT_DOMAIN.getFormat();
    ACE shareAce = createACE("google\\accountants", AclScope.GROUP);
    ACE [] shareAces = {shareAce};
    expect(smbFile.getShareSecurity(true)).andReturn(shareAces);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

  }


  public void testACLForHTTPBasicTypeACL () throws IOException {
    SmbFileDelegate smbFile = createNiceMock(SmbFileDelegate.class);
    String httpAceFormat = AclFormat.DOMAIN_BACKSLASH_USER.getFormat();
    ACE shareAce = createACE("google\\accountants", AclScope.GROUP);
    ACE [] shareAces = {shareAce};
    expect(smbFile.getShareSecurity(true)).andReturn(shareAces);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

    verify(smbFile);
  }


  public void testACLForHTTPBasicUserAceAndSAMLGroupAce () throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("google\\superUser", AclScope.USER);
    ACE fileAce1 = createACE("user2", AclScope.USER);
    ACE [] fileAces = {fileAce, fileAce1};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    //To ensure that we get same SID for checking equality
    ACE shareAce = fileAce;
    ACE shareAce1 = createACE("google\\employees", AclScope.GROUP);
    ACE [] shareAces = {shareAce, shareAce1};
    expect(smbFile.getShareSecurity(true)).andReturn(shareAces);
    expect(smbFile.getURL()).andReturn(new URL("file","host","file"));
    expectLastCall().anyTimes();
    replay(smbFile);

View Full Code Here

    verify(shareAce1);
  }


  public void testACLForPresenceOfInheritedFolderLevelACE() throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce0 = createACE("accountants", AclScope.GROUP,
        AclAccess.PERMIT, AceType.ALL_INHERITED);
    ACE fileAce1 = createACE("sales", AclScope.GROUP,
        AclAccess.PERMIT, AceType.OBJECT_INHERITED);
    ACE fileAce2 = createACE("testing1", AclScope.GROUP,
        AclAccess.PERMIT, AceType.DIRECT);
    ACE fileAce3 = createACE("testing2", AclScope.GROUP,
        AclAccess.PERMIT, AceType.INHERIT_ONLY);
    ACE fileAce4 = createACE("testing3", AclScope.GROUP,
        AclAccess.PERMIT, AceType.CONTAINER_INHERITED);
    ACE fileAce5 = createACE("testing4", AclScope.GROUP,
        AclAccess.PERMIT, AceType.INHERITED);
    ACE[] fileAces =
        {fileAce0, fileAce1, fileAce2, fileAce3, fileAce4, fileAce5};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.isDirectory()).andReturn(true);

View Full Code Here

0 1 2 3 4

TOP

Related Classes of jcifs.smb.ACE

com.google.enterprise.connector.filesystem.LegacySmbAclBuilder

com.google.enterprise.connector.filesystem.LegacySmbAclBuilderTest

com.google.enterprise.connector.filesystem.SmbAclBuilderTest

org.apache.manifoldcf.crawler.connectors.sharedrive.SharedDriveConnector

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.