> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stratapt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Single Sign-On (SSO)

> How Single Sign-On works in StrataEMR, what your team needs to set it up, how staff sign in, and how to fix common problems.

Single Sign-On (SSO) lets your staff sign in to StrataEMR with their organization's Microsoft Entra ID or Google Workspace account instead of a StrataEMR password. Your team signs in once with the account they already use, and your IT administrator controls who has access.

Setup has two parts. Your IT administrator creates a SAML app in Microsoft or Google. StrataPT then enters that app's details in StrataEMR. Both sides must match exactly, or sign-in fails.

> [!NOTE]
>
> **Access:** StrataPT configures SSO for your organization. You cannot change SSO settings yourself. Staff who meet the requirements below can sign in with SSO. Your IT administrator manages the Microsoft or Google side.

***

## How SSO Setup Works

To turn on SSO, contact [StrataPT Support](https://docs.stratapt.com/after-go-live/getting-help.md). Then two people each do their part:

1. **Your IT administrator** creates a SAML app in your Microsoft Entra or Google Workspace account. StrataPT gives them the Local Login URL to use as the app's reply URL.
2. **Your IT administrator** sends StrataPT the details from the app: the Login URL, Issuer, Entity ID, and signing certificate.
3. **StrataPT** enters those details in StrataEMR and sets the status to **Active**.

StrataPT enters the following settings. Your IT administrator supplies most of them.

| Setting | What it is | Microsoft example | Google example |
| - | - | - | - |
| Local Login URL | The address your staff use to sign in. StrataEMR fills it in automatically. | `https://strataemr.com/?org=[your-org-ID]` | Same |
| Login URL | The sign-in address of your identity provider. | `https://login.microsoftonline.com/{tenant-id}/saml2` | `https://accounts.google.com/o/saml2/idp?idpid={idp-id}` |
| Issuer | Your identity provider's identifier. It must match exactly, including any trailing slash. | `https://sts.windows.net/{tenant-id}/` | `https://accounts.google.com/o/saml2?idpid={idp-id}` |
| Entity ID | The identifier you chose when you created the SAML app. It must be identical on both sides. Capital letters don't matter. | `https://strataemr.com/[your-org-ID]` | Same |
| Certificate | The signing certificate from your identity provider. StrataPT pastes only the base64 text between the BEGIN CERTIFICATE and END CERTIFICATE lines. | `MIIDdzCCAl+gAwIBAgIE...` | Same |
| Status | **Active** turns SSO on. **Disabled** makes the Single Sign On button fail with an error, but the button still appears on the login page. | Active | Active |

> [!WARNING]
>
> **Warning:** Check staff emails before SSO goes live. Each staff member's email in StrataEMR must match the email their Microsoft or Google account sends at sign-in. A mismatch blocks that person.

***

## Who Can Sign In With SSO

A staff member can sign in with SSO when all of the following are true:

* The email their Microsoft or Google account sends at sign-in exactly matches their staff email in StrataEMR. Capital letters don't matter, and StrataEMR doesn't check the email domain.
* Their staff status is **Active**.
* If their staff account has an IP restriction, they sign in from that IP address.
* If their staff account uses two-factor authentication, they have a valid mobile number. They receive a text message at every SSO sign-in.

SSO doesn't replace password sign-in. Staff who have a StrataEMR password can still use it.

***

## Sign In With SSO

1. Go to your organization's Local Login URL, for example `https://strataemr.com/?org=[your-org-ID]`. Bookmark it, because the Single Sign On button appears only on this URL.
2. Select **Single Sign On**.
3. Sign in on the Microsoft or Google page.
4. If two-factor authentication is on for your account, enter the code from the text message.
5. StrataEMR opens to the main page.

> [!NOTE]
>
> **Note:** Start from the Local Login URL every time. Opening StrataEMR from Microsoft My Apps or the Google app launcher doesn't work.

### Choose an Organization

If your account has access to more than one StrataEMR organization that shares the same SSO setup, StrataEMR shows a **Choose an organization** page after you sign in. The page confirms the email you signed in with.

* **Four or fewer organizations.** Each organization appears as its own row. Select a row to open that organization.
* **Five or more organizations.** Select an organization from the **Organization** list, then select **Continue**.

Select **Use a different account** to return to the SSO login.

***

## Sign Out

Signing out of StrataEMR doesn't sign you out of Microsoft or Google. Signing out of Microsoft or Google doesn't sign you out of StrataEMR.

While your Microsoft or Google session is open, selecting **Single Sign On** signs you straight back in without a password prompt. On shared workstations, sign out of StrataEMR and your Microsoft or Google account.

***

## Renew the Certificate

Microsoft and Google signing certificates expire. Microsoft's default is three years. When your IT administrator renews the certificate, send the new certificate to [StrataPT Support](https://docs.stratapt.com/after-go-live/getting-help.md) so they can update it in StrataEMR.

> [!WARNING]
>
> **Warning:** Until StrataPT updates the certificate, SSO sign-in fails for everyone in your organization. Put the expiry date on your calendar when SSO is first set up.

***

## Troubleshoot SSO Sign-In

Every SSO failure shows the same message: **Single sign-on failed. Please try again. If you are still unable to sign in, please contact technical support for assistance.** Check these causes in order.

| What you see | Likely cause | What to do |
| - | - | - |
| Microsoft shows error AADSTS50011 | The reply URL in Microsoft Entra doesn't exactly match the Local Login URL. | Your IT administrator copies the Local Login URL from StrataEMR into Entra again. |
| Fails for everyone right after setup | SSO isn't active yet, the status isn't **Active**, or the Issuer or Entity ID has a typo. | Contact StrataPT Support. Check each value against your identity provider. |
| Fails for everyone after it worked before | The certificate was renewed or expired. | Send the current certificate to StrataPT Support. |
| Fails for everyone and the certificate looks right | The Federation Metadata XML or a binary certificate was used, or the Issuer is missing its trailing slash. | Send the base64 certificate text. Copy the Issuer exactly. |
| Fails for one person | Their identity provider email doesn't match their StrataEMR staff email, their staff status isn't **Active**, or an IP restriction blocks them. | Fix the email or status. Check the IP restriction. |
| Fails when opened from My Apps or the Google app launcher | Sign-in started at the identity provider. | Start from the Local Login URL. |

***

## Related

* [Accessing StrataEMR](https://docs.stratapt.com/accessing-strataemr.md) — Log in, supported browsers, and common access problems
* [Adding Users and Roles](https://docs.stratapt.com/getting-started/adding-users-and-roles.md) — How staff accounts are created
* [Getting Help](https://docs.stratapt.com/after-go-live/getting-help.md) — Contact StrataPT Support


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.