View basketContact us
Cisco Partner

Guide

Cisco Umbrella SSO and identities: Active Directory, Entra ID, SAML

Policies and reports are only as good as the identities behind them. Getting users and groups into Umbrella lets you filter by role and see who did what, not just which IP address.

Umbrella content filtering settings and categories
Cisco Umbrella logo

In short

Cisco Umbrella SSO and SAML have two jobs: SAML authenticates web users at the SIG secure web gateway, and separately gives administrators dashboard single sign-on. It sits alongside Umbrella's other identities (networks, roaming computers, tunnels, network devices, and users and groups from Active Directory through the AD Connector, or from Microsoft Entra ID by provisioning).

Want help with Cisco Umbrella identity integration?

We can plan it with you or do it for you. Tell us where you are up to.

Contact us for free advice or a quote

The Umbrella identity types

Each deployment method creates its own kind of identity, and one request can match several. Umbrella applies the first policy in the list that matches any of them, so order matters.

The Umbrella identity types
IdentityCreated byTypical use
NetworkRegistering a public IP addressDefault policy for a site
Internal network or IPVirtual applianceDifferent policy for a subnet such as guest Wi-Fi
Roaming computerUmbrella Roaming Security Module in Cisco Secure ClientLaptops on any network
Chromebook userCisco Security for ChromebookPupil and staff policy on ChromeOS
Network tunnelIPsec tunnel (SIG)All traffic from a SIG-connected site
Network deviceDevice integrations such as Cisco Meraki access pointsPer-SSID or per-device DNS policy
User and groupProvisioned by the AD Connector, Microsoft Entra ID, Okta or a manual CSV import; matched to traffic by VAs, the roaming module or SAMLRole-based policy and named reporting

User and group identities are the ones that make the biggest difference to schools and businesses alike. Cisco lists Active Directory integration in every Umbrella package. SAML user authentication works through the secure web gateway (opens in a new tab), so it needs a SIG package; check your entitlement in our Cisco Umbrella licensing guide.

When a policy contains AD-linked identities, Umbrella checks them in a fixed order: AD user first, then AD computer, internal network, site, roaming client and finally network. Within the policy list itself, Umbrella works from the top down and applies the first policy that matches.

Not sure which option applies to you? Ask us

Tell us about your organisation and we will point you to the right option.

Contact us for free advice or a quote

On-premises Active Directory: the AD Connector and VAs

For on-premises AD, Umbrella uses two components working together:

  • The AD Connector, a Windows service that passes domain controller logon events to the VAs so they know which user is on which computer and IP address. It uploads users, groups and computers to the Umbrella cloud over HTTPS, sending only changes after the first sync. Passwords are not uploaded, Cisco says user information is hashed locally, and the connector does not read password hashes.
  • Umbrella virtual appliances, which receive the connector's logon data and attach the user to each DNS request they forward.

Practical points from Cisco's documentation:

  • The connector runs on a domain member server with a supported Windows Server release and .NET Framework, or directly on a domain controller that meets the same requirements.
  • It needs a dedicated AD account with read and Replicating Directory Changes permissions (not Replicating Directory Changes All). Membership of the built-in Enterprise Read-only Domain Controllers group grants these.
  • One connector per AD domain is enough to provision identities, with an optional second for redundancy. For VA integration, a domain controller needs a connector in the same Umbrella site.
  • The connector sends events to VAs one way and unencrypted, so keep that path on a trusted internal network. Cisco recommends API key credentials to authenticate connectors and VAs to Umbrella.
  • Build Umbrella policy around AD groups, and keep the list of groups that matter short.
  • Laptops with the roaming module gather the logged-in user and groups from the operating system, so they are identified off network too.

Cloud directories: Microsoft Entra ID provisioning

If your users live in Microsoft Entra ID (formerly Azure AD), you can provision them into Umbrella from the cloud instead of, or alongside, the AD Connector. The integration uses the Microsoft Entra provisioning service:

  1. In the Umbrella dashboard, go to Deployments, Core Identities, Users and Groups, expand the Microsoft Entra card and generate a token on the API Keys page. Copy the URL and token straight away: the token is shown once.
  2. In the Microsoft Entra admin center, add Cisco User Management for Secure Access from the application gallery and enter the URL and token as the tenant URL and secret token on its Provisioning tab.
  3. Scope provisioning to the users and groups you need, test with a few using on-demand provisioning, then start provisioning and watch the provisioning logs.

Microsoft documents (opens in a new tab) a limit of 200 provisioned groups, so plan which groups Umbrella really needs. If devices run older Secure Client or AnyConnect versions, Microsoft's guide describes syncing the AD objectGUID attribute through Microsoft Entra Connect so users are matched correctly, and says to turn off the on-premises AD Connector before importing it. Any Umbrella policy built on groups needs reconfiguring after groups are imported from Entra ID. Umbrella can also provision users and groups from Okta.

Prefer a hand with this?

We can help you plan it and set it up, alongside your own team.

Contact us for free advice or a quote

SAML: authenticating web users and dashboard admins

SAML appears in Umbrella in two separate places, which is a common source of confusion.

SAML: authenticating web users and dashboard admins
UseWhat it doesWho signs in
SAML user authentication for web traffic (SIG)When traffic arrives from a network or tunnel identity without a user attached, the secure web gateway asks the user to authenticate with your identity provider, so web policy and reports can be per userEnd users
Dashboard single sign-onAdministrators sign in to the Umbrella dashboard with your identity provider instead of an Umbrella password (Admin, Authentication, SAML)Umbrella administrators

SAML for web users has a few requirements that catch people out:

  • Cisco lists Active Directory (through AD FS), Azure AD (now Microsoft Entra ID), Duo Security, Okta, OpenAM and PingID as supported identity providers, with a generic option for others.
  • The web policy ruleset must have both SAML and HTTPS inspection turned on, because Umbrella reads a cookie inside HTTPS traffic as the authentication surrogate, and the Umbrella root certificate must be on every client behind that network or tunnel.
  • SAML identities are matched to users and groups already provisioned into Umbrella, for example by the AD Connector or a CSV import.
  • SAML is not supported for the roaming module, which identifies users from the operating system instead.
  • IP surrogates can help where a cookie cannot be set; Cisco recommends cookie surrogates where several users share an IP address, as in Citrix or VDI.
  • If you use AD FS, exclude its URL from HTTPS inspection so authentication is not broken.

Dashboard SSO only handles sign-in; each administrator's role is still set in Umbrella, and the email address must match in both places. Microsoft publishes a gallery application, Cisco Umbrella Admin SSO, for Entra ID that supports both service-provider and identity-provider initiated sign-in, and admin accounts still need creating in Umbrella. If you want stronger sign-in for your identity provider itself, Duo SSO (opens in a new tab) can sit in front of it, and Entra ID tenants are usually part of a wider Microsoft 365 estate.

Multi-org and MSP consoles: SAML user authentication for web traffic is set up in each child organisation. Administrators can still use SAML single sign-on for the multi-org or MSP console itself, except on consoles that use a Cisco CEC login. See Umbrella multi-org and MSP consoles.

Designing identity-based policy

  • Start with a default network policy that protects everyone, then add group policies above it for exceptions.
  • Keep the number of groups small and meaningful: staff, pupils, IT, finance, guests.
  • Use the same groups for content filtering and reporting so safeguarding or HR reviews make sense.
  • Document which identity source is authoritative for each group, especially in hybrid AD and Entra ID estates.
  • Test with real users in a pilot group before changing the default policy.

Identities in Secure Access, and how we help

Cisco Secure Access uses the same kinds of identity sources, and Cisco's Entra ID provisioning application is now named for Secure Access. A tidy identity design in Umbrella transfers more cleanly when you migrate; Umbrella's end of sale is 31 January 2027. See Umbrella to Secure Access migration.

We install and harden AD Connectors, set up Entra ID provisioning, configure SAML for SIG users and dashboard SSO, and build group-based policy. Contact us to plan your identity integration, or return to the Cisco Umbrella setup guide.

Sources (checked 11 November 2026): Cisco's guides to SAML integrations for the supported identity providers, IP surrogates and authentication for AD Connectors and VAs; Microsoft's provisioning tutorial for the 200-group limit; and Cisco's end-of-life notice for the Umbrella dates.

How Forever Systems can help with Cisco Umbrella

We can supply and deploy Cisco Umbrella, help you run it, and plan the move to its successor, Cisco Secure Access.

  • Package selection: Umbrella DNS or SIG, Essentials or Advantage, plus add-ons, matched to your users, sites and compliance needs
  • Deployment: network DNS forwarding, virtual appliances, the roaming module in Cisco Secure Client, Chromebooks, IPsec tunnels from Cisco Meraki and other firewalls, and Active Directory, Entra ID or SAML identity integration
  • Policy design: security categories, content filtering for schools and businesses, allow and block lists, and reporting
  • Migration planning from Umbrella to Cisco Secure Access ahead of Cisco's end-of-sale and end-of-support dates
  • Ongoing help: reporting, policy tuning, renewals and licence changes

Forever Systems is a Cisco Partner and also supplies the wider Cisco Secure portfolio, including Cisco Secure Access.

Frequently asked questions

How does Umbrella use SAML for user identity?

In two ways: SAML user authentication lets the SIG web gateway identify users whose traffic arrives from a network or tunnel without a user attached, and SAML single sign-on lets administrators sign in to the Umbrella dashboard through your identity provider.

How do I set up SSO for the Cisco Umbrella dashboard?

Configure SAML in the dashboard under Admin, Authentication, SAML, using your identity provider; for Entra ID, Microsoft publishes the Cisco Umbrella Admin SSO gallery application. Each administrator's account and role are still created in Umbrella, and the email address must match in both places.

Does Cisco Umbrella support Entra ID?

Yes. Users and groups can be provisioned from Microsoft Entra ID into Umbrella using the Cisco User Management for Secure Access gallery application and a token from the Umbrella dashboard. Microsoft documents a limit of 200 provisioned groups.

Does the Umbrella AD Connector upload passwords?

No. Cisco says no passwords are uploaded and user information is hashed locally. The connector account needs Replicating Directory Changes permission but not Replicating Directory Changes All, so it cannot read password hashes.

How many AD Connectors do I need?

One per AD domain is enough to provision identities, with an optional second for redundancy. For virtual appliance integration, each domain controller needs a connector in the same Umbrella site.

Why does SAML in Umbrella need HTTPS inspection?

Umbrella uses a cookie inside HTTPS traffic as the user's authentication token, so the web policy must have HTTPS inspection turned on and the Umbrella root certificate must be installed on client devices.

Can I set up SAML on the Umbrella multi-org console?

SAML user authentication for web traffic is set up in each child organisation. Administrators can use SAML single sign-on for the multi-org or MSP console itself, except on consoles that use a Cisco CEC login.

Still have a question about Cisco Umbrella identity integration?

Ask us and a member of our team will get back to you.

Contact us for free advice or a quote

Next step

Want a Cisco Umbrella quote, deployment or migration plan?

Tell us what you need and we will come back to you with options and next steps.

  1. 1
    Tell us what you needA few lines is enough: your organisation, users or sites, and timescales.
  2. 2
    We read it and get back to youWith options and clear next steps.
  3. 3
    You decideChoose the option that suits you and we take it from there.

Send a quick enquiry

A few lines is enough.

About: Cisco Umbrella identity integration

We use these details to reply to your enquiry. Privacy notice

Talk to us about Cisco Umbrella identity integration

For businesses and organisations. A few lines is enough.

We use these details to reply to your enquiry. Privacy notice
Talk to us aboutCisco Umbrella identity integration
Contact us