This is the documentation for Wazuh 3.9. Check out the docs for the latest version of Wazuh!

Using the CLI in MacOS X hosts

To register an agent using the command line, first follow the steps from the Manager section and then, from the Agent section.

Manager

  1. In the CLI of the Wazuh manager host, we will run manage_agents to add the agent. In this example, we are going to add a new agent. Its name will be macos-mojave and its address or IP is any.

    # /var/ossec/bin/manage_agents -a any -n macos-mojave
    
  2. Now, list the agents to get the ID of the macos-mojave agent:

    # /var/ossec/bin/manage_agents -l
    
    Available agents:
        ID: 001, Name: macos-mojave, IP: any
    
  3. Using the ID from the previous command, extract the new agent’s key using. Copy this key because you will need it for the agent:

    # /var/ossec/bin/manage_agents -e 001
    
    Agent key information for '001' is:
    MDAxIG1hY29zLW1vamF2ZSBhbnkgZjcwMTI0MjQ5NDMwNzA3N2IyN2NlZjRmZDQ1NzlmYzkwYzcyMzcyZDMxMTM5ZTBkZjZiYzdmODMyODBjZjA4YQ==
    

Agent

Once you have added the agent in the Wazuh manager host, open a session in your MacOS X agent host as root user. After that, let’s import the key and connect the agent to the manager.

  1. First, import the key using manage_agents:

    # /Library/Ossec/bin/manage_agents -i MDAxIG1hY29zLW1vamF2ZSBhbnkgZjcwMTI0MjQ5NDMwNzA3N2IyN2NlZjRmZDQ1NzlmYzkwYzcyMzcyZDMxMTM5ZTBkZjZiYzdmODMyODBjZjA4YQ
    
    Agent information:
       ID:001
       Name:macos-mojave
       IP Address:any
    
    Confirm adding it?(y/n): y
    Added.
    
  2. Edit the Wazuh agent configuration in /Library/Ossec/etc/ossec.conf to add the Wazuh server IP address. In the <client><server> section, change the MANAGER_IP value to the Wazuh server address. The address of the Wazuh server can be an IP address or a DNS name:

    <client>
      <server>
        <address>MANAGER_IP</address>
        ...
      </server>
    </client>
    
  3. Once you have complete the step 1 and 2, start the agent:

    # /Library/Ossec/bin/ossec-control start