With SSO and directory sync, your identity provider decides how your people sign in to Tilt Base and who's in your organisation. Read this before you start, so you know what changes for your members and Admins.
## What each does
- **SSO (single sign-on).** Once an SSO connection is active, everyone with an address at its domains signs in through your identity provider, in Tilt Base and in their AI platforms' connections. Members who already have accounts keep them. You can use SSO without a directory.
- **Directory sync (SCIM).** Your directory decides who is in Tilt Base. It adds the people it lists and removes those it drops and, if you choose, sets their roles through groups mapped to roles. A directory belongs to one SSO connection, so SSO comes first.
## What Tilt switches on first
Tilt switches SSO on for your organisation, and directory sync separately. Tilt passes on the cost of any extra connection, and agrees it with you first. Tilt switches these on for your organisation; contact [support@tilt.legal](mailto:support@tilt.legal).
- Until SSO is on, Settings › Organisation › General says SSO isn't switched on for your organisation.
- Once it's on, Settings › Organisation › SSO and directory appears, with your domains and SSO connections.
- The page's directory part appears once Tilt also switches directory sync on.
Only Admins can set up domains, SSO connections and directories. Whoever controls an SSO connection could sign in as anyone at its domains, and whoever sets up a directory decides who's a member, so no other role can.
## The order to set up
1. <mention-page url="https://app.notion.com/p/41b4815eed4f816cb587d2302d26a112">Verify your domains</mention-page>: prove each of your firm's domains with a DNS record.
2. <mention-page url="https://app.notion.com/p/41b4815eed4f81df82f0c80b7ee3a569">Set up SSO</mention-page>: add a connection, test a sign-in through it, then activate it.
3. <mention-page url="https://app.notion.com/p/41b4815eed4f81ad9bf2c175e15637d2">Set up directory sync</mention-page> on that connection.
4. Choose who sets roles, Base or your directory, as <mention-page url="https://app.notion.com/p/41b4815eed4f8106881cd767f9a68dba">Roles from your directory</mention-page> describes.
Stop after step 2 if you want SSO alone.
## Once SSO is active
- People who sign up at the connection's domains sign in through your identity provider instead of being invited.
- While you have no directory, just-in-time sign-up gives someone at those domains an account and a membership the first time they sign in. You can switch it off.
- If you remove someone on Members who signs in through SSO, Base warns that they're added back the next time they sign in, unless your identity provider removes them too.
## While a directory runs
- **No invitations.** Members shows "Your directory adds people" in place of **Invite**. Setting up your first directory withdraws pending invitations, and your verified domains invite nobody who signs up. This stays so while the directory is paused.
- **No just-in-time sign-up.** It's off on every SSO connection, so only your directory adds new people.
- **The directory's mark.** On Members, people your directory added carry its identity provider's logo. Only your directory removes them.
- **Deactivated.** When your directory removes someone, their Tilt Base account is deactivated, not only their membership, so they can't sign in to Base anywhere. Members shows a **Deactivated** badge beside them.
- **Withdrawn.** While a directory's removal is unfinished, Members lists anyone it took the membership from with a **Withdrawn** badge, until finishing the removal gives it back. See <mention-page url="https://app.notion.com/p/41b4815eed4f81238c01c7fdfb1374e4">Pause or remove a directory</mention-page>.
- **Read-only roles and fields.** While your directory sets roles, the roles of the people it manages are read-only in Base. The name, email and position it syncs are read-only too: on the person's Account page they read "Your firm's directory keeps this up to date."
## Before you move someone's address out of your domains
<callout icon="⚠️" color="yellow_bg">
	**Deactivate people before moving their address.** Deactivate someone in your directory before you move their address out of your domains. Once it's moved, your directory no longer reaches them, and Base can't remove the membership left behind.
</callout>
Someone whose address was moved first keeps their membership, and any sessions already open until those end, though your identity provider still refuses their sign-in. To clear the membership, either:
- move their address back while they're deactivated, so your directory reaches them again; or
- add the new domain to the SSO connection, once you've proved it by DNS.
## Related
- <mention-page url="https://app.notion.com/p/41b4815eed4f816cb587d2302d26a112">Verify your domains</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f81df82f0c80b7ee3a569">Set up SSO</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f81ad9bf2c175e15637d2">Set up directory sync</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f8106881cd767f9a68dba">Roles from your directory</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f81238c01c7fdfb1374e4">Pause or remove a directory</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f81dc92c6cf6bdd40f80e">Members and invitations</mention-page>