https://github.com/broadinstitute/puppet-qualys_agent

Puppet module for installing and configuring the Qualys Cloud Agent

https://github.com/broadinstitute/puppet-qualys_agent

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 8 committers (12.5%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.4%) to scientific vocabulary

Keywords from Contributors

projection interactive archival generic sequences observability autograding hacking shellcodes modular
Last synced: 10 months ago · JSON representation

Repository

Puppet module for installing and configuring the Qualys Cloud Agent

Basic Info
  • Host: GitHub
  • Owner: broadinstitute
  • License: bsd-3-clause
  • Language: Ruby
  • Default Branch: main
  • Size: 191 KB
Statistics
  • Stars: 3
  • Watchers: 21
  • Forks: 7
  • Open Issues: 2
  • Releases: 0
Created about 7 years ago · Last pushed 11 months ago
Metadata Files
Readme Changelog License Codeowners

README.md

qualys_agent

checks Puppet Forge Puppet Forge Puppet Forge License codecov

Table of Contents

  1. Overview
  2. Module Description
  3. Setup
  4. Usage
  5. Reference
  6. Limitations - OS compatibility, etc.
  7. Release Notes
  8. Contributors

Overview

Install and configure the Qualys Cloud Agent on a system.

Module Description

This module will install the Qualys Cloud Agent from a repository and keep the required configuration files updated.

Setup

Setup Requirements

Due to the nature of Qualys' distribution methods, making the actual package available in a repository is outside the scope of this module. In most cases, you can create your own custom Yum, Apt, etc. repository and serve out the qualys-cloud-agent package you can download from the Qualys interface.

Installation

No trailing slashes should be provided for any paths.

Puppet Forge

sh puppet module install broadinstitute-qualys_agent

Puppetfile

ruby mod 'broadinstitute/qualys_agent'

Usage

Puppet Manifest

puppet class { 'qualys_agent': activation_id => 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', customer_id => 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', }

With Hiera

```yaml

classes: - qualysagent qualysagent::activationid: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' qualysagent::customer_id: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' ```

Running as a user other than root

The configuration is a little tricky if you want to run as a non-root user. To do so, you need to set several options in the configuration together. An example is configured below:

yaml qualys_agent::activation_id: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' qualys_agent::agent_user: 'qualys_auth' qualys_agent::customer_id: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' qualys_agent::sudo_user: 'qualys_auth' qualys_agent::use_sudo: 1

This turns on the use of sudo, but it also sets the User and SudoUser variables in the configuration file, which are both necessary to make the service run as a non-root user.

Reference

REFERENCE.md (generated with Puppet Strings)

Limitations

This has currently only been tested extensively on RedHat-based systems.

Contributors

Owner

  • Name: Broad Institute
  • Login: broadinstitute
  • Kind: organization
  • Location: Cambridge, MA

Broad Institute of MIT and Harvard

GitHub Events

Total
  • Delete event: 12
  • Issue comment event: 3
  • Push event: 22
  • Pull request event: 24
  • Pull request review event: 13
  • Create event: 13
Last Year
  • Delete event: 12
  • Issue comment event: 3
  • Push event: 22
  • Pull request event: 24
  • Pull request review event: 13
  • Create event: 13

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 104
  • Total Committers: 8
  • Avg Commits per committer: 13.0
  • Development Distribution Score (DDS): 0.433
Past Year
  • Commits: 14
  • Committers: 3
  • Avg Commits per committer: 4.667
  • Development Distribution Score (DDS): 0.286
Top Committers
Name Email Commits
dependabot[bot] 4****] 59
coreone c****e 39
zschulte z****e@b****g 1
backstage-bits[bot] 1****] 1
Ralf Bosz r****f@b****m 1
Matthew Barnes 5****R 1
Gene Liverman g****e@t****s 1
circleci@localhost c****i@l****t 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 4
  • Total pull requests: 127
  • Average time to close issues: 7 months
  • Average time to close pull requests: 9 days
  • Total issue authors: 3
  • Total pull request authors: 9
  • Average comments per issue: 0.5
  • Average comments per pull request: 0.46
  • Merged pull requests: 95
  • Bot issues: 0
  • Bot pull requests: 91
Past Year
  • Issues: 1
  • Pull requests: 21
  • Average time to close issues: 15 minutes
  • Average time to close pull requests: 3 days
  • Issue authors: 1
  • Pull request authors: 4
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.29
  • Merged pull requests: 16
  • Bot issues: 0
  • Bot pull requests: 17
Top Authors
Issue Authors
  • coreone (2)
  • andrewt-bw (1)
  • hdep (1)
  • eglobal-it (1)
Pull Request Authors
  • dependabot[bot] (94)
  • coreone (33)
  • luisilva (2)
  • backstage-bits[bot] (2)
  • hdep (2)
  • genebean (1)
  • ralfbosz (1)
  • mbarnesBHR (1)
  • zschulte (1)
Top Labels
Issue Labels
Pull Request Labels
dependencies (94) maintenance (85) github_actions (53) enhancement (13) ruby (6) bugfix (5)

Packages

  • Total packages: 1
  • Total downloads:
    • puppet 8,141 total
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 5
forge.puppet.com: broadinstitute-qualys_agent

Install and configure the Qualys Cloud Agent

  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 8,141 Total
Rankings
Dependent repos count: 0.0%
Stargazers count: 11.2%
Forks count: 11.4%
Dependent packages count: 15.5%
Average: 22.1%
Downloads: 72.5%
Last synced: 11 months ago

Dependencies

.github/workflows/checks.yaml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • ruby/setup-ruby v1.133.1 composite
.github/workflows/deploy.yaml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • ruby/setup-ruby v1.133.1 composite
.github/workflows/test_deploy.yaml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • ruby/setup-ruby v1.133.1 composite
.devcontainer/Dockerfile docker
  • puppet/pdk latest build
Gemfile rubygems
  • codecov ~> 0.2 development
  • concurrent-ruby < 1.2.0 development
  • dependency_checker ~> 1.0.0 development
  • facterdb ~> 1.18 development
  • metadata-json-lint ~> 3.0 development
  • parallel_tests = 3.12.1 development
  • pdk ~> 3.0.0 development
  • pry ~> 0.10 development
  • puppet-debugger ~> 1.0 development
  • puppet-strings ~> 4.0 development
  • puppet_litmus ~> 1.0 development
  • puppetlabs_spec_helper ~> 6.0 development
  • rb-readline = 0.5.5 development
  • rspec-puppet-facts ~> 2.0 development
  • rubocop = 1.48.1 development
  • rubocop-performance = 1.16.0 development
  • rubocop-rspec = 2.19.0 development
  • serverspec ~> 2.41 development
  • simplecov-console ~> 0.5 development
  • voxpupuli-puppet-lint-plugins ~> 5.0 development