Entra ID

Entra ID is the core identity service for Microsoft cloud products. It offers authentication and authorization to securely access platforms like SharePoint. Microsoft product integrations in TenantWise will utilise Entra ID for authentication. You can create reusable Entra ID credentials for use with integrations such as SharePoint.

Credential Manager

The Credential Manager in the TenantWise admin console provides a single place to manage credentials for the systems you integrate with TenantWise. To create a credential, navigate to Credential Manager under the integrations tab in the admin console.

Create Entra ID credential (OAuth 2.0)

OAuth 2.0 is the recommended setup method. TenantWise securely requests tokens on your behalf using your tenant ID, so there are no credentials to manage or rotate.

1

From Credential Manager click New Credential

2

Select OAuth 2.0 as the setup method

3

Give the credential a name and enter your Microsoft Entra Tenant ID

You can find your Tenant ID in the Azure Portal under Microsoft Entra ID > Overview > Tenant ID.

4

Review the Microsoft Graph API permissions that will be requested. Your organisation's Microsoft Entra admin will need to approve these permissions during the consent flow.

5

Click Save & Connect. A popup window will open to Microsoft where an Entra admin must grant consent. Once consent is granted, the popup will close and the credential status will update to 'Connected'.

---

Create Entra ID credential (Manual Configuration)

Manual configuration allows you to use your own Azure app registration. You are responsible for managing and rotating secrets.

Please ensure a service principal and valid credentials are created in Entra ID prior to carrying out the following steps.

You can refer to TenantWise Admin ToolKit to help you do this

1

From Credential Manager click New Credential

2

Select Manual Configuration as the setup method

3

Give the credential a name and enter the Tenant ID, Client ID and Client Secret from your Azure app registration

4

Click Save

---

Updating an existing Entra ID credential

1

Click Edit on the Entra ID credential you wish to update

2

Enter the values you wish to update and Save

OAuth 2.0 credentials can only have their name and tenant ID edited. Manual credentials can also have their client ID and client secret updated.

---

Updating permissions (OAuth 2.0)

From time to time, TenantWise may update the Microsoft Graph API permissions required by the platform app. When this happens, the credential status will change to 'Update Required' in Credential Manager.

To update permissions, click Update Permissions on the affected credential. A popup window will open to Microsoft where an Entra admin must grant consent for the updated permissions. Once consent is granted, the credential status will return to 'Connected'.