Policy Related API Changes
Background
Prior to FileCloud 17.3, many settings and options were either set globally or overridden on a per-user basis. This is hard to manage for hundreds of users in the system and can be error-prone. To help alleviate this issue, 17.3 introduces the concept of policies that allow administrators a great deal of flexibility in managing a large FileCloud installation. Policies are a collection of rules and settings that apply to a specific user or sets of users. Any number of policies can be created by an administrator and then can be associated to a set of users indvidually or to set of FileCloud Groups.
What API is affected?
- Quota Settings for User Accounts: If you are using "size" parameter in updateuser API to set the allowed user quota for managed storage, it is no longer supported and the API will ignore the setting and log an error message.
- System Config Settings: If you are using the setconfigsetting API or updatepolicyforuser API, then following keys can no longer by set using this API and should be managed by the new Policy infrastructure
TONIDOCLOUD_DEFAULT_SIZE_PERUSER TONIDOCLOUD_DISABLE_NOTIFICATION TONIDOCLOUD_GLOBAL_SHARE_MODE TONIDOCLOUD_ENABLE_PRIVACY_SETTINGS TONIDOCLOUD_ENABLE_2FA TONIDOCLOUD_2FA_DELIVERY_MODE TONIDOCLOUD_DISABLE_INVITES TONIDOCLOUD_DEVICE_LOGIN_CODE_MODE TONIDOCLOUD_ADMIN_DEVICE_APPROVAL_REQUIRED TONIDOCLOUD_ENFORCE_SESSIONTIMEOUT_DEVICES TONIDOCLOUD_CREATE_ACCOUNT_ON_INVITE TONIDOCLOUD_SET_ACL TONIDOCLOUD_REQUIRE_PASSCODE_MOBILECLIENTS TONIDOCLOUD_DISABLE_CONNECT_MOBILECLIENTS TONIDOCLOUD_DISABLE_PRINT_MOBILECLIENTS TONIDOCLOUD_DISABLE_DOWNLOAD_MOBILECLIENTS TONIDOCLOUD_DISABLE_OPENWITH_MOBILECLIENTS TONIDOCLOUD_DISABLE_SHARE_MOBILECLIENTS TONIDOCLOUD_DISABLE_FAV_MOBILECLIENTS TONIDOCLOUD_DISABLE_EDITS_MOBILECLIENTS TONIDOCLOUD_DISABLE_CONFIG_CHANGES_MOBILECLIENTS TONIDOCLOUD_APPLY_CONFIG_MOBILECLIENTS TONIDOCLOUD_NOTIFICATION_DISABLE_ADD TONIDOCLOUD_NOTIFICATION_DISABLE_UPDATE TONIDOCLOUD_NOTIFICATION_DISABLE_DELETE TONIDOCLOUD_NOTIFICATION_DISABLE_DOWNLOAD TONIDOCLOUD_NOTIFICATION_DISABLE_PREVIEW TONIDOCLOUD_NOTIFICATION_DISABLE_LOCK TONIDOCLOUD_NOTIFICATION_DISABLE_SELF_NOTIFICATION
Handling Changes
If you are upgrading to 17.3 and if you are using the above APIs. Please note that you will need to handle it differently.
Setting Quota for Specific Users
If you want to just a specific quota for a user, you should instead
- create a new policy for that user if policy doesn't exist and attach it to the user
- (or) if policy is already attached to that user, retrieve that policy
- set the required quota in that user specific policy
Setting Default Quota Globally
If you want to set the default quota and make that change apply to all users, you should instead
Setting specific user level settings
If you want to set specific user level settings(via updatepolicyforuser API) that were managed by the above configuration flags (listed in section above), you should instead
- create a new policy for that user if policy doesn't exist and attach it to the user
- (or) if policy is already attached to that user, retrieve that policy
- set the required setting in that policy
Setting Global Setings
If you want to set the global settings and make that change apply to all users, you should instead