Create an Office 365 Connector

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. Click the 'Configurations' option from the navigation panel.

2. Click the 'Connectors' option.

3. Click theicon from the grid header.

   
4. The 'Add' connector screen will appear to add the connector details. It comprises of two sections, i.e. Basic Information and Details. Specify the basic information and click the button to provide the respective connector details.

5. Click the 'Create' button. A new connector will be saved and displayed in the list. See the table below for field descriptions.

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.

The following table describes the fields on the "Details" section of this screen.

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 look up 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 be 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".