34.2. FTP tables

The access to FTP resources is based on:

34.2.1. Users table

Users can access to FTP server only if they're enabled to FTP service (parameter FTP set tot YES).

[17:13:00] ABILIS_CPX:d user

- Not Saved (SAVE CONF) -------------------------------------------------------
------------------------+-------------+----------------------------------------
USER             PWD ACT|CTIP CLUS    |CHAT LDAP PPP FTP HTTP MAIL IAX SIP VO
------------------------+-------------+----------------------------------------
admin            *** YES #    #        YES  YES  YES YES YES  NO   NO  NO  NO
ftpuser          *** YES #    #        NO   NO   NO  YES NO   NO   NO  NO  NO
guest                NO  #    #        NO   NO   NO  NO  NO   NO   NO  NO  NO

Type the command d user:<user> to show the detailed user configuration parameters.

[17:13:05] ABILIS_CPX:d user:ftpuser

Parameter:          | Value:
--------------------+----------------------------------------------------------
USER:                 ftpuser
REAL-NAME:            ftpuser
ID:                   7             <Read Only>
PWD:                  ***
ACT:                  YES
GROUP:                
CTIP:                 #
CLUS:                 #
ADDRBOOK-SYNC:        SYS           
ADDRBOOK-NUMBER:      AUTO          
ADDRBOOK-OUTDIAL:     NONE          
ADDRBOOK-PUB-ENABLED: SYS           
OPC-ROLE:             USER
OPC-VIEW:             *
OPC-HIDE-NUMBERS:     NO
OPC-MONITOR:          NONE
OPC-PRIVACY:          NO
CHAT:                 NO    
CHAT-USER:            SYS
CHAT-PWD:             SYS
FTP:                  YES   
FTP-HOMEDIR:          
FTP-PROT:             PLAIN,SSL
-------------------------------------------------------------------------------

Meaning of the parameters:

FTP

Enables/disables the FTP service.

FTP-HOMEDIR

FTP user's home directory.

FTP-PROT

User's access protocol [PLAIN: not encrypted; SSL: encrypted].

34.2.2. FTP Virtual Root Paths table

FTP Virtual Paths Table specifies the association between virtual paths and their respective physical paths.

Virtual paths can be added/set/displayed/cleared with the commands:

a/s/d/c ftp path:<virtual path> [phys-path:<physical path>]

The whole table can be shown with the following command. By default the table contains the following entries:

[17:16:13] ABILIS_CPX:d ftp path

Parameter:  | Value:
------------+------------------------------------------------------------------
PATH:         /pub/
PHYS-PATH:    C:\USR\PUB\
-------------------------------------------------------------------------------
PATH:         /pub2/
PHYS-PATH:    D:\USR\PUB\
-------------------------------------------------------------------------------
PATH:         /usr/
PHYS-PATH:    C:\USR\
-------------------------------------------------------------------------------
PATH:         /usr2/
PHYS-PATH:    D:\USR\
-------------------------------------------------------------------------------

To show a specific path:

[17:25:52] ABILIS_CPX:d ftp path:/pub/

Parameter:  | Value:
------------+------------------------------------------------------------------
PATH:         /pub/
PHYS-PATH:    C:\USR\PUB\
-------------------------------------------------------------------------------

Meaning of the parameters:

PATH

Specifies a virtual directory path with UNIX notation. Virtual path / needs not to be specified because / does never refer to physical path, it is only the “container” of virtual paths. The maximum length is 32 characters.

PHYS-PATH

Specifies a physical directory path, with DOS notation (it starts with the disk letter and it ends with the character \ ). The maximum length is 128 characters.

34.2.3. FTP Virtual Paths Access Rights table

This table specifies the associations between virtual paths, users and their respective access rights.

Access rights for a specific virtual path can be added/set/displayed/cleared with the following commands.

a ftp rights path:<virtual path> |id:<id>

Adds the path only.

a ftp rights path:<virtual path> |id:<id> [user:<user> file:<file rights> dir:<dir rights> recur:yes|no mode:plain,ssl]

Adds user and path.

s ftp rights path:<virtual path> |id:<id> user:<user> [file:<file rights> dir:<dir rights> recur:yes|no mode:plain,ssl]

Sets rights and other parameters for an already existent user.

c ftp rights path:<virtual path> |id:<id> user:<user>

Deletes an existing user; if the user is the last one the path isn't deleted.

d ftp rights

Displays rights summary.

d ftp rights path:<virtual path> | id:<id>

Displays rights for a specific path.

d ftp rights user:<user>

Displays rights that a user has on all paths; the paths for which the user isn't defined are skipped.

An example of the output (by default the table contains the following entries):

[17:53:58] ABILIS_CPX:d ftp rights

-------------------------------------------------------------------------------
ID: PATH:
       USER:                            FILE: DIR:  RECUR: PROT:
-------------------------------------------------------------------------------
  1 /pub/
       admin                            rwdn  lcdn  YES    PLAIN,SSL
       anonymous                        r---  l---  YES    PLAIN,SSL
-------------------------------------------------------------------------------
  2 /pub2/
       admin                            rwdn  lcdn  YES    PLAIN,SSL
       anonymous                        r---  l---  YES    PLAIN,SSL
-------------------------------------------------------------------------------
  3 /sysdrives/
       admin                            rwdn  lcdn  YES    PLAIN,SSL
-------------------------------------------------------------------------------
  4 /usr/
       admin                            rwdn  lcdn  YES    PLAIN,SSL
-------------------------------------------------------------------------------
  5 /usr2/
       admin                            rwdn  lcdn  YES    PLAIN,SSL
-------------------------------------------------------------------------------

The rights are split in “file rights” and “directory rights” and are configured/viewed with two different parameters: FILE and DIR.

Table 34.1. FILE parameters values

RWDN
ReadWriteDeleteRename

Table 34.2. DIR parameters values

LCDN
ListCreateDeleteRename

The syntax is:

FILE:[+|-R][+|-W][+|-D][+|-N] DIR:[+|-L][+|-C][+|-D][+|-N]

  • The + sets granted right.

  • The - sets denied right.

  • If + or - isn't specified, the value + is assumed, so it may be omitted.

  • Not specified right is left unchanged.

  • FILE and DIR values do not care about the characters' position.

  • FILE and DIR values are case insensitive.

The following commands are equivalent:

  1. S FTP RIGHTS PATH:/ USER:test FILE:+R+W+D+N

    S FTP RIGHTS PATH:/ USER:test FILE:rwdn

    S FTP RIGHTS PATH:/ USER:test FILE:NdwR

  2. S FTP RIGHTS PATH:/ USER:test FILE:+D-N

    S FTP RIGHTS PATH:/ USER:test FILE:D-N

    S FTP RIGHTS PATH:/ USER:test FILE:-ND