TLS Certificates

Copy these TLS parameters to/var/opt/jfrog/postgres/data/postgresql.conf.

ssl = on
ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL'
ssl_prefer_server_ciphers = on
ssl_cert_file = '/full/path/to/postgres/certificates/server.crt'
ssl_key_file = '/full/path/to/postgres/certificates/server.key'
ssl_ca_file = '/full/path/to/postgres/certificates/server_ca.crt'

Verify that the certificates have the correct permissions.

chown postgres /full/path/to/postgres/certificates/* && \
chgrp postgres /full/path/to/postgres/certificates/* && \
chmod 600 /full/path/to/postgres/certificates/*

Change the connection string in the / var/opt/jfrog/xray/var/etc/system.yaml file.

postgres://xray:xray@postgres:5432/xraydb?sslrootcert=/full/path/to/xray/certificates/ca_certificate.crt&sslkey=/full/path/to/xray/certificates/client.key&sslcert=/full/path/to/xray/certificates/client.crt&sslmode=verify-ca

Make sure you have an Xray user and group.

groupadd -g 1035 xray && \
adduser xray --uid 1035 --gid 1035

Assign permissions to the certificates.

chown xray /full/path/to/xray/certificates/* && \
chgrp xray /full/path/to/xray/certificates/* && \
chmod 600 /full/path/to/xray/certificates/*

Restartall the Xray services.

bash /opt/jfrog/xray/scripts/xray.sh restart all

Generate certificates for RabbitMQ and Xray.

1. Create Certificate Authority (CA) files.

   #Creates ca-key.pem and ca.csr CA files. These are self-signed.
   openssl req -new -nodes -text -out ca.csr -keyout ca-key.pem -subj "/CN=certificate-authority"
   
   

2. Sign the CA private key, ca-key.pem, and create the related CA certificate.

   openssl x509 -req -in ca.csr -text -extfile /etc/ssl/openssl.cnf -extensions v3_ca -signkey ca-key.pem -out ca-cert.pem

3. Create the RabbitMQ private key (server-key.pem) and certificate signing request file(server.csr).

   openssl req -new -nodes -text -out server.csr -keyout server-key.pem -subj "/CN=rabbitmq"

4. Create a signed RabbitMQ public key (server-cert.pem).

   openssl x509 -req -in server.csr -text -CA ca-cert.pem -CAkey ca-key.pem -CAcreateserial -out server-cert.pem

5. Create Xray client key (client-key.pem) and certificate signing request file (client.csr).

   openssl req -new -nodes -text -out client.csr -keyout client-key.pem -subj "/CN=rabbitmq"

6. Create Xray client certificate file.

   openssl x509 -req -in client.csr -text -CA ca-cert.pem -CAkey ca-key.pem -CAcreateserial -out client-cert.pem

Create the certs directories under $JFROG_HOME/xray/var/data/server and$JFROG_HOME/xray/var/data/rabbitmq.

mkdir $JFROG_HOME/xray/var/data/server/certs

mkdir $JFROG_HOME/xray/var/data/rabbitmq/certs

Copy the ca and server certificates to $JFROG_HOME/xray/var/data/rabbitmq/certs and $JFROG_HOME/xray/var/data/server/certs respectively.

Docker Compose

ls -ltr <mounted directory>/xray/var/data/server/certs/
total 3
-rw-r--r-- 1 xray xray 1127 Oct 11 15:55 ca-cert.pem
-rw-r--r-- 1 xray xray  993 Oct 11 15:55 client-cert.pem
-rw-r--r-- 1 xray xray 1704 Oct 11 15:55 client-key.pem

RPM / DEB

ls -ltr /opt/jfrog/xray/var/data/server/certs/
total 3
-rw-r--r-- 1 xray xray 1127 Oct 11 15:55 ca-cert.pem
-rw-r--r-- 1 xray xray  993 Oct 11 15:55 client-cert.pem
-rw-r--r-- 1 xray xray 1704 Oct 11 15:55 client-key.pem

Linux Archive

ls -ltr JFROG_HOME/xray/var/data/server/certs/
total 3
-rw-r--r-- 1 xray xray 1127 Oct 11 15:55 ca-cert.pem
-rw-r--r-- 1 xray xray  993 Oct 11 15:55 client-cert.pem
-rw-r--r-- 1 xray xray 1704 Oct 11 15:55 client-key.pem

cp ca-cert.pem server-cert.pem server-key.pem $JFROG_HOME/xray/var/data/rabbitmq/certs

cp ca-cert.pem client-cert.pem client-key.pem $JFROG_HOME/xray/var/data/server/certs

volumes:
      - /etc/localtime:/etc/localtime:ro
      - "${ROOT_DATA_DIR}/var:/var/opt/jfrog/xray"
      - /opt/jfrog/xray/app/third-party/rabbitmq/rabbitmq-root-ca.crt:/etc/ssl/certs/ca-certificates.crt

# cp rabbitmq-root-ca.crt /usr/local/share/ca-certificates/
# update-ca-certificates
Updating certificates in /etc/ssl/certs...
1 added, 0 removed; done.
Running hooks in /etc/ca-certificates/update.d...Adding debian:rabbitmq-root-ca.pem
done.
done.

# cp rabbitmq-root-ca.crt /etc/pki/ca-trust/source/anchors/
# update-ca-trust

# openssl verify -verbose /opt/jfrog/xray/var/data/server/certs/rabbitmq-client.crt
/opt/jfrog/xray/var/data/server/certs/rabbitmq-client.crt: OK

# openssl verify -verbose /opt/jfrog/xray/var/data/rabbitmq/certs/rabbitmq-server.crt
/opt/jfrog/xray/var/data/rabbitmq/certs/rabbitmq-server.crt: OK
Otherwise we will get the error

# openssl verify -verbose /opt/jfrog/xray/var/data/server/certs/rabbitmq-client.crt
/opt/jfrog/xray/var/data/server/certs/rabbitmq-client.crt: CN = rabbitmq
error 20 at 0 depth lookup:unable to get local issuer certificate

# openssl verify -verbose /opt/jfrog/xray/var/data/rabbitmq/certs/rabbitmq-server.crt
/opt/jfrog/xray/var/data/rabbitmq/certs/rabbitmq-server.crt: CN = rabbitmq
error 20 at 0 depth lookup:unable to get local issuer certificate

Modify the certificate permissions for the RabbitMQ user.

Docker Compose

chown -R 999:999 <mounted directory>/xray/var/data/rabbitmq/certs

DEB / RPM

chown -R xray:xray /opt/jfrog/xray/var/data/rabbitmq/certs

Linux Archive

## default user and group is xray:xray
chown -R <xray user>:<xray group> JFROG_HOME/xray/var/data/rabbitmq/certs

Modify the certificate permissions for the Xray user.

Docker Compose

chown -R 1035:1035 <mounted directory>/xray/var/data/server/certs

RPM / DEB

chown -R xray:xray /opt/jfrog/xray/var/data/server/certs/

Linux Archive

## default user and group is xray:xray
chown -R <xray user>:<xray group> JFROG_HOME/xray/var/data/server/certs/

Modify /opt/jfrog/xray/var/etc/system.yaml (under the shared folder) according to your configuration. Do not overwrite existing lines in the file

shared:
    rabbitMq:
        url: amqps://guest:<rabbitmq-password>@rabbitmq:5671
        autoStop: true
            ## By default RabbitMQ will always be running; "autoStop" will make sure that RabbitMQ stops along with the Xray service
            ## This is applicable only to non-Docker Compose installers
        node:
            rabbitmqConf:
                - name: ssl_options.cacertfile
                  value: /var/opt/jfrog/xray/data/rabbitmq/certs/ca-cert.pem
                - name: ssl_options.certfile
                  value: /var/opt/jfrog/xray/data/rabbitmq/certs/server-cert.pem
                - name: ssl_options.keyfile
                  value: /var/opt/jfrog/xray/data/rabbitmq/certs/server-key.pem
                - name: ssl_options.verify
                  value: verify_peer
                - name: ssl_options.fail_if_no_peer_cert
                  value: false
                - name: management.listener.ssl
                  value: true
                - name: listeners.ssl.default
                  value: 5671
    clientCaCertFilePath: "/var/opt/jfrog/xray/data/server/certs/ca-cert.pem"
    clientCertFilePath: "/var/opt/jfrog/xray/data/server/certs/client-cert.pem"
    clientCertKeyFilePath: "/var/opt/jfrog/xray/data/server/certs/client-key.pem"

Replace <rabbitmq-password> with your own RabbitMQ password. If you use a different user in RabbitMQ, replace the guest user with your own user in the shared.rabbitMq.url value.

Create a JSON file with the following content to enable the TLS connection to RabbitMQ in Xray using the REST API.Xray REST APIs

{

    "sslInsecure": false,

    "maxDiskDataUsage": 80,

    "monitorSamplingInterval": 300,

    "mailNoSsl": false,

    "messageMaxTTL": 7,

    "jobInterval": 86400,

    "allowSendingAnalytics": true,

    "httpsPort": 443,

    "enableTlsConnectionToRabbitMQ": true,

    "httpClientMaxConnections": 50,

    "httpClientMaxIdleConnections": 20,

    "jsFilesBatch": 20

}

Run the REST API call using the JSON file you created in the previous step to enable the TLS connection to RabbitMQ in Xray.Xray REST APIs

curl -u<username>:<password> -d @<your_json_file>.json -H "Content-Type: application/json" -X PUT http://<artifactory_url>/xray/api/v1/configuration/systemParameters

Replace <username> and <password> with an admin user and password credentials for Artifactory, the <your_json_file>.json with the name of the JSON file you created in the previous step and the <artifactory_url> with the actual Artifactory URL address.

Run the following steps to enable the TLS connection to RabbitMQ in Xray if you use Docker Compose.

Docker Compose

cd  <path to extracted compose directory>/jfrog-xray-<version>-compose/

## Export the TLS port in the docker-compose-rabbitmq.yaml (docker-compose.yaml for older versions of 3.x) and add under services -> rabbitmq -> ports.
- 5671:5671

# Restart RabbitMQ services
docker-compose -p xray-rabbitmq -f docker-compose-rabbitmq.yaml down
docker-compose -p xray-rabbitmq -f docker-compose-rabbitmq.yaml up -d

Restart Xray services.

Docker Compose

docker-compose -p xray -f docker-compose.yaml down
docker-compose -p xray -f docker-compose.yaml up -d

RPM / DEB

systemctl stop xray.service
systemctl start xray.service

## For Centos 6 and RHEL 6
# service xray stop
# service xray start 

Linux Archive

/opt/jfrog/xray/bin/xray.sh stop
/opt/jfrog/xray/bin/xray.sh start 

After Xray services are up and running, you can verify if RabbitMQ is accessible through https://<xray-ipaddress-or-hostname>:15672.

To overcome this issue, you will need to import the Proxy certificate into each Xray instance/pod by placing it under the following path within the Xray machine/container/pods:/etc/ssl/certs/.

Next, you will need to restart Xray.

The path shown above is the default directory used by Go applications (such as Xray) when importing SSL certificates.