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 |
|---|---|
|
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 | Description |
|---|---|
|
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 | Description |
|---|---|
|
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 | Description |
|---|---|
|
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 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 | Description |
|---|---|
|
The value of this property must correspond exactly to an existing attribute name. Value options: Attribute name Requires restart? No |
|
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 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 want portal downloads to prompt for justification, you must ensure your public user is either an appropriate user level or included in a user group that 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.
Viewing justification data
Navigate to the Download requests tab of the Tools menu in NetX proper, while logged in as a Director-level user or higher. The Download requests table displays all requests regardless of their approval status. Here, you can reference older requests and review any pending requests.
Request status
- View the list of justification-only downloads by selecting Justified from the Status dropdown along the top of the requests table.
- View all requests (regardless of their approval status) by changing the Status dropdown to Any.
Sort and filter
- Easily find downloads by using the column headers to order the list by user, date, asset count, status, or source.
- Search for particular users associated with a download using the search filter in the header.
Export CSV
- Justification data can be exported as a CSV file by clicking the Export button. This export is filtered by the Status dropdown, so make sure your filter is set to Justified or Any to see justification-only requests.
Select assets
- To select all assets in a request for bulk operations, click on the request's action menu and choose Select all.
Request details
To see more details about a download, click on a request or use the overflow menu and select View assets.
View assets
- Downloaded assets are listed with their thumbnail, file name, and file format.
- Clicking an asset's thumbnail will open that asset's detail page in a new tab.
View request details
- In the right pane, the Justification tab shows the downloader's username, email address, time, date, source of the request, and justification response.
- The Files tab displays the download options requested for the listed assets.
Select assets
- To select all assets in a request for bulk operations, click the Select all button in the details header.