Skip to content
SHC Docs

shc auth create-identity-provider

declare an external OIDC identity provider

declare an external OIDC identity provider. Requires an explicit --tenant and platform:manage. On master, first login must link an existing user.

shc auth create-identity-provider <alias> [flags]
--authentication string client-jwt (RS256), client-jwt=<alg>, or client-secret=<ref+vault://...> (default "client-jwt")
--client-id string client id registered with the identity provider (required)
--display-name string display name shown on the login page
--first-login string first login policy: link-only or create (default "link-only")
-h, --help help for create-identity-provider
--issuer string absolute HTTPS issuer URL (required)
--sync-mode string user synchronization mode: import, legacy, or force (default "import")
-t, --tenant string realm that holds the identity provider: master or a tenant (required)
--config stringArray extra YAML config file to layer on top of auto-discovered config; repeatable, later files win
-d, --debug enable debug mode (default: $SHC_DEBUG)
-e, --environment string environment name (default: "prod", or "default" on an estate with no licence and no trial; $SHC_ENVIRONMENT and shc ctx -e override it, and the "master" tenant is always "default")
--exclude string comma-separated dotted paths to drop
--fields string comma-separated columns/keys to show (and their order)
--filter string comma-separated dotted paths to keep (drops everything else)
-o, --output string output format: tty|text|json|yaml (default: $SHC_OUTPUT)
-s, --stack string stack name (default: $SHC_STACK)
-v, --verbose verbose output (default: $SHC_VERBOSE)
  • shc auth - authenticate the CLI against a cluster