- Description
- Setup - The basics of getting started with cntlm
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
The cntlm module installs, configures, and manages the cntlm service across a range of Linux distributions.
If you intend to use this module to install cntlm, please ensure any optional repositories containing cntlm have been enabled. For example, on Red Hat and its derivatives EPEL must be enabled.
To install and configure cntlm with some basic settings:
class { 'cntlm':
cntlm_username => 'test_user',
cntlm_domain => 'test_domain',
cntlm_password => 'test_password',
cntlm_proxy => ['localhost:8080'],
}
All cntlm settings are configurable via cntlm_<lowercase_param_name>.
- cntlm: Main class, contains all other classes.
- cntlm::install: Handles the packages.
- cntlm::config: Handles the configuration file.
- cntlm::service: Handles the service.
For more information about this module's parameters, generate the puppet strings documentation using puppet strings
and view doc/puppet_classes/cntlm.html
This module has only been tested on CentOS 7, Debian Stretch and Ubuntu Xenial. Support for other platforms is possible by overriding default configuration values.
Pre-hashed passwords must be supplied to the module's hashed password parameters. The module does not perform automatic hashing of cleartext passwords.
Contributions are encouraged, please open a pull request for all proposed changes, and ensure Puppet best practices are maintained.