{"id":15517607,"url":"https://github.com/bodgit/puppet-sasl","last_synced_at":"2025-04-23T03:52:09.557Z","repository":{"id":30702736,"uuid":"34258776","full_name":"bodgit/puppet-sasl","owner":"bodgit","description":"Puppet Module for managing Cyrus SASL","archived":false,"fork":false,"pushed_at":"2024-01-11T17:16:25.000Z","size":163,"stargazers_count":0,"open_issues_count":5,"forks_count":13,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-17T19:17:35.976Z","etag":null,"topics":["puppet","sasl","saslauthd"],"latest_commit_sha":null,"homepage":"https://forge.puppetlabs.com/bodgit/sasl","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-04-20T12:22:39.000Z","updated_at":"2023-09-08T16:56:55.000Z","dependencies_parsed_at":"2024-10-02T10:13:56.689Z","dependency_job_id":"8414a67b-790b-41dc-8b65-94041d3c53f2","html_url":"https://github.com/bodgit/puppet-sasl","commit_stats":{"total_commits":46,"total_committers":3,"mean_commits":"15.333333333333334","dds":0.04347826086956519,"last_synced_commit":"59133d95196807428902a6b25b2ea47a02e67e21"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-sasl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-sasl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-sasl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-sasl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bodgit","download_url":"https://codeload.github.com/bodgit/puppet-sasl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250366687,"owners_count":21418768,"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":["puppet","sasl","saslauthd"],"created_at":"2024-10-02T10:13:53.375Z","updated_at":"2025-04-23T03:52:09.540Z","avatar_url":"https://github.com/bodgit.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sasl\n\n[![Build Status](https://travis-ci.org/bodgit/puppet-sasl.svg?branch=master)](https://travis-ci.org/bodgit/puppet-sasl)\n[![Codecov](https://img.shields.io/codecov/c/github/bodgit/puppet-sasl)](https://codecov.io/gh/bodgit/puppet-sasl)\n[![Puppet Forge version](http://img.shields.io/puppetforge/v/bodgit/sasl)](https://forge.puppetlabs.com/bodgit/sasl)\n[![Puppet Forge downloads](https://img.shields.io/puppetforge/dt/bodgit/sasl)](https://forge.puppetlabs.com/bodgit/sasl)\n[![Puppet Forge - PDK version](https://img.shields.io/puppetforge/pdk-version/bodgit/sasl)](https://forge.puppetlabs.com/bodgit/sasl)\n\n#### Table of Contents\n\n1. [Description](#description)\n2. [Setup - The basics of getting started with sasl](#setup)\n    * [What sasl affects](#what-sasl-affects)\n    * [Beginning with sasl](#beginning-with-sasl)\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 Cyrus SASL.\n\n## Setup\n\n### What sasl affects\n\nThis module can install per-application SASL configuration, automatically\npulling in any additional packages to provide the required authentication\nmethods. It can also manage saslauthd if that is the chosen mechanism along\nwith its own configuration options.\n\n### Beginning with sasl\n\nIn the very simplest case, you can just include the following:\n\n```puppet\ninclude ::sasl\n```\n\n## Usage\n\nTo configure Postfix for `DIGEST-MD5` and `CRAM-MD5` authentication using the\nsasldb backend:\n\n```puppet\ninclude ::sasl\n\n::sasl::application { 'smtpd':\n  pwcheck_method =\u003e 'auxprop',\n  auxprop_plugin =\u003e 'sasldb',\n  mech_list      =\u003e ['digest-md5', 'cram-md5'],\n}\n```\n\nTo configure Postfix for `PLAIN` and `LOGIN` authentication using the saslauthd\nbackend which itself is using LDAP+STARTTLS:\n\n```puppet\ninclude ::sasl\n\nclass { '::sasl::authd':\n  mechanism           =\u003e 'ldap',\n  ldap_auth_method    =\u003e 'bind',\n  ldap_search_base    =\u003e 'ou=people,dc=example,dc=com',\n  ldap_servers        =\u003e ['ldap://ldap.example.com'],\n  ldap_start_tls      =\u003e true,\n  ldap_tls_cacert_dir =\u003e '/etc/pki/tls/certs',\n  ldap_tls_ciphers    =\u003e 'AES256',\n}\n\n::sasl::application { 'smtpd':\n  pwcheck_method =\u003e 'saslauthd',\n  mech_list      =\u003e ['plain', 'login'],\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-sasl/](https://bodgit.github.io/puppet-sasl/)\nand available also in the [REFERENCE.md](https://github.com/bodgit/puppet-sasl/blob/master/REFERENCE.md).\n\n## Limitations\n\nThis module has been built on and tested against Puppet 5 and higher.\n\nThe module has been tested on:\n\n* RedHat Enterprise Linux 6/7\n* Ubuntu 14.04/16.04\n* Debian 8\n\n## Development\n\nThe module relies on [PDK](https://puppet.com/docs/pdk/1.x/pdk.html) and has\nboth [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 spec\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-sasl).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbodgit%2Fpuppet-sasl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbodgit%2Fpuppet-sasl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbodgit%2Fpuppet-sasl/lists"}