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.

    verify(smbFile);
  }


  public void testACLForPresenceOfInheritedFileLevelACE() throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("accountants", AclScope.GROUP,
        AclAccess.PERMIT, AceType.INHERITED);
    ACE fileAce2 = createACE("testing1", AclScope.GROUP,
        AclAccess.PERMIT, AceType.DIRECT);
    ACE fileAce3 = createACE("testing2", AclScope.GROUP,
        AclAccess.PERMIT, AceType.INHERIT_ONLY);
    ACE[] fileAces = {fileAce, fileAce2, fileAce3};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.isDirectory()).andReturn(false);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));

View Full Code Here

  }


  public void testACLForPresenceOfInheritedFileLevelDenyACE()
      throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce = createACE("Sales Engineers", AclScope.USER,
        AclAccess.DENY, AceType.INHERITED);
    ACE fileAce2 = createACE("Sales Managers", AclScope.GROUP,
        AclAccess.DENY, AceType.INHERITED);
    ACE fileAce3 = createACE("testing1", AclScope.GROUP,
        AclAccess.DENY, AceType.DIRECT);
    ACE fileAce4 = createACE("testing2", AclScope.GROUP,
        AclAccess.DENY, AceType.INHERIT_ONLY);
    ACE[] fileAces = {fileAce, fileAce2, fileAce3, fileAce4};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.isDirectory()).andReturn(false);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));

View Full Code Here

   * the parent's inheritable ACEs and not injected into the
   * ACEs of the child (as they were in the past).
   */
  public void testInheritOnlyACEFromParent () throws IOException {
    SmbFileDelegate parentFile = createNiceMock(SmbFileDelegate.class);
    ACE parentAce1 = createACE("accountants", AclScope.GROUP,
        AclAccess.PERMIT, AceType.ALL_INHERIT);
    ACE parentAce2 = createACE("inherit-only", AclScope.GROUP,
        AclAccess.PERMIT, AceType.INHERIT_ONLY);
    ACE[] parentAces = { parentAce1, parentAce2 };
    expect(parentFile.getSecurity()).andReturn(parentAces);
    expect(parentFile.getURL()).andReturn(new URL("file", "host", "parent"));
    expectLastCall().anyTimes();
    replay(parentFile);


    SmbFileDelegate smbFile = createNiceMock(SmbFileDelegate.class);
    ACE fileAce1 = createACE("accountants", AclScope.GROUP,
        AclAccess.PERMIT, AceType.INHERITED);
    ACE fileAce2 = createACE("inherit-only", AclScope.GROUP,
        AclAccess.PERMIT, AceType.INHERITED);
    ACE[] fileAces = { fileAce1, fileAce2 };
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "parent/file"));
    expectLastCall().anyTimes();

View Full Code Here

   * We only care if an ACE could eventually get inherited by a regular file,
   * and child containers inheriting such an ACE could not pass it on.
   */
  public void testNoPropagateACEFromParent () throws IOException {
    SmbFileDelegate parentFile = createNiceMock(SmbFileDelegate.class);
    ACE parentAce1 = createACE("accountants", AclScope.GROUP,
        AclAccess.PERMIT, AceType.ALL_INHERIT);
    ACE parentAce2 = createACE("no-propagate", AclScope.GROUP,
        AclAccess.PERMIT, AceType.NO_PROPAGATE);
    ACE[] parentAces = { parentAce1, parentAce2 };
    expect(parentFile.getSecurity()).andReturn(parentAces);
    expect(parentFile.getURL()).andReturn(new URL("file", "host", "parent"));
    expectLastCall().anyTimes();

View Full Code Here

   * subordinate files (but not containers).  We create separate ACLs that could
   * be inherited by containers vs. files.
   */
  public void testSeparateFileAndContainerInheritACLs () throws IOException {
    SmbFileDelegate parentFile = createNiceMock(SmbFileDelegate.class);
    ACE parentAce1 = createACE("accountants", AclScope.GROUP,
        AclAccess.PERMIT, AceType.ALL_INHERIT);
    ACE parentAce2 = createACE("container-inherit", AclScope.GROUP,
        AclAccess.PERMIT, AceType.CONTAINER_INHERIT);
    ACE parentAce3 = createACE("file-inherit", AclScope.GROUP,
        AclAccess.PERMIT, AceType.OBJECT_INHERIT);
    ACE[] parentAces = { parentAce1, parentAce2, parentAce3 };
    expect(parentFile.getSecurity()).andReturn(parentAces);
    expect(parentFile.getURL()).andReturn(new URL("file", "host", "parent"));
    expectLastCall().anyTimes();

View Full Code Here

  }


  /** Test hasInheritedAcls returns false when the file has no inherited ACEs. */
  public void testHasInheritedAclsWithNoInheritedAcl() throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce1 = createACE("testing1", AclScope.GROUP,
        AclAccess.PERMIT, AceType.DIRECT);
    ACE fileAce2 = createACE("testing2", AclScope.USER,
        AclAccess.PERMIT, AceType.DIRECT);
    ACE fileAce3 = createACE("testing3", AclScope.GROUP,
        AclAccess.DENY, AceType.DIRECT);
    ACE fileAce4 = createACE("testing4", AclScope.USER,
        AclAccess.DENY, AceType.DIRECT);
    ACE[] fileAces = {fileAce1, fileAce2, fileAce3, fileAce4};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));
    expectLastCall().anyTimes();

View Full Code Here

  }


  /** Test hasInheritedAcls returns true when the file has inherited ACEs. */
  public void testHasInheritedAclsWithInheritedAclOnFolder() throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce1 = createACE("testing1", AclScope.GROUP,
        AclAccess.PERMIT, AceType.ALL_INHERITED);
    ACE fileAce2 = createACE("testing2", AclScope.USER,
        AclAccess.PERMIT, AceType.CONTAINER_INHERITED);
    ACE fileAce3 = createACE("testing3", AclScope.GROUP,
        AclAccess.DENY, AceType.OBJECT_INHERITED);
    ACE fileAce4 = createACE("testing4", AclScope.USER,
        AclAccess.DENY, AceType.NO_PROPAGATE);
    ACE[] fileAces = {fileAce1, fileAce2, fileAce3, fileAce4};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.isDirectory()).andReturn(true);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));

View Full Code Here

   * inherit-from chain remains unbroken.
   */
  public void testHasInheritedAclsWithFilteredInheritedAclOnFolder()
      throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce1 = createACE("testing1", AclScope.GROUP,
        AclAccess.PERMIT, AceType.CONTAINER_INHERITED);
    ACE fileAce2 = createACE("testing2", AclScope.USER,
        AclAccess.PERMIT, AceType.CONTAINER_INHERITED);
    ACE fileAce3 = createACE("testing3", AclScope.GROUP,
        AclAccess.DENY, AceType.CONTAINER_INHERITED);
    ACE fileAce4 = createACE("testing4", AclScope.USER,
        AclAccess.DENY, AceType.NO_PROPAGATE);
    ACE[] fileAces = {fileAce1, fileAce2, fileAce3, fileAce4};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.isDirectory()).andReturn(true);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));

View Full Code Here

   */
  public void testACLForBuiltInACE() throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    SID sid = new SID(new SID("S-1-5-32-544"), SID.SID_TYPE_ALIAS,
                      "BUILTIN", "Administrators", false);
    ACE fileAce = createACE(sid, AclAccess.PERMIT, AceType.DIRECT);
    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(smbFile);
  }


  public void testACEForcheckAndAddAces() throws IOException {
    SmbFileDelegate smbFile = createMock(SmbFileDelegate.class);
    ACE fileAce1 = createACE("test2", AclScope.USER,
        AclAccess.PERMIT, AceType.DIRECT);
    ACE fileAce2 = createACE("test3", AclScope.USER,
        AclAccess.DENY, AceType.DIRECT);
    ACE fileAce3 = createACE("tester", AclScope.GROUP,
        AclAccess.PERMIT, AceType.DIRECT);
    ACE fileAce4 = createACE("testing", AclScope.GROUP,
        AclAccess.DENY, AceType.DIRECT);
    ACE fileAce5 = createACE("testing2", AclScope.GROUP,
        AclAccess.DENY, AceType.INHERITED);
    ACE[] fileAces = {fileAce1, fileAce2, fileAce3, fileAce4, fileAce5};
    expect(smbFile.getSecurity()).andReturn(fileAces);
    expect(smbFile.getURL()).andReturn(new URL("file", "host", "file"));
    expectLastCall().anyTimes();

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.