dadoonet · AlexBlueSteele · Oct 7, 2025 · Oct 7, 2025 · Oct 8, 2025 · Oct 9, 2025
@@ -19,6 +19,12 @@
 
 package fr.pilato.elasticsearch.crawler.fs.beans;
 
+import fr.pilato.elasticsearch.crawler.fs.framework.FileAcl;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
 /**
  * Represents additional file attributes.
  */
@@ -27,6 +33,7 @@ public class Attributes {
     private String owner;
     private String group;
     private int permissions;
+    private List<FileAcl> acl;
 
     public String getOwner() {
         return owner;
@@ -51,4 +58,16 @@ public int getPermissions() {
     public void setPermissions(int permissions) {
         this.permissions = permissions;
     }
+
+    public List<FileAcl> getAcl() {
+        return acl != null ? Collections.unmodifiableList(acl) : null;
+    }
+
+    public void setAcl(List<FileAcl> acl) {
+        if (acl == null || acl.isEmpty()) {
+            this.acl = null;
+        } else {
+            this.acl = new ArrayList<>(acl);
+        }
+    }
 }
@@ -32,11 +32,13 @@ public class Folder {
 
     private Path path;
     private File file;
+    private Attributes attributes;
 
     public Folder() {
         path = new Path();
         file = new File();
         file.setContentType(CONTENT_TYPE);
+        attributes = null;
     }
 
     /**
@@ -61,6 +63,7 @@ public Folder(String name, String root, String real, String virtual, LocalDateTi
         file.setLastModified(localDateTimeToDate(modification));
         file.setCreated(localDateTimeToDate(creation));
         file.setLastAccessed(localDateTimeToDate(lastAccess));
+        attributes = null;
     }
 
     public Path getPath() {
@@ -78,4 +81,12 @@ public File getFile() {
     public void setFile(File file) {
         this.file = file;
     }
+
+    public Attributes getAttributes() {
+        return attributes;
+    }
+
+    public void setAttributes(Attributes attributes) {
+        this.attributes = attributes;
+    }
 }
@@ -45,6 +45,8 @@
 import java.time.temporal.ChronoUnit;
 import java.util.ArrayList;
 import java.util.Collection;
+import java.util.List;
+import java.util.List;
 
 import static fr.pilato.elasticsearch.crawler.fs.framework.FsCrawlerUtil.*;
 import static fr.pilato.elasticsearch.crawler.fs.framework.JsonUtil.asMap;
@@ -493,6 +495,12 @@ private void indexFile(FileAbstractModel fileAbstractModel, ScanStatistic stats,
                 if (fileAbstractModel.getPermissions() >= 0) {
                     doc.getAttributes().setPermissions(fileAbstractModel.getPermissions());
                 }
+                if (fsSettings.getFs().isAclSupport()) {
+                    List<FileAcl> fileAcls = fileAbstractModel.getAcls();
+                    if (!fileAcls.isEmpty()) {
+                        doc.getAttributes().setAcl(fileAcls);
+                    }
+                }
             }
             // Attributes
 
@@ -634,6 +642,26 @@ private void indexDirectory(String path, String rootPath) throws Exception {
                 getModificationTime(folderInfo),
                 getLastAccessTime(folderInfo));
 
+        if (fsSettings.getFs().isAttributesSupport() && (fsSettings.getServer() == null || PROTOCOL.LOCAL.equals(fsSettings.getServer().getProtocol()))) {
+            Attributes attributes = new Attributes();
+            attributes.setOwner(getOwnerName(folderInfo));
+            attributes.setGroup(getGroupName(folderInfo));
+            int permissions = getFilePermissions(folderInfo);
+            if (permissions >= 0) {
+                attributes.setPermissions(permissions);
+            }
+            if (fsSettings.getFs().isAclSupport()) {
+                List<FileAcl> folderAcls = getFileAcls(folderInfo);
+                if (!folderAcls.isEmpty()) {
+                    attributes.setAcl(folderAcls);
+                }
+            }
+
+            if (attributes.getOwner() != null || attributes.getGroup() != null || attributes.getAcl() != null || permissions >= 0) {
+                folder.setAttributes(attributes);
+            }
+        }
+
         indexDirectory(SignTool.sign(path), folder);
     }
 

@@ -38,8 +38,12 @@
 
 package fr.pilato.elasticsearch.crawler.fs.crawler;
 
+import fr.pilato.elasticsearch.crawler.fs.framework.FileAcl;
 
 import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
 
 public class FileAbstractModel {
     private final String name;
@@ -55,9 +59,11 @@ public class FileAbstractModel {
     private final String group;
     private final int permissions;
     private final String extension;
+    private final List<FileAcl> acls;
 
     public FileAbstractModel(String name, boolean file, LocalDateTime lastModifiedDate, LocalDateTime creationDate, LocalDateTime accessDate,
-                             String extension, String path, String fullpath, long size, String owner, String group, int permissions) {
+                             String extension, String path, String fullpath, long size, String owner, String group, int permissions,
+                             List<FileAcl> acls) {
         this.name = name;
         this.file = file;
         this.directory = !file;
@@ -71,6 +77,11 @@ public FileAbstractModel(String name, boolean file, LocalDateTime lastModifiedDa
         this.group = group;
         this.permissions = permissions;
         this.extension = extension;
+        if (acls == null || acls.isEmpty()) {
+            this.acls = Collections.emptyList();
+        } else {
+            this.acls = Collections.unmodifiableList(new ArrayList<>(acls));
+        }
     }
 
     public String getName() {
@@ -125,6 +136,10 @@ public String getExtension() {
         return extension;
     }
 
+    public List<FileAcl> getAcls() {
+        return acls;
+    }
+
     @Override
     public String toString() {
         return "FileAbstractModel{" + "name='" + name + '\'' +
@@ -137,6 +152,7 @@ public String toString() {
                 ", owner='" + owner + '\'' +
                 ", group='" + group + '\'' +
                 ", permissions=" + permissions +
+                ", acls=" + acls +
                 ", extension='" + extension + '\'' +
                 ", fullpath='" + fullpath + '\'' +
                 ", size=" + size +

@@ -34,6 +34,7 @@
 import java.nio.file.Paths;
 import java.util.ArrayList;
 import java.util.Collection;
+import java.util.Collections;
 import java.util.Comparator;
 import java.util.stream.Stream;
 
@@ -61,6 +62,8 @@ private String resolveSeparator(String path) {
 
     @Override
     public FileAbstractModel toFileAbstractModel(String path, File file) {
+        final boolean collectAcls = fsSettings.getFs().isAclSupport();
+        System.out.println("[ACL DEBUG] Collecting ACLs for file " + file.getAbsolutePath() + " -> " + collectAcls);
         return new FileAbstractModel(
                 file.getName(),
                 file.isFile(),
@@ -73,7 +76,8 @@ public FileAbstractModel toFileAbstractModel(String path, File file) {
                 file.length(),
                 getOwnerName(file),
                 getGroupName(file),
-                getFilePermissions(file));
+                getFilePermissions(file),
+                collectAcls ? getFileAcls(file) : Collections.emptyList());
     }
 
     @Override

@@ -108,7 +108,8 @@ public FileAbstractModel toFileAbstractModel(String path, FTPFile file) {
                 file.getSize(),
                 file.getUser(),
                 file.getGroup(),
-                FTPUtils.getFilePermissions(file));
+                FTPUtils.getFilePermissions(file),
+                Collections.emptyList());
     }
 
     @Override

@@ -33,6 +33,7 @@
 import java.time.LocalDateTime;
 import java.time.ZoneId;
 import java.util.Collection;
+import java.util.Collections;
 import java.util.Comparator;
 import java.util.function.Predicate;
 import java.util.stream.Collectors;
@@ -82,7 +83,8 @@ public FileAbstractModel toFileAbstractModel(String path, SftpClient.DirEntry fi
                 file.getAttributes().getSize(),
                 Integer.toString(file.getAttributes().getUserId()),
                 Integer.toString(file.getAttributes().getGroupId()),
-                file.getAttributes().getPermissions());
+                file.getAttributes().getPermissions(),
+                Collections.emptyList());
     }
 
     @Override

@@ -122,6 +122,9 @@ The job file (``~/.fscrawler/test/_settings.yaml``) for the job name ``test`` mu
      # inlcude user/group of file only if needed
      attributes_support: false
 
+     # collect ACL metadata when available
+     acl_support: false
+
      # do you REALLY want to store every file as a copy in the index ? Then set this to true
      store_source: false
 

@@ -30,6 +30,8 @@ Here is a list of Local FS settings (under ``fs.`` prefix)`:
 +----------------------------+-----------------------+---------------------------------+
 | ``fs.attributes_support``  | ``false``             | `Adding file attributes`_       |
 +----------------------------+-----------------------+---------------------------------+
+| ``fs.acl_support``         | ``false``             | `Collecting ACL metadata`_      |
++----------------------------+-----------------------+---------------------------------+
 | ``fs.raw_metadata``        | ``false``             | `Enabling raw metadata`_        |
 +----------------------------+-----------------------+---------------------------------+
 | ``fs.filename_as_id``      | ``false``             | :ref:`filename-as-id`           |
@@ -422,6 +424,22 @@ and ``attributes.permissions``, you can set ``attributes_support`` to ``true``.
     On Windows systems, ``attributes.group`` and ``attributes.permissions`` are
     not generated.
 
+Collecting ACL metadata
+^^^^^^^^^^^^^^^^^^^^^^^
+
+To extract NTFS access control entries (principal, type, permissions and flags),
+enable both ``attributes_support`` and ``acl_support``:
+
+.. code:: yaml
+
+   name: "test"
+   fs:
+     attributes_support: true
+     acl_support: true
+
+When ``acl_support`` is disabled, FSCrawler skips resolving ACLs even if
+``attributes_support`` is active.
+
 Enabling raw metadata
 ^^^^^^^^^^^^^^^^^^^^^
 

@@ -59,6 +59,7 @@ It will give you a response similar to:
          "store_source" : false,
          "index_content" : true,
          "attributes_support" : false,
+         "acl_support" : false,
          "raw_metadata" : true,
          "xml_support" : false,
          "index_folders" : true,

@@ -545,6 +545,7 @@ public void createIndexAndComponentTemplates() throws Exception {
             // If needed, we create the component and index templates for the folder index
             if (settings.getFs().isIndexFolders()) {
                 logger.debug("Creating/updating component templates for [{}]", settings.getElasticsearch().getIndexFolder());
+                loadAndPushComponentTemplate(majorVersion, "fscrawler_mapping_attributes", settings.getElasticsearch().getIndexFolder());
                 loadAndPushComponentTemplate(majorVersion, "fscrawler_mapping_file", settings.getElasticsearch().getIndexFolder());
                 loadAndPushComponentTemplate(majorVersion, "fscrawler_mapping_path", settings.getElasticsearch().getIndexFolder());
 

@@ -7,6 +7,22 @@
             "group": {
               "type": "keyword"
             },
+            "acl": {
+              "properties": {
+                "flags": {
+                  "type": "keyword"
+                },
+                "permissions": {
+                  "type": "keyword"
+                },
+                "principal": {
+                  "type": "keyword"
+                },
+                "type": {
+                  "type": "keyword"
+                }
+              }
+            },
             "owner": {
               "type": "keyword"
             }

@@ -4,6 +4,7 @@
   ],
   "priority": 600,
   "composed_of": [
+    "fscrawler_INDEX_NAME_mapping_attributes",
     "fscrawler_INDEX_NAME_mapping_file",
     "fscrawler_INDEX_NAME_mapping_path"
   ],

@@ -7,6 +7,22 @@
             "group": {
               "type": "keyword"
             },
+            "acl": {
+              "properties": {
+                "flags": {
+                  "type": "keyword"
+                },
+                "permissions": {
+                  "type": "keyword"
+                },
+                "principal": {
+                  "type": "keyword"
+                },
+                "type": {
+                  "type": "keyword"
+                }
+              }
+            },
             "owner": {
               "type": "keyword"
             }

@@ -4,6 +4,7 @@
   ],
   "priority": 600,
   "composed_of": [
+    "fscrawler_INDEX_NAME_mapping_attributes",
     "fscrawler_INDEX_NAME_mapping_file",
     "fscrawler_INDEX_NAME_mapping_path"
   ],

@@ -7,6 +7,22 @@
             "group": {
               "type": "keyword"
             },
+            "acl": {
+              "properties": {
+                "flags": {
+                  "type": "keyword"
+                },
+                "permissions": {
+                  "type": "keyword"
+                },
+                "principal": {
+                  "type": "keyword"
+                },
+                "type": {
+                  "type": "keyword"
+                }
+              }
+            },
             "owner": {
               "type": "keyword"
             }

@@ -4,6 +4,7 @@
   ],
   "priority": 600,
   "composed_of": [
+    "fscrawler_INDEX_NAME_mapping_attributes",
     "fscrawler_INDEX_NAME_mapping_file",
     "fscrawler_INDEX_NAME_mapping_path"
   ],