Skip to content

Getting Started

Jump to bottom
kryptops edited this page Feb 18, 2022 · 7 revisions

DNS Setup

Before running any agents, you'll need to set up DNS. For this you will need two records:

  1. A record for your NS server. This is an A record that points directly at your DNS listener.
  2. A record targeting your NS server. This is an NS record that points to the A record for your DNS listener.

Additionally, you may have to deactivate existing DNS services and change any loopback entries in the resolv.conf file to point to a trusted public dns server.

NOTE: sometimes, the agent will be unable to call back in linux if systemd-resolved is disabled. I've also observed that my home router doesn't seem to allow it to properly communicate with dns.

Intro to the Interface

Before you run lytty, you will need to run wolfmon.py to receive command output.

This is wolfmon, which acts as an output window for the server to keep verbose output separate from the rest of the cli.

Run lytty in another window.

Enter <your username>@<ip of api server>. You will then be prompted for your password, which is masked. If everything goes well, you should get another prompt in the main 'console' view. Run help to see the commands available for your current view.

Setting up the CLI

Once you have installed the server, you will need to add a first operator and campaign. Login with the admin credentials you created during server setup and complete the following steps

[1] Create User

  1. execute 'use manage'
  2. execute 'load add.user'
  3. execute 'set roles operator'
  4. execute 'set username '
  5. execute 'run'

Lycanthropy will auto-generate a password for the user (which you should save). Some commands for lycanthropy's control view are restricted to operators, so you will need this password to interact with agents that call back to your server.

[2] Create Campaign

  1. execute 'use manage'
  2. execute 'load add.campaign'
  3. execute 'set operators <username from before / comma-separated list of operators>'
  4. if desired, execute 'set name '
  5. execute 'run'

If you did not specify a name for the campaign, lycanthropy will generate one and spit it out for you to use. This campaign acts as a partition for data and a parent object for agents. You will definitely need the name of the campaign in future, so don't forget what it gave you.

Clone this wiki locally