Win-STunnel

This project helps you install and set up stunnel on Windows.

Role Variables

You can use the following settings to configure stunnel. If a setting needs to be "yes" or "no", use strings instead of YAML's boolean values.

• stunnel_global_options: A list of global options for stunnel.conf. The default is {}, meaning no global options are set.
• stunnel_services: A list of services to configure in stunnel.conf. Each service should have its options and values in a dictionary. The default is {}, so you'll need to define at least one service.

For more advanced setups, you can use these variables:

• stunnel_conf_template: Use a different template for configuring stunnel. The default is "stunnel.conf.j2", which uses the above-defined options.
• stunnel_download_url: Set an alternate URL to download the stunnel installer; the default URL is "https://www.stunnel.org/downloads/stunnel-5.41-win32-installer.exe".
• stunnel_force_install: Force the installation of stunnel even if it's already installed according to registry keys; the default is false.

Example Playbook

The example below shows how to install stunnel and set up a service to forward local unencrypted SMTP connections on port 2525 to smtp.gmail.com port 465:

- hosts: windows
  roles:
    - role: cchurch.win-stunnel
      stunnel_services:
        'gmail-smtp':
          client: 'yes'
          accept: 2525
          connect: smtp.gmail.com:465
          delay: 'yes'

License

BSD

Author Information

Chris Church chris@ninemoreminutes.com