Anthos clusters on bare metal supports OpenID Connect (OIDC) and Lightweight Directory Access Protocol (LDAP) as authentication mechanisms for interacting with a cluster's Kubernetes API server, using Anthos Identity Service. Anthos Identity Service is an authentication service that lets you bring your existing identity solutions for authentication to multiple Anthos environments. Users can log in to and use your Anthos clusters from the command line (all providers) or from the Google Cloud console (OIDC only), all using your existing identity provider.
Anthos Identity Service works with any kind of bare metal cluster: admin, user, hybrid, or standalone. You can use both on-premises and publicly reachable identity providers. For example, if your enterprise runs an Active Directory Federation Services (ADFS) server, the ADFS server could serve as your OpenID provider. You might also use publicly-reachable identity provider services such as Okta. Identity provider certificates may be issued by either a well-known public certificate authority (CA), or by a private CA.
For an overview of how Anthos Identity Service works, see Introducing Anthos Identity Service.
If you already use or want to use Google IDs to log in to your Anthos clusters instead of an OIDC or LDAP provider, we recommend using the Connect gateway for authentication. Find out more in Connecting to registered clusters with the Connect gateway.
Before you begin
Note that headless systems are unsupported. A browser-based authentication flow is used to prompt users for consent and authorize their user account.
To authenticate through the Google Cloud console, each cluster that you want to configure must be registered with your project fleet.
Setup process and options
OIDC
Register Anthos Identity Service as a client with your OIDC provider following the instructions in Configuring providers for Anthos Identity Service.
Choose from the following cluster configuration options:
- Configure your clusters at fleet level following the instructions in Configuring clusters for fleet-level Anthos Identity Service (preview, Anthos clusters on bare metal version 1.8 and higher). With this option, your authentication configuration is centrally managed by Google Cloud.
- Configure your clusters individually following the instructions in Configuring clusters for Anthos Identity Service with OIDC. Because fleet-level setup is a preview feature, you may want to use this option in production environments, if you are using an earlier version of Anthos clusters on bare metal, or if you require Anthos Identity Service features that aren't yet supported with fleet-level lifecycle management.
Set up user access to your clusters, including role-based access control (RBAC), following the instructions in Setting up user access for Anthos Identity Service.
LDAP
- Follow the instructions in Set up Anthos Identity Service with LDAP.
Access clusters
After Anthos Identity Service has been set up, users can log in to configured clusters using either the command line or the Google Cloud console.
- Learn how to log in to registered clusters with your OIDC or LDAP ID in Accessing clusters using Anthos Identity Service.
- Learn how to log in to clusters from the Google Cloud console in Logging in to a cluster from the Google Cloud console (OIDC only).