org.bluezoo.gumdrop.ftp.file (Gumdrop API)

package org.bluezoo.gumdrop.ftp.file

Filesystem-based FTP handler implementations.

This package provides FTP handlers that map FTP operations to the local filesystem, with support for virtual paths, chroot jails, and role-based access control.

Key Components

Services (v2)

SimpleFTPService - Simple file-based FTP service with optional realm authentication
RoleBasedFTPService - FTP service with role-based access control and quota support
AnonymousFTPService - FTP service for anonymous public file distribution

Handlers and Supporting Classes

SimpleFTPHandler - Basic filesystem connection handler
RoleBasedFTPHandler - Handler with role-based access control
AnonymousFTPHandler - Handler for anonymous FTP access
BasicFTPFileSystem - Local filesystem implementation with chroot
RoleAwareFTPFileSystem - Decorator that enforces role-based access at the filesystem operation level; activated via RoleBasedFTPService.setFilesystemEnforcement(boolean)

Features

Chroot-style isolation per user
Configurable home directories
Integration with quota management
Virtual path mapping
Hidden file filtering

Configuration Example


 <realm id="ftpRealm" class="org.bluezoo.gumdrop.BasicRealm">
   <property name="href">ftp-users.xml</property>
 </realm>

 <service class="org.bluezoo.gumdrop.ftp.file.RoleBasedFTPService">
   <property name="realm" ref="#ftpRealm"/>
   <property name="root-directory">/var/ftp/users</property>
   <property name="welcome-message">Welcome to Gumdrop FTP</property>
   <listener class="org.bluezoo.gumdrop.ftp.FTPListener" port="21"/>
 </service>

Security

The handlers enforce strict path validation to prevent directory traversal attacks. Users are confined to their designated directories and cannot access files outside their scope.

Author:

Chris Burdess

See Also: