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.

    return false;
  }
  
  public void testFilterUnwantedAces() throws Exception {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class); 
    ACE unsupportedTypeAce = createACE(
        createSID(null, "Nobody", SID.SID_TYPE_WKN_GRP),
        AclAccess.PERMIT, AceType.DIRECT);
    ACE unsupportedBuiltinAce = createACE(
        createSID("BUILTIN", "Batch", SID.SID_TYPE_ALIAS),
        AclAccess.PERMIT, AceType.DIRECT);
    ACE unresolvedAce = createACE(
        new SID(new SID("S-1-16-696969"), SID.SID_TYPE_ALIAS,
                null, "S-1-16-696969", false),
        AclAccess.PERMIT, AceType.DIRECT);
    ACE noReadAccessAce = createACE(
        createSID(null, "NoReading", SID.SID_TYPE_DOM_GRP),
        AclAccess.PERMIT, AceType.DIRECT,
        ACE.FILE_WRITE_DATA | ACE.FILE_APPEND_DATA | ACE.FILE_WRITE_EA |
        ACE.FILE_EXECUTE | ACE.FILE_DELETE | ACE.FILE_WRITE_ATTRIBUTES |
        ACE.DELETE | ACE.WRITE_DAC | ACE.WRITE_OWNER | ACE.SYNCHRONIZE |

View Full Code Here

   *        inherited ACE and if INHERIT_ONLY inherit_only ACE will be created.
   * @param aceAccessMask the mask of access bits OR'd together
   */
  private ACE createACE(SID sid, AclAccess aclAccess, AceType aceInheritType,
                        int aceAccessMask) {
    ACE ace = createMock(ACE.class);
    expect(ace.getSID()).andStubReturn(sid);
    expect(ace.isAllow()).andStubReturn(aclAccess == AclAccess.PERMIT);
    expect(ace.getFlags()).andStubReturn(aceInheritType.flags);
    expect(ace.getAccessMask()).andStubReturn(aceAccessMask);
    replay(ace);
    return ace;
  }

View Full Code Here

  private final String defaultAceFormat =
      AclFormat.DOMAIN_BACKSLASH_USER.getFormat();


  public void testACLForFileAndShareAndIntersection () throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("user1", true);
    ACE fileAce1 = createACE("user2", true);
    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("group1", false);
    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 testACLForFileAndShareAndUnion () throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("user1", true);
    ACE [] fileAces = {fileAce};
    expect(smbFile.getSecurity()).andReturn(fileAces);


    ACE shareAce = createACE("user2", true);
    ACE shareAce1 = createACE("group1", false);
    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 testACLForFileLevelAClOnly() throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("user1", true);
    ACE [] fileAces = {fileAce};
    expect(smbFile.getSecurity()).andReturn(fileAces);


    expect(smbFile.getURL()).andReturn(new URL("file","host","file"));
    expectLastCall().anyTimes();

View Full Code Here

  }


  public void testACLForShareLevelAclOnly () throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);


    ACE shareAce = createACE("user2", true);
    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 testACLForShareLevelGroupAclOnly () throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);


    ACE shareAce = createACE("accountants", false /* this will create a group ACE*/);
    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 testACLForIncorrectSecurityLevel () throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("user1", true);
    ACE [] fileAces = {fileAce};
    expect(smbFile.getSecurity()).andReturn(fileAces);


    ACE shareAce = createACE("user2", true);
    ACE shareAce1 = createACE("group1", false);
    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

  }


  public void testACLForDomainNameStrippedOff () throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);


    ACE shareAce = createACE("domain\\accountants", false /* this will create a group ACE*/);
    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 = createMock(SmbFileDelegate.class);
    ACE shareAce = createACE("accountants", false /*group ACE*/, true /*Deny ACE*/);
    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

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.