SigningHub configuration

To be able to save back completed documents into SharePoint, after completing the Azure configuration, a SigningHub Integration must be configured.

Below steps must be completed with a SigningHub account with access to Integration settings.

Setup an Integration

The first step is to create an integration on your SigningHub Enterprise.

• Login with an admin account into SigningHub.

• From the left bar menu, select the Configurations option next to the gear icon.

• In the Configurations page, Under Settings click on Integrations.

New Integration

Click on + Add an integration, follow the documentation to configure each section:

Application

Choose an appropriate Client ID to identify this integration. A descriptive name is recommended, so others in the future can link the integration configuration with the given integration.

Provide the URL to the UnityPortal endpoint under Callback URL,

Use this template https://__unityPortalHostname__/apache/generic/web/callback-landing.html?button=back , replacing __unityPortalHostname__ with the domain of your Unity Integrations Hub.

SigningHub.com Unity Integrations Hub deployment uses int-hub.signinghub.com .

The callback URL for SigningHub.com users would be: https://int-hub.signinghub.com/apache/generic/web/callback-landing.html?button=back

Be aware callback-landing.html must be deployed on the Unity Integrations Hub as part of the common static files deployed to the Apache server component. For more details, see Unity Integrations Hub configuration.

Click on Save changes and a Client Secret will be generated. Write down this secret for future use in this guide.

Integration Settings

Under the Settings tab. configure the settings for the integration.

• Define the default role for users that have no SigningHub account. These are the people outside your organisation that will receive a document, and have to act over it.

• Add the roles with access to the integration for those users with a SigningHub account.

• The rest of the settings can be left as default.

Webhooks

Under the "Webhooks" tab

• Enable all events under the Documents section.

• Setup the Server URL. Using the URL: https://__unityPortalHostname__/unity-sh/__customerId__/sharepoint/notification/sh-webhook replacing:

  • __unityPortalHostname__ with the URL of your Unity Integrations Hub, for SigningHub.com use int-hub.signinghub.com .

  • __customerId__. With your Tenant ID from Azure, or the one suplied by Ascertia Support or your IT Team for custom deployments.

Workflow Completion

Leave Workflow Completion tab untouched,

Save the changes

Click on the Save changes button, to save the configuration.