oz0 oidc set

Add an identity provider, or change one: only the flags given change.

For: Operators and developers looking up a command.

Add an identity provider, or change one: only the flags given change. --group-role and --cluster-role replace the provider's group rules, which apply at every sign-in: a cluster role for members of a group, or a role in a tenant. A membership an owner set by hand stays as it is. Without --client-secret-stdin the server is a public client and PKCE alone protects the code.

Usage

oz0 oidc set ID [flags]

Flags

FlagTypeDefaultDescription
--assume-email-verifiedboolwith --username-claim email, take the provider's addresses as verified when its tokens have no email_verified claim, for a provider that verifies or sets every address itself, such as Microsoft Entra ID; without it such a token names no account, since an unverified address could be anyone's (--assume-email-verified=false to undo)
--client-idstringthe client ID the provider gave this server
--client-secret-stdinboolread the client secret from stdin; it is sealed with the master key and never shown again
--cluster-rolestringArrayGROUP=ROLE: members of the group get the cluster role admin, reader or member; repeatable
--create-usersboolcreate an account for someone who has none at their first sign-in
--default-rolestringmemberthe cluster role of accounts the provider creates: member or reader
--disabledboolturn the provider off (and sign out everyone who signed in through it), or on again with --disabled=false
--display-namestringthe IDwhat the sign-in button names, as in "Sign in with Okta"
--group-rolestringArrayGROUP=TENANT:ROLE[:content|:no-content]: members of the group get the role in the tenant; repeatable
--groups-claimstringgroupsthe claim that lists a person's groups
--groups-sourcestringwhere people's groups come from at sign-in: token (the groups claim, the default) or directory (what a provisioner set with account groups)
--issuerstringthe issuer URL, such as https://acme.okta.com; https, or http on a loopback address
--no-client-secretboolremove the stored client secret: a public client, with PKCE
--scopestringsopenid, profile, emailscopes to ask for; repeatable
--username-claimstringpreferred_usernamethe ID token claim an account's name comes from

Inherited flags

FlagTypeDefaultDescription
--contextstring$OZ0_CONTEXT or <config dir>/orchestrator-zero/context.jsonCLI context file written by server init
--log-levelstringinfolog level: debug, info, warn or error

See all oz0 commands and the global flags.

On this page
Copyright © 2026