Create a CSR & install your SSL certificate using the ¶ºÒõ¹Ý® Certificate Utility for Windows

These instructions assume that you already own your IBM Bluemix account, and that you have configured the custom domain for your application. For more information, visit . If you need instructions for IBM Watson IoT Platform, see IBM Watson IoT Platform: Create CSR & Install Messaging Server SSL Certificate for Your Watson IoT Organization (¶ºÒõ¹Ý Utility).

Use the instructions on this page to create your certificate signing request (CSR) and then to install your SSL certificate.

For a simpler way to create your CSRs (Certificate Signing Requests) and install and manage your SSL certificates, we recommend that you use the ¶ºÒõ¹Ý® Certificate Utility for Windows. For more information about our utility, see?¶ºÒõ¹Ý® Certificate Utility for Windows.

  1. To create your certificate signing request (CSR), see IBM Bluemix: Creating Your CSR with the ¶ºÒõ¹Ý Utility.

  2. To install your SSL certificate, see IBM Bluemix: Using the ¶ºÒõ¹Ý Utility & Bluemix Console to Install Your SSL Certificate.

If you don't have access to a Microsoft server or workstation, prefer not to use the ¶ºÒõ¹Ý Utility, or for some reason cannot use the utility, see IBM Bluemix: Create CSR & Install SSL Certificate (OpenSSL).

 

I. IBM Bluemix: Creating Your CSR with the ¶ºÒõ¹Ý Utility

The ¶ºÒõ¹Ý® Certificate Utility for Windows streamlines the CSR creation process enabling you to generate the CSR with just one click.

How to Create Your CSR with the ¶ºÒõ¹Ý Utility

  1. On your Windows machine, download and save the ¶ºÒõ¹Ý® Certificate Utility for Windows executable (¶ºÒõ¹ÝUtil.exe).

  2. Run the ¶ºÒõ¹Ý Certificate Utility.

  3. Double-click?¶ºÒõ¹ÝUtil.

  4. In the?¶ºÒõ¹Ý Certificate Utility for Windows©, click?SSL?(gold lock), and then, click?Create CSR.

    Utility Create CSR

  5. On the Create CSR?page, enter the following information:

    Certificate Type: Select SSL.
     
    Common Name: Enter the fully qualified domain name (FQDN) (e.g., www.example.com).
      You may also enter the IP address.
     
    Subject Alternative Names: If you are requesting a Multi-Domain (SAN) Certificate, type any SANs that you want to include.
      (e.g., www.example.com, www.example2.com, and www.example3.net)
     
    Organization: Type your company's legally registered name (e.g., YourCompany, Inc.).
     
    Department: (Optional) Enter the department within your organization that you want to appear on the SSL certificate.
     
    City: Type the city where your company is legally located.
     
    State: In the drop-down list, select the state where your company is legally located.
    If your company is located outside the USA, you can type the applicable name in the box.
     
    Country: In the drop-down list, select the country where your company is legally located.
     
    Key Size: In the drop-down list, select 2048.
     
    Provider: In the drop-down list, select Microsoft RSA SChannel Cryptographic Provider,
      unless you have a specific cryptographic provider.

    Add CSR Details

  6. Click?Generate.

  7. On?The certificate request has been successfully created?page, do one of the following, and then, click?Close:

    Click Copy CSR. Copies the certificate contents to the clipboard.
    If you use this option, we recommend that you paste the CSR into a tool such as Notepad.
    If you forget and copy some other item, you still have access to the CSR, and you do not have to go back and recreate it.
     
    Click Save to File. Saves the CSR as a .txt file to the Windows server or workstation.
      We recommend that you use this option.

    Copy CSR

  8. Use a text editor (such as Notepad) to open the file. Then, copy the text, including the?-----BEGIN NEW CERTIFICATE REQUEST-----?and?-----END NEW CERTIFICATE REQUEST-----?tags, and paste it into the ¶ºÒõ¹Ý order form.

    Ready to Order Your SSL Certificate

    Learn More
  9. After you receive your SSL certificate from ¶ºÒõ¹Ý, you can install it.

 

II. IBM Bluemix: Using the ¶ºÒõ¹Ý Utility & Bluemix Console to Install Your SSL Certificate

If you have not yet used the ¶ºÒõ¹Ý® Certificate Utility for Windows to create a CSR and ordered your certificate, see IBM Bluemix: Creating Your CSR with the ¶ºÒõ¹Ý Utility.

After receiving your SSL certificate, you need to upload it upload it to your IBM Bluemix account and configure your application to use it.

To install your IBM Bluemix SSL certificate, complete the steps below.

  1. Import your SSL certificate to your Windows server using the ¶ºÒõ¹Ý® Certificate Utility for Windows.

    How to Import Your SSL Certificate Using the ¶ºÒõ¹Ý Certificate Utility

  2. Export the SSL certificate in Apache compatible format (separate .key and .crt files) using the ¶ºÒõ¹Ý® Certificate Utility for Windows.

    How to Export Your SSL Certificate in Apache Compatible Format Using the ¶ºÒõ¹Ý Certificate Utility

  3. Upload and implement your SSL certificate using the IBM Bluemix Management Console.

    IBM Bluemix: Installing Your SSL Certificate

 

i. How to Import Your SSL Certificate Using the ¶ºÒõ¹Ý Certificate Utility

After we validate and issue your SSL certificate, you can use the ¶ºÒõ¹Ý® Certificate Utility for Windows to import the file to your Microsoft server.

  1. On the server where you created the CSR, save the SSL certificate .cer file (e.g., your_domain_com.cer) that ¶ºÒõ¹Ý sent to you.

  2. Run the ¶ºÒõ¹Ý® Certificate Utility for Windows.

    Double-click ¶ºÒõ¹ÝUtil.

  3. In the ¶ºÒõ¹Ý Certificate Utility for Windows©, click SSL (gold lock) and then click Import.

    Install Certificate

  4. In the Certificate Import window, under?File Name, click?Browse?to browse to the .cer (e.g.,?your_domain_com.cer) certificate file that ¶ºÒõ¹Ý sent you, select the file, click?Open, and then click?Next.

    Import Certificate

  5. In the?Enter a new friendly name or you can accept the default?box, enter a friendly name for the certificate. The friendly name is not part of the certificate; instead, it is used to identify the certificate.

    We recommend that you add ¶ºÒõ¹Ý and the expiration date to the end of your friendly name, for example:?yoursite-¶ºÒõ¹Ý-expirationDate. This information helps identify the issuer and expiration date for each certificate. It also helps distinguish multiple certificates with the same domain name.

    Friendly Name

  6. To Import the SSL certificate to your server, click Finish.

    You should receive a message that the certificate was successfully imported.

  7. You should now see your SSL certificate in the?¶ºÒõ¹Ý Certificate Utility for Windows, under?SSL Certificates.

 

ii. How to Export Your SSL Certificate Using the ¶ºÒõ¹Ý Certificate Utility

To make an SSL connection, your server needs two parts, a private key file and the certificate file. Apache (and many other server types) separate these two certificate parts into separate?.key?file and?.crt?files.

  1. Run the ¶ºÒõ¹Ý® Certificate Utility for Windows.

    Double-click?¶ºÒõ¹ÝUtil.

  2. In?¶ºÒõ¹Ý Certificate Utility for Windows©, click?SSL?(gold lock), select the SSL certificate you want to export, and then click?Export Certificate.

    Export Certificate

  3. In the?Certificate Export?wizard, select?Yes, export the private key, select?key file (Apache compatible format), and then click?Next.

    Export Certificate

  4. In the?File name?box, click?¡­?to browse for and select the location and file name where you want to save the certificate .key file, and then click?Finish.

    This creates the following files that you will need to upload and implement using your Bluemix?Management Console.

    • Private Key:?your_domain_com.key
    • Server Certificate: your_domain_com.crt
    • Intermediate Certificate: ¶ºÒõ¹ÝCA.crt

    Export Certificate

  5. After you receive the "Your certificate and key have been successfully exported" message, click?OK.

 

iii. IBM Bluemix: Installing Your SSL Certificate

Once you have the private key and certificate files, you can upload it to your IBM Bluemix account and configure your application to use it.

    Upload the SSL Certificate to Your IBM Bluemix Account

  1. In a browser, open and log into the IBM Bluemix account.

  2. On the Dashboard select the application the SSL certificate is to secure.

    IBM Bluemix SSL certificate install

  3. On the app Overview page, next to View app, click the down arrow and select Manage domains.

    IBM Bluemix SSL certificate install

  4. On the Manage Organizations page, on the Domains tab, to the right of the application in the SSL Certificate column, click the upload symbol.

  5. In the Upload Certificate window, do the following:

    Certificate: Click Browse. Then locate and select your server certificate .crt file (e.g., star_digicert_support.crt).
     
    Private Key: Click Browse. Then locate and select your private key .key file (e.g., star_digicert_support.key).
     
    Intermediate Certificate: Click Browse. Then locate and select the intermediate certificate .crt file (e.g., ¶ºÒõ¹ÝCA.crt).

  6. When you are finished, click Upload.

  7. Configure Your Application to Use the SSL Certificate

  8. Within the Manage Organizations section, on the Add Domain page, to the right of the application in the SSL Certificate column, you should see a green certificate symbol.

    Note: After you upload your certificate, it may take some time to propagate the certificate chain to the apps.

  9. Click the green certificate symbol to view the uploaded certificate.

  10. To verify that your application is using your SSL certificate, do the following:

    1. Navigate to the application Dashboard.

    2. On the Dashboard select the application that you secured with the SSL certificate.

      IBM Bluemix SSL certificate install

    3. On the app Overview page, next to View app, click the down arrow and select Edit routes.

    4. In the Edit routes window, to the right of the application you just secured, click the green lock to verify that the route has been secured.

  11. As a final check, open your application in a browser and in the address bar. Click on the green lock to the left of the URL and then, view the certificate details.

    Note: After you upload your certificate, it may take some time to propagate the certificate chain to the apps.

  12. Congratulations! You have successfully installed your application's SSL certificate.