Skip to content
This repository has been archived by the owner on Sep 18, 2024. It is now read-only.

Latest commit

 

History

History
40 lines (30 loc) · 2.17 KB

README.md

File metadata and controls

40 lines (30 loc) · 2.17 KB

SSL Termination FQDN Proxy

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.
  • upstreams Space separated list with upstreams. Example: localhost:8080.

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.