94 lines
3.1 KiB
Markdown
94 lines
3.1 KiB
Markdown
sudo_rules Cookbook
|
|
===================
|
|
Reads through a special data bag of sudo rules to compile a list of sudoers.d rules to create/remove.
|
|
|
|
Requirements
|
|
------------
|
|
#### packages
|
|
- sudo
|
|
|
|
Attributes
|
|
----------
|
|
|
|
#### sudo_rules::default
|
|
|
|
Key | Type | Description | Default
|
|
-------------------------------- | ------ | ---------------------------------------------------------- | ----------
|
|
`['sudo_rules']['data_bag']` | String | Name of data bag to use for entries. | sudo_rules
|
|
`['sudo_rules']['search_query']` | String | Custom search query for matching instead of just host:fqdn | None
|
|
|
|
#### data bag
|
|
|
|
Key | Type | Description | Default | Required?
|
|
---------- | ------ | ------------------------------------------------------------------------------------ | ---------- | ---------
|
|
`id` | String | Name of Data Bag item, and sudoers.d/Id filename. | None | Yes
|
|
`name` | String | Instead of using Id, you can choose the name of the file for sudoers.d/Name instead. | Same as Id | No
|
|
`hosts` | Array | List of hosts to apply this rule to by fqdn, can be wildcard matched. | [] | Yes
|
|
`action` | String | `create` or `remove` Sets whether to create or remove the entry. | `create` | No
|
|
`user` | String | Username or %Groupname to use for the sudo rule. | None | Yes
|
|
`runas` | String | Allowed colon-separated list of users for sudoers runas. | `ALL` | No
|
|
`commands` | Array | List of commands (and arguments) this rule adds for the user/group. | [] | Yes
|
|
`defaults` | Array | List of defaults this user has. | [] | No
|
|
|
|
Usage
|
|
-----
|
|
#### sudo_rules::default
|
|
|
|
Include `sudo_rules` in your node's `run_list`:
|
|
|
|
```json
|
|
{
|
|
"name":"my_node",
|
|
"run_list": [
|
|
"recipe[sudo_rules]"
|
|
]
|
|
}
|
|
```
|
|
|
|
And provide properly formatted data bag:
|
|
|
|
```json
|
|
{
|
|
"id": "Data Bag unique name, default value for name below",
|
|
"name": "Name of the sudoers.d file",
|
|
"hosts": [
|
|
"fqdn1",
|
|
"fqdn2",
|
|
...
|
|
],
|
|
"action": "create",
|
|
"user": "someuser",
|
|
"runas": "ALL",
|
|
"commands": [
|
|
"/usr/sbin/somecommand args",
|
|
"/usr/sbin/anothercommand",
|
|
...
|
|
],
|
|
"defaults": [
|
|
"env_reset"
|
|
]
|
|
}
|
|
```
|
|
|
|
Contributing
|
|
------------
|
|
1. Fork the repository on Github.
|
|
2. Switch to the develop branch.
|
|
3. Create a named feature branch off develop (like `githubusername/feature/add_component_x`).
|
|
4. Write your change.
|
|
5. Update documentation if appropriate.
|
|
6. Write tests for your change (if applicable).
|
|
7. Run the tests, ensuring they all pass.
|
|
8. Submit a Pull Request using Github to develop branch.
|
|
|
|
or
|
|
|
|
1. Report issue on Github
|
|
|
|
License and Authors
|
|
-------------------
|
|
- Authors:
|
|
- Eric Renfro <erenfro@linux-help.org>
|
|
- Contributors:
|
|
- Pieter Vogelaar
|
|
|