The Office 365 connector allows SigningHub to connect with Office 365 to authenticate users both at the time of login and at the time of signing. By using this connector, the SigningHub users can authenticate themselves by using their (same) Office 365 account credentials. For this, SigningHub needs to be registered with the Office 365 platform. 

Create an Office 365 connector


  1. Access the SigningHub Admin portal.
  2. Click the "Configurations"section from the left menu.
  3. Click the "Connectors" tab. The "Connectors" screen will appear.
  4. Click  from the grid header.



  5. A dialog will appear to add the connector details. The connector dialog is comprised of two screens, i.e. Basic Information and Details. Specify the basic information and click the "Next" button to provide the respective connector details. See the below table for fields description. 
  6. Click the "Finish" button. A new connector will be saved and displayed in the list.


Basic Information

Fields

Description

Name

Specify a unique name for this connector, i.e. My Office 365. This connector will be used in the configuration of Authentication Profiles.

Provider

Select the provider for this connector, i.e. "Office 365". 

Purpose

This field will display the purpose of the selected provider above, i.e. the purpose of "Office 365" is "Authentication".

Active

Tick this check box to make this connector active. Inactive connectors cannot be configured in the Authentication Profiles.


Details

Fields

Description

Logo

Select an appropriate image in the jpeg, jpg, gif or png format for the connector's logo that will be displayed on the login screen.

Client ID

Specify the registered client ID that has been provided by Office 365 during account configuration, e.g.
 "04586340-uc46ggb7obrikmapn0or2ubignra". 
SigningHub will use this ID to communicate with the Office 365 server.

Client Secret

Specify the client secret that has been provided by Office 365 during account configuration, e.g.
"hniZYHqPEcKy6H25-LjzSX0Q".

Account Type

Specify whether the account type is Single Tenant or Multi Tenant. 
A single tenant account allows the accounts within the same organisational directory only to use the application. While a multi tenant account allows all the organisational directories to use the application.

[Name] Attribute

Specify the attribute against which you want SigningHub to lookup the "Name" of a user, from the Azure Active Directory (Azure AD), which is used to manage identities and authentication for Office 365.
The character limit for this field is 255 characters.

[Email] Attribute

Specify the attribute against which you want SigningHub to lookup the "Email" of a user, from the Azure Active Directory (Azure AD), which is used to manage identities and authentication for Office 365.
The character limit for this field is 255 characters.


  1. The "[Name] Attribute" and the "[Email] Attribute" fields are optional. These can be configured if the administrator wants to specify certain fields from which SigningHub should fetch the name and email information respectively.
  2. In case the "[Name] Attribute" and the "[Email] Attribute" fields have been configured, the system will only lookup the specified attributes.
  3. In case the "[Name] Attribute" and the "[Email] Attribute" fields have been configured, but the system is unable to find the specified attributes for the Office 365 authentication, the system will prompt an error message.
  4. The following link contains the list of parameters that can specified in the "[Name] Attribute" and the "[Email] Attribute" fields:
    https://learn.microsoft.com/en-us/graph/api/user-get?view=graph-rest-1.0&tabs=http
  5. For example if your SigningHub site is "https://web.signinghub.com" then the Callback URL for SigningHub will be "https://web.signinghub.com/OAuth/Office365CallBack".





See Also