Enable identity bridging, configure the external host name for the service, and download the Unified Access Gateway service provider metadata file.
This metadata file is uploaded to the Web application configuration page in the VMware Identity Manager service.
You must have configured the following Identity Bridging Settings on the Unified Access Gateway admin console. You can find these settings under the Advanced Settings section.
Identity provider metadata uploaded to Unified Access Gateway.
The Kerberos principal name configured and the keytab file uploaded to Unified Access Gateway.
The realm name and key distribution center information.
Ensure that TCP/UDP port 88 is open since Unified Access Gateway uses this port for the Kerberos communication with Active Directory.
- In the admin UI Configure Manually section, click Select.
- In the Show. line, click
- Click the Reverse Proxy Settings gearbox icon.
- In the Reverse Proxy Settings page, click Add to create a proxy setting.
- Set Enable Reverse Proxy Settings to YES, and configure the following edge service settings.
The edge service identifier is set to the Web reverse proxy.
Unique name for the Web reverse proxy instance.
Proxy Destination URL
Specify the internal URl for the Web application. Unified Access Gateway must be able to resolve and access this URL.
Proxy Destination URL Thumbprints
Enter the URI to match with this proxy setting. A thumbprint is in the format [alg=]xx:xx, where alg can be sha1, the default or md5. The 'xx' are hexadecimal digits. For example, sha=C3 89 A2 19 DC 7A 48 2B 85 1C 81 EC 5E 8F 6A 3C 33 F2 95 C3.
If you do not configure the thumbprints, the server certificates must be issued by a trusted CA.
Enter the matching URI paths that forward to the destination URL. For example, enter as (/|/SAAS(.*)|/hc(.*)|/web(.*)|/catalog-portal(.*)).
Note: When you configure multiple reverse proxies, provide the hostname in the proxy host pattern
- To configure other advanced settings, click More.
The default is to use pass-through authentication of the user name and password. The authentication methods you configured in Unified Access Gateway are listed in the drop-down menus. RSA SecurID, RADIUS, and Device Certificate Auth methods are supported.
Health Check URI Path
Unified Access Gateway connects to this URI path to check the health of your web application.
Required when you configure Unified Access Gateway as an authenticated reverse proxy for VMware Identity Manager. Enter the name of the SAML service provider for the View XML API broker. This name must either match the name of a service provider you configured with Unified Access Gateway or be the special value DEMO. If there are multiple service providers configured with Unified Access Gateway, their names must be unique.
The default value is the Unified Access Gateway host URL, port 443. You can enter another external URL. Enter as
Enter the known VMware Identity Manager redirection pattern. For example:
Enter the authentication cookie name. For example: HZN
Login Redirect URL
If the user logs out of the portal, enter the redirect URL to log back in. For example: /SAAS/auth/login?dest=%s
Proxy Host Pattern
External hostname used to check the incoming host to see whether it matches the pattern for that particular instance. Host pattern is optional, when configuring Web reverse proxy instances.
Add a trusted certificate to this edge service. Click '+' to select a certificate in PEM format and add to the trust store. Click '-' to remove a certificate from the trust store. By default, the alias name is the filename of the PEM certificate. Edit the alias text box to provide a different name.
Enter the details to be added in /etc/hosts file. Each entry should include an IP, a hostname, and an optional hostname alias in that order, separated by a space. For example, 10.192.168.1 example1.com, 10.192.168.2 example2.com example-alias. Click the '+" sign to add multiple host entries.Important:
The host entries are saved only after you click Save.
- In the Enable Identity Bridging section, change NO to YES.
- Configure the following Identity Bridging settings.
From the drop-down menu, select the identity provider.
In the drop-down menu, select the configured keytab for this reverse proxy.
Target Service Principal Name
Enter the Kerberos service principal name. Each principal is always fully qualified with the name of the realm. For example, myco_hostname@MYCOMPANY. Type the realm name in uppercase. If you do not add a name to the text box, the service principal name is derived from the host name of the proxy destination URL.
Service Landing Page
Enter the page that users are redirected to in the identity provider after the assertion is validated. The default setting is
User Header Name
For header-based authentication, enter the name of the HTTP header that includes the user ID derived from the assertion.
- In the Download SP Metadata section, click Download.
Save the service provider metadata file.
- Click Save.
What to do next
Add the Unified Access Gateway service provider metadata file to the Web application configuration page in the VMware Identity Manager service.