Watchtower TLS guide

The aim of this guide is to explain how to configure Watchtower server and Abiquo as client with TLS enabled.


Watchtower configuration

Properties

Property name

Description

Default

emmett.service.ssl

True if TLS is enabled

false

emmett.service.certfile

Path of the certificate to use

""

emmett.service.keyfile

Path of the key to use in PKCS8 syntax

""

emmett.service.keypassword

Passphrase that encrypts the key

""

Key format

The key should be stored in PKCS8 syntax. The command openssl can be used to convert the key:

openssl pkcs8 -v1 PBE-SHA1-3DES -topk8 \ 
-in /etc/pki/abiquo/monitoring-c7.key \
-out /etc/pki/abiquo/monitoring-c7.key.netty \
-passout pass:

Abiquo configuration

Properties

The properties below only applies if the value of the system property 'abiquo.rabbitmq.tls' is true.

Property name

Description

Default

abiquo.watchtower.tls

True if TLS is enabled.

False

abiquo.watchtower.tls.trustallcertificates

If true, abiquo will not enforce any server certificate authentication.

False

Possible configurations

Plain TCP

This is the default configuration with no SSL enabled. The default values match this configuration but you should ensure that 'abiquo.watchtower.tls' value is false.

Property name

Value

abiquo.watchtower.tls

false

Trust all certificates

In this configuration Abiquo will connect without validating the server certificate and without presenting any client certificates.

Property name

Value

abiquo.watchtower.tls

true

abiquo.watchtower.tls.trustallcertificates

true

Use trust manager to validate server certificates

In this configuration Abiquo will connect validating the server certificate and without presenting any client certificates.

Property name

Value

abiquo.watchtower.tls

true

abiquo.watchtower.tls.trustallcertificates

false

Apache Tomcat boot classpath configuration

As watchtower-emmett is a Netty HTTP2 service, Tomcat should be run with an APLN agent to negotiate the TLS connection. Read more about it in the Jetty documentation.
The APLN agent should be installed in the API and RS appliances. Tomcat boot parameters need to be modified accordingly:

-Xbootclasspath/p:/path/to/alpn-boot-8.1.7.v20160121.jar

The agent can be downloaded from the Jetty Maven repository

Copyright © 2006-2022, Abiquo Holdings SL. All rights reserved