ftp.update

Update ftp service configuration.

clients is an integer value which sets the maximum number of simultaneous clients allowed. It defaults to 32.

ipconnections is an integer value which shows the maximum number of connections per IP address. It defaults to 0 which equals to unlimited.

timeout is the maximum number of seconds that proftpd will allow clients to stay connected without receiving any data on either the control or data connection.

timeout_notransfer is the maximum number of seconds a client is allowed to spend connected, after authentication, without issuing a command which results in creating an active or passive data connection (i.e. sending/receiving a file, or receiving a directory listing).

onlyanonymous allows anonymous FTP logins with access to the directory specified by anonpath.

banner is a message displayed to local login users after they successfully authenticate. It is not displayed to anonymous login users.

filemask sets the default permissions for newly created files which by default are 077.

dirmask sets the default permissions for newly created directories which by default are 077.

resume if set allows FTP clients to resume interrupted transfers.

fxp if set to true indicates that File eXchange Protocol is enabled. Generally it is discouraged as it makes the server vulnerable to FTP bounce attacks.

defaultroot when set ensures that for local users, home directory access is only granted if the user is a member of group wheel.

ident is a boolean value which when set to true indicates that IDENT authentication is required. If identd is not running on the client, this can result in timeouts.

masqaddress is the public IP address or hostname which is set if FTP clients cannot connect through a NAT device.

localuserbw is a positive integer value which indicates maximum upload bandwidth in KB/s for local user. Default of zero indicates unlimited upload bandwidth ( from the FTP server configuration ).

localuserdlbw is a positive integer value which indicates maximum download bandwidth in KB/s for local user. Default of zero indicates unlimited download bandwidth ( from the FTP server configuration ).

anonuserbw is a positive integer value which indicates maximum upload bandwidth in KB/s for anonymous user. Default of zero indicates unlimited upload bandwidth ( from the FTP server configuration ).

anonuserdlbw is a positive integer value which indicates maximum download bandwidth in KB/s for anonymous user. Default of zero indicates unlimited download bandwidth ( from the FTP server configuration ).

tls is a boolean value which when set indicates that encrypted connections are enabled. This requires a certificate to be configured first with the certificate service and the id of certificate is passed on in ssltls_certificate.

tls_policy defines whether the control channel, data channel, both channels, or neither channel of an FTP session must occur over SSL/TLS.

tls_opt_enable_diags is a boolean value when set, logs verbosely. This is helpful when troubleshooting a connection.

options is a string used to add proftpd(8) parameters not covered by ftp service.

Type: object

Type: array
No Additional Items

Tuple Validation

Parameter 1: ftp_update

ftp_update

Type: object
No Additional Properties

Port

Type: integer

Value must be greater or equal to 1 and lesser or equal to 65535

Clients

Type: integer

Value must be greater or equal to 1 and lesser or equal to 10000

Ipconnections

Type: integer

Value must be greater or equal to 0 and lesser or equal to 1000

Loginattempt

Type: integer

Value must be greater or equal to 0 and lesser or equal to 1000

Timeout

Type: integer

Value must be greater or equal to 0 and lesser or equal to 10000

Timeout Notransfer

Type: integer

Value must be greater or equal to 0 and lesser or equal to 10000

Onlyanonymous

Type: boolean

Anonpath


Type: string
Type: null

Onlylocal

Type: boolean

Banner

Type: string

Filemask

Type: string

Dirmask

Type: string

Fxp

Type: boolean

Resume

Type: boolean

Defaultroot

Type: boolean

Ident

Type: boolean

Reversedns

Type: boolean

Masqaddress

Type: string

Passiveportsmin

Type: integer

Passiveportsmax

Type: integer

Localuserbw

Type: integer

Value must be greater or equal to 0

Localuserdlbw

Type: integer

Value must be greater or equal to 0

Anonuserbw

Type: integer

Value must be greater or equal to 0

Anonuserdlbw

Type: integer

Value must be greater or equal to 0

Tls

Type: boolean

Tls Policy

Type: enum (of string)
Must be one of:
  • ""
  • "on"
  • "off"
  • "data"
  • "!data"
  • "auth"
  • "ctrl"
  • "ctrl+data"
  • "ctrl+!data"
  • "auth+data"
  • "auth+!data"

Tls Opt Allow Client Renegotiations

Type: boolean

Tls Opt Allow Dot Login

Type: boolean

Tls Opt Allow Per User

Type: boolean

Tls Opt Common Name Required

Type: boolean

Tls Opt Enable Diags

Type: boolean

Tls Opt Export Cert Data

Type: boolean

Tls Opt No Empty Fragments

Type: boolean

Tls Opt No Session Reuse Required

Type: boolean

Tls Opt Stdenvvars

Type: boolean

Tls Opt Dns Name Required

Type: boolean

Tls Opt Ip Address Required

Type: boolean

Ssltls Certificate


Type: integer
Type: null

Options

Type: string

FtpEntry

Type: object
No Additional Properties

Id

Type: integer

Port

Type: integer

Value must be greater or equal to 1 and lesser or equal to 65535

Clients

Type: integer

Value must be greater or equal to 1 and lesser or equal to 10000

Ipconnections

Type: integer

Value must be greater or equal to 0 and lesser or equal to 1000

Loginattempt

Type: integer

Value must be greater or equal to 0 and lesser or equal to 1000

Timeout

Type: integer

Value must be greater or equal to 0 and lesser or equal to 10000

Timeout Notransfer

Type: integer

Value must be greater or equal to 0 and lesser or equal to 10000

Onlyanonymous

Type: boolean

Anonpath


Type: string
Type: null

Onlylocal

Type: boolean

Banner

Type: string

Filemask

Type: string

Dirmask

Type: string

Fxp

Type: boolean

Resume

Type: boolean

Defaultroot

Type: boolean

Ident

Type: boolean

Reversedns

Type: boolean

Masqaddress

Type: string

Passiveportsmin

Type: integer

Passiveportsmax

Type: integer

Localuserbw

Type: integer

Value must be greater or equal to 0

Localuserdlbw

Type: integer

Value must be greater or equal to 0

Anonuserbw

Type: integer

Value must be greater or equal to 0

Anonuserdlbw

Type: integer

Value must be greater or equal to 0

Tls

Type: boolean

Tls Policy

Type: enum (of string)
Must be one of:
  • ""
  • "on"
  • "off"
  • "data"
  • "!data"
  • "auth"
  • "ctrl"
  • "ctrl+data"
  • "ctrl+!data"
  • "auth+data"
  • "auth+!data"

Tls Opt Allow Client Renegotiations

Type: boolean

Tls Opt Allow Dot Login

Type: boolean

Tls Opt Allow Per User

Type: boolean

Tls Opt Common Name Required

Type: boolean

Tls Opt Enable Diags

Type: boolean

Tls Opt Export Cert Data

Type: boolean

Tls Opt No Empty Fragments

Type: boolean

Tls Opt No Session Reuse Required

Type: boolean

Tls Opt Stdenvvars

Type: boolean

Tls Opt Dns Name Required

Type: boolean

Tls Opt Ip Address Required

Type: boolean

Ssltls Certificate


Type: integer
Type: null

Options

Type: string


Required roles: SHARING_FTP_WRITE