Cortana Tutorial - Armitage

2. Controlling Metasploit
Hello Metasploit
Our first Cortana script will register an event, print out some Metasploit statistics, and quit.
on ready {
println("Hello Metasploit!");
println("Hosts: " . size(hosts());
println("Sessions: " . size(sessions());
println("Services: " . size(services());
println("Credentials: " . size(credentials());
quit();
}
This script registers a listener for the ready event. Registering an event is like declaring a
function. The difference is, events use the on keyword instead of sub. You may declare as
many listeners for an event as you like. Cortana will execute all of them when the event
fires.
The ready event fires once in the life of a script. It fires after Cortana first synchronizes
hosts, sessions, services, loots, and routes from the database.
The code enclosed in two curly braces is the event handler. This handler executes when the
ready event fires. This code will query Metasploit's hosts, sessions, and services using
Cortana functions. We use the &size function to find out how many hosts, sessions, and
services are known.
Once we're done we call &quit. Cortana is an event driven language. Because of this,
Cortana will not quit until we tell it to. If multiple scripts exist in a Cortana container,
Cortana will not exit until all scripts have called &quit.
Scripts may fire their own events with the &fire_event function. This function will trigger
event handlers inside the current Cortana container. Use &fire_event_local.
to isolate an event to the current script.
Metasploit Consoles
One of the most common use cases for controlling Metasploit is to send commands to
Metasploit and have it execute them.
You can do this from Cortana with the &cmd_async function.
cmd_async("db_status");
This function accepts any Metasploit command, exactly as you would type it. It then
executes the command. To see the output of the command, use a console_* event. This
event fires when the command you're interested in completes. To catch the output of the
db_status command, use:
11