OIDC Identity Provider
OIDC Identity Provider
OpenID Connect is an interoperable authentication protocol based on the OAuth 2.0 family of specifications. It uses straightforward REST/JSON message flows with a design goal of “making simple things simple and complicated things possible”. It’s uniquely easy for developers to integrate, compared to any preceding Identity protocol, such as Keycloak, Okta, Dex, Auth0, Gluu, Casdoor and many more.
Prerequisites
You need to deploy a Kubernetes cluster and install KubeSphere in the cluster. For details, see Installing on Linux and Installing on Kubernetes.
Procedure
Log in to KubeSphere as
admin
, move the cursor to in the lower-right corner, click kubectl, and run the following command to editks-installer
of the CRDClusterConfiguration
:kubectl -n kubesphere-system edit cc ks-installer
Add the following fields under
spec.authentication.jwtSecret
.Example of using Google Identity Platform:
spec: authentication: jwtSecret: '' authenticateRateLimiterMaxTries: 10 authenticateRateLimiterDuration: 10m0s oauthOptions: accessTokenMaxAge: 1h accessTokenInactivityTimeout: 30m identityProviders: - name: google type: OIDCIdentityProvider mappingMethod: auto provider: clientID: '********' clientSecret: '********' issuer: https://accounts.google.com redirectURL: 'https://ks-console/oauth/redirect/google'
See description of parameters as below:
Parameter Description clientID The OAuth2 client ID. clientSecret The OAuth2 client secret. redirectURL The redirected URL to ks-console in the following format: https://<Domain name>/oauth/redirect/<Provider name>
. The<Provider name>
in the URL corresponds to the value ofoauthOptions:identityProviders:name
.issuer Defines how Clients dynamically discover information about OpenID Providers. preferredUsernameKey Configurable key which contains the preferred username claims. This parameter is optional. emailKey Configurable key which contains the email claims. This parameter is optional. getUserInfo GetUserInfo uses the userinfo endpoint to get additional claims for the token. This is especially useful where upstreams return "thin" ID tokens. This parameter is optional. insecureSkipVerify Used to turn off TLS certificate verification.
Feedback
Was this page Helpful?
Receive the latest news, articles and updates from KubeSphere
Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.