ImageVault SharePoint Connect with Low-trust

When using a Low-trust installation, the Provider Web which serves content and functionality to Add-in pages will be hosted remotely by ImageVault. User authentication when visiting the Add-in is handled by Microsoft Azure.

Since the Provider Web is hosted remotely, you will receive the latest updates automatically.

Requirements

  • SharePoint Online, or SharePoint 2013 On-premise with Azure ACS.
  • A configured App Environment in SharePoint.

Installation package

The installation package for Low-trust contains the following:

  • ImageVault SharePoint Connect Add-in.
  • (Optional) Javascript file with hostweb functionality.

Installing the Add-in

Configuring the App Environment

Please follow the instructions in the follow link in order to configure an App Environment. This step is not required for SharePoint Online.

https://technet.microsoft.com/en-us/library/fp161236.aspx

Registering the SharePoint Add-in

The Add-in should be registered in SharePoint before it is added to any sites. Visit the add-in registration page at the below address:

https://[My SharePoint Address]/_layouts/15/appregnew.aspx

Enter the following values to complete the registration:

Uploading the SharePoint Add-in

SharePoint stores add-in packages in an Add-in Catalog. The add-ins are available to all organizational sites when uploaded and published to the catalog.

Updates to the Add-in are uploaded in the same way and can then be used to upgrade installed instances on individual SharePoint sites.

Visit the Add-in Catalog and upload the ImageVault SharePoint Connect Add-in which has been provided to you.

Note

The zip file provided with the installation contains an Addin folder where the add-in is located. It is named ImageVaultConnect_ProviderHosted_vxxx.app where xxx is the application version.

Finding your Add-in Catalog in SharePoint Online

Depending on your subscription level there may exist a pre-created Add-in Catalog at the following location:

https://[organization].sharepoint.com/sites/appcatalog

Please follow the instructions in the following link in order to create a new Add-in Catalog:

https://msdn.microsoft.com/en-us/library/office/dn574752.aspx

Finding your Add-in Catalog in SharePoint on-premise

Please follow the instructions in the following link in order to create a new Add-in Catalog:

https://msdn.microsoft.com/en-us/library/office/fp123530.aspx

Finished

ImageVault SharePoint Connect Low-trust should now be configured.

(Optional) Installing Host web scripts

The Add-in supports enhanced functionality for inserting media into rich text fields, and interacting with App-parts, by including a Javascript file to your SharePoint host web.

The host web scripts enables the following:

  • Inserting ImageVault media in rich text fields.
  • Editing ImageVault media in rich text fields.
  • Inserting ImageVault media in publishing templates.
  • Editing ImageVault media in publishing templates.
  • Displaying a media viewer when a user clicks on media in Gallery App-parts.

Install the script by including it to any page layout or masterpage in SharePoint where the functionality is required.

Note

The script is located in the Scripts folder in the zip file provided with the installation.

BREAKING CHANGES

The host web scripts are not compatible with the SharePoint modern version. Only available for SharePoint "classic" sites.