An Azure Service Principal iClient stores your Microsoft Entra ID (Azure AD) app registration credentials so you can authenticate Azure connections — including Azure Data Lake Storage Gen2, Azure Blob Storage, Azure DevOps, and Microsoft Dynamics 365 — without re-entering credentials for each connection.
You can create an iClient at Resources → iClients, or directly during setup of any Azure connection that uses this iClient type.
Tip
Open the Microsoft Entra admin center in a separate window so you can locate and copy your Tenant ID, Client ID, and Client secret without switching contexts.
You need an app registration (service principal) already created in Microsoft Entra ID, with a client secret generated, or permissions to create one. If you don't have an app registration, register one in the Microsoft Entra admin center before continuing.
| Setting | Description |
|---|---|
| Name * | Enter a clear and distinguishable name. |
| Type * | Read-only. Set to Azure service principal. |
| Setting | Description |
|---|---|
| Tenant ID * | The directory (tenant) ID of your Microsoft Entra ID instance. Identifies which Entra ID directory your app registration belongs to. |
| Client ID * | The application (client) ID of your app registration. |
| Client secret * | The client secret value generated for your app registration. integrator.io stores the credential encrypted. This field is never displayed again after you save — to update the credential, generate a new secret in Entra ID and re-enter the full value. |
Note
Client secrets are encrypted at rest, never returned in API responses, and never logged. Once saved, the value is never redisplayed in the UI — to update it, generate a new secret in Entra ID and re-enter the full value.
Note
The following steps reflect the Microsoft Entra admin center UI at time of writing. Microsoft periodically updates this UI — see Register an application, How to find your tenant ID, and Add and manage app credentials for the current version if these steps don't match what you see.
- Sign in to the Microsoft Entra admin center as at least an Application Developer.
- To find your Tenant ID: go to Entra ID → Overview → Properties, and copy the Tenant ID shown there.
- To find your Client ID: go to Entra ID → App registrations, select the app registration you want to use (or select New registration to create one), and on the Overview page copy the Application (client) ID.
- To create a Client secret: on the same App registration, go to Certificates & secrets → Client secrets → New client secret. Enter a description and expiration, then select Add. Copy the Value immediately — Entra ID only displays it once.
- Paste the Tenant ID, Client ID, and Client secret into the corresponding fields in integrator.io.