Skip to content

This aggressor script uses a beacon's note field to indicate the health status of a beacon.

License

Notifications You must be signed in to change notification settings

Cobalt-Strike/beacon_health_check

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Beacon Health Check Aggressor Script

Joe Vest (Twitter: @joevest)

Description

This aggressor script uses a beacon's note field to indicate the health status of a beacon. This is done by ...

  • Tracking each beacon's current sleep/jitter time
  • Calculating health based on a "max expected check in time"
  • Updating the note field with an appropriate icon every minute using the event heartbeat_1m
  • Labeling new beacons as "NEW" with the time of arrival
  • Adding beacon id and PID to the initial beacon event log message

Demo

Demo on YouTube

Heath Checks and Icons

☑ - symbol indicates beacon as active and working

Calculated as last checkin is less than max expected check-in time (sleep + (sleep * .01 * jitter))

i.e., A beacon with sleep 300 20 would have a max expected check-in time of 360 calculated as 300 + (300 * .01 * 20).

💀 - symbol indicates beacon has died

Calculated as last checkin time is greater then max expected check-in time * 2. This is known as the "dead time".

i.e., A beacon with sleep 300 20 would have a dead time of 720.

❎ - symbol indicates beacon has been killed by an operator.

If beacon['alive'] is false, then an opertor killed/exited this beacon and the beacon acknowleded the exit command.

⚠ - symbol indicates beacon as dying

Calculated as last checkin is greater than the max expected check-in time and less than the dead time.

⏸ - symbol indicates the beacon as paused.

This is a linked beacon that has been disconnected but is still considered alive. These beacons depend on a parent for communication. Instead of marking these dead, they are marked paused. There is no great way to track processes of disconnected beacons.

The following shows what these icons look like in the Cobalt Strike client.

Beacon Health Status Icons

The beacon Id and PID has been added to the initial beacon event log message.

Additional info in the event log for new beacons

Usage

Load the beaconhealth.cna file through the script manager.

Use the get_BeaconHealthCheck_settings function in the script console to view the beacon sleep/jitter tracker.

What you should know about the script

  • It uses the Note field. You are free to edit as you like. The first character of the note will be updated during a health check with the appropriate symbol.
  • Linked beacons do not have a sleep. Sleeps are tracked by the parent of the linked beacon
  • Sleep settings are not verified before tracked. Setting sleep on a dead beacon may cause the symbol to change before the actual sleep has been processed by the beacon.
  • The health check is designed to monitor longer running beacons.
    • Health is measured every minute
    • This may still be too aggressive
    • You can adjust the timing by changing the heartbeat event that kicks off a check.
  • The tracking database is not persistent. If you close the Cobalt Strike client and reconnect, the database will be refreshed and beacons may be marked as NEW

About

This aggressor script uses a beacon's note field to indicate the health status of a beacon.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published