Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sous-chefs/htpasswd
Development repository for the htpasswd cookbook
https://github.com/sous-chefs/htpasswd
chef chef-cookbook chef-resource hacktoberfest htpasswd managed-by-terraform
Last synced: about 1 month ago
JSON representation
Development repository for the htpasswd cookbook
- Host: GitHub
- URL: https://github.com/sous-chefs/htpasswd
- Owner: sous-chefs
- License: apache-2.0
- Created: 2012-03-28T09:32:34.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2024-01-31T23:12:49.000Z (11 months ago)
- Last Synced: 2024-04-14T11:03:41.450Z (8 months ago)
- Topics: chef, chef-cookbook, chef-resource, hacktoberfest, htpasswd, managed-by-terraform
- Language: Ruby
- Homepage: https://supermarket.chef.io/cookbooks/htpasswd
- Size: 123 KB
- Stars: 15
- Watchers: 19
- Forks: 31
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# htpasswd Cookbook
[](https://supermarket.chef.io/cookbooks/htpasswd)
[](https://circleci.com/gh/sous-chefs/htpasswd)
[](#backers)
[](#sponsors)
[](https://opensource.org/licenses/Apache-2.0)
Manage users in htpasswd files.
## Maintainers
This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit [sous-chefs.org](https://sous-chefs.org/) or come chat with us on the Chef Community Slack in [#sous-chefs](https://chefcommunity.slack.com/messages/C2V7B88SF).
## Requirements
### Platforms
- CentOS 7+
- Debian 9+
- Ubuntu 16.04+ LTS
### Chef Infra
This cookbook requires Chef Infra >= 15.3.
## Resource/Provider
### htpasswd
### Actions
- :add: Add a login in a htpasswd file. Update and modify it if there is already one and create file if not found (default)
- :overwrite: Overwrite an htpasswd file (delete file and add user) NOTE: This action is _not_ idempotent.
- :delete: Delete a login in a htpasswd file.
### Parameters
- :file: Path of the htpasswd to manage
- :user: User to create
- :password: Password for the user
- :type: Password algorithm to use. Valid options are: "md5", "bcrypt", "sha1", "plaintext", or "crypt". Default is
"md5"
- :mode: File mode for the file. Default is `0640`.
### Example
```ruby
# add user "foo" with password "bar" to "/etc/nginx/htpassword" with the default md5 type.
htpasswd "/etc/nginx/htpassword" do
user "foo"
password "bar"
end
# add user "foo" with password "bar" using sha1 as the type.
htpasswd "/etc/nginx/htpassword" do
user "foo"
password "bar"
type "sha1"
end
# add user "foo" with encrypted password using plaintext as the type.
htpasswd "/etc/nginx/htpassword" do
user "foo"
password "$apr1$H5Z8CUB.$L3wyxUF1ZDd.oZFlTkJ4X."
type "plaintext"
end
```
## Contributors
This project exists thanks to all the people who [contribute.](https://opencollective.com/sous-chefs/contributors.svg?width=890&button=false)
### Backers
Thank you to all our backers!
### Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website.
