All applications which run on HTTPS via the web require a Security Certificate, or Public Key Certificate. This is used to validate that the data is coming from a trusted source. The security certificate bundled with the Jazz Team Server and ELM applications is signed to localhost. As soon as the application is accessed with a URL other than localhost (for example, hostname or IP address), the browser will present the following errors:
The security certificate presented by this website was not issued by a trusted certificate authority.
The security certificate presented by this website was issued for a different website's address.
These errors occur because:
The security certificate was self-signed, meaning that the server being accessed created the certificate, and
The security certificate was created for localhost, and you are accessing the server using a different hostname, IP address or the appropriate Public URI.
In order to resolve these errors, you can:
Purchase a certificate from a well-known trusted Certificate Authority and install it.
If you do not need encryption, configure the server for HTTP rather than HTTPS access.
Configure the browser to ignore or accept this invalid certificate
In this article we will provide a guide on how to configure CA Certificate purchased from well-known Authority or internal CA certificate.
Using IKEYMAN (Graphical User Interface)
Create Keystore (Optional, if existing keystore is not used)
Open ikeyman.exe, Key Database File -> New
Select any Type
Provide File name and path to the file
Update server.xml (Only for Liberty) to point to new key store (Optional, only if new keystore is created)
Update server.xml located at JazzTeamServer\server\liberty\servers\clm to point to new database file, type and password
If type Selected while creating keystore is pk12 Type will be PKCS12, for jks Type will be JKCS
Restart the server for changes to take effect
Create Self-Signed Certificate
Open ikeyman (GUI) utility located at JazzTeamServer\server\jre\bin
Key Database File -> Open -> Browser to keystore file, enter password to open the file
Click Create -> New Self Signed Certificate and fill the required details
Restart server for changes to take effect
Configure CA Certificate
Generate certificate Request
Open the Keystore database file using ikeyman
Click Create -> New Certificate request and fill the necessary details
Send the certificate request generated to CA authority
Receive Certificate and Add it to Keystore
Open the Keystore database file using ikeyman
Click Receive -> Browse to the certificate received
Using IKEYCMD CLI
Installation Paths for each component will be:
For CLM Liberty use ikeycmd
JazzTeamServerInstall\server\jre\bin
IBM HTTP Server use gskcmd
IHSinstall_root\bin
Create Keystore (Optional, if existing keystore is not used)