tinyproxy

Table of Contents

1. Description
2. Setup - The basics of getting started with tinyproxy

• Setup requirements
• Beginning with tinyproxy

1. Usage - Configuration options and additional functionality

• Configuring tinyproxy
• Configuring modules from Hiera

1. Reference - An under-the-hood peek at what the module is doing and how

• Public Classes
• Private Classes
• Parameters

1. Limitations - OS compatibility, etc.
2. Development - Guide for contributing to the module

• Running tests
• Testing quickstart

Description

The tinyproxy module handles installing, configuring, and running tinyproxy.

Setup

Setup Requirements

The tinyproxy module requires the following puppet modules:

• puppetlabs-stdlib (>= 4.0.0 < 5.0.0)
• puppetlabs-apt (>= 2.0.0 < 3.0.0) (only Debian-based distributions)
• stahnma-epel (>= 1.0.0 < 2.0.0) (only RedHat-based distributions)

Beginning with tinyproxy

To install the tinyproxy with default parameters, declare the tinyproxy class.

include ::tinyproxy

Usage

Configuring tinyproxy

class { '::tinyproxy':
  use_epel       => true,
  package_ensure => 'installed',
  config_ensure  => 'file',
  service_ensure => 'running',
  service_enable => true,
}

Configuring modules from Hiera

---
tinyproxy::use_epel: true
tinyproxy::package_ensure: installed
tinyproxy::config_ensure: file
tinyproxy::service_ensure: running
tinyproxy::service_enable: true

Reference

Public Classes

• tinyproxy: Installs, configures, and runs tinyproxy.

Private Classes

• tinyproxy::install: Installs the tinyproxy package.
• tinyproxy::config: Configures tinyproxy.conf.
• tinyproxy::service: Manages service.

Parameters

Class: tinyproxy

• use_epel: Whether epel repository should be installed. Type is Boolean. Default: true.
• package_ensure: What state the tinyproxy package should be in. Type is String. Default: 'installed'.
• config_ensure: Whether the tinyproxy.conf should exist. Type is Enum['file', 'absent']. Default: 'file'.
• port:Specify the port which tinyproxy will listen on. Type is Integer. Default: 8888.
• listen: Allow you to bind to an interface. Type is Optional[String]. Default: undef.
• bind: Specify which interface will be used for outgoing connections. Type is Optional[String]. Default: undef.
• bind_same: Whether tinyproxy will bind the outgoing connection to the ip address of the incoming connection. Type is Optional[Boolean]. Default: undef.
• timeout: Specify a timeout of a connection. Type is Integer. Default: 600.
• error_files: Specify the HTML file to send when a given HTTP error occurs. Type is Optional[Hash[Integer, String]]. Default: undef.
• default_error_file: Specify the default Error HTML file. Type is String. Default: '/usr/share/tinyproxy/default.html'.
• stat_host: Specify the stat host. Type is Optional[String]. Default: undef.
• stat_file: Specify the HTML file for the stat host. Type is String. Default: '/usr/share/tinyproxy/stats.html'.
• log_file: Specify the log file. Type is Optional[String]. Default: '/var/log/tinyproxy/tinyproxy.log'.
• use_syslog: Whether tinyproxy uses syslog instead of a log file. This parameter and $log_file are mutually exclusive. Type is Boolean. Default: false.
• pid_file: Specify the pid file. Type is String. Default: '/var/run/tinyproxy/tinyproxy.pid'.
• use_xtinyproxy: Whether tinyproxy include the 'X-Tinyproxy' header. Type is Boolean. Default: false.
• default_upstreams: Specify a set of rules for deciding whether the default upstream proxie servers are to be used. Type is Optional[Array[String]]. Default: undef.
• upstreams: Specify a set of rules for deciding whether upstream proxie servers are to be used. Type is Optional[Hash[String, String]]. Default: undef.
• no_upstreams: Specify no upstream proxy for internal websites and unqualified hosts. Type is Optional[Array[String]]. Default: undef.
• max_clients: Specify maximum number of clients can be connected at the same time. Type is Integer. Default: 100.
• min_spare_servers: Specify the lower limit for the number of spare servers which should be available. Type is Integer. Default: 5.
• max_spare_servers: Specify the upper limit for the number of spare servers which should be available. Type is Integer. Default: 20.
• start_servers: Specify the number of servers to start initially. Type is Integer. Default: 10.
• max_requests_per_child: Specify the number of connections a thread will handle before it's killed. Type is Integer. Default: 0.
• allow: Specify authorization control which clients are allowed to access Tinyproxy. Type is Optional[String]. Default: '127.0.0.1'.
• deny: Specify authorization control which clients are denied to access Tinyproxy. Type is Optional[String]. Default: undef.
• add_headers: Specify additional headers. Type is Optional[Hash[String, String]]. Default: undef.
• via_proxy_name: Specify the "Via" header. Type is String. Default: 'tinyproxy'.
• disable_via_header: Whether tinyproxy disables the "Via" header. Type is Boolean. Default: false.
• filter: Specify the location of the filter file. Type is Optional[String]. Default: false.
• filter_urls: Whether filter is based on urls rather than domains. Type is Optional[Boolean]. Default: undef.
• filter_extended: Whether filter uses POSIX Extended regexp. Type is Optional[Boolean]. Default: undef.
• filter_case_sensitive: Whether filter uses case sensitive regexp. Type is Optional[Boolean]. Default: undef.
• filter_default_deny: Whether filter changes the default policy of the filtering system. Type is Optional[Boolean]. Default: undef.
• log_level: Set the logging level. Type is Enum['Critical', 'Error', 'Warning', 'Notice', 'Connect', 'Info']. Default: 'Info'.
• anonymous: Specify anonymous keywords. Type is Optional[Array[String]]. Default: undef.
• connect_ports: Specify a list of ports allowed by tinyproxy when the CONNECT method is used. Type is Optional[Array[Integer]]. Default: [443, 563].
• reverse_paths: Specify a mapping from the local path to remote URL. Type is Optional[Hash[String, String]]. Default: undef.
• reverse_only: Whether the normal(forward) proxy is turned off. Type is Optional[Boolean]. Default: undef.
• reverse_magic: Whether tinyproxy uses a cookie to track reverse proxy mappings. Type is Optional[Boolean]. Default: undef.
• reverse_baseurl: Specify URL that's used to access this reverse proxy. Type is Optional[String]. Default: undef.
• service_ensure: Whether a service should be running. Type is Enum['running', 'stopped']. Default: 'running'.
• service_enable: Whether a service should be enabled to start at boot. Type is Boolean. Default: true.

Limitations

This module has been tested on:

• RedHat Enterprise Linux 7
• CentOS 7
• Scientific Linux 7
• Debian 8
• Ubuntu 16.04

Development

Running tests

The tinyproxy module contains tests for both rspec-puppet (unit tests) and beaker-rspec (acceptance tests) to verify functionality. For detailed information on using these tools, please see their respective documentation.

Testing quickstart

• Unit tests:

$ bundle install
$ bundle exec rake test

• Acceptance tests using docker:

# List available beaker nodesets
$ bundle exec rake beaker_nodes
centos7
jessie
xenial

# Run beaker acceptance tests
$ BEAKER_set=centos7 bundle exec rake beaker

Release 0.1.6 (2017/03/08)

tinyupdate

Release 0.1.5 (2017/03/08)

Configure params #13

Release 0.1.4 (2017/03/04)

Configure ConnectPort #12

Release 0.1.3 (2017/03/02)

Hiera 5 and Add params #10

Release 0.1.2 (2017/02/27)

Fix service ensure attribute #11

Release 0.1.0 (2017/02/26)

Initial release.