Kubelogin is designed to run as a client-go credential plugin. When you run kubectl, kubelogin opens the browser and you can log in to the provider. Then kubelogin gets a token from the provider and kubectl accesses Kubernetes APIs with the token. If you install via GitHub releases, you need to put the kubelogin binary on your path under the name kubectl-oidc_login so that the kubectl plugin mechanism can find it when you invoke kubectl oidc-login. The other install methods do this for you. If the cached ID token is valid, kubelogin just returns it. If the cached ID token has expired, kubelogin will refresh the token using the refresh token. If the refresh token has expired, kubelogin will perform re-authentication (you will have to login via browser again).
Features
- Documentation available
- Install the latest release from Homebrew, Krew, Chocolatey or GitHub Releases
- Examples available
- kubectl plugin for Kubernetes
- OpenID Connect authentication (kubectl oidc-login)
- After authentication, kubelogin returns the credentials to kubectl
Project Samples
