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. .. raw:: html
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