Configure download URL

censhare Web allows users to share asset files via landing pages and download links with users without access to your censhare system. Configure the download URL for this action.

Context

To use the "Add shared link" action in censhare Web and export asset files in the censhare Client, the download URL must be correctly configured.

Prerequisites

Available since censhare 2017.5

Introduction

censhare provides a default download directory named /tempDownload/. This directory must be accessible to download asset files from the server. Therefore, you have to adjust the base URL of the download path.

In censhare Web, the download path is configured in the System asset. The download path is the URL that the Add shared link wizard uses to create temporary download links. On the other side, the base URL must be adjusted in the XSLT file that creates the Temporary download asset for censhare Web. Both URLs must match so that download files are written to and fetched from the same path.

In the censhare Client, the temporary download action must be enabled. In the temporary download settings, the base URL must be adjusted likewise.

Note: If you want to share files with users outside your network, make sure that the URL can be publicly accessed.

Key steps

• In censhare Web

  • Adjust the base URL in the XSLT: Temporary download link (censhare Web) asset

  • Enter the download path in the System asset configuration

• In censhare Client

  • Enable the Send temporary download link action

  • Adjust the server URL in the Temporary download preferences

Configure download URL in censhare Web

Note: This configuration is done in censhare Web.

1. Open the XSLT: Temporary download link (censhare Web) asset. The resource key of this asset is censhare:temporary-download-link-c5.

2. Create a resource replace variant of this asset and open it.

3. In the "Editor" tab, search for:

   CODE

   <url>
       <xsl:value-of select="concat('https://localhost.censhare.com:9443/tempDownload/', $hash)"/>
       </url>

   Replace the host and port number with the base URL of your system.

4. Copy the URL to the clipboard and save your changes.

5. Open the System asset and open the Properties dialog.

6. In the "Settings" section, paste the URL in the "Temporary download URL" field.

7. Click OK to close the dialog and save your changes. 

Configure download URL and download action in the censhare Client

Note: This configuration is done in the censhare Admin Client.

1. Open the Configuration/Modules/Temporary Download/Send Temporary Download Link configuration.

2. Enable the action in the "General setup" section and click OK to save.

3. Open the Configuration/Modules/Temporary Download/Send Temporary Download (Preferences) configuration.

4. Enable the module if it is disabled and click Edit XML File.

5. Search for:

   CODE

   <temp-download-settings>
      <setting id="tempDownload" base-url="https://localhost.censhare.com:9443/tempDownload/"></setting>       
   </temp-download-settings>

   Replace the host and port number with the base URL of your server.

6. Click OK to close the XML editor.

7. Click OK to save the configuration.

The internal HTTP server must be activated to use this action.