SSO and SCIM provisioning
Let your team log in with your company’s identity provider, and keep workspace membership in sync with your directory.
Who can use this feature?
- Workspace Owners and Admins can set up SSO and SCIM
- Available on the Enterprise plan
Overview
With single sign-on (SSO), people log in to Lora with the work account your identity provider already manages. With SCIM, your directory adds, deactivates, and removes workspace members for you. You can use either one on its own, but SCIM needs a verified SSO domain first.
Set up SSO
Connect an identity provider
- From your workspace, click Settings in the sidebar, then Identity.
- Under Single sign-on, next to SSO & SCIM, click Set up (or Manage, if you’ve already connected a provider).
- Click Connect provider and choose your provider: Microsoft Entra ID, Google Workspace, Okta, another OpenID Connect provider, or SAML 2.0.
- Click Continue. Follow the steps in the dialog to create an app in your identity provider. The dialog shows the redirect URI (or, for SAML, the entity ID and reply URL) to paste there.
- Enter your first email domain and the connection details from your identity provider, then click Connect provider.
Verify your email domains
People can only log in through SSO with an email address on a domain you’ve verified. A connection can have up to 10 domains, and each one is verified on its own.
- From SSO & SCIM, open your identity provider.
- Under SSO domains, click Add, or open the menu on a pending domain and click Verify.
- At your DNS provider, add the TXT record the dialog shows. Copy Host / name and Value exactly.
- Click Verify.
A domain shows Pending verification until DNS has the record, then Claimed. DNS changes usually show up within minutes but can take up to 48 hours. The record’s value is valid for 7 days. Open the dialog again for a new one.
A domain can be claimed by one workspace at a time, and a subdomain of a domain another workspace has claimed isn’t available.
Note: Removing a domain stops SSO for the addresses on it. Those people keep their accounts and log in with an email code instead. A connection always keeps at least one domain.
Test the connection
Click Test next to Test SSO connection. Lora logs you in again through your identity provider and shows when the last test succeeded. The test replaces your session with the account the identity provider signed in, so use your own work account.
Turn the identity provider on or off
Use Enable identity provider to pause SSO without removing the connection. While it’s off:
- People on your SSO domains log in with an email code instead.
- Owners and Admins can still log in through it, to test it.
- Nobody new joins the workspace through SSO.
Memberships don’t change, and SCIM keeps working.
How people log in
When someone enters an email address on a verified domain on the login page, Lora sends them to your identity provider. If their account is new to the workspace, they join as a Member. People on other domains log in the way they always have.
SSO is offered, not required. People on your SSO domains can still log in with an email code, Google, Apple, or a passkey unless you require SSO.
While SSO is on, people can’t join the workspace by approved email domain. Settings → Identity shows a notice with a link to your SSO configuration instead of the approved domains list. Your approved domains come back if you turn SSO off.
Require SSO
Turn on Require SSO to make your identity provider the only way in for people on your SSO domains. Google, Apple, email and phone codes, and passkeys stop working for them, and any session they have that didn’t use SSO ends. Workspace Owners are the exception while Let owners skip SSO is on, which it is by default. It applies to their Lora account, not only to this workspace.
- From your workspace, click Settings in the sidebar, then Identity.
- Next to SSO & SCIM, click Manage.
- Under SSO policy, turn on Require SSO.
- Confirm.
The switch stays off until the identity provider is on, a domain is verified, and Test SSO connection has succeeded in the last 30 days. If you’re logged in without SSO yourself, log in through your identity provider first, so Lora doesn’t end your own session.
Let owners skip SSO is on by default. While SSO is required, Workspace Owners keep their other login methods, so a problem with your identity provider can’t lock out the people who could fix it. Turn it off to hold Workspace Owners to SSO too.
While SSO is required, you can’t turn off or remove the identity provider, or remove its last verified domain. Turn off Require SSO first.
Note: To connect the Lora Extension, log in to Lora with SSO in your browser first, then connect the extension again.
Provision members with SCIM
- Open your identity provider’s page, under SSO & SCIM.
- Turn on Enable SCIM user provisioning. It stays disabled until a domain is verified.
- Under Token expires after, choose 90, 180, or 365 days, then click Connect SCIM.
- Copy the Tenant URL (SCIM base URL) and the Secret token into your directory’s provisioning settings. Lora shows the token once.
From then on, your directory manages membership:
| When your directory… | Lora… |
|---|---|
| Creates a user or sets them active | Adds them as a Member, or restores a suspended member |
| Deactivates a user | Suspends their membership and frees their seat |
| Deletes a user | Removes their membership. Their shortcuts go to the workspace’s oldest Owner |
Lora never deletes the account itself, and your directory can’t deactivate or delete a Workspace Owner. Transfer ownership first. Once the workspace is no longer on Enterprise, its former Owners are treated as Admins and the directory can deactivate them.
Email addresses outside your verified domains are refused, and a person an Admin removed stays removed unless the directory provisioned them.
Rotate or revoke tokens
Click View configuration next to the switch. Create new token adds a second token while the first keeps working, so you can switch your directory without a gap. A connection holds two tokens at most. Revoke one to create another.
Turn off Enable SCIM user provisioning to disconnect. Every token stops working and current members keep their access.
Let your directory own names
Turn off Allow users to change their name to make the name from your directory read-only in Lora for the people it manages. Everyone else can still change their name. Their email address is always managed by the directory.
Tip: Agree on one source of truth for names before you turn this off. Once it’s off, a name only changes in your directory.
Other login methods
Other login methods, under Settings → Identity, sets how people can log in to the workspace. Once SSO is on, it applies to people whose email isn’t on one of your SSO domains. People on your SSO domains can use any method unless you require SSO.
- Google allows logging in with a Google account.
- Apple allows logging in with an Apple account.
- Email & passkey allows logging in with an email or phone code, or a passkey.
A switch you can’t turn off says why in its row.
If a method is off, people who log in that way see a screen that names the workspace and the methods it accepts, with a button to log out and log in again. Someone who logs in through another company’s SSO, say a contractor on their own identity provider, can always open the workspace.
Some rules keep you from locking yourself out:
- You can’t turn off the method you’re logged in with, unless your email is on an SSO domain. Log in another way first.
- All three can only be off while SSO is on and a domain is verified. And while all three are off, SSO can’t be turned off or removed, and no verified domain can be removed: the people on it would have no way in.
- If only one method is off, you can’t remove the SSO domain your own email is on while you’re logged in with that method. Log in another way first.
- A session from before this setting existed has to log in again before it can change anything here.
- Turning a method off needs the Enterprise plan. Turning it back on never does.
Restrict new workspace creation
On the SSO & SCIM page, under SSO policy, turn on Restrict new workspace creation to stop people on your verified SSO domains from creating other workspaces. Owners and Admins of your workspace are exempt. It’s available once a domain is verified.
FAQ
Verification says it can’t find the TXT record DNS can take a while to update. Check that the host is the full name shown in the dialog, and that the value is exactly the one shown. If the dialog says the value expired, publish the new one.
Someone on our domain can’t log in with SSO Their domain needs to show Claimed, and Enable identity provider needs to be on. A new person also needs a free seat to join.
Someone can’t open the workspace after we turned off a login method They signed in with a method the workspace no longer accepts. The screen they see lists the accepted ones. They log out and log in again with one of them, or an Admin turns the method back on.
I can’t turn off a login method You’re logged in with it, the workspace isn’t on the Enterprise plan, or turning it off would leave SSO as the only way in without an active SSO connection. The text under the switch says which.
Someone on our domain is told SSO is required You turned on Require SSO, so they need to log in through your identity provider. On the login page, they enter their work email and click Continue with SSO.
What happens if we downgrade from Enterprise? SSO members keep logging in through the existing connection, and login-method, Require SSO, and workspace-creation restrictions stay in force. You can turn the connection off or remove it (turn off Require SSO first), switch methods back on, and lift the restrictions, but not add new restrictions.