agent_groups

The agent_groups program allows you to list agents assigned to a group, assign agents to a group and manage the agents groups. Below are the parameters that can be used with this new function:

-h	Displays the help message
-q	Quiet mode (outputs no confirmation)
-d	Debug
-l	Lists all groups
-l -g group_id	Lists the agents in the group
-c -g group_id	Lists the configuration files in group
-a -g group_id [-q]	Creates a group
-r -g group_id [-q]	Removes a group (affects to all agents assigned to it)
-a -i agent_id -g group_id [-q]	Assigns group_id to the agent's group list
-a -f -i agent_id -g group_id [-q]	Replaces the agent's groups to group_id
-r -i agent_id [-q]	Remove an agent from all its groups
-r -i agent_id -g group_id [-q]	Remove an agent from a specific group
-s -i agent_id	Shows the groups of an agent
-S -i agent_id	Shows the shared files sync status of an agent

Examples

Create group 'debian':

$ /var/ossec/bin/agent_groups -a -g debian

Do you want to create the group 'debian'? [y/N]: y
Group 'debian' created.

Assign group 'debian' to agent 002:

$ /var/ossec/bin/agent_groups -a -i 002 -g debian

Do you want to set the group 'debian' to the agent '002'? [y/N]: y
Group 'debian' assigned to agent '002'.

Get the groups of agent 002:

$ /var/ossec/bin/agent_groups -s -i 002

The agent 'agent-deb-002' with ID '002' belongs to groups: default, debian, east-office

List all agents in group 'debian':

$ /var/ossec/bin/agent_groups -l -g debian

3 agent(s) in group 'debian':
    ID: 002  Name: agent-deb-002.
    ID: 003  Name: agent-deb-003.
    ID: 004  Name: agent-deb-004.

List configuration files in group 'debian':

$ /var/ossec/bin/agent_groups -c -g debian

Files for group 'debian':
  agent.conf                [ab73af41699f13fdd81903b5f23d8d00]
  rootkit_trojans.txt       [76d8be9b97d8eae4c239e530ee7e71c8]
  merged.mg                 [4437654d67c9c4ac2e46cf5f73e04518]
  cis_debian_linux_rcl.txt  [38cc9b168dc24576daa76f4502575a4f]
  rootkit_files.txt         [127711eb705cf90c6946ef4b7053d9c3]
  system_audit_ssh.txt      [5c4a3180e4b5b3f7bb7b61b0b9d23a4b]
  system_audit_rcl.txt      [882122c1e9e30e86c80893cbb9482c2d]

Remove agent 002 from all groups except the default:

$ /var/ossec/bin/agent_groups -r -i 002

Do you want to delete all groups of agent '002'? [y/N]: y
Group unset for agent '002'.

Remove agent 003 from a specific group

$ /var/ossec/bin/agent_groups -r -i 003 -g group2

Do you want to delete the group 'group2' of agent '003'? [y/N]: y

Group 'group2' unset for agent '003'.

Remove the group 'debian' from every agent:

$ /var/ossec/bin/agent_groups -r -g debian

Do you want to remove the 'debian' group? [y/N]: y
Group debian removed.

Add an agent to more than one group:

$ /var/ossec/bin/agent_groups -a -i 001 -g group1

Do you want to add the group 'group1' to the agent '001'? [y/N]: y
Group 'group1' added to agent '001'.

$ /var/ossec/bin/agent_groups -a -i 001 -g group2

Do you want to add the group 'group2' to the agent '001'? [y/N]: y
Group 'group2' added to agent '001'.

Now, 'agent1' belongs to 'default', 'group1' and 'group2'.