Open topic with navigation

Binding a Certificate to a Port

When you use the Service property page to configure your web service integration to use an HTTPS connection, you must bind a Secure Socket Layer (SSL) server certificate to the port that you want to use before you run the integration. You can bind the certificate manually by running a Netsh command, or you can configure Integration Builder to bind the certificate automatically by entering the certificate's thumbprint in the Thumbprint field on the Service property page.

To enter the thumbprint, you can either copy it from an existing certificate (.cer) file or use the Certificate Manager feature to retrieve the thumbprint and then enter it.

ClosedTo bind the certificate manually

  1. In Windows, open the Command Prompt window.

  2. At the command prompt, enter a command that resembles the following: 

    netsh http add sslcert ipport=0.0.0.0:1234 certhash=e8642dc5138c14082ca62391b75415b22e47ab04 appid={8722cd6c-33b4-4a90-a7ab-a2a51a3e7b16}

    In this command, the "ipport" value is the IP address and port number, the "certhash" value is the SSL certificate thumbprint, and the "appid" value is a GUID that represents the application identity. Note that if you use the Integration Service's appid value, as shown in this example, the certificate binding is removed when the integration stops.

  3. Press Enter to run the command.

ClosedTo add a thumbprint by copying it from a certificate file

  1. On the Service property page, click Copy from a Certificate File.

  2. In the Open File dialog, browse to and then double-click the certificate file that you want.

ClosedTo add a thumbprint by using the Certificate Manager

  1. On the Service property page, click Open Certificate Manager. The Microsoft Management Console is displayed.

  2. In the left navigation pane of the certlm - [Certificates - Local Computer] console window, expand the folder that contains the certificate that you want, such as the Personal folder.

  3. Click the Certificates folder.

  4. Locate and then double-click the certificate that you want.

  5. In the Certificate dialog box, click the Details tab.

  6. In the Field list, click Thumbprint. The thumbprint appears in the editable box below the list.

  7. Copy the thumbprint string, and then paste it into the Thumbprint field on the Service property page.