> For the complete documentation index, see [llms.txt](https://docs.tiny.plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tiny.plus/guides/advanced/single-sign-on-azure.md).

# Single Sign-On (Microsoft Entra ID)

Allow your users to log in with your domain usernames and passwords.

{% hint style="success" %}
This is a Pro plan feature
{% endhint %}

## Prerequisites

This feature requires:

* An active [Microsoft Entra ID](https://www.microsoft.com/security/business/identity-access/microsoft-entra-id) tenant (formerly Azure Active Directory) for your organisation, containing all users attached to your domain
* Your tiny+ user account email address domains must match your Entra ID domain to enable Single Sign-On for them. Sub-domains or variations on your email domain are not currently supported. For example if your tiny+ login is <jane.donaldson@mycompany.com>, and your Entra ID login is <jane.donaldson@ad.mycompany.com> or <jane.donaldson@mycompany.net> then you will not be able to activate this feature.
* Your tiny+ admin user account must use the same domain.

## Enable Single Sign-On for your account

{% hint style="info" %}
You must be an Account Admin to enable this feature.
{% endhint %}

Navigate to [Account Settings -> Single Sign On](https://crm.tiny.plus/account/sso).

<figure><img src="https://1957838173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnoXYnzHXoSKmkXmIHw%2Fuploads%2Fgit-blob-5673883b918018afefac3475a3782753297e3226%2Fsso-settings.png?alt=media" alt="Account Settings, Single Sign On: the enabled domains, and the Enable SSO button for your domain" width="979"><figcaption></figcaption></figure>

Click *Enable SSO for \[your domain]*.

You will be asked to sign in to Microsoft. Please log in with an account capable of granting organisational consent on behalf of the directory.

Accept the permissions and you will be redirected back to tiny+. Confirm that your domain has been added to the *Single Sign On enabled domains* list.

Once permissions are granted, everyone with a tiny+ login at that domain signs in with their Microsoft username and password. The sign-in page sends them to Microsoft as soon as they type their email address, and a Microsoft sign-in isn't asked for a tiny+ [two-factor code](https://docs.tiny.plus/guides/how-tos/enabling-two-factor-authentication.md).

Please be aware, tiny+ will not communicate this change to your users on your behalf. You should prepare your own communications to your users regarding this change.

## What will my users see?

When logging in to an SSO-enabled domain, the login screen will hide the 'password' field once it detects a valid domain, and the 'Login' button will be replaced with a 'Continue' button. The user will be redirected to sign in with their Microsoft credentials. If the user is already logged in on their browser, this may happen with no user prompts.

## Account Provisioning / Deprovisioning

Your user account provisioning and management will still need to be handled in tiny+.

Someone whose Entra ID account is disabled can't sign in with Microsoft. Their tiny+ password still works, so deactivate them under Account Settings -> Users as well when they leave.

## Notes and other considerations

* New users added to your tiny+ account will be required to set a tiny+ password when they first sign up, but every later sign-in uses Entra ID.
* Be wary of email address discrepancies between Entra ID and tiny+. For example, imagine user Jane Donaldson has two email addresses - <jdonaldson@mycompany.com> and <jane.donaldson@mycompany.com>. Her Entra ID login is <jdonaldson@mycompany.com> however her tiny+ login uses the jane.donaldson@ address. Once Single Sign-On is enabled, Jane will no longer be able to access tiny+ until her tiny+ email address is changed to match her Entra ID login address.

## More questions?

If you have any queries or would like support in the use of this feature, please contact our [support team](https://crm.tiny.plus/help).
