action dracoon_request_general_settings {
  label: "Request general settings"
  description: "<h3 style='padding: 5px; background-color: #F6F7F8; border: 1px solid #AAA; border-radius: 5px; display: table-cell;'>&#128640; Since v4.6.0</h3>\n\n### Description:  \nDRACOON general settings configuration entry point.  \n\n### Precondition:\nRight <span style='padding: 3px; background-color: #F6F7F8; border: 1px solid #000; border-radius: 5px; display: inline;'>&#128275; read global config</span> and\nrole <span style='padding: 3px; background-color: #F6F7F8; border: 1px solid #000; border-radius: 5px; display: inline;'>&#128100; Config Manager</span> of the Provider Customer required.\n\n### Postcondition:\nReturns a list of configurable general settings.\n\n### Further Information:\n\n### Auth token restrictions:\n\nA restriction is a lower bound for a token timeout and defines a duration after which a token is invalidated when it wasn't used.  \nThe access/refresh token validity duration of the client is the upper bound. A token is invalidated - in any case - when it has passed.  \n\nAuth token restrictions are enabled by default.\n\n* Default access token validity: **2 hours**  \n* Default refresh token validity: **30 days**\n\n### Configurable general settings:\n<details open style=\"padding: 10px; background-color: #F6F7F8; border: 1px solid #AAA; border-radius: 5px;\">\n<summary style=\"cursor: pointer; outline: none\"><strong>Expand</strong></summary>\n\n| Setting | Description | Value |\n| :--- | :--- | :--- |\n| `sharePasswordSmsEnabled` | Determines whether sending of share passwords via SMS is allowed. | `true or false` |\n| `cryptoEnabled` | Determines whether client-side encryption is enabled.<br>Can only be enabled once; disabling is **NOT** possible. | `true or false` |\n| `emailNotificationButtonEnabled` | Determines whether email notification button is enabled. | `true or false` |\n| `eulaEnabled` | Determines whether EULA is enabled.<br>Each user has to confirm the EULA at first login. | `true or false` |\n| `useS3Storage` | Defines if S3 is used as storage backend.<br>Can only be enabled once; disabling is **NOT** possible. | `true or false` |\n| `s3TagsEnabled` | Determines whether S3 tags are enabled | `true or false` |\n| `authTokenRestrictions` | Determines auth token restrictions. (e.g. restricted access token validity) | `object` |\n\n</details>\n\n### Deprecated configurable general settings:\n<details style=\"padding: 10px; background-color: #F6F7F8; border: 1px solid #AAA; border-radius: 5px;\">\n<summary style=\"cursor: pointer; outline: none\"><strong>Expand</strong></summary>\n\n| Setting                           | Description | Value |\n|:----------------------------------| :--- | :--- |\n| <del>`mediaServerEnabled`</del>   | Determines whether media server is enabled.<br>Returns boolean value dependent on conjunction of `mediaServerConfigEnabled` AND `mediaServerEnabled` | `true or false` |\n| <del>`weakPasswordEnabled`</del>  | Determines whether weak password is allowed.<br>Use `GET /system/config/policies/passwords` API to get configured password policies. | `true or false` |\n| <del>`hideLoginInputFields`</del> | Determines whether input fields for login should be enabled | `true or false` |\n\n</details>"
  provider: dracoon
  method: GET
  path: "/v4/system/config/settings/general"
  encoding: json
  input: {
    type: "object"
    properties: {
      "X-Sds-Auth-Token": {
        type: "string"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "General settings"
    properties: {
      authTokenRestrictions: {
        type: "object"
        description: "Auth token restrictions"
        properties: {
          accessTokenValidity: {
            type: "integer"
            format: "int32"
            description: "&#128640; Since v4.13.0\n\nRestricted OAuth access token validity (in seconds)"
          }
          refreshTokenValidity: {
            type: "integer"
            format: "int32"
            description: "&#128640; Since v4.13.0\n\nRestricted OAuth refresh token validity (in seconds)"
          }
          restrictionEnabled: {
            type: "boolean"
            description: "&#128640; Since v4.13.0\n\nDefines if OAuth token restrictions are enabled"
          }
        }
      }
      cryptoEnabled: {
        type: "boolean"
        description: "Activation status of client-side encryption.\n\nCan only be enabled once; disabling is not possible."
      }
      emailNotificationButtonEnabled: {
        type: "boolean"
        description: "Enable email notification button"
      }
      eulaEnabled: {
        type: "boolean"
        description: "Each user has to confirm the EULA at first login."
      }
      hideLoginInputFields: {
        type: "boolean"
        description: "&#128679; Deprecated since v4.42.0\n\nDefines if login fields should be hidden"
      }
      mediaServerEnabled: {
        type: "boolean"
        description: "&#128679; Deprecated since v4.12.0\n\nDetermines if the media server is enabled"
      }
      s3TagsEnabled: {
        type: "boolean"
        description: "&#128640; Since v4.9.0\n\nDefines if S3 tags are enabled"
      }
      sharePasswordSmsEnabled: {
        type: "boolean"
        description: "Allow sending of share passwords via SMS"
      }
      useS3Storage: {
        type: "boolean"
        description: "Defines if S3 is used as storage backend"
      }
      weakPasswordEnabled: {
        type: "boolean"
        description: "&#128679; Deprecated since v4.14.0\n\nAllow weak password\n\n* A weak password has to fulfill the following criteria:\n\n   * is at least 8 characters long\n\n   * contains letters and numbers\n\n* A strong password has to fulfill the following criteria in addition:\n\n   * contains at least one special character\n\n   * contains upper and lower case characters\n\nPlease use `GET /system/config/policies/passwords` API to get configured password policies."
      }
    }
  }
}