FAQ
SSL
Enable SSL (HTTPS) for Artifactory

Read the instructions below if you have installed Artifactory with Myst and want to setup HTTPS (SSL).

Prerequisites

JKS keystore (example here uses the keystore filename identity.jks)
SSL server certificate in JKS keystore (example here uses the certificate alias artifactory)

Update Myst docker-compose Files

Expose the SSL Port in docker-compose.yml

Port 8443 is exposed to you as SSL. Use this port to access Artifactory. Don't forget the 's' on https. For example: https://artifactory.mystsoftware.com:8443

Update the /opt/myst-studio/conf/maven/docker-compose.yml to include '- 8084:8443'. Indentation is important.

version: '2'
services:
repo:
 image: maven-repository
 container_name: maven-repository
 ports:
  - 8083:8081
  - 8084:8443
 environment:
  - START_TMO=600
 restart: unless-stopped
web:
 links:
  - repo
ci:
 links:
  - repo

Enable Artifactory SSL

Copy Keystore to Artifactory and Enable SSL in Tomcat

Copy your keystore into the Artifactory Docker container.

docker exec -ti maven-repository /bin/sh -c 'mkdir -p /opt/jfrog/artifactory/data/keystore'
docker cp identity.jks maven-repository:/opt/jfrog/artifactory/data/keystore/

Update Tomcat server.xml to enable the SSL port. ```shell
Backup server.xml
docker exec -ti maven-repository /bin/sh -c 'cd /opt/jfrog/artifactory/tomcat/conf/ && cp -p server.xml server.xml.org' docker cp identity.jks maven-repository:/opt/jfrog/artifactory/data/keystore/

Replace server.xml with the contents below which includes SSL

docker exec -ti maven-repository /bin/sh -c 'cat > /opt/jfrog/artifactory/tomcat/conf/server.xml <<EOF

EOF '


# Update Jenkins settings.xml

The Maven `settings.xml` used by Jenkins' job to build artifacts should be updated to use the new HTTPS URL.

```shell
# Create Backup
docker exec -ti maven-repository /bin/sh -c 'cd /var/jenkins_home/ && cp -p settings.xml settings.xml.bak'

# Update settings.xml
docker exec -ti maven-repository /bin/sh -c 'cat > /var/jenkins_home/settings.xml <<EOF

<?xml version="1.0" encoding="UTF-8"?>
<settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <profiles>
    <profile>
      <repositories>
        <repository>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
          <id>central</id>
          <name>libs-release</name>
          <url>https://maven-repository:8443/artifactory/libs-release</url>
        </repository>
        <repository>
          <snapshots />
          <id>snapshots</id>
          <name>libs-snapshot</name>
          <url>https://maven-repository:8443/artifactory/libs-snapshot</url>
        </repository>
        <repository>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
          <id>ext-release</id>
          <name>ext-release-local</name>
          <url>https://maven-repository:8443/artifactory/ext-release-local</url>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
          <id>central</id>
          <name>plugins-release</name>
          <url>https://maven-repository:8443/artifactory/plugins-release</url>
        </pluginRepository>
        <pluginRepository>
          <snapshots />
          <id>snapshots</id>
          <name>plugins-snapshot</name>
          <url>https://maven-repository:8443/artifactory/plugins-snapshot</url>
        </pluginRepository>
      </pluginRepositories>
      <id>artifactory</id>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>artifactory</activeProfile>
  </activeProfiles>
  <servers>
    <server>
      <username>admin</username>
      <password>password</password>
      <id>central</id>
    </server>
    <server>
      <username>admin</username>
      <password>password</password>
      <id>snapshots</id>
    </server>
    <server>
      <username>admin</username>
      <password>password</password>
      <id>ext-release</id>
    </server>
  </servers>

EOF

Update Myst Continuous Delivery Profile

Update the Repository URL and the Custom Maven Settings File with your new HTTPS URL.

Add Trusted Certificates to Clients

The server's public certificate needs to be added to clients' truststores for a successful SSL handshake. In the Myst ecosystem truststores need to be updated on:

Jenkins -> Artifactory
- build jobs uploading artifacts to Artifactory
Maven -> Artifactory
- mvn commands executed by Myst to download artifacts for FMW deployment

Jenkins Truststore

If the Jenkins SSL Truststore has not yet been setup as part of Enable SSL (HTTPS) for Jenkins then follow the instructions there.

Maven Truststore

There are many options to add the arguments to Maven. Maven documentation has information. Here are three options.

Option 1 - Java cacerts

Go to each Linux host and import the Myst certifcate into $JAVA_HOME/jre/lib/security/cacerts

Option 2 - .mavenrc

On each AdminServer $HOME/.mavenrc

MAVEN_OPTS="$MAVEN_OPTS -Djavax.net.ssl.trustStore=/location/of/truststore/truststore.jks"

Option 3 - Environment Variable

Similar to Option 2, you can define an environment variable for the SSH user in .bashrc or .bash_profile.

export MAVEN_OPTS="$MAVEN_OPTS -Djavax.net.ssl.trustStore=/location/of/truststore/truststore.jks"

(Optional) Disable HTTP - non-SSL

To disable the Artifactory Docker container's HTTP (non-SSL) port, comment out the port from the conf/ci/docker-compose-base.yml file.

ports:
 #- 8083:8081
 - 8084:8443

Restart the docker containers via Myst

cd /opt/myst-studio/bin
./stop.sh
./start.sh

Enable SSL (HTTPS) for Artifactory