Users subject to download justification are still able to download assets without administrator approval. To configure download approval, see our article on download approval.
With download justification enabled, users are required to fill out a form justifying the download of any affected asset. Download justification can be applied to individual assets, specific users, or entire user levels, but is only triggered when attempting to download the original asset. Any views, proxies, attribute data exports, or PDFs will not trigger download justification. Administrators are always exempt from download justification.
Enable download justification
| Property | Descriptions |
|---|---|
image.downloadJustificationEnabled |
If this property is true, download justification will be enabled on your site. If this property is false, no user regardless of any other property configuration will be subject to download approval. If none of the trigger properties below are set, this property will remain false even if the property's value has been explicitly set to true. However, the existence of trigger properties does not mean this property cannot be turned off by saving its value as false. Value options: true / false Requires restart? No |
Configure download justification
Download justification can be configured with a variety of triggers that determine which users and assets are subject to download justification.
By user level
When this property is set to the numeric equivalent for a user level, all users of that user level (and below) will be subject to download justification.
| Property | Descriptions |
|---|---|
image.downloadJustificationUserLevel |
Enforces download justification across any user of the specified user level or below, i.e. a value of 4 will enforce download justification for all producer, importer, consumer, and browser-level users. Only a single user level value can be used at a time. Value options: 0, 1, 2, 3, 4, 7, 8, 9 (User level number) Requires restart? No |
By group
To apply download justification to specific users, add these users to a group and configure one of the following settings:
By group name
Use the following property to target specific user groups for download justification; this setting will enforce download justification across all assets for all non-administrator users included in the named group.
| Property | Descriptions |
|---|---|
image.downloadJustificationGroups |
The value of this property must correspond exactly to at least one existing group name; any non-administrator user in the named group will be subject to download justification, even if they are a member of other groups that are not subject to download justification. Multiple groups can be added, delimited by commas with no space on either side of the comma. Value options: Group name(s) Requires restart? No |
By group attribute value
The following property targets specific user groups for download justification but also allows for a more granular justification trigger that can be applied to individual assets. This means assets can be tagged individually with a group's name rather than enforcing download justification across all assets.
| Property | Descriptions |
|---|---|
image.downloadJustificationAttributeName |
The value of this property must correspond exactly to an existing attribute name. If the attribute's value applied to an asset matches the exact name of the desired justification group, all users of that group will be subject to download justification for that asset. Multiple groups can be tagged on the same asset under the same attribute name if multiple selections are supported for that attribute's type. A pulldown, multiselect, or tag attribute type is highly recommended as this limits any value options to exact matches to the value(s) for a group name. Value options: Attribute name Requires restart? No |
By attribute value
Date type attributes are not supported as justification triggers.
The following properties, when set in conjunction, trigger download justification on any asset with the named attribute value applied to the named attribute. This will subject every user who is not an administrator to download justification for all affected assets.
| Property | Descriptions |
|---|---|
image.downloadJustificationAttributeName |
The value of this property must correspond exactly to an existing attribute name. Value options: Attribute name Requires restart? No |
image.downloadJustificationAttributeValue |
If a value for the attribute named in the property image.downloadJustificationAttributeName matches the value of this property, all non-administrator users will be subject to download justification for all affected assets. Pulldown, multiselect, or tag attribute types are highly recommended to avoid any potential value mismatches. Value options: Attribute name Requires restart? No |
Multiple justification triggers
Multiple download justification triggers can be configured at once, with two things to keep in mind:
- If an attribute value is used as the justification trigger, it will supersede any coexisting user level triggers.
- The property image.downloadJustificationAttributeName may only be used to customize a group trigger or an attribute value trigger, but not both. To set up a trigger for both scenarios, use the group property in conjunction with an attribute trigger.
Download justification and public users
If you have configured a portal with anonymous access and would like assets downloaded from the affected portal to be subject to download justification, you must ensure your public user is either an appropriate user level or included in a user group which requires justification. Attribute-based justification configurations will also apply to the public user.
Justifying a download
- Attempt to download or share on either an asset with a value, group, or user trigger.
- Select Original from the download options window; any other download selection will not be subject to download justification.
- Use the justification form to justify your download.
- Click Continue.