Update system settings

v1.0.0

🚧 Deprecated since v4.6.0

Description:

Update configurable settings.

Precondition:

Right 🔓 change global config and role 👤 Config Manager of the Provider Customer required.

Postcondition:

One or more global settings gets changed.

Further Information:

This API is deprecated and will be removed in the future.
Check for every settings key new corresponding API and key below.

Configurable settings:

Expand

Setting	Description	Value
`branding_server_branding_id`	The branding UUID, which corresponds to BRANDING-QUALIFIER in the new branding server. cf. `PUT /system/config/settings/branding` `BrandingConfig.brandingQualifier`	`String`
`branding_portal_url`	Access URL to to the Branding Portal Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/branding` `BrandingConfig.brandingProviderUrl`	`String`
`dblog`	Write logs to local database. Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/eventlog` `EventlogConfig.enabled`	`true or false`
`default_downloadshare_expiration_period`	Default expiration period for Download Shares in days cf. `PUT /system/config/settings/defaults` `SystemDefaults.downloadShareDefaultExpirationPeriod`	`Integer between 0 and 9999` Set `0` to disable.
`default_file_upload_expiration_date`	Default expiration period for all uploaded files in days cf. `PUT /system/config/settings/defaults` `SystemDefaults.fileDefaultExpirationPeriod`	`Integer between 0 and 9999` Set `0` to disable.
`default_language`	Define which language should be default. cf. `PUT /system/config/settings/defaults` `SystemDefaults.languageDefault`	cf. `GET /public/system/info` - `SystemInfo.languageDefault`
`default_uploadshare_expiration_period`	Default expiration period for Upload Shares in days cf. `PUT /system/config/settings/defaults` `SystemDefaults.uploadShareDefaultExpirationPeriod`	`Integer between 0 and 9999` Set `0` to disable.
`enable_client_side_crypto`	Activation status of client-side encryption Can only be enabled once; disabling is NOT possible. cf. `PUT /system/config/settings/general` `GeneralSettings.cryptoEnabled`	`true or false` default: `false`
`eula_active`	Each user has to confirm the EULA at first login. cf. `PUT /system/config/settings/general` `GeneralSettings.eulaEnabled`	`true or false`
`eventlog_retention_period`	Retention period (in days) of event log entries After that period, all entries are deleted. cf. `PUT /system/config/settings/eventlog` `EventlogConfig.retentionPeriod`	`Integer between 0 and 9999` If set to `0`: no logs are deleted Recommended value: `7`
`ip_address_logging`	Determines whether a user's IP address is logged. Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/eventlog` `EventlogConfig.logIpEnabled` cf. `PUT /system/config/settings/syslog` `SyslogConfig.logIpEnabled`	`true or false`
`mailserver`	Email server to send emails. Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/mail_server` `MailServerConfig.host`	`DNS name or IPv4 of an email server`
`mailserver_authentication_necessary`	Set to `true` if the email server requires authentication. Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/mail_server` `MailServerConfig.authenticationEnabled`	`true or false`
`mailserver_password`	Password for email server cf. `PUT /system/config/settings/mail_server` `MailServerConfig.password`	`Password for authentication`
`mailserver_port`	Email server port Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/mail_server` `MailServerConfig.port`	`Valid port number`
`mailserver_username`	Username for email server Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/mail_server` `MailServerConfig.username`	`Username for authentication`
`mailserver_use_ssl`	Email server requires SSL connection? Only visible for Config Manager of Provider Customer. Requires `mailserver_use_starttls` to be `false` cf. `PUT /system/config/settings/mail_server` `MailServerConfig.username`	`true or false`
`mailserver_use_starttls`	Email server requires StartTLS connection? Only visible for Config Manager of Provider Customer. Requires `mailserver_use_ssl` to be `false` cf. `PUT /system/config/settings/mail_server` `MailServerConfig.starttlsEnabled`	`true or false`
`syslog`	Write logs to a syslog interface. Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/syslog` `SyslogConfig.enabled`	`true or false`
`syslog_host`	Syslog server (IP or FQDN) Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/syslog` `SyslogConfig.host`	`DNS name or IPv4 of a syslog server`
`syslog_port`	Syslog server port Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/syslog` `SyslogConfig.port`	`Valid port number`
`syslog_protocol`	Protocol to connect to syslog server. Only visible for Config Manager of Provider Customer. cf. `PUT /system/config/settings/syslog` `SyslogConfig.protocol`	`TCP or UDP`
`enable_email_notification_button`	Enable mail notification button. cf. `PUT /system/config/settings/general` `GeneralSettings.emailNotificationButtonEnabled`	`true or false`
`allow_share_password_sms`	Allow sending of share passwords via SMS. cf. `PUT /system/config/settings/general` `GeneralSettings.sharePasswordSmsEnabled`	`true or false`

Deprecated settings:

Expand

Setting	Description	Value
~~`allow_system_global_weak_password`~~	Determines whether weak password (cf. Password Policy below) is allowed. cf. `PUT /system/config/settings/general` `GeneralSettings.weakPasswordEnabled` Use `PUT /system/config/policies/passwords` API to change configured password policies.	`true or false`
~~`branding_server_customer`~~	The UUID of the branding server customer, which corresponds to customer key in the branding server.	`String`
~~`branding_server_url`~~	Access URL to to the Branding Server. Only visible for Config Manager of Provider Customer.	`String`
~~`email_from`~~	Sender of system-generated emails Only visible for Config Manager of Provider Customer. Moved to branding	`Valid email address`
~~`email_to_sales`~~	Contact email address for customers to request more user licenses or data volume. Moved to branding	`Valid email address`
~~`email_to_support`~~	Support email address for users Moved to branding	`Valid email address`
~~`file_size_js`~~	Maximum file size (in bytes) for downloads of encrypted files with JavaScript. Bigger files will require a JavaApplet.	`Integer` Recommended value: `10485760` (=`10MB`)
~~`system_name`~~	System name Moved to branding use `product.title`	`Display name of the DRACOON`

Input

{
  "type": "object",
  "properties": {
    "X-Sds-Auth-Token": {
      "type": "string"
    },
    "items": {
      "type": "array",
      "description": "List of key-value pairs",
      "items": {
        "type": "object",
        "description": "Key-value pair",
        "required": [
          "key",
          "value"
        ],
        "properties": {
          "key": {
            "type": "string",
            "description": "Entry key"
          },
          "value": {
            "type": "string",
            "description": "Entry value"
          }
        }
      }
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "additionalProperties": true
}