Skip to content

Latest commit

 

History

History
264 lines (217 loc) · 9.43 KB

CHANGELOG.md

File metadata and controls

264 lines (217 loc) · 9.43 KB

Change Log

All notable changes to this project will be documented in this file.

[v3.3.0]

Added

  • Improved agent registration/removal bash script (#71).

[v3.2.3]

Added

  • New API requests:
    • GET/rules/gdpr (#78).
    • GET/agents/no_group.
    • GET/cluster/healthcheck.
    • GET/cluster/nodes/:node_name.
  • A parameter in request GET/rules to filter by GDPR requirements (#78).
  • Parameters in GET/cluster/nodes: search, sort, offset, limit, select. And a new filter: type.
  • A parameter in request GET/agents to filter agents by cluster nodes.

Changed

  • Output of GET/nodes: Added a new attribute version.

Removed

  • The following requests have been removed:
    • GET/cluster/agents: Duplicated request (GET/agents).
    • GET/cluster/node: Duplicated request (GET/cluster/config).
    • GET/cluster/files: It will not be available in this version of the cluster.

[v3.2.2]

Added

  • Added an option in config.js to run the API with root privileges for debug purposes and troubleshooting. The API runs as ossec by default. (#68)

Changed

  • Changed mode from 750 to 660 in /configuration/auth/user file after installing it.

[v3.2.1]

There are no changes for Wazuh API in this version.

[v3.2.0]

Added

  • Version selector added to GET /agents (#60).
  • It's possible search agents by version in GET /agents (#60).
  • New attributes added to the output of GET /agents (Wazuh #375).

Fixed

  • Fixed ìnstall_api.sh script to load preloaded_vars.conf (#53).
  • Fixed api-register-agent.sh script (#56).
  • Fixed bad assigment of agent attributes (mergedSum and configSum) (Wazuh #372).

Changed

  • Change output of GET/manager/info (Wazuh #371).
  • Change timestamp format of ossec logs (affected calls output: GET /manager/logs and GET /manager/summary) (Wazuh #355).

[v3.1.0]

Added

Changed

Fixed

Removed

[v3.0.0]

Added

  • Parameter in config.js file to configure the SSL version to use in the API.
  • Add requests to manage groups.
    • Get basic information about all groups: GET/agents/groups
    • Get the agents of :group_id group: GET/agents/groups/:group_id
    • Get :group_id's shared configuration: GET/agents/groups/:group_id/configuration
    • Get :group_id's files: GET/agents/groups/:group_id/files
    • Get :filename file of :group_id group: GET/agents/groups/:group_id/files/:filename
    • Set :agent_id agent to group :group_id: PUT/agents/:agent_id/group/:group_id
    • Create the :group_id group: PUT/agents/groups/:group_id
    • Remove :group_id group: DELETE/agents/groups/:group_id
    • Unset :agent_id's group: DELETE/agents/groups/:group_id
  • Unattended install and configure mode using preloaded_vars.conf.
  • Add timestamp field at index query.
  • Improve output of delete and restart agents requests: each ID includes error information.
  • Add requests to manage remote agent upgrades.
  • Add requests to manage cluster:
    • Get information about the actual manager node in the cluster - GET/cluster/node
    • Get information about all nodes in the cluster - GET/cluster/nodes
    • Get information about the status of the synchronized files in the cluster - GET/cluster/files
    • Get information about the agents in the cluster - GET/cluster/agents
    • Get the cluster status (enabled or disabled) - GET/cluster/status
    • Get the cluster configuration - GET/cluster/config
  • Add a selector for the API call to retrieve information about an agent using its ID.

Fixed

  • When adding a new agent, now it checks that its name is different than manager's name.
  • Bug in XML parser of rules, decoders and configuration.

Changed

  • Change output format of GET/manager/logs call to JSON.

[v2.1.1]

Fixed

  • Issue issue when deleting and restarting a list of agents
  • Issue with socket comunication in authd.

[v2.1.0]

Added

  • Added OS information to GET /agent request
  • New request: Delete a list of agents - DELETE /agents - Params: {"ids":["id_1", ..., "id_n"]}
  • New request: Restart a list of agents - POST /agents/restart - Params: {"ids":["id_1", ..., "id_n"]}

Changed

  • Support add/remove agents with ossec-authd running

[v2.0.1] - 2017-07-25

Fixed

  • Issue when basic-auth is disabled.
  • Regex for latest version in install_api.sh
  • Wrong scan dates for syscheck and rootcheck.
  • IP value always must be lowercase.

[v2.0.0] - 2017-04-24

Added

  • Wazuh v2.0 is required to run the API.

  • API must be launched with root user, but it is run with ossec user.

  • Scripts:

    • install_api.sh
    • configure_api.sh

  • Parameters:

    • Pretty JSON (?pretty)
    • Pagination: offset & limit
    • Search
    • Sort

  • Requests:

    • Agents
      • GET /agents/summary (Get agents summary)
      • PUT /agents/restart (Restart all agents)
      • POST /agents/insert (Insert agent)
    • Manager
      • GET /manager/info (Get manager information)
      • GET /manager/logs (Get ossec.log)
      • GET /manager/logs/summary (Get summary of ossec.log)

  • Decoders

    • GET /decoders (Get all decoders)
    • GET /decoders/:decoder_name (Get decoders by name)
    • GET /decoders/files (Get all decoders files)
    • GET /decoders/parents (Get all parent decoders)

  • Rules

    • GET /rules (Get all rules)
    • GET /rules (Get rules by id)
    • GET /rules/files (Get files of rules)
    • GET /rules/groups (Get rule groups)
    • GET /rules/pci (Get rule pci requirements)

  • Rootcheck

    • GET /rootcheck/:agent_id/cis (Get rootcheck CIS requirements)
    • GET /rootcheck/:agent_id/pci (Get rootcheck pci requirements)

  • API

    • GET /version

  • Wazuh framework: Manage Wazuh from python.

  • Unit tests

  • Cache (750ms) for GET requests

Changed

  • Improved API service.
  • Improved input validation.
  • Improved Error Handling.
  • Improved logging.
  • Settings in /api/configuration.
  • By default, API is installed using HTTP.
  • xmljson is not necessary.
  • apache-utils is not necessary.
  • Requests:
  • Improved:
  • GET /rootcheck/:agent_id (Get rootcheck database)
  • GET /syscheck/:agent_id (Get syscheck files)

Removed

  • Requests that require root privileges:
  • /manager/configuration/test
  • /manager/start,stop,restart

[v1.2.1] - 2016-07-25

Fixed

  • Issue installing API as service.

[v1.2] - 2016-04-13

Added

  • Run API as service
  • API Versioning
  • Improved error handling
  • Improved Cross-origin resource sharing (CORS)
  • Automatic agent IP address registration
  • Improved proxy server IP source extraction

Changed

  • NodeJS modules must be installed with npm install
  • Response JSON: Field response changed to data.

Fixed

  • Problem importing xmljson package in Python
  • Wrong HTTP Status Code in some specific cases

[v1.1] - 2016-02-24

Added

  • Agents

  • DELETE /agents/:agent_id

  • POST /agents

  • PUT /agents/:agent_id/restart

  • PUT /agents/:agent_name

  • Manager

  • GET /manager/configuration

  • GET /manager/configuration/test

  • GET /manager/stats

  • GET /manager/stats/hourly

  • GET /manager/stats/weekly

  • GET /manager/status

  • PUT /manager/restart

  • PUT /manager/start

  • PUT /manager/stop

  • Rootcheck

  • DELETE /rootcheck

  • DELETE /rootcheck/:agent_id

  • GET /rootcheck/:agent_id

  • GET /rootcheck/:agent_id/last_scan

  • PUT /rootcheck

  • PUT /rootcheck/:agent_id

  • Syscheck

  • DELETE /syscheck

  • DELETE /syscheck/:agent_id

  • GET /syscheck/:agent_id/files/changed

  • GET /syscheck/:agent_id/last_scan

  • PUT /syscheck

  • PUT /syscheck/:agent_id

Changed

  • Directory structure
  • HTTP verbs for agents resource.
  • Requests /agents/sysrootcheck have been split:
  • /syscheck
  • /rootcheck

[v1.0] - 2015-11-08

  • Inital version