cookbook 'pam', '~> 1.1.0'
pam (5) Versions 1.1.0 Follow2
Installs/Configures pam
cookbook 'pam', '~> 1.1.0', :supermarket
knife supermarket install pam
knife supermarket download pam
pam-cookbook
Manages PAM services in /etc/pam.d
Limitations
This cookbook will not set up PAM if you do not already have it installed. It will only modify an existing configuration.
Also, currently it only includes defaults for /etc/pam.d/su
on Debian systems.
If you want to override any other PAM services, or you are not on a Debian-based OS, you will first need to transcribe the entire service configuration into the appropriate node attibute, otherwise the PAM file will be overwritten with only the attributes you configure (and your system will become unusable).
Supported Platforms
This cookbook should work fine on Red Hat systems, however it has only been tested on Ubuntu 14.04 & 16.04.
Attributes
-
node['pam_d']['services']
- Example:
{ 'su' => { 'main' => { 'pam_env' => { 'interface' => 'session', 'control_flag' => 'required', 'name' => 'pam_env.so', 'args' => 'readenv=1', 'disabled' => false, 'priority' => 10, } }, 'includes' => %w( common-something ) } }
NOTE: pam_env
in this case is just a placeholder so that we can use a keyed hash instead of an array. disabled
is optional but if it is present and set to true, it will prevent the entry from showing up in the PAM service file.
Line ordering within the service can be achieved by setting the priority
key, lower numbers coming first. If priority
is unset, then it is considered to be 9999
and will be at the mercy of node attribute ordering.
Usage
pam::default
Include pam
in a recipe:
include_recipe 'pam'
Contributing
- Fork the repository on Github
- Create a named feature branch (i.e.
add-new-recipe
) - Write your change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request
License and Authors
Author:: EverTrue, Inc. devops@evertrue.com
Author:: Jeff Byrnes thejeffbyrnes@gmail.com
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
CHANGELOG
v1.1.0
- Add
pam_limits
for Debian systems to defaults (#4) - Add
priority
key to order modules within service (#6) - Refactor testing & clean up lint/style/syntax (#7)
v1.0.3
- Gracefully handle when no services are defined
v1.0.2
- Avoid requiring
includes
(#1) - Update Serverspec tests
- Clean up cookbook
v1.0.1
- First public release
v0.1.0
Initial release of pam
Collaborator Number Metric
1.1.0 failed this metric
Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.1.0 passed this metric
No Binaries Metric
1.1.0 passed this metric
Testing File Metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.1.0 failed this metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.1.0 passed this metric
No Binaries Metric
1.1.0 passed this metric
Testing File Metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.1.0 passed this metric
1.1.0 passed this metric
Testing File Metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.1.0 failed this metric
1.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number