> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/2023-2/configure/auth/azure-id/set-up-sso/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Set up Azure SSO for Itential

> How to configure the SSO login page for Itential Platform when using Azure AD authentication.

When users attempt to access the Itential login page, they are redirected to the Azure SSO page. To enable this, a custom HTML page is created and specified in the `uiProps.login` section of `IAP_Profile`.

#### Locate the sample sso.html

A sample `sso.html` is available and should work for most default installations. Its location is:

```
node_modules/@itential/adapter-azure_aaa/samples
```

#### Place the sso.html file

Locate or create the `sso.html` file. It can be renamed as long as it matches the `uiProps.login` path. Itential recommends placing the file in a `custom` directory under `/opt/itential/current/` and naming the file `sso.html`:

```
custom/sso.html
```

#### Edit the file

Modify the following values to match your setup.

The secret is not required and should not appear in this file, as `sso.html` can be read by any browser.

```javascript
var host = 'https://login.microsoftonline.com/';
var tenant = 'a28044b2-e519-4675-ab09-eb6ee673ed72';
var client = 'd42380f6-4fae-43ed-bb78-415243bce4c7';
```

#### Verify the tenant and client values

Verify the `tenant` and `client` values are the same as those used in `Service_Config`.

> How to configure the SSO login page for Itential Platform when using Azure AD authentication.