This topic describes how to connect VMware Tanzu Kubernetes Grid Integrated Edition (TKGI)
to a SAML identity provider (IdP).
User Account and Authentication (UAA), the identity management service for Tanzu Kubernetes Grid Integrated Edition, can authenticate users either through its internal user account store or external authentication mechanisms such as an LDAP server or a SAML IdP.
To connect Tanzu Kubernetes Grid Integrated Edition to a SAML IdP:
You must configure a SAML IdP to designate Tanzu Kubernetes Grid Integrated Edition as a service provider (SP) before configuring the SAML IdP in the Tanzu Kubernetes Grid Integrated Edition tile.
See the table below for information about industry-standard SAML IdPs and how to integrate them with Tanzu Kubernetes Grid Integrated Edition:
|Solution Name||Integration Guide|
|Okta Single Sign-On||Configuring Okta as a SAML Identity Provider|
|Azure Active Directory||Configuring Azure Active Directory as a SAML Identity Provider|
To integrate UAA with your SAML IdP:
Under Configure your UAA user account store with either internal or external authentication mechanisms, select SAML Identity Provider.
For Provider Name, enter a unique name you create for the IdP. This name can include only alphanumeric characters, +, _, and -. You must not change this name after deployment because all external users use it to link to the provider.
For Display Name, enter a display name for your provider. This display name appears as a link on your Ops Manager login page, which you can access at
To directly authenticate users with the configured external identity provider, enable Default Identity Provider.
To automatically bypass displaying the scope approval screen when logging in to the TKGI CLI, enable Enable tkgi cli automatic approval.
To automatically bypass displaying the scope approval screen for the
tkgi get-credentials cli command, enable Enable cluster client tkgi cli automatic approval.
Retrieve the metadata from your IdP. You recorded your IdP metadata when you configured your IdP to designate Tanzu Kubernetes Grid Integrated Edition as a SP. See Prerequisites above.
Enter your IdP metadata into either the Provider Metadata or the Provider Metadata URL fields:
Note: VMware recommends that you use the Provider Metadata URL rather than Provider Metadata because the metadata can change. You need to select only one of the above configurations. If you configure both, your IdP defaults to the (OR) Provider Metadata URL.
For Name ID Format, select the name identifier format for your SAML IdP. This translates to
username in Tanzu Kubernetes Grid Integrated Edition. The default is
For First Name Attribute and Last Name Attribute, enter the attribute names in your SAML database that correspond to the first and last names in each user record. This field is case sensitive.
For Email Attribute, enter the attribute name in your SAML assertion that corresponds to the email address in each user record, for example,
EmailID. This field is case sensitive.
For External Groups Attribute, enter the attribute name in your SAML database for your user groups. This field is case sensitive. To map the groups from the SAML assertion to admin roles in TKGI, see Grant Tanzu Kubernetes Grid Integrated Edition Access to an External SAML Group in Managing Tanzu Kubernetes Grid Integrated Edition Users with UAA.
By default, all SAML authentication requests from Tanzu Kubernetes Grid Integrated Edition are signed. To change this, deactivate Sign Authentication Requests and configure your IdP to verify SAML authentication requests.
To validate the signature for the incoming SAML assertions, enable Required Signed Assertions and configure your IdP to send signed SAML assertions.
For Signature Algorithm, choose an algorithm from the dropdown to use for signed requests and assertions. The default value is
For information about creating Tanzu Kubernetes Grid Integrated Edition roles and managing Kubernetes cluster access, see: