ssl termination fqdn #1

Description

Client which forms a bridge between a webservice and the proxy, to allow service-specific configuration


SSL Termination FQDN

This charm installs a subordinate for the SSL Termination Proxy.
It requests ssl-termination for a webservice.

Configs

It has 3 config values:

  • fqdns is a space separated list of domain names on which the webservice should be accessable. Note: make sure to point the DNS records of these domain names to the ssl-termination-proxy. Example: "example.com www.example.com".
  • credentials is a space-separated pair of username and password for basic authentication.
  • contact-email is the contact email address for lets encrypt. This email address will receive notifications when the certificate expires. Note that the ssl-termination-proxy automatically renews certificates after 2 months so you will only get an email when something is broken.

How to use

See the ssl-termination-proxy charm for more info on how to use this.

# Deploy your http webservice.
juju deploy jenkins
# Deploy your ssl-termination-fqdn
juju deploy cs:~tengu-team/ssl-termination-fqdn fqdn-jenkins
# Configure the client
juju config fqdn-jenkins fqdns="example.com www.example.com"
juju config fqdn-jenkins basic_auth="username password"
# Connect the webservice with the ssl client
juju add-relation jenkins fqdn-jenkins
# Connect the ssl-client with the proxy.
juju add-relation fqdn-jenkins:ssltermination ssl-termination-proxy:ssltermination
# Now you can surf to https://example.com and you wil reach the webservice.

Authors

This software was created in the IDLab research group of Ghent University in Belgium. This software is used in Tengu, a project that aims to make experimenting with data frameworks and tools as easy as possible.

Configuration

credentials
(string) Space-separated username and password for basic authentication.
fqdns
(string) Space-separated list of domain names. These will share the same certificate.
contact-email
(string) Contact email for Let's Encrypt