Importing certificates and configuring browsers for Report Builder reports

Edit online

To access Report Builder reports on Jazz dashboards, your browser must have a valid certificate from the server that runs Report Builder. Complete this task only if a Jazz administrator or project administrator gives you a self-signed certificate or a PKCS12 (.p12) file to install in your browser.

Before you begin

You do not have to complete this task if your organization purchases certificates from a certificate authority; a Jazz administrator or project administrator installs these certificates on the Report Builder server.

If your organization does not purchase secure socket layer (SSL) certificates from a certifying authority, you must complete one of the following steps:
  • Install a self-signed certificate for your browser.
  • Import a Personal Information Exchange Syntax Standard (PKCS #12) file into the certificate store of your browser. A PKCS#12 file has .p12 as a file name extension. Typically, an administrator with JazzAdmins or JazzProjectAdmins privileges provides this file and a corresponding password.

About this task

Complete the steps for the web browsers that you use.

Firefox

Edit online

Procedure

  1. You can install a self-signed certificate; you do not need to import a .p12 file into Firefox.
    1. Start Firefox.
    2. Go to the Report Builder logon page for the server whose certificate that you are adding: https://server_name:port/rs

      A message about an untrusted connection is displayed.

    3. Click Add Exception.
    4. Ensure that the Permanently store this exception checkbox is selected.
    5. Click Confirm Security Exception.
  2. Configure Firefox to display localized content.
    1. On the Firefox menu bar, click the Firefox menu, and then click Options.
    2. On the Content page, in the Languages section, click Choose.
    3. From the Select a language to add menu, select a language; then, click Add.
    4. Use the controls to move the new language to the beginning of the list.
    5. Click OK to control the menus for the options.
    Firefox now displays localized content.
  3. Close all instances of Firefox and restart it.

What to do next

Now you can access Report Builder reports on Jazz dashboards without receiving warning messages about invalid browser certificates.

Internet Explorer

Edit online

Procedure

  1. Import one of the following items into the certificate store.
    Option Description
    Import a .p12 file
    1. Start Internet Explorer.
    2. Ensure that the menu bar is displayed: Below the address field, right-click and verify that Menu Bar is selected.
    3. Click Tools > Internet Options.
    4. On the Content tab, click Certificates.
    5. Click Import.
    6. On the welcome page of the Certificate Import Wizard, click Next.
    7. Click Browse and select the .p12 file for the Report Builder; then, click Open > Next.
    8. Enter the password that you received with the .p12 file and click Next.
    9. Select Place all certificates in the following store.
    10. Click Browse and select Trusted Root Certificate Authorities.
    11. Click OK > Next > Finish; then click OK to close the other windows in the Certificate Import Wizard.
    Install a self-signed certificate
    1. Start Internet Explorer.
    2. Ensure that the menu bar is displayed: Below the address field, right-click and verify that Menu Bar is selected.
    3. Go to the Report Builder server login page: https://server_name:port/rs
    4. Ensure that the browser displays a message about a problem with this website security certificate. If you do not see this message and you see the login page, the browser certificate is already imported to the browser. You do not need to complete any additional steps.
    5. On the menu bar, click Tools > Internet Options.
    6. On the Security tab, click Trusted sitesSites.
    7. To add your server to the list of trusted sites, click Add; then, click Close > OK.
    8. In the browser, click Continue to this website (not recommended).
    9. On the Report Builder login page, click the red Certificate Error icon near the browser's address bar; then, click View certificates.
    10. Click Install Certificate, and then click Next.
    11. Click Place all certificates in the following store.
    12. Click Browse and select Trusted Root Certification Authorities.
    13. Click OK and finish the steps in the wizard.
    14. Click Yes if you are prompted to install a certificate claiming to represent the host that runs Report Builder.
    15. Click OK twice.
    16. Close all instances of Internet Explorer.
    17. Open a new instance of Internet Explorer, and in the address bar, enter https://server_name:port/rs and ensure that a certificate error message is not displayed. Also, ensure that a lock icon in the address bar to indicates that browser is using the HTTPS protocol.
  2. Set the compatibility mode to ensure that Internet Explorer does not switch to Internet Explorer 7 compatibility mode when you run reports.
    1. On the menu bar, click Tools > Compatibility View Settings.
    2. Clear all the check boxes on the Compatibility View Settings page, and then click Close.
  3. Configure the browser to display localized content.
    1. On the menu bar, click Tools > Internet Options.
    2. On the General page, click Languages, click Add and select your language; then, click OK.
    3. In the Language pane, select the language that you added, and use the controls to move it to the beginning of the list.
    4. Click OK twice.
    5. Change the system settings on your computer: Click Start > Control Panel.
    6. From the View by menu, select Small icons.
    7. Click Region and Language.
    8. On the Formats tab, from the Format menu, select your language.
    9. Click Apply.

    Internet Explorer now displays localized content.

  4. Close all instances of Internet Explorer and restart it.

What to do next

Now you can access Report Builder reports on Jazz dashboards without receiving warning messages about invalid browser certificates.

Chrome

Edit online

Procedure

  1. Chrome uses the Microsoft Windows certificate store. If you have already imported either the .p12 file or installed the self-certificate for Report Builder into Internet Explorer, you can proceed to step 2.
    Option Description
    Import a .p12 file
    1. Start Chrome.
    2. From the control menu, which is near the right of the address bar, click Settings > Show advanced settings.
    3. In the HTTPS/SSL section, click Manage Certificates.
    4. On the Trusted Root Certification Authorities tab, click Import > Next.
    5. Click Browse and select the .p12 file for the Report Builder; then, click Open > Next.
    6. Enter the password that you received with the .p12 file and click Next.
    7. Select Place all certificates in the following store.
    8. Click Browse and select Trusted Root Certificate Authorities.
    9. Click OK > Next > Finish; then click OK to close the other windows in the Certificate Import Wizard.
    Install a self-signed certificate
    1. Start Chrome.
    2. Go to the Report Builder server whose certificate that you are adding: https://server_name:port/rs
    3. In the address bar, right-click the red lock icon.
    4. On the Connection tab, click Certificate Information.
    5. On the Details tab, click Copy to File. The Certificate Export Wizard opens.
    6. Click Next.
    7. On the Export File Format page, select DER encoded binary X.509 (.CER); then, click Next.
    8. Click Browse and assign a descriptive name to this file.
    9. Click Next, and then click Finish. The Certificate Export Wizard closes.
    10. From the control menu, which is near the right of the address bar, click Settings > Show advanced settings.
    11. In the HTTPS/SSL section, click Manage Certificates.
    12. On the Trusted Root Certification Authorities tab, click Import > Next.
    13. On the File to Import page, click Browse and select the certificate file that you saved in step 1.h.
    14. Click Next.
    15. Select Place all certificates in the following store and ensure that the selected store is Trusted Root Certification Authorities. If necessary, click Browse and select that store.
    16. If a security warning is displayed, click Yes.
  2. If localized strings exist, configure the browser to display localized content.
    1. From the Chrome control menu, click Settings.
    2. Scroll and click Show advanced settings. If the link says Hide advanced settings, proceed to step d.
    3. In the Languages section, click Language and input settings.
    4. In the Languages window, click Add and select the language in which to display content; then, click OK.
    5. Click and drag that language to the beginning of the list.
    6. Optional: Click Done.
    7. To display localized dates, select the language that you added in step 2.d and click Display Google Chrome in this language.
      Note: If the locale is in the format locale-region and the region is not supported by the browser, the date-picker and the date format will be displayed according to the parent locale language. If the parent locale language is also not supported, then the date-picker will display in English and the date format will be mm/dd/yyyy. For example, if French (Canada) is not supported as a regional language, then the date-picker and the date format will be displayed in the parent locale language, which is French.
    8. Click Done and close the Settings page.
    Chrome now displays localized content.
  3. Close all instances of Chrome and restart it.

What to do next

Now you can access Report Builder reports on Jazz dashboards without receiving warning messages about invalid browser certificates.