Okta Privileged Access RDP URL Error Occurs With Multiple Certificates
Last Updated:
Overview
Okta Privileged Access (OPA) generates a Remote Desktop Protocol (RDP) URL error when a network security product intercepts the connection and returns a certificate chain instead of a single host certificate. Bypass the Secure Sockets Layer (SSL) inspection for the OPA domain to resolve the error. OPA generates the following error when initiating an RDP connection to an internal server from an external environment:
RDP URL error: gateway client connection error: rpc error: code = Unavailable desc = connection error: desc = "transport: authentication handshake failed: expected a single host certificate, received 3"
Applies To
- Okta Identity Engine (OIE)
- Okta Privileged Access (OPA)
- Remote Desktop Protocol (RDP)
Cause
The OPA client expects a single host certificate for validation. Network security products, such as SSL inspection proxies or load balancers, intercept the connection and return a certificate chain containing multiple certificates.
Solution
How is the certificate chain error resolved?
Bypass SSL inspection for the OPA domain within the network security product and verify the port requirements.
- Add the OPA domain (
pam.oktapreview.com) to the SSL inspection allowlist. - Verify the configuration using the Okta Privileged Access port requirements documentation.
