Configuring SSO

FOR SPYCLOUD CONSOLE

🧭 Overview

SpyCloud supports Single Sign-On (SSO) through your preferred Identity Provider (IdP), letting users securely log in with existing credentials.

We support Okta, Entra ID (Azure AD), ADFS, and any custom SAML or OIDC provider. SpyCloud’s console, access to user, organization, and license settings is controlled through two built-in roles you can assign to each member of your security team.

🕒 Setup time: ~10 minutes
👤 Required role: Administrator


👇CONFIGURE SSO


🧰 Before You Begin

RequirementDescription
Admin AccessYou must have administrator privileges in your SpyCloud Console.
IdP AccessAccess to Okta, Entra ID, ADFS, or another SAML/OIDC provider.
Verified Domains(Optional) Associate your company email domains with SSO.
⚠️

Important:
If you already have 2FA enabled, it will be disabled once SSO is connected.
Your IdP will take over authentication settings, including 2FA, SMS, and password policies.


🚀 Step-by-Step Setup

  1. Log in to your Console as an Admin.
  2. Navigate to Configuration → Settings → Security Settings.
  3. Click Connect Single Sign-On.
  4. Follow the guided pop-up to complete setup.

👇SECURITY SETTINGS


🧩 Choose Your Identity Provider

Provider
Okta
Entra ID (Azure AD)
ADFS
Custom SAML or OIDC Provider

👇EXAMPLE CONFIGURATION FOR OKTA


🔗 Configure in Your IdP

  1. Add SpyCloud as a new application in your IdP.
  2. Copy the configuration values shown in SpyCloud:
    • Redirect URLs
    • Client IDs
    • Etc
  3. Paste these values into your IdP SSO setup form to establish the connection.

💡 Tip: SpyCloud’s SSO workflow is powered by Auth0.
Refer to Auth0 documentation for advanced installation and configuration options.

👇EXAMPLE CONFIGURATION FOR OKTA


☑️ Test Connection

  1. Click Test Connection to validate setup.
  2. Close of out the new tab that says "Testing Complete!" and navigate back to the SSO configuration.
  3. Review and confirm the user attributes returned in code field.
  4. Click Done.

👇"TESTING COMPLETE" SECONDARY TAB

Successful SSO Test - New Tab

👇SUCCESSFUL TEST USER ATTRIBUTES

Successful Test Connection - User Metadata


☑️ Verify Your Domains

All domains require ownership verification for login redirection to work properly. However, the verification process is slightly different depending on the specific domain and selections made earlier in the SSO configuration process.

Primary Domains

SpyCloud associates and verifies a primary domain for every Console organization (e.g. Example Corporation = example.com). This domain may differ from the actual email domains associated with organization users.

Auto Verification

Checking the "Include my verified domain" checkbox in the beginning of the SSO setup flow will auto verify the primary domain associated with the Console organization. No further domain verification is required for the primary domain with this selection.

👇PRIMARY DOMAIN AUTO VERITIFCATION CHECKBOX

Include my verified domain

Manual Verification

Every other scenario or domain will require manual verification.

  1. Click on Domain Configuration.
  2. Select the Add Domain tab and add a domain.
  3. Create a DNS TXT record with the Name and Content values listed for the domain.
  4. Click the Verify button once the TXT record has propagated.
  5. Confirm the domain is listed under the Managed Domains tab.

👇PENDING DOMAIN TXT RECORD DETAILS

👇MANAGED DOMAINS TAB

Managed domains


✅ Complete SSO Configuration

  1. Ensure both Single Sign-On and Domain Configuration are displaying green checkmarks.
  2. Confirm the Domain Configuration row lists the correct number of verified domains.
  3. Click the Enable Connection button.
  4. Click Proceed on the pop-up window.

👇CONFIGURATION STATUS

Enabled SSO Connection

👇SSO COMPLETION STEP

Enabled SSO Connection - Proceed Menu


🧠 Post-Deployment Expectations

  • IdP manages all authentication (2FA, password policies).

  • Users will sign in via SSO on next login.

  • Admins can update IdP or domains anytime under Configuration → Settings → Security Settings.


🛑 Limitations

  • IdP-initiated SSO from a tile is not currently supported.
  • SCIM capabilities are currently limited to user provisioning.

Did this page help you?