{"id":15148740,"url":"https://github.com/bodgit/puppet-bsdauth","last_synced_at":"2025-04-07T04:29:04.529Z","repository":{"id":35839482,"uuid":"40122885","full_name":"bodgit/puppet-bsdauth","owner":"bodgit","description":"Puppet Module for managing BSD authentication","archived":false,"fork":false,"pushed_at":"2018-04-29T21:32:43.000Z","size":113,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-05-15T09:53:54.904Z","etag":null,"topics":["openbsd","puppet"],"latest_commit_sha":null,"homepage":"https://forge.puppet.com/bodgit/bsdauth","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bodgit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-03T12:13:02.000Z","updated_at":"2018-04-29T21:32:56.000Z","dependencies_parsed_at":"2022-09-14T21:41:28.597Z","dependency_job_id":null,"html_url":"https://github.com/bodgit/puppet-bsdauth","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-bsdauth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-bsdauth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-bsdauth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-bsdauth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bodgit","download_url":"https://codeload.github.com/bodgit/puppet-bsdauth/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247592687,"owners_count":20963556,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["openbsd","puppet"],"created_at":"2024-09-26T13:22:21.204Z","updated_at":"2025-04-07T04:29:04.501Z","avatar_url":"https://github.com/bodgit.png","language":"Ruby","readme":"# bsdauth\n\nTested with Travis CI\n\n[![Build Status](https://travis-ci.org/bodgit/puppet-bsdauth.svg?branch=master)](https://travis-ci.org/bodgit/puppet-bsdauth)\n[![Coverage Status](https://coveralls.io/repos/bodgit/puppet-bsdauth/badge.svg?branch=master\u0026service=github)](https://coveralls.io/github/bodgit/puppet-bsdauth?branch=master)\n[![Puppet Forge](http://img.shields.io/puppetforge/v/bodgit/bsdauth.svg)](https://forge.puppetlabs.com/bodgit/bsdauth)\n[![Dependency Status](https://gemnasium.com/bodgit/puppet-bsdauth.svg)](https://gemnasium.com/bodgit/puppet-bsdauth)\n\n#### Table of Contents\n\n1. [Description](#description)\n2. [Setup - The basics of getting started with bsdauth](#setup)\n    * [Beginning with bsdauth](#beginning-with-bsdauth)\n3. [Usage - Configuration options and additional functionality](#usage)\n4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n5. [Limitations - OS compatibility, etc.](#limitations)\n6. [Development - Guide for contributing to the module](#development)\n\n## Description\n\nThis module manages the BSD authentication framework primarily found on\nOpenBSD. It manages the `/etc/login.conf` configuration file containing all\nof the login classes and installs any packages required for additional login\nstyles.\n\nOpenBSD is supported using Puppet 4.4.0 or later.\n\n## Setup\n\n### Beginning with bsdauth\n\nTo maintain the default `/etc/login.conf` content and login classes, use the\nfollowing:\n\n```puppet\ninclude ::bsdauth\ninclude ::bsdauth::authpf\ninclude ::bsdauth::bgpd\ninclude ::bsdauth::pbuild\ninclude ::bsdauth::unbound\n```\n\n## Usage\n\nTo override the default login classes, (you then must manage all of them):\n\n```puppet\nclass { '::bsdauth':\n  classes =\u003e {\n    'auth-defaults' =\u003e {\n      'capabilities' =\u003e [\n        'auth=yubikey,passwd',\n      ],\n      'order'        =\u003e '01',\n    },\n    ...\n  },\n}\n```\n\nTo add an additional login class:\n\n```puppet\ninclude ::bsdauth\n::bsdauth::class { 'example':\n  capabilities =\u003e [\n    'auth=yubikey,passwd',\n    'tc=default',\n  ],\n}\n```\n\nTo enable LDAP login support:\n\n```puppet\ninclude ::bsdauth\ninclude ::bsdauth::ldap\n::bsdauth::ldap::class { 'ldap':\n  base_dn =\u003e 'dc=example,dc=com',\n  servers =\u003e [\n    {\n      'hostname' =\u003e '192.0.2.1',\n    },\n  ],\n}\n```\n\n## Reference\n\nThe reference documentation is generated with\n[puppet-strings](https://github.com/puppetlabs/puppet-strings) and the latest\nversion of the documentation is hosted at\n[https://bodgit.github.io/puppet-bsdauth/](https://bodgit.github.io/puppet-bsdauth/).\n\n## Limitations\n\nThis module has been built on and tested against Puppet 4.4.0 and higher.\n\nThe module has been tested on:\n\n* OpenBSD 6.2/6.3\n\n## Development\n\nThe module has both [rspec-puppet](http://rspec-puppet.com) and\n[beaker-rspec](https://github.com/puppetlabs/beaker-rspec) tests. Run them\nwith:\n\n```\n$ bundle exec rake test\n$ PUPPET_INSTALL_TYPE=agent PUPPET_INSTALL_VERSION=x.y.z bundle exec rake beaker:\u003cnodeset\u003e\n```\n\nPlease log issues or pull requests at\n[github](https://github.com/bodgit/puppet-bsdauth).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbodgit%2Fpuppet-bsdauth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbodgit%2Fpuppet-bsdauth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbodgit%2Fpuppet-bsdauth/lists"}