Sign in →
CloudLab Works emblem: Waku the orca ringed by CloudLab and WorksCLOUDLAB WORKScrossed whale bones, one end a wrenchCloud City, headwaters of the agentic cloud revolution!

Nutanix: Invisible Wires: Agentic Cloud

Onboarding people into NC2 without tickets: access and role mapping, done once

· By Alex Alvord

A common NC2 access problem isn't a bug. Someone is added in My Nutanix, signs in to the NC2 console, and has no access to anything. Everybody's first guess is a broken invite. It isn't one. They were authenticated, which means NC2 knows who they are. They weren't authorized, which means nothing gives them an NC2 role.

The NC2 user guides say this plainly, in the user management chapter of the current Google Cloud and Azure editions. This post turns that section into an onboarding design you set up once, so that adding a person stops being a ticket.

Two sign-in paths, and what each one gives you

NC2 access: two sign-in paths, and what NC2 gives each
NC2 access: two sign-in paths, and what NC2 gives each

My Nutanix. A My Nutanix Admin can reach NC2 through the supported My Nutanix-to-NC2 administrator role mapping, and is mapped to an administrator role that fits the entity. My Nutanix User and Read-Only have no supported NC2 role mapping. That is the "signed in, sees nothing" user. There's a second limit: a My Nutanix account can have only three account administrators at any one time.

SAML2. Your identity provider (Entra ID, Okta, Active Directory and others) authenticates the user, and a SAML2 permission in NC2 decides which role they get. You configure it at the Customer or the Organization level. The guide's own instruction for every granular role is to use SAML2.

API. For pipelines and scripts, an API key carries the role you attach to it. No person's account belongs in a pipeline.

A username and password is not one of the paths. The guide's revision history records basic authentication being removed from the user section in April 2026.

The rule of thumb that follows: My Nutanix is for the three people who own the account. Everyone else arrives through the identity provider, as a member of a group.

The shape NC2 roles hang on

NC2 has two entities you manage. The Customer is created for you when you sign up, and there is exactly one. Organizations sit under it, typically one per department or environment, and clusters live inside an organization. Roles exist at all three levels:

LevelAdministratorRead-onlySecurityOther
CustomerCustomer AdministratorCustomer AuditorCustomer Security Administrator
OrganizationOrganization AdministratorOrganization AuditorOrganization Security Administrator
ClusterCluster AdministratorCluster AuditorCluster Super Admin, Cluster User

Administrators can only grant what their own level covers. A Customer Administrator can grant any role in any organization. An Organization Administrator can grant roles for that organization and its clusters. The security administrator roles manage the authentication providers, SAML2 settings and users, plus the audit trail, without running clusters. That is the separation of duties most security teams ask for.

Onboarding as a group change, not a ticket

Onboarding as a group change: identity provider groups mapped to NC2 roles
Onboarding as a group change: identity provider groups mapped to NC2 roles

A worked example first. A company runs NC2 for two departments, with a Finance organization and a payments application team. It creates seven groups in its identity provider and one SAML2 permission per group in NC2:

Identity provider groupNC2 role grantedWhere
nc2-customer-adminsCustomer AdministratorCustomer
nc2-securityCustomer Security AdministratorCustomer
nc2-auditCustomer AuditorCustomer
nc2-org-finance-adminsOrganization AdministratorFinance organization
nc2-org-finance-auditOrganization AuditorFinance organization
nc2-cluster-opsCluster Administratorthe clusters ops runs
nc2-app-team-paymentsCluster Userthe payments cluster

Each permission uses "When any condition is satisfied", its condition is the group claim in the SAML assertion, and its grant is the role. From then on:

The setup, in the order that saves rework

  1. Name the three My Nutanix administrators. They're the account owners and your break-glass access if the identity provider is down. Decide, and write down, whether "Allow Nutanix Admins on MyNutanix to administer this customer" stays on. If the identity provider is your only path in, break-glass has to come from somewhere.
  2. Choose the level for SAML2. Use the Customer level when one identity provider serves everything, and turn on Enforce settings so organizations can't drift. Use the Organization level when a department really does run its own identity provider. Once the Customer level is enforced, organization-level settings can't be changed, so decide this before departments configure anything.
  3. Add the provider with a metadata URL, not pasted XML. The guide notes that when the SAML certificate expires, a metadata URL needs no change in NC2, while XML has to be updated by hand. Certificate rotation then stops being an outage you have to remember.
  4. On Entra ID, two details. The Application ID must be entered as spn:<Application ID>. The Reply URL on the Entra side is the NC2 one given in the guide, which is different from the URL used when SAML is enabled on the My Nutanix side.
  5. Write one SAML2 permission per group, as in the table, and grant the narrowest role that does the job. Use auditors for reviewers, Cluster User for application teams, and administrators only where someone actually runs something.
  6. Hand people the customer-specific URL. With SAML enabled, users sign in at https://cloud.nutanix.com/<customer_URL> so the console offers your identity provider.
  7. Give automation an API key with its own role, and manage its credentials from the API tab, never from a person's account.

What it costs the architecture

In exchange, onboarding happens where people already exist, and so does offboarding, which matters more. The NC2 console stops being somewhere you manage people at all.

What this does not claim

Sources: Nutanix, Nutanix Cloud Clusters on Google Cloud Deployment and User Guide, edition of October 6, 2026, chapter "NC2 User Management" (entities, user roles, adding users from the NC2 console, My Nutanix and SAML2 authentication, SAML2 permissions, API authentication, the three-administrator limit, the metadata URL and certificate expiry note, Entra ID Application ID format and Reply URL); Nutanix, Nutanix Cloud Clusters on Azure Deployment and User Guide, edition of October 5, 2026, same chapter.

Personal blog. Alex works at Nutanix; the opinions here are his own and nothing here is Nutanix confidential: every fact is public or his own field experience.

Comments

  1. Loading comments…

Comments are read by Alex before they appear. No email address needed; your name shows as you type it. See privacy.

← All posts