Add an extra layer of security with your enterprise team with SSO. We currently offer SSO support for our customers on an Enterprise subscription. This guide will explain how to set up SSO with your current Enterprise subscription.

To inquire about getting set up with SSO, contact our sales team.

This service is compatible with any IdP that supports either SAML or OIDC protocols such as Okta, Azure Microsoft, Google, and OneLogin.

Activating SSO

1. After being whitelisted by Gather, go to your Space Dashboard
2. Click on the SSO tab on the left navigation
3. Add your custom email domains (ex: @gather.town)
4. Complete your SSO configuration with WorkOS (our 3rd party SSO provider). Tip: You can share this link with your security team to complete the setup.
5. Once the setup is complete, SSO is enabled for your space and you are ready to test. 
6. Sign out of your Gather account
7. Sign back in (make sure to click “Use single sign-on”) using one of your custom email domains
8. Have a few of your teammates try signing in via SSO and give us a final thumbs up that everything is working.

SSO Domain Verification

1. Login to Your Domain Provider:
   • Start by logging into the platform where you registered your domain, often referred to as your domain registrar or domain provider (e.g., GoDaddy, Namecheap, Bluehost).
2. Navigate to DNS Management:
   • Look for an option such as "DNS Settings", "DNS Management", or "Manage Domains".
3. Locate the TXT Records Section:
   • Within the DNS Management area, find the section that allows you to edit or add TXT records
4. Add a New TXT Record:
   • Click an option like "Add Record" or "Create Record".
   • Select "TXT" from the record type dropdown, if prompted.
   • In the "Host" or "Name" field, enter the email domain you’re verifying.
   • In the "Value" or "Text" field, paste the verification code from the Gather SSO Dashboard
5. Save Changes:
   • Click "Save" or "Add Record" to apply the changes.
6. Wait for Propagation:
   • DNS changes might take some time to propagate across the internet. This can be anywhere from a few minutes to 48 hours, but often it's much faster. The exact time depends on your domain registrar and the TTL (Time To Live) setting for your DNS records.
7.  Verify on  Gather:
   • Once you've added the TXT record, go back to the Gather SSO Dashboard.
   • Click their "Verify" button for the domain you’re verifying. 

Things to Keep in Mind

• Right now, SSO is not compatible with our Mobile app. We hope to bring this feature to our customers soon!