Configuring the integration between BMC Remedyforce and BMC Client Management

To enable staff members to work with BMC Client Management (known before version 12.0 as BMC FootPrints Asset Core) devices in BMC Remedyforce, you must enable the integration between BMC Remedyforce and BMC Client Management on the Remedyforce Administration > Integrations > BMC Client Management Integration Settings page.

The following table describes the steps that you must perform to configure the integration between BMC Remedyforce and BMC Client Management.

Installing an SSL certificate on the BMC Client Management server

To secure the transactions and encrypt the information passing between the BMC Client Management server and BMC Remedyforce, you must install a Secure Socket Layer (SSL) certificate on the BMC Client Management server. For more information about SSL, see http://en.wikipedia.org/wiki/Secure_Sockets_Layer.

If your organization already has an SSL certificate, you can use it or you can purchase an SSL certificate from an SSL vendor such as Go Daddy (http://www.godaddy.com/ssl/ssl-certificates.aspx) or Symantec (http://www.symantec.com/theme.jsp?themeid=ssl-information-center). For more information, see http://wiki.developerforce.com/page/Outbound_Messaging_SSL_CA_Certificates.

After preparing the certificate request by creating a private key and Certificate Signing Request (CSR), you must purchase the SSL certificate. After you purchase the SSL certificate, you are ready to install it.

To install an SSL certificate on the BMC Client Management server

1. Start the BMC Client Management console from the CMDB Manager in BMC Remedyforce.
2. Navigate to Global Settings > External Integration > Web Service Configuration.
3. Click the Properties toolbar icon.
4. Select the Enable Web Service check box.
5. In the Web Service Port field, type the number of the port on which the web service should run.
6. In the Web Service Thread Count field, type the number of threads that may be handled simultaneously.
7. Click OK.
8. To create a private key and CSR, perform the following actions:
   1. Click the Prepare Certificate Request toolbar icon.
   2. In the Prepare Certificate Request window, enter the following details: 
      • Domain Name
      • Organization
      • Department
      • City
      • State/Province
      • Country
      • Private Key Password
   3. Click Save Private Key.
   4. Browse to the location at which you want to save the private key.
       BMC recommends that you save the private key in the same folder in which you saved the SSL certificate.
   5. Click Save.
   6. In the Prepare Certificate Request window, click Save CSR.
   7. Browse to the location at which you want to save the CSR.
       BMC recommends that you save the CSR in the same folder in which you saved the SSL certificate and the private key
   8. Click Save, and then click Close.
9. Provide the private key and CSR to an SSL vendor and purchase the SSL certificate from the vendor.
10. Click Install the certificate.
11. In the Give a name to your certificate field, type a name for your certificate.
12. In the Root Certificate section, click Browse to browse to the location at which the root certificate is located, and open the root certificate file.
     Some certificate providers might give you the root and intermediate certificates in one file. You can verify that you have added the correct certificate by clicking Details and viewing the content of the certificate. A root authority is self-signed; therefore, the Issuer and Subject fields must have the same value.
13. If both certificates are present in one file, delete the content from the ----BEGIN CERTIFICATE-- to the- ---END CERTIFICATE--- markers for the first certificate. Click Details and verify that the Issuer and Subject fields have the same value. If values are different, delete the entire content and again open the root certificate file. Now, delete the content from the ---BEGIN CERTIFICATE--- to the- ---END CERTIFICATE---- markers for the second certificate. Click Details and verify that the Issuer and Subject fields have the same value.
14. Click Close.
15. In the Intermediate Certificate section, click Browse to browse to the location at which the intermediate certificate is located, and open the intermediate certificate file.
16. If both certificates are present in one file, delete the content from the ----BEGIN CERTIFICATE--- to the- ---END CERTIFICATE--- markers for the first certificate. Click Details and verify that the Issuer and Subject fields have different values. If the values are the same, delete the entire content and again open the intermediate certificate file. Now, delete the content from the ---BEGIN CERTIFICATE--- to the- ---END CERTIFICATE---- markers for the second certificate. Click Details and verify that the Issuer and Subject fields have different values.
17. In the Final Certificate section, click Browse to browse to the location at which the final certificate is located, and open the final certificate file.
18. To view the final certificate, click Details.
19. Click Close.
20. In the Final Certificate section, click Browse to browse to the location at which the private key is located, and open the private key file. You can verify that the private key has been added by checking for the ---BEGIN RSA PRIVATE KEY--- and ---END RSA PRIVATE KEY---- markers.
21. In the Private Key Password field, type the private key password you entered while creating the private key.
22. Click Install Certificates.
23. In the confirmation dialog box, click Close.
24. In the Install Certificate window, click Close.
25. Click Refresh. The SSL certificate is installed on the BMC Client Management server. The SSL certificate appears in the Web Service SSL Certificate File attribute.