KNOWLEDGE BASE

Error "SSL peer certificate or SSH remote key was not OK" Connecting to Tableau Server


Published: 29 Apr 2014
Last Modified Date: 25 Jul 2018

Issue

When you try to sign in to Tableau Server from Tableau Desktop, the following error might occur:
 
Cannot connect to Tableau Server. Please check the server name and port and try again.

Internet communication error: SSL peer certificate or SSH remote key was not OK <server name or IP>.
 

Environment

  • Tableau Server 
  • Tableau Desktop 
  • SSL

Resolution

Option 1:

Verify that the Common Name defined in the SSL certificate matches the server name in the Tableau Server Sign In dialog box.

Option 2: If Tableau Server is configured for Mutual SSL 

Work with your IT to configure the proper client certificates on the computer running Tableau Desktop.
OR 
As a Tableau Server administrator, open the "Configure Tableau Server" menu, and disable the "Mutual SSL" option listed on the SSL tab.
 

Cause

The server name used in the Server field of the Tableau Desktop connection dialog box does not match the Common Name defined in the SSL certificate.
OR
If your Tableau Server administrator has enabled Mutual SSL, then Tableau Server is looking for a "client certificate" on your Tableau Desktop computer.  If that client certificate is missing or malformed, it will return the same "SSL peer certificate or SSH remote key was not OK" error.

Additional Information

  • Tableau Desktop cannot append domains in the URL when using SSL to connect to Tableau Server.  It will only use the common name as defined in the certificate to connect.
  • SSL Knowledge Base: Q10048 - FAQ: What is the Common Name?
Did this article resolve the issue?