{"id":19029749,"url":"https://github.com/guardian/wazup","last_synced_at":"2025-09-06T23:31:38.627Z","repository":{"id":38085429,"uuid":"355961510","full_name":"guardian/wazup","owner":"guardian","description":"Automated deployment of Wazuh configuration changes","archived":false,"fork":false,"pushed_at":"2022-06-10T14:01:07.000Z","size":59,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-01-01T20:42:19.968Z","etag":null,"topics":["security","vulnerability-detection","wazuh"],"latest_commit_sha":null,"homepage":"","language":"Scala","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/guardian.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2021-04-08T15:31:11.000Z","updated_at":"2023-11-08T14:57:09.000Z","dependencies_parsed_at":"2022-09-17T20:51:26.881Z","dependency_job_id":null,"html_url":"https://github.com/guardian/wazup","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guardian%2Fwazup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guardian%2Fwazup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guardian%2Fwazup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guardian%2Fwazup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guardian","download_url":"https://codeload.github.com/guardian/wazup/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232149972,"owners_count":18479562,"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":["security","vulnerability-detection","wazuh"],"created_at":"2024-11-08T21:15:07.572Z","updated_at":"2025-01-02T03:42:58.721Z","avatar_url":"https://github.com/guardian.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wazup\n\nAutomated deployment of Wazuh configuration files\n_____\n\n[Wazuh](https://github.com/wazuh/wazuh) is an open source platform for threat detection, security monitoring and incident response. It can be used to monitor endpoints, cloud services and containers, and to aggregate and analyze data from external sources.\n\nWazup is intended to be run on every node in a [Wazuh cluster](https://documentation.wazuh.com/current/user-manual/configuring-cluster/basics.html) and handles the entire lifecycle of the Wazuh manager, including starting the service for the first time.\n\n## Purpose\n\nWazup allows a single, centralised source of configuration that can be polled by each node in the cluster. Wazup polls the storage location of the configuration, customises the configuration depending on the node type and inserts missing secrets.\n\nAdditionally, the configuration can be kept under version control and follow a change management system whereby updates are reviewed and approved before they are applied to production.\n\nWazup removes the requirement for anyone to ssh onto an instance to change the configuration.\n\n## Development\n\nYou will need to create a local configuration file; ideally in an alternative directory to minimise the risk of it being committed to the repository.\n\nThe configuration can use HOCON format and requires the following entries:\n\n```\nwazup {\n  nodeType = ???\n  bucket = ???\n  bucketPath = ???\n  parameterPrefix = ???\n  confPath = ???\n}\n```\n\nRun Wazup with sbt and provide the path to the local configuration file:\n\n    sbt -Dconfig.file=\u003cPATH\u003e/wazup.local.conf run\n\n## Deployment\n\nWazup does not yet have automated builds or deployment.\n\nThe debian package can be created with the sbt-native-packager:\n\n```\nsbt debian:packageBin\n```\n\nOnce the package has been built, use the AWS command line tools to upload it to S3:\n\n```\naws s3 cp target/wazup.deb s3://$BUCKET_NAME/$STACK/$STAGE/ --profile $PROFILE\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguardian%2Fwazup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguardian%2Fwazup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguardian%2Fwazup/lists"}