Provide a secure, authenticated directory listing that allows users to browse parent directories and view private images. The index must respect file system hierarchy, enforce access permissions, and offer a visual gallery interface for images.
A parent directory is the folder that contains one or more sub‑folders (or files). When that directory holds private images, an index is a listing—often generated automatically—that shows the names, thumbnails, or metadata of those images. parent directory index of private images
GET /browse?path=<relative_path>
Response: JSON containing
- current_path
- parent_path (or null if root)
- entries: [ name, type, size, modified, thumbnail_url, download_url ]
Performance notes:
When you visit a normal website, the web server is programmed to look for a default file—usually index.html or index.php—and display it to you. Image privacy classification (on-device ML model):
However, if the server is missing that default file and directory listing is left turned on, the server won't show an error page. Instead, it will display a raw, text-and-link list of every single file and folder stored inside that directory. This is called a "Directory Listing" or an "Index." When you visit a normal website
If that specific folder happens to be where a website or application stores user uploads (like private images, receipts, or documents), you get a Parent Directory Index of Private Images—a publicly accessible, bare-bones web page listing files that were never meant to be seen by the public.
Even with indexing off, it's good practice to place a blank index.html file in every directory. This ensures that even if a configuration resets, the directory doesn't turn into a listing page.
© 2009-2025 FactionFiles