{"id":21081315,"url":"https://github.com/104ru/crowdstrike","last_synced_at":"2025-05-16T08:32:47.695Z","repository":{"id":40787433,"uuid":"346904297","full_name":"104ru/crowdstrike","owner":"104ru","description":"Puppet module to deploy and manage CrowdStrike agent","archived":false,"fork":false,"pushed_at":"2024-02-28T21:06:51.000Z","size":42,"stargazers_count":1,"open_issues_count":0,"forks_count":11,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-24T17:22:42.895Z","etag":null,"topics":["crowdstrike","puppet"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/104ru.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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}},"created_at":"2021-03-12T02:08:54.000Z","updated_at":"2022-01-08T05:31:02.000Z","dependencies_parsed_at":"2024-02-26T22:37:18.842Z","dependency_job_id":null,"html_url":"https://github.com/104ru/crowdstrike","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/104ru%2Fcrowdstrike","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/104ru%2Fcrowdstrike/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/104ru%2Fcrowdstrike/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/104ru%2Fcrowdstrike/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/104ru","download_url":"https://codeload.github.com/104ru/crowdstrike/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254496367,"owners_count":22080698,"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":["crowdstrike","puppet"],"created_at":"2024-11-19T20:08:16.965Z","updated_at":"2025-05-16T08:32:42.688Z","avatar_url":"https://github.com/104ru.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/104ru/crowdstrike/workflows/CI/badge.svg)](https://github.com/104ru/crowdstrike/actions?query=workflow%3ACI)\n[![Puppet Forge](https://img.shields.io/puppetforge/v/ruthenium/crowdstrike.svg)](https://forge.puppet.com/modules/ruthenium/crowdstrike)\n[![Puppet Forge -- Downloads](https://shields.io/puppetforge/dt/ruthenium/crowdstrike)](https://forge.puppet.com/modules/ruthenium/crowdstrike)\n\n# crowdstrike\n\nThe module is designed to deploy and manage CrowdStrike's Falcon Sensor\nantivirus agent.\n\n## Table of Contents\n\n1. [Description](#description)\n1. [Setup - The basics of getting started with crowdstrike](#setup)\n    * [Setup requirements](#setup-requirements)\n    * [Beginning with crowdstrike](#beginning-with-crowdstrike)\n1. [Usage - Configuration options and additional functionality](#usage)\n1. [Limitations - OS compatibility, etc.](#limitations)\n\n## Description\n\nThe modules installs and manages or removes the Falcon Sensor anti-virus\nagent by CrowdStrike. Proxy settings and tags can be confiugred additionaly. \n\n## Setup\n\n### Setup requirements\n\nThe module installs a package `falcon-sensor`, which it assumes to be\navailable in a repo configured on the system. The vendor does not maintain\na Linux repository.\n\nAlternatively you can customize package source and provider to have an ability\nto install from a different source.\n\n### Beginning with crowdstrike\n\nThe most basic usage of the module:\n\n```puppet\nclass { 'crowdstrike': cid =\u003e 'AAAAAAAAAAAAA-BB' }\n```\n\nParameter `cid` is mandatory.\n\n## Usage\n\nIn most cases just specifying `cid` (customer id) is sufficient, but adding\ntags is desirable for easy grouping and searching of the hosts in the\nCrowdStrike console:\n\n```puppet\nclass { 'crowdstrike':\n  cid  =\u003e 'AAAAAAAAAAAA-BB',\n  tags =\u003e [ 'My Organization', 'My Department' ]\n}\n```\n\nIf the computer does not have direct access to the CrowdStrike cloud service,\nconnection can be routed through a proxy server:\n\n```puppet\nclass { 'crowdstrike':\n  cid        =\u003e 'AAAAAAAAAAAA-BB',\n  proxy_host =\u003e 'proxy-server.my-organization.com',\n  proxy_port =\u003e 3128\n}\n```\n\nBoth `proxy_host` and `proxy_port` are mandatory if either specified.\n\nIf provisioning token is reqired during the installation, use the `provisioning_token`\nparameter:\n\n```puppet\nclass { 'crowdstrike':\n  cid                =\u003e 'AAAAAAAAAAAA-BB',\n  provisioning_token =\u003e 'XXXXXXXXXXXXXX'\n}\n```\n\n## Limitations\n\nIf proxy has been used and later disabled, the host and port configuration is\nnot removed entirely, only disabled. This does not affect the functionality in\nany way.\n\nCrowdStrike sensor software is capable of auto-updating its binaries if\nconfigured to do so in the console. It happened in the past when update changes\nthe format of the falconctl output, which may break the fact in this module. If\nthat happens, the module detects this situation, displays the relevant error\nmessage and fails the puppet run. If you see this happening, it is time to\nupdate the version of the module you have.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F104ru%2Fcrowdstrike","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F104ru%2Fcrowdstrike","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F104ru%2Fcrowdstrike/lists"}