Skip to content
Edouard Topin's Blog
VCF identity and zero trust / Series 01/03

VCF Identity Broker: where VCF 9.1 single sign-on actually stops

VCF Identity Broker federates login across the VCF consoles, but the documented perimeter is narrower than the pitch. We map what it covers, what stays local, and the break-glass path.

Edouard Topin
16 min read
Abstract editorial illustration of a single key opening part of a wheel of locks, the others staying shut.

Eight consoles, eight local accounts, one password spreadsheet shared by the on-call team. Then an audit lands: every leaver must be revoked across the whole estate in under twenty-four hours. That trigger — not an appetite for modernity — is what puts VCF Single Sign-On on the design table.

This article is not a “how to plug in an SSO” walkthrough. It answers one question, the one that gets decided badly up front and paid for later in operations: once VCF Single Sign-On is configured, which consoles stop asking for a local account, and which ones keep asking? We read the component list exactly as Broadcom publishes it, name the exclusions exactly as they are written, and put a number on the exit cost of the deployment mode. No lab was run: what follows is documentation reading across VCF 9.0 and 9.1, with its gaps stated out loud.

Published perimeterVCF 9.1No lab executed

TL;DR

  • The decision: settle embedded versus appliance before anything else, because changing mode later forces a full Reset SSO — identity provider configuration, provisioned users and groups, component configuration, all deleted and all to be redone.
  • The trade-off that costs: appliance mode brings a three-node cluster and up to five VCF instances attached, but it forces you to generate a new OAuth client for PowerCLI and to redo the identity provider configuration instead of carrying it over.
  • The Monday-morning action: write out the access paths that stay outside SSO — SDDC Manager UI, ESX, VKS clusters, the local admin account of every component — and name, for each one, the break-glass account and who holds it.

Component or configuration: two names, two planes

VCF Identity Broker is the component you deploy. It is the name carried by the TechDocs page titles: Deploying VCF Identity Broker, Deployment Modes of the VCF Identity Broker, Upgrade to Identity Broker 9.1. VCF Single Sign-On is the configuration you build with it — Configuring VCF Single Sign-On, Configure a New VCF Single Sign-On for a VCF Instance. A sentence like “deploy VCF SSO” mixes the two planes at the first word.

The abbreviation “vIDB” circulates widely in the field. An official VCF post dated 18 February 2026 states that the Identity Broker “was previously known as VIDB”. No TechDocs page that was loaded uses it as a normative name: treat it as corridor shorthand, not as a catalogue name.

The next trap costs more. In VCF 9.1, the NSX Authentication and Authorization index lists thirteen subsections, including, side by side, Integration with VMware Workspace ONE Access and Integration with VCF Identity Broker for Single-Sign-On Access. Both identity integrations coexist in the 9.1 documentation, with no announced hierarchy between them.

One rename artefact is perfectly verifiable, though: the NSX page is titled Integration with VCF Identity Broker for Single-Sign-On Access yet still lives at an address whose segment reads workspace-one-access-broker. The product name changed faster than the documentation tree. It is an anecdote, and it is also the best reason to check a name before writing it into an architecture document.

The three circles of coverage — and the two boundaries

The Configuring VCF Single Sign-On page enumerates the components in scope: vCenter, VCF Operations, VCF Automation, VCF Operations for logs, VCF Operations for networks, VCF Operations orchestrator, VCF Operations HCX and NSX. The 9.1 wording is unambiguous: “across all VCF components except SDDC Manager and ESX”. That is not an editorial oversight, it is a product boundary.

Inside that list, integration depth is not the same everywhere. The split below is published as such on no page: it is an assembly of several official pages, and it is worth what a reading is worth, not what an observation would be worth.

Circle 1 — one screen, two components. vCenter and NSX are configured together from VCF Operations, under Fleet Management → Identity & Access. In 9.1 the path runs through the Start button facing Enable SSO for vCenter and NSX, then component selection in the grid and Configure. The step page is literally called Configure VCF Single Sign-On for NSX and vCenter.

Circle 2 — a dedicated step, now optional. VCF Operations and VCF Automation have their own step in the sequence. In 9.1 it is explicitly marked (Optional).

Circle 3 — an OIDC client wired component by component. The Configure VCF Single Sign-On for other VCF Components step is a navigation hub: it points to a per-component procedure rather than describing one. And those procedures do not look alike.

Component Where configuration happens What you must supply
VCF Operations for logs inside the logs appliance (Configuration → Authentication → VCF SSO card) and on the fleet side (Identity & Access → VCF Other Components) super admin privileges on the appliance, VCF licence
VCF Operations for networks local login to the component, then Configure → Identity and Access Management → VCF SSO identity broker issuer address, REPLACE_WITH_CLIENT_ID, REPLACE_WITH_SHARED_SECRET, then Test Connection
VCF Operations HCX inside HCX Manager, on its own administration port, Configuration menu an OAuth application created beforehand, then a mandatory role mapping
PowerCLI OAuth client generated on the fleet side (Identity & Access → VCF Other Components → Add → Generate OIDC Client) Client ID and secret; the OAuth context is exchanged for a SAML context to reach vCenter
VCF Operations orchestrator configuration page not loaded during this research unknown — to be established on your own platform

The “orchestrator” row is an acknowledged gap: the component is named by the hub and by the role matrix, but its configuration page could not be loaded. Describing its path would amount to inventing it.

First boundary: SDDC Manager and ESX. The Points to Consider page spells out the real behaviour: “SDDC Manager UI will support logins only with local admin accounts such as @vsphere.local users”, while “SDDC Manager APIs will support logins with VCF Single Sign-On users”. The interface is excluded, the API is not. An official VCF post dated 19 June 2025, by Eric Gray, states the same limit in practical terms.

Second boundary: VKS. The Configuring Identity and Access for VKS Clusters page knows only two methods — vCenter Single Sign-On by default, or an OIDC-compliant external identity provider. VCF Identity Broker is named nowhere on it, and neither VKS nor vSphere Supervisor appears in the list of covered components. The only description of wiring the Identity Broker to vSphere Supervisor is a personal post by William Lam, published on 8 June 2026, presented by its author for “lab or PoC” purposes — and carrying his own decisive caveat: once VCF Automation is deployed with the Supervisor, VCFA becomes the IdP interface and the Identity Broker is out of the loop. That is not product documentation, and it grounds no support status: for readers building clusters, standing up a first VKS cluster remains a separate identity workstream.

What “SSO” does not cover

The word promises four things. Two hold, two do not — and the documentation says so itself.

What the reader hears What the documentation establishes
one login yes, for the components on the published list
one directory yes, a single authentication source configured from VCF Operations
one logout no — “VCF Single Sign-On supports a single component logout mechanism. When you log out, the session ends exclusively for that particular VCF component within the designated browser.”
one role model no — “VCF roles do not aim to replace the individual components roles or their Authorization model”

Six built-in VCF roles exist: VCF Administrator, VCF Viewer, SDDC Administrator, SDDC Viewer, Migration Admin, Migration Appliance Admin. Their published mapping leaves cells empty, and that is the most useful part of the table.

VCF role vCenter NSX VCF Operations VCF Automation
VCF Administrator Admin enterprise_admin Administrator System Administrator
VCF Viewer ReadOnly auditor ReadOnly
SDDC Administrator Admin enterprise_admin
SDDC Viewer ReadOnly auditor

The Managing VCF Roles page adds the sentence that kills the shortcut: “If a user has VCF roles and component roles assigned, then the overall access is a combination of both, and not the replacement of one over the other.” And the step page, in 9.0 as in 9.1, warns that after the initial setup you must log in with each component’s local admin account to assign roles to the provisioned users and groups.

Operational translation for our demonstration estate: grp-vcf-admins maps to VCF Administrator, grp-vcf-viewers to VCF Viewer, but grp-nsx-secops finds no suitable built-in VCF role. Writing NSX security policy goes through one of the fifteen built-in NSX roles, assigned locally. Authentication is centralised; authorisation is not.

The direct consequence for the opening SLA: an SSO is not a revocation. Cutting the user upstream closes the opening of new sessions, but you still have to rule on sessions already open and on roles assigned locally inside each component.

Embedded or appliance: exit price before entry price

Two modes exist, and only two. Embedded mode is configured in the management domain vCenter: a single-node service, protected by vSphere HA and by vCenter backup and restore, with the published recommendation of one Identity Broker per VCF instance. Appliance mode is deployed from VCF Operations as a three-node cluster, tolerates the failure of one node, and accepts at most five VCF instances attached to a single Identity Broker.

The published selection criteria for the appliance are explicit: several VCF instances to connect, a management domain vCenter unreachable by some components, or a need to survive a node failure. The design library rules the same way: the embedded model “fits new VMware Cloud Foundation platforms, or deployments that have lower requirements for availability”, while the appliance model targets “critical up-time requirements” and “multi-instance multi-site” platforms. It formalises two numbered requirements, VCF-SSO-REQD-EXT-001 — deploy the appliance in the first vCenter of the management domain, with the published implication of additional operational overhead — and VCF-SSO-REQD-EXT-002, connect the appliance to the enterprise identity provider.

What quick comparisons leave out is the exit price. Changing mode after the fact is not a setting: the Change the Deployment Mode in VCF Single Sign-On page imposes a Reset SSO, described as the deletion of every SSO-related configuration, “including the identity provider configuration, the provisioned users and groups, and the component configuration”. Second cost, counter-intuitive: the documentation announces continuity for PowerCLI automation only if the identity provider is configured in the management domain vCenter in embedded mode — in appliance mode, or on an alternate management vCenter, a new OAuth client must be generated. Third: when reusing an existing identity provider configuration, it is retained only in embedded mode, and “Users and groups are not migrated” in every case.

For our demonstration platform, appliance mode is the choice — idb-par-01.corp.example, nodes idb-par-01a through idb-par-01c — because a second instance vcf-lyo-01 is planned and the failure of the management vCenter must not take authentication down with it. That is a design hypothesis, not a Broadcom recommendation, and its price is accepted in writing: reworking the PowerCLI automation estate, and reconfiguring the identity provider from scratch instead of carrying it over.

Network placement, finally, is an architecture decision and not an installation detail. The Upgrade to Identity Broker 9.1 page publishes the component’s most expensive constraint: when VCF Operations is already on 9.1, an Identity Broker 9.0.x appliance sitting on an NSX overlay segment, or on a network and datastore different from those of the VCF management services, makes the upgrade fail. The guidance is to deploy it on the VCF management network, and to ensure it can reach the identity provider during the transition. An identity component placed “wherever there was room” is paid for at the first upgrade, not at deployment.

The 9.1 sequence, and the prerequisite that costs a maintenance window

The configuration sequence changed shape between 9.0 and 9.1. Quoting a step number without quoting its version misleads.

VCF 9.0 — seven steps VCF 9.1 — six steps
1 Select a VCF Instance Choose the Deployment Mode
2 Choose the Deployment Mode Configure an Identity Provider
3 Configure an Identity Provider Configure VCF Single Sign-On for NSX and vCenter
4 Configure VCF Single Sign-On for NSX and vCenter (Optional) Assign a VCF Role
5 Configure VCF SSO for VCF Operations and VCF Automation (Optional) Configure VCF SSO for VCF Operations and VCF Automation
6 (Optional) Configure VCF SSO for other VCF Components (Optional) Configure VCF SSO for other VCF Components
7 Assigning Roles and Permissions

Three differences are worth commenting on. Instance selection disappears from the 9.1 sequence. Role assignment becomes a numbered and optional step instead of a closing one. And connecting VCF Operations and VCF Automation becomes explicitly optional.

Before the first step, a structural prerequisite is waiting for the project: Enhanced Linked Mode must be deactivated. The dedicated page is categorical — “VCF Single Sign-On is not compatible with the vCenter Enhanced Linked Mode (ELM)” — and mandates the cmsso-util break-elm utility, which requires every vCenter instance in the topology to be operational and on version 9.0. The published effect is not trivial: “Any shared configurations, like tags, roles, permissions and so on that are in ELM, will remain local to individual vCenter Instances after you deactivate ELM.” The page recommends offline snapshots of all vCenter instances — therefore an outage, despite the “without downtime” in its own title.

Two other points on the same page change the cutover plan. After configuring VCF Single Sign-On from VCF Operations, you can no longer configure identity sources in the vCenter instances, and pre-existing vCenter identity provider configurations are overwritten, with users and groups to be re-provisioned. And the account performing the configuration needs the All Objects scope in VCF Operations, assigned through Administration → Control Panel → Access Control. The components themselves must be on version 9.0 or later, licensed, and outside any ELM ring.

On the NSX side, the integration page states the scope — NSX Managers, Local Managers and Global Managers — and points, for Global Managers and standalone NSX Managers, to Broadcom knowledge base article number 3875053. That article is cited by number and not by an address: the corresponding URL does not load, and a neighbouring article numbered 387503 covers a different NSX version. Do not substitute one for the other.

What stays local after the cutover — and the break-glass account

Non-interactive access is managed from Fleet Management → Identity & Access → VCF SSO Overview, API Access tab. The published durations are an API token of thirty days by default and an access token of thirty minutes by default, both capped by the API Token Expiry and Access Token Expiry settings under Fleet Settings → IAM Setting. The effective value on your platform is still to be established: REPLACE_WITH_TOKEN_TTL.

The break-glass account does have a documented place. The emergency access client is described for “break-glass scenarios that provide high-privilege and long-lived access tokens to critical systems when standard methods fail”. Its published characteristics: the highest role and the widest scope, not modifiable; a default validity of one hundred and eighty days; a single emergency access token at a time; regeneration and deletion available.

An honest on-call procedure names the access paths that survive centralisation:

  • the local admin account of every component, needed for role assignment after the cutover;
  • the local admin account of SDDC Manager, whose interface only accepts accounts such as @vsphere.local;
  • access to ESX, out of scope by the documentation itself;
  • access to VKS clusters, which follows vCenter Single Sign-On or an OIDC identity provider declared on the Supervisor;
  • the emergency access client, if one was created, together with where its token is kept.

One gap remains, and it deserves saying rather than filling: no loaded page describes component behaviour during an outage of the upstream identity provider — how long open sessions stay valid, whether it fails open or closed, what tolerance exists. Claiming that “open sessions survive” or that “everything drops” would be invented in either direction. That question belongs to the identity provider and is settled in a lab, not in an article.

Pitfalls

Two more reflexes belong in the architecture review. First: the rollback is not symmetric. Reset SSO deletes the configuration, but no loaded page describes restoring ELM, nor restoring the local vCenter identity sources overwritten at cutover. Presenting the operation as “reversible as a block” is false as long as that path is undocumented.

Second: the VCF Operations 9.1 interface labels — Identity & Access, VCF SSO Overview, API Access, Emergency Access — are the ones recorded in the documentation, and they can move from one patch level to the next. A runbook quoting them without stating the version goes stale silently. For the general fleet / instance / domain frame all of this sits in, the new VCF 9 architecture sets the vocabulary, and the security and resilience side of VCF 9.1 gives the hardening context.

Conclusion

This article stops deliberately at step 2 of the 9.1 sequence, Configure an Identity Provider: that is the entire subject of the next one, Federating VCF identity: Okta, Entra ID, and the generic path, which publishes the real identity provider matrix, protocol by protocol. The third instalment, vDefend Distributed Firewall: zero trust at the workload level, will go looking for what this identity lets you write — or not — into a firewall rule. The answer there is less comfortable than it looks from here.

The perimeter is a list

Eight named components, SDDC Manager and ESX excluded, VKS absent. Copying the list into the architecture document beats summarising it as “the whole platform”.

The mode is chosen once

Embedded or appliance: changing it goes through a full Reset SSO. Decide knowing the exit price — PowerCLI, identity provider reuse, role reassignment.

Local accounts do not vanish

One admin account per component, the SDDC Manager UI, ESX, VKS, and the break-glass path. Name them and govern them, rather than pretending they were removed.

Get the next one by email

New articles and series, sent when they are published. No other mail.

One click to unsubscribe, any time.

Back to blog
Share

Related articles

  1. 14 min read

    vDefend Distributed Firewall: zero trust at the workload level

    Least-privilege policy per vNIC, built on dynamic groups and tags rather than IP addresses — and the honest boundary where federated identity stops and the firewall starts.

  2. 16 min read

    Federating VCF identity: Okta, Entra ID, and the generic path

    Four identity providers are documented by name, each with its own protocol path. Everything else goes through generic SAML 2.0 — a route that works without being a support statement.

  3. 23 min read

    Network policies and Cilium: building a defensible default-deny

    The NetworkPolicy API ships with Kubernetes; enforcing it is the CNI's job. What Cilium adds, what stays standard, and how to reach default-deny by watching real flows before blocking any.

Follow along

New articles, thoughts, and updates.