{"id":22700222,"url":"https://github.com/simp/pupmod-simp-vsftpd","last_synced_at":"2025-07-30T14:07:34.867Z","repository":{"id":32298741,"uuid":"35873702","full_name":"simp/pupmod-simp-vsftpd","owner":"simp","description":"The SIMP vsftpd Puppet Module","archived":false,"fork":false,"pushed_at":"2024-09-16T18:53:43.000Z","size":358,"stargazers_count":2,"open_issues_count":2,"forks_count":16,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-06-04T05:07:13.838Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","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,"zenodo":null}},"created_at":"2015-05-19T09:49:44.000Z","updated_at":"2024-09-16T16:08:26.000Z","dependencies_parsed_at":"2022-09-26T20:31:13.235Z","dependency_job_id":"b88e99fe-bc30-43cc-b255-c7158c65dff6","html_url":"https://github.com/simp/pupmod-simp-vsftpd","commit_stats":{"total_commits":76,"total_committers":14,"mean_commits":5.428571428571429,"dds":0.5789473684210527,"last_synced_commit":"0e0e4899db33bb8bf62d4e37dd14de2d75279e72"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/simp/pupmod-simp-vsftpd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-vsftpd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-vsftpd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-vsftpd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-vsftpd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simp","download_url":"https://codeload.github.com/simp/pupmod-simp-vsftpd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simp%2Fpupmod-simp-vsftpd/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263047658,"owners_count":23405280,"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":[],"created_at":"2024-12-10T06:10:33.201Z","updated_at":"2025-07-01T23:03:23.077Z","avatar_url":"https://github.com/simp.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License](https://img.shields.io/:license-apache-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/73/badge)](https://bestpractices.coreinfrastructure.org/projects/73)\n[![Puppet Forge](https://img.shields.io/puppetforge/v/simp/vsftpd.svg)](https://forge.puppetlabs.com/simp/vsftpd)\n[![Puppet Forge Downloads](https://img.shields.io/puppetforge/dt/simp/vsftpd.svg)](https://forge.puppetlabs.com/simp/vsftpd)\n[![Build Status](https://travis-ci.org/simp/pupmod-simp-vsftpd.svg)](https://travis-ci.org/simp/pupmod-simp-vsftpd)\n\n#### Table of Contents\n\n\u003c!-- vim-markdown-toc GFM --\u003e\n\n* [Overview](#overview)\n* [This is a SIMP module](#this-is-a-simp-module)\n* [Module Description](#module-description)\n* [Usage](#usage)\n  * [A Basic Anonymous FTP Server](#a-basic-anonymous-ftp-server)\n  * [A TLS Protected FTP Server with Local Accounts](#a-tls-protected-ftp-server-with-local-accounts)\n* [Development](#development)\n  * [Acceptance tests](#acceptance-tests)\n\n\u003c!-- vim-markdown-toc --\u003e\n\n## Overview\n\nThis module manages [vsftpd](https://security.appspot.com/vsftpd.html) on\nsupported systems.\n\n## This is a SIMP module\n\nThis module is a component of the [System Integrity Management Platform](https://simp-project.com),\na compliance-management framework built on Puppet.\n\nIf you find any issues, they can be submitted to our [JIRA](https://simp-project.atlassian.net/).\n\nThis module is optimally designed for use within a larger SIMP ecosystem, but it can be used independently:\n* When included within the SIMP ecosystem, security compliance settings will be\n  managed from the Puppet server.\n* If used independently, all SIMP-managed security subsystems will be disabled by\n  default and must be explicitly opted into by administrators.  Please review\n  ``simp_options`` for details.\n\n## Module Description\n\nThis module can be used for the configuration of vsftpd and includes support for\nsetting up TLS protected servers.\n\n## Usage\n\n### A Basic Anonymous FTP Server\n\n```puppet\n# If you're not using the SIMP iptables module, you'll need to make sure the\n# PASV ports are accessiable using your preferred method.\n\nclass { 'vsftpd':\n  ssl_enable    =\u003e false,\n  pasv_min_port =\u003e 10000,\n  pasv_max_port =\u003e 20000\n}\n```\n\n### A TLS Protected FTP Server with Local Accounts\n\n```puppet\n# If you're not using the SIMP iptables module, you'll need to make sure the\n# PASV ports are accessiable using your preferred method.\n\n# If you decide not to use the SIMP PKI module, you'll need to manage the\n# certificate locations on the filesystem yourself using the options in\n# vsftpd::config\n\n# You may need to flip one or more SELinux booleans depending on your setup.\n# This really depends on your system so it cannot be automated cleanly.\n\nclass { 'vsftpd':\n  local_enable  =\u003e true,\n  ssl_enable    =\u003e true,\n  pasv_min_port =\u003e 10000,\n  pasv_max_port =\u003e 20000\n}\n```\n\n## Development\n\nPlease read our [Contribution Guide](https://simp.readthedocs.io/en/stable/contributors_guide/Contribution_Procedure.html)\n\n### Acceptance tests\n\nThis module includes [Beaker](https://github.com/puppetlabs/beaker) acceptance\ntests using the SIMP [Beaker Helpers](https://github.com/simp/rubygem-simp-beaker-helpers).\nBy default the tests use [Vagrant](https://www.vagrantup.com/) with\n[VirtualBox](https://www.virtualbox.org) as a back-end; Vagrant and VirtualBox\nmust both be installed to run these tests without modification. To execute the\ntests run the following:\n\n```shell\nbundle exec rake beaker:suites\n```\n\nSome environment variables may be useful:\n\n```shell\nBEAKER_debug=true\nBEAKER_provision=no\nBEAKER_destroy=no\nBEAKER_use_fixtures_dir_for_modules=yes\nBEAKER_fips=yes\n```\n\n* `BEAKER_debug`: show the commands being run on the STU and their output.\n* `BEAKER_destroy=no`: prevent the machine destruction after the tests finish so you can inspect the state.\n* `BEAKER_provision=no`: prevent the machine from being recreated. This can save a lot of time while you're writing the tests.\n* `BEAKER_use_fixtures_dir_for_modules=yes`: cause all module dependencies to be loaded from the `spec/fixtures/modules` directory, based on the contents of `.fixtures.yml`.  The contents of this directory are usually populated by `bundle exec rake spec_prep`.  This can be used to run acceptance tests to run on isolated networks.\n* `BEAKER_fips=yes`: enable FIPS-mode on the virtual instances. This can\n  take a very long time, because it must enable FIPS in the kernel\n  command-line, rebuild the initramfs, then reboot.\n\nPlease refer to the [SIMP Beaker Helpers documentation](https://github.com/simp/rubygem-simp-beaker-helpers/blob/master/README.md)\nfor more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimp%2Fpupmod-simp-vsftpd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimp%2Fpupmod-simp-vsftpd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimp%2Fpupmod-simp-vsftpd/lists"}