Cortana Tutorial - Armitage

Some popup menus are created with arguments. You may access these arguments through
the array @_ or $1 ... $n. When a popup has arguments, its arguments propagate to any
children menu and item blocks. Here's an example of a menu attached to a Meterpreter
session.
popup meterpreter_bottom {
menu "&Annoy User" {
item "&Enable Keyboard/Mouse" {
m_cmd($1, "uictl enable keyboard");
m_cmd($1, "uictl enable mouse");
}
}
}
item "&Disable Keyboard/Mouse" {
m_cmd($1, "uictl disable keyboard");
m_cmd($1, "uictl disable mouse");
}
The above example adds an Annoy User menu to the Meterpreter menu displayed by
Armitage. Meterpreter menus propagate the session id as an argument. When the Enable
Keyword/Mouse item is triggered, the session id $1 is available to it.
You may use &show_menu and its variations to build a menu from popup constructs
declared in any loaded scripts. When you call this function, you have the opportunity to set
the arguments that are propagated to the child menus.
Through Cortana, you also have the opportunity to create new menus in the top-­‐level
menubar of Armitage. Use the &menubar function to set these up. By default, all new
menus will go to the right of existing menus and show up to the left of the Help menu.
menubar("Web Tools", "webstuff", 2);
The above example creates a Web Tools menu located before the Help and Workspaces
menu. Scripts may add menus to it by defining a popup for the webstuff hook.
Built-­‐in Dialogs
Cortana provides several functions to use dialogs already defined in Armitage. The
&show_message function displays a message to the user.
The &prompt_text function asks the user to answer a question. The &prompt_confirm
function is like &prompt_text except the only options are yes or no.
$answer = prompt_text("What is your favorite icecream?");
if ($answer !is $null) {
show_message("Mine too!");
}
&prompt_file_open is available to show a file open dialog. And &prompt_file_save is
available to show a file save dialog.
27