LogoLogo
EmpireStarkillerBlogDiscord
  • Empire
  • Quickstart
    • Installation
    • Server
  • Starkiller
    • Introduction
    • Agent Tasks
  • Listeners
    • Dropbox
    • OneDrive
    • HTTP
    • Malleable C2
  • Stagers
    • multi_generate_agent
  • Plugins
    • Development
      • Imports
      • Lifecycle Hooks
      • Execution
      • Hooks and Filters
      • Plugin Tasks
      • Notifications
      • Database Usage
      • Settings
      • Migration
  • Modules
    • Autorun Modules
    • Module Development
      • PowerShell Modules
      • Python Modules
      • C# Modules
      • BOF Modules
  • Agents
    • Python
      • Main Agent Class
      • Stage Class
      • Packet Handler Class
      • Extended Packet Handler Class
    • Go
      • Main Agent Class
      • Packet Handler Class
      • Main.go Template
    • Staging
  • RESTful API
  • Settings
    • Logging
    • Bypasses
    • IP Filtering
Powered by GitBook
On this page
  • Steps to Configure AutoRun
  • Use Cases for AutoRun

Was this helpful?

  1. Modules

Autorun Modules

PreviousModulesNextModule Development

Last updated 1 month ago

Was this helpful?

The Autorun feature allows users to predefine modules to automatically run when an agent becomes active.

Steps to Configure AutoRun

1

Navigate to Listeners

  • From the sidebar, click on the "Listeners" icon.

  • You will be taken to the Listeners list screen, where all the active listeners are shown.

2

Select a Listener

  • Choose the listener you want to configure from the list. If no listener exists, create one by clicking on the "Create" button at the top right.

3

Access Autorun

  • Once inside the listener’s details, you’ll notice an option for the AutoRun Modules as a tab.

  • Click on this tab to configure what should happen automatically when the listener is engaged.

4

Choose Modules for AutoRun

  • In the Autorun screen, you can select specific modules that will automatically run whenever an agent first connects.

5

Confirm Selection

  • After selecting your desired modules, confirm your choices. Empire will automatically link these modules to the listener.

6

Running

  • When the listener is activated, the selected modules will now automatically run on any new agent.

  • You can view the tasks in real time from Starkiller.

Use Cases for AutoRun

  • Automation of Payloads: Configure a listener to automatically deliver payloads to compromised machines without manual input.

  • Post-Exploitation Tasks: Automatically run scripts to escalate privileges, gather system info, or set up persistence as soon as a listener engages.

  • Environment Monitoring: Set up monitoring modules to run instantly when an agent calls back to the listener.