> For the complete documentation index, see [llms.txt](https://knowledgebase.autorabit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms/single-sign-on.md).

# Single Sign-On

People can sign in to IZ Suite with their MuleSoft Anypoint or Microsoft Azure account instead of an email and password. You register an app with the identity provider, save its details in Setup, and choose whether IZ Suite creates an account for people who sign in for the first time.

The single sign-on step appears in Setup when your licence covers MuleSoft Anypoint or Azure and that platform is ticked under **What do you use?** in Setup. Each provider card follows the same rule.

{% hint style="warning" %}
You need a role that can change global settings to set up single sign-on. Turning on **Create people on first sign-in** also needs a role that can assign roles.
{% endhint %}

## How Single Sign-On Works

1. On the sign-in page, the person clicks the identity provider's option under **Sign in with**.
2. The identity provider asks them to sign in and returns them to IZ Suite's redirect URL.
3. IZ Suite looks for an enabled person with the same email address.
4. If there is one, they are signed in. If there is none, they are created with the roles you chose, but only when **Create people on first sign-in** is on; otherwise the sign-in is refused.

Two-factor authentication for single sign-on is handled by the identity provider. IZ Suite's own two-factor authentication applies to email-and-password sign-in only.

## Sign-In Options

| Option                                                                                                                                 | People sign in with                                          | Page                                                                                                                                                   |
| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [**IZ User**](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms/single-sign-on/iz-user.md) | Their email address and an IZ Suite password. On by default. | IZ User                                                                                                                                                |
| **MuleSoft Anypoint**                                                                                                                  | Their Anypoint Platform account.                             | [Anypoint Platform](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms/single-sign-on/anypoint-platform.md) |
| **Microsoft Azure**                                                                                                                    | Their Microsoft Entra ID (Azure) work account.               | [Azure](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms/single-sign-on/azure.md)                         |

All options are set up in one Setup drawer: open **Administration** → **Setup** and click **Set up** (or **Review**) on **Let people sign in with single sign-on**. Each provider has its own card and saves on its own.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FcW9qBym4IpRud03NPZqZ%2Fv2-plat-sso.png?alt=media&amp;token=c0c431a9-0beb-4b23-a6ca-fb68f965b53f" alt="Let people sign in with single sign-on drawer with the MuleSoft Anypoint and Microsoft Azure sign-in cards, redirect URLs, switches and client details"><figcaption></figcaption></figure>

## Create People on First Sign-In

By default, only people you invited can sign in with single sign-on. To let anyone who can sign in at the identity provider in:

1. In the same drawer, turn on **Create people on first sign-in**.
2. Under **Roles for new people**, choose at least one role. Every person created this way gets all of these roles.
3. Click **Save**.

People created this way appear under [Users](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/administration/organizations/users.md) like invited people, and you can change their roles later.

{% hint style="danger" %}
Anyone who can sign in through the identity provider gets these roles. Keep the roles narrow, and restrict the app to the intended people at the provider (for example **Who can use this application?** in Anypoint, or user assignment in Microsoft Entra ID).
{% endhint %}

## Next Steps

* [IZ User](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms/single-sign-on/iz-user.md): email-and-password sign-in, two-factor authentication and lockouts.
* [Anypoint Platform](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms/single-sign-on/anypoint-platform.md): set up Anypoint sign-in.
* [Azure](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms/single-sign-on/azure.md): set up Microsoft Azure sign-in.
* [Sign In](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/getting-started/sign-in.md): what people see when they sign in.
* [Users](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/administration/organizations/users.md): invite people, reset two-factor authentication and set temporary passwords.
* [Setup](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/administration/setup.md): the other platform steps.
* [Supported Platforms](https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms.md): back to the platform overview.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://knowledgebase.autorabit.com/product-guides/integral-zone/iz-suite/supported-platforms/single-sign-on.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
