Connecting Tanzu Kubernetes Grid Integrated Edition to a SAML Identity Provider

Note: As of v1.8, Enterprise PKS has been renamed to VMware Tanzu Kubernetes Grid Integrated Edition. Some screenshots in this documentation do not yet reflect the change.

Page last updated:

This topic describes how to connect VMware Tanzu Kubernetes Grid Integrated Edition to a SAML identity provider (IdP).

Overview

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 enable an internal user account store for UAA, you select Internal UAA in the Tanzu Kubernetes Grid Integrated Edition tile > UAA.

If you want to connect Tanzu Kubernetes Grid Integrated Edition to a SAML IdP, you must integrate the UAA server with your SAML IdP by following the instructions in Integrate UAA with a SAML IdP below. This enables UAA to delegate authentication to your SAML IdP.

Prerequisites

Before you configure a SAML IdP in the Tanzu Kubernetes Grid Integrated Edition tile, you must configure your IdP to designate Tanzu Kubernetes Grid Integrated Edition as a service provider (SP).

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

Integrate UAA with a SAML IdP

To integrate UAA with a SAML IdP:

  1. In Tanzu Kubernetes Grid Integrated Edition > UAA, under Configure your UAA user account store with either internal or external authentication mechanisms, select SAML Identity Provider.

    SAML Fields 1

  2. 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.

  3. 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 https://TKGI-API:8443/login.

    SAML provider display name

  4. 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.

  5. Enter your IdP metadata into either the Provider Metadata or the Provider Metadata URL fields:

    • If your IdP exposes a metadata URL, enter it in Provider Metadata URL.
    • If your IdP does not expose a metadata URL, paste the XML you retrieved into Provider Metadata.

    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.

  6. 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 Email Address.

    SAML Fields 2

  7. 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.

  8. 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.

  9. 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.

  10. By default, all SAML authentication requests from Tanzu Kubernetes Grid Integrated Edition are signed. To change this, disable Sign Authentication Requests and configure your IdP to verify SAML authentication requests.

  11. To validate the signature for the incoming SAML assertions, enable Required Signed Assertions and configure your IdP to send signed SAML assertions.

  12. For Signature Algorithm, choose an algorithm from the dropdown to use for signed requests and assertions. The default value is SHA256.

  13. Click Save.

Complete Your Tile Configuration

Next Steps

For information about creating Tanzu Kubernetes Grid Integrated Edition roles and managing Kubernetes cluster access, see:


Please send any feedback you have to pks-feedback@pivotal.io.