SSL setup¶

The smart proxy can work in SSL mode, where both sides verify and trust each other.

Configure SSL certificates¶

This request will only be accepted if the SSL certificates match. Therefore the client's private key grants access to proxy's funtionality, so protect it.

As this tool is meant to interoperate with a puppet installation I suggest that you use the Certificate Authority provided by a puppet server as your CA.

1. Login to your puppetmaster, which has a Certificate Authority
2. Use the puppet tools to create a new certificate
   

   
     puppetca --generate <proxy-FQDN>
   

3. Copy the certificate keys to your Windows host
   

   
       scp puppetmaster:/var/lib/puppet/ssl/ca/signed/<proxy-FQDN>.pem signed.pem
       scp puppetmaster:/var/lib/puppet/ssl/private_keys/<proxy-FQDN>.pem private.pem
   

4. Copy the ssl/certs/ca.pem from any puppet client to the smart-proxy\config directory. This ensures that the proxy trusts the same CA as a puppet client.

Troubleshooting¶

Unable to save
Unable to communicate with the proxy: No such file or directory - /.puppet/var/ssl/certs/foremanserver.domainname.corp.pem
Please check the proxy is configured and running on the host before saving.

Workaround
#. ln -s /var/lib/puppet/ var
#. add foreman, foreman-proxy to puppet group
#. chmod -R 640 /var/lib/puppet/ssl/private_keys
#. chgrp -R puppet /var/lib/puppet/ssl/private_keys