This key's fingerprint is A04C 5E09 ED02 B328 03EB 6116 93ED 732E 9231 8DBA

-----BEGIN PGP PUBLIC KEY BLOCK-----

mQQNBFUoCGgBIADFLp+QonWyK8L6SPsNrnhwgfCxCk6OUHRIHReAsgAUXegpfg0b
rsoHbeI5W9s5to/MUGwULHj59M6AvT+DS5rmrThgrND8Dt0dO+XW88bmTXHsFg9K
jgf1wUpTLq73iWnSBo1m1Z14BmvkROG6M7+vQneCXBFOyFZxWdUSQ15vdzjr4yPR
oMZjxCIFxe+QL+pNpkXd/St2b6UxiKB9HT9CXaezXrjbRgIzCeV6a5TFfcnhncpO
ve59rGK3/az7cmjd6cOFo1Iw0J63TGBxDmDTZ0H3ecQvwDnzQSbgepiqbx4VoNmH
OxpInVNv3AAluIJqN7RbPeWrkohh3EQ1j+lnYGMhBktX0gAyyYSrkAEKmaP6Kk4j
/ZNkniw5iqMBY+v/yKW4LCmtLfe32kYs5OdreUpSv5zWvgL9sZ+4962YNKtnaBK3
1hztlJ+xwhqalOCeUYgc0Clbkw+sgqFVnmw5lP4/fQNGxqCO7Tdy6pswmBZlOkmH
XXfti6hasVCjT1MhemI7KwOmz/KzZqRlzgg5ibCzftt2GBcV3a1+i357YB5/3wXE
j0vkd+SzFioqdq5Ppr+//IK3WX0jzWS3N5Lxw31q8fqfWZyKJPFbAvHlJ5ez7wKA
1iS9krDfnysv0BUHf8elizydmsrPWN944Flw1tOFjW46j4uAxSbRBp284wiFmV8N
TeQjBI8Ku8NtRDleriV3djATCg2SSNsDhNxSlOnPTM5U1bmh+Ehk8eHE3hgn9lRp
2kkpwafD9pXaqNWJMpD4Amk60L3N+yUrbFWERwncrk3DpGmdzge/tl/UBldPoOeK
p3shjXMdpSIqlwlB47Xdml3Cd8HkUz8r05xqJ4DutzT00ouP49W4jqjWU9bTuM48
LRhrOpjvp5uPu0aIyt4BZgpce5QGLwXONTRX+bsTyEFEN3EO6XLeLFJb2jhddj7O
DmluDPN9aj639E4vjGZ90Vpz4HpN7JULSzsnk+ZkEf2XnliRody3SwqyREjrEBui
9ktbd0hAeahKuwia0zHyo5+1BjXt3UHiM5fQN93GB0hkXaKUarZ99d7XciTzFtye
/MWToGTYJq9bM/qWAGO1RmYgNr+gSF/fQBzHeSbRN5tbJKz6oG4NuGCRJGB2aeXW
TIp/VdouS5I9jFLapzaQUvtdmpaeslIos7gY6TZxWO06Q7AaINgr+SBUvvrff/Nl
l2PRPYYye35MDs0b+mI5IXpjUuBC+s59gI6YlPqOHXkKFNbI3VxuYB0VJJIrGqIu
Fv2CXwy5HvR3eIOZ2jLAfsHmTEJhriPJ1sUG0qlfNOQGMIGw9jSiy/iQde1u3ZoF
so7sXlmBLck9zRMEWRJoI/mgCDEpWqLX7hTTABEBAAG0x1dpa2lMZWFrcyBFZGl0
b3JpYWwgT2ZmaWNlIEhpZ2ggU2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBLZXkgKFlv
dSBjYW4gY29udGFjdCBXaWtpTGVha3MgYXQgaHR0cDovL3dsY2hhdGMzcGp3cGxp
NXIub25pb24gYW5kIGh0dHBzOi8vd2lraWxlYWtzLm9yZy90YWxrKSA8Y29udGFj
dC11cy11c2luZy1vdXItY2hhdC1zeXN0ZW1Ad2lraWxlYWtzLm9yZz6JBD0EEwEK
ACcCGwMFCwkIBwMFFQoJCAsFFgIDAQACHgECF4AFAlb6cdIFCQOznOoACgkQk+1z
LpIxjbrlqh/7B2yBrryWhQMGFj+xr9TIj32vgUIMohq94XYqAjOnYdEGhb5u5B5p
BNowcqdFB1SOEvX7MhxGAqYocMT7zz2AkG3kpf9f7gOAG7qA1sRiB+R7mZtUr9Kv
fQSsRFPb6RNzqqB9I9wPNGhBh1YWusUPluLINwbjTMnHXeL96HgdLT+fIBa8ROmn
0fjJVoWYHG8QtsKiZ+lo2m/J4HyuJanAYPgL6isSu/1bBSwhEIehlQIfXZuS3j35
12SsO1Zj2BBdgUIrADdMAMLneTs7oc1/PwxWYQ4OTdkay2deg1g/N6YqM2N7rn1W
7A6tmuH7dfMlhcqw8bf5veyag3RpKHGcm7utDB6k/bMBDMnKazUnM2VQoi1mutHj
kTCWn/vF1RVz3XbcPH94gbKxcuBi8cjXmSWNZxEBsbirj/CNmsM32Ikm+WIhBvi3
1mWvcArC3JSUon8RRXype4ESpwEQZd6zsrbhgH4UqF56pcFT2ubnqKu4wtgOECsw
K0dHyNEiOM1lL919wWDXH9tuQXWTzGsUznktw0cJbBVY1dGxVtGZJDPqEGatvmiR
o+UmLKWyxTScBm5o3zRm3iyU10d4gka0dxsSQMl1BRD3G6b+NvnBEsV/+KCjxqLU
vhDNup1AsJ1OhyqPydj5uyiWZCxlXWQPk4p5WWrGZdBDduxiZ2FTj17hu8S4a5A4
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
J3x7gtxUMkTadELqwY6hrU8=
=BLTH
-----END PGP PUBLIC KEY BLOCK-----
		

Contact

If you need help using Tor you can contact WikiLeaks for assistance in setting it up using our simple webchat available at: https://wikileaks.org/talk

If you can use Tor, but need to contact WikiLeaks for other reasons use our secured webchat available at http://wlchatc3pjwpli5r.onion

We recommend contacting us over Tor if you can.

Tor

Tor is an encrypted anonymising network that makes it harder to intercept internet communications, or see where communications are coming from or going to.

In order to use the WikiLeaks public submission system as detailed above you can download the Tor Browser Bundle, which is a Firefox-like browser available for Windows, Mac OS X and GNU/Linux and pre-configured to connect using the anonymising system Tor.

Tails

If you are at high risk and you have the capacity to do so, you can also access the submission system through a secure operating system called Tails. Tails is an operating system launched from a USB stick or a DVD that aim to leaves no traces when the computer is shut down after use and automatically routes your internet traffic through Tor. Tails will require you to have either a USB stick or a DVD at least 4GB big and a laptop or desktop computer.

Tips

Our submission system works hard to preserve your anonymity, but we recommend you also take some of your own precautions. Please review these basic guidelines.

1. Contact us if you have specific problems

If you have a very large submission, or a submission with a complex format, or are a high-risk source, please contact us. In our experience it is always possible to find a custom solution for even the most seemingly difficult situations.

2. What computer to use

If the computer you are uploading from could subsequently be audited in an investigation, consider using a computer that is not easily tied to you. Technical users can also use Tails to help ensure you do not leave any records of your submission on the computer.

3. Do not talk about your submission to others

If you have any issues talk to WikiLeaks. We are the global experts in source protection – it is a complex field. Even those who mean well often do not have the experience or expertise to advise properly. This includes other media organisations.

After

1. Do not talk about your submission to others

If you have any issues talk to WikiLeaks. We are the global experts in source protection – it is a complex field. Even those who mean well often do not have the experience or expertise to advise properly. This includes other media organisations.

2. Act normal

If you are a high-risk source, avoid saying anything or doing anything after submitting which might promote suspicion. In particular, you should try to stick to your normal routine and behaviour.

3. Remove traces of your submission

If you are a high-risk source and the computer you prepared your submission on, or uploaded it from, could subsequently be audited in an investigation, we recommend that you format and dispose of the computer hard drive and any other storage media you used.

In particular, hard drives retain data after formatting which may be visible to a digital forensics team and flash media (USB sticks, memory cards and SSD drives) retain data even after a secure erasure. If you used flash media to store sensitive data, it is important to destroy the media.

If you do this and are a high-risk source you should make sure there are no traces of the clean-up, since such traces themselves may draw suspicion.

4. If you face legal action

If a legal action is brought against you as a result of your submission, there are organisations that may help you. The Courage Foundation is an international organisation dedicated to the protection of journalistic sources. You can find more details at https://www.couragefound.org.

WikiLeaks publishes documents of political or historical importance that are censored or otherwise suppressed. We specialise in strategic global publishing and large archives.

The following is the address of our secure site where you can anonymously upload your documents to WikiLeaks editors. You can only access this submissions system through Tor. (See our Tor tab for more information.) We also advise you to read our tips for sources before submitting.

wlupld3ptjvsgwqw.onion
Copy this address into your Tor browser. Advanced users, if they wish, can also add a further layer of encryption to their submission using our public PGP key.

If you cannot use Tor, or your submission is very large, or you have specific requirements, WikiLeaks provides several alternative methods. Contact us to discuss how to proceed.

Vault7: CIA Hacking Tools Revealed

Navigation: » Directory » Operational Support Branch (OSB)


Owner: User #1179751

Margarita v1.6 User Guide


















Engineering Development Group
Margarita v1.3
User Guide
Rev. A
29 Nov 2011








Classified By: 2259322
Derived From: COL S-06
Reason: 1.4 (c)
Declassify on: 20350629*Change Log*

Doc
Rev

Doc
Date

Rev
By

Change Description

Reference

Authority/
Approval Date

New

01-24-11

VGY

New

 

 

V1.1

02-25-11

VGY

Updates for version 1.1

 

 

V1.2

06-02-11

VGY

Updates for version 1.2

 

 

V1.3

11-29-11

VGY

Updates for version 1.3

 

 

V1.6

03-24-2013

SDP

Updates for version 1.6

 

 

 

 

 

 

 

 


Table of Contents























(U) Scope

(U) This document establishes the User Guide for Margarita v1.6.

(U) System Overview and Description

(S) The BARTENDER program is a set of IOCInformation Operation Center tools and concepts of operations that are specifically tailored for "blended" operations and rely on social engineering as well as technical sophistication for success. Tools for BARTENDER operations will be highly configurable, produce standardized results, will not require HQS interaction for deployment in most cases, and will not leave significant artifacts on the target computer.
(S) The BARTENDER program will use a common interface to configure the survey and will produce a common result regardless of the exploitation vector. The platform will be easy to use but also allow advanced users to detail robust surveys. The survey platform will include all features from EZCheese 5.0. Results of surveys will be stored on the same device that the survey was launched from and will be hidden and/or protected in order to allow the NOC freedom of movement.
(S) BARTENDER will also have a suite of tools that launch from a thumb drive and require the NOC to engineer a circumstance to view particular files. BARTENDER tools may trigger pop up messages from operations systems and personal security products. These messages will be part o the concept of operations. The NOC will be trained to expect them, allay the fears of the target, and guide the target to allow the survey to function.

(U) Assumptions and Constraints

(S) As mentioned above, in order for Margarita to collect files the NOC will be required to have some interaction with the target computer. Depending on the execution vector this may result in pop up messages.
(S) Margarita requires .Net 4.5 on the computer that does the configuration.

(U) Applicable Documents

(S) The following documents pertain to this tool. In the event of a conflict between the documents referenced below, the contents of this document will be considered binding.

  • Margarita v1.6 User Guide.doc (S)
  • Margarita v1.6 TDR.ppt (S)


(U) System Description

(U) System Concepts and Capabilities

  • (S) The Margarita configures an executable that will be used to perform a survey and/or do file collection.

Prerequisites

  • (S) (S) Margarita requires .Net 4.5 on the configuration computer.

(U) Operation

(U) Installation and Setup

  1. (S) The Margarita v1.6 GUIGraphical User Interface configures various parameters of the survey and file collection. Various environment variables (such as %temp%) can be used in collection and output fields. Additionally, where output is being written, three additional variables are recognized that can be used to direct multiple surveys and collection to the same location:
    1. %GUID% - a unique id string, changed for every launch
    2. %ft% - a hex string derived from the current time
    3. %st% - a readable time/date string
    4. %drive% - the drive letter of the flash drive (Ex: F:)

(U) Preparing a Margarita

(U) Initial Setup

(S) Prior to use, a license key needs to be generated. In the Admin folder is a program called licencesgen.exe. Run this program and create a key with a valid start and end date. In addition to the start and end date, it should be decided if the payload tab should be shown. Once license.txt has be generated, but that file in the same folder as MargaritaWizard.exe
(S) The following instructions provide information on how to configure the Margarita tool in the Station by a NOC.
(U) Double-click on MargaritaWizard.exe. The following user interface will appear:

Figure 1: (S) Margarita v1.6 Main Tab
(S) The interface will guide the user through the necessary configuration steps, and is laid out in a way that the user must click through all the pages before configuring the drive.
(S) The first tab (seen above) is the main tab. This tab allows the user to select the device or devices that they wish to configure, or post process (covered later). On this tab simply select one or more of the drives listed and hit next. If the device you wish to use isn't listed, ensure it is plugged in and hit refresh.

Figure 2: (S) Margarita v1.6 – Verification Tab
(S) The next tab, verifies the drives selected previously to ensure that the user has selected the proper device.
(S) Furthermore, if the user desires to load a configuration that had been created previously the "Load Config" button can be selected. If this is selected the subsequent boxes will be populated with data from the previous configuration. The user will still be required to click through all this information, and can make any necessary changes.

Figure 3: (S) Margarita v1.6 – Time out / indicator file / space to leave free
(S) The next tab covers three options, the time out, indicator file, and space to leave free.
(S) If desired, the user can select an applicable timeout. This timeout will ensure that the survey and file collection will not run longer than the specified time. Note, that if the timeout is hit, any file collection of survey data not collected will not be written to disk, and the program will just end.
(S) If a visual file indicating the successful and full completion of the survey and file collection is desired and indicator file can be requested. This file will be a zero byte file created in the case of the all files and survey data being successfully collected. Note, if the timeout is hit, a log file will not be created.
(S) Space to leave free is a required number, and must be set. This ensure that the thumb drive doesn't become unusable for overt functions. This value is the amount of space that will remain available for overt use, and must be at least 0.1 GB. In addition, the amount of space available for file collection and survey data (i.e. total size – space to leave free) must be greater than 1 GB. Drives not large enough to support this, are no longer supported.


Figure 4: (S) Survey Tab
(S) The next tab is for Survey options. Clicking the Enable survey options checkbox will enable the screen. Below the "Enable Survey Options" checkbox is a field to specify the survey output directory. The survey output directory will be the location where the collection program will save the survey information. If the output directory is intended for the USBUniversal Serial Bus drive, begin the path with a backslash. For example: \surveyOutput\surveydata.dat. Note: If a drive letter is included, the application will attempt to write the survey results to the exact path provided - it will not adjust to the drive letter of the USBUniversal Serial Bus drive on the target machine.
(S)Now the user can select specific survey options to run on the target. The first section is a set of canned Windows Management Instrumentation queries.
(S)Note that the Browser survey collects information on Internet Explorer, Firefox, Chrome, Safari, and Opera such as bookmarks and history. This option can be slow.

Figure 5: (S) File Collection Tab
(S) The third tab allows for configurable File Collection. Again, the user must check the Enable file pattern collection check box to enable the screen. For each file pattern entered, collection criteria is created and saved as a row in the collection priorities table. Wildcards may be used in the file pattern field. For example, a file pattern of *.doc will collect all Microsoft Word docs off of all fixed drives in the system. A file pattern of C:*.doc will collect all Microsoft Word docs off of the C drive. Note that 2007 Office docs have an x on the extension, so to include all 2007 Word docs search with C:*.docx or C:*.doc. To search for specific files, enter the entire path to the file: *C:\Program Files\sample.txt.
(S) To enable the date controls and the min/max file size fields, the appropriate check boxes must be selected. Also for each file pattern, an output filename must be specified. This should be the full path to the file on the USBUniversal Serial Bus drive, minus the drive letter (i.e. it should always start with a backslash such as "\output\outputFile.dat").
(S) Under the "Advanced Editor" clicking the new button will add a row to the table on the lower part of the screen. To add additional file patterns with different collection criteria, change the entries in the Collection Criteria area of the screen. "Copy" will make a copy of the highlighted row and select it for editing.
(S) Entries may be moved up and down within the table by clicking on the row of interest to move (it will be highlighted once it is selected), and then clicking the Up and Down buttons until the row is in the desired position. Note that collection will occur based on the priority of entries in the table, with the highest priority collection set starting at the top. Each collection set will run individually. So the application will run through the list starting at the beginning of the table. Once all files in the first collection set have been saved, it will move to the next row of the table and so on, until the USBUniversal Serial Bus drive is filled to the limit.
(S) To delete a row in the table, click on a row, (again it will be highlighted when selected), and then hit the Delete Row button or the red "X" on the side of the table.
(S) There are checkboxes on the "File Collection" tab to make configuration easier. Selecting any of the checkboxes will configure Margarita to collect the files listed to the right of the checkbox. These files will be put in the folder that you type in the box below the checkboxes. So if you specify "\Backup\MonthYear\" and the Office Docs and Mail checkboxes, Margarita will save the files collected to \Backup\MonthYear\doc and \Backup\MonthYear\mail respectively.

Figure 6: (S) Additional collection details
(S) The next tab covers areas where you want Margarita to NOT collect files. These directories are relative to each drive, so do not give a drive letter. The paths allow wild cards, so you can specify \Windows\ and Margarita will not collect from Windows, or you could specify \Program Files* and on a 64-bit system Margarita would skip both \Program Files\ and Program Files (x86)\. Margarita will still do a directory listing of the folders that are ignored.
(S) In addition, a previous hashfile can be loaded. During execution the file collection piece creates a hash of any files collected. This enables the drive to not collect files that were previously collected on subsequent runs. During post processing these files are collected and saved. If desired, the user can load a file from a previous collection to protect against duplication of work.

Figure 7: (S) Payload

(S) The fourth tab, Payload, allows the user to specify a payload to drop on the target machine: See Figure 4. To select a payload click on the "…" button. A folder dialog will appear. Simply browse to the location of the payload file, and then click Open. The path to the payload may also be manually entered in the text box located to the right of the Find Payload button. Any arguments used when launching the payload should be entered in the Payload Arguments text field. For example, if ipconfig is used as a payload it takes command line arguments such as /all. So at the command line a user would type:
ipconfig /all
(S) To include command line arguments using Margarita v1.0, only the arguments are needed, so the user would enter only /all in the Payload Arguments text field.
(S) Only one path is needed on the target machine: the fully qualified path to the location where Margarita should drop the payload.

Figure 8: (S) Blacklist Tab
(S) The Blacklist tab allows for a quick bailout if a targeted process is present. While the program will still execute, it will quickly exit, thus hopefully avoiding any pop up alerts. We tried to include all the major AVAnti-Virus vendors, and if selected all the listed processes will be added to the blacklist. If any additional items are desired they can be added in the bottom box on the tab.

Figure 9: (S) Execution Vector Tab
(S) The execution vectors tab allows the user to specify an execution vectors for Margarita.
(S) Kamikaze is a configured binary that isn't meant to be used with a cover application. This executable would be used in a situation where you are not under scrutiny and can just browse to the USBUniversal Serial Bus drive and double click on the file. In the "execution path" box enter the full path for the executable, starting with the drive letter. For example, to put the file directly on the USBUniversal Serial Bus drive, you might use E:\MargaritaPath\files\Margarita.exe. The filename can be anything as long as it has a .exe extension.
(S) ScrewDriver is an encryption program called UPE that is similar to WinZip or WinRAR. When files with specially configured names are added to the archive they will be automatically executed when the archive is opened. See the ScrewDriver Guide for more details.
(S) Openbar is an ability to Trojan most publically available executable. See the Openbar User's Guide for more details.
(S) ScrewDriver and Openbar can drop and run Margarita from different locations. In the "execution path" box enter the directory on the USBUniversal Serial Bus where you want to run Margarita, starting with a backslash, not the drive letter. For example, \MargaritaPath\files\Margarita.exe. The filename can be anything as long as it has a .exe extension.

(U) Additional Notes

(S) Shortcut variables may also be used in the path names for the target entries and the file patterns. For example, %temp%\dir1\dir2\payload.exe would be expanded as a payload executable directory. Three additional environment variables are expanded if entered on the GUIGraphical User Interface for the "Survey output filename" and the "Specify output file" fields, as follows:

  • %GUID% - adds a GUIDGlobally Unique Identifier in the filepath
  • %ft% - adds the filetime to the filepath
  • %st% - adds the systemtime to the filepath


(S) So an example entry would be:

  • \Windows\System32%GUID%


(S) The GUIGraphical User Interface now allows for a user to save and/or load configuration files. The user must simply navigate to the file menu and select either "Load Configuration" or "Save Configuration" based on the action desired. The file menu also allows for individual tabs to be cleared, if necessary.

(U) Application Configuration

(S) Once all desired collection sets are in the table, and the exploit parameters are set, the user must navigate to the file menu, then select Configure Exploit, to configure the tool. The application now forces the user to save a configuration file before proceeding. Once configured, the tool will create the configured executable(s). If an execution vector has been selected the file will be created in the same directory as the executable specified in the Main tab.

(S) Initiating a Session on the Target System

(S) Margarita will be executed on the target system via the NOC's execution vector of choice. If no execution vector was chosen in the Execution Vector tab, Margarita will still output a basic, configured executable using the filename supplied in the Main tab. This file could be double clicked on the target computer to run the survey.
(S) IMPORTANT: The collection process may take several minutes. If the drive is removed from the system before the collection completes, some survey/collection data may not be written to the thumb drive. The user should allow the tool to complete the survey/collection and stop activity to the thumb drive. There is no other visible indication that the process is finished.

(U) Stopping and Suspending Work

(S) The Margarita tool cannot be stopped once it is initiated. If the drive is removed while the tool is still running, it will terminate gracefully but only complete a partial collection.

(U) Assistance and Problem Reporting

(S) Please contact EDG/AED/OSB for assistance.

(U) Additional Operational Procedures

(U) Post Processing


(S) The following guidelines should be used to post process any survey/collection results from the Margarita tool:

  1. (S) Plug the target thumb drive into an appropriately classified, controlled computer. Note the letter assigned to the drive.


  1. (S) Double click on MargaritaWizard.


  1. (S) Click "Post Process!" and select "Next".



Figure 10. Rehab post processing tool
(S) The collected data will be extracted to the current directory. The system information will be extracted and sent to Internet Explorer to display. (Note: often, the information collected contains data that invalidates the XML, so another XMLExtensible Markup Language viewer such as Firefox may be desired). The following directories and files will be created:

  • Directory Listing.txt
  • SysInfo.xsl
  • Arp Table.txt
  • Routing Table.txt
  • IP config.txt


  • Firefox information:
    • FirefoxBookmarks*
    • bookmarks.html
    • cookies.txt
    • places.sqlite
    • Firefox Cookies.txt
    • Firefox History.txt


  • Internet Explorer information:
    • IECookies*
    • IEFavorites*
    • IE History.txt


(U) Viewing the results


(S) The DirectoryListProcessor can be used to view the dirlist.txt files created by Rehab. This will give you a Windows Explorer type view of the directory list.
(S) To run the tool, click "File" at the top of the screen and select "Open". Browse to the dirlist.txt file created by Rehab and open it. After a few minutes you will see a the directory list in an explorer type view.

Figure 6. Initial view

Figure 7. DirectoryListProcessor

(U) Release Notes


(U) Updates from previous v1.2 to v1.3

  1. Fixed a bug that caused the generic collection to happen before specific file collection.
  2. Added Martini compatability.
  3. Added MS Office and MRUMost Recently Used registry entries to the survey.
  4. Removed the requirement that you specify a logging file.
  5. Added error checking on output filenames.
  6. Fixed a bug that didn't save filetimes on the target system when post-processing.
  7. Fixed a bug that changed the file access time on files collected on XPWindows operating system (Version) machines.
  8. Moved the default location of configured ScrewDriver and Martini files to subfolders "ScrewDriver" and "Martini".
  9. Fixed a bug in Kamikaze creation. If the path to the specified Kamikaze file didn't exist v1.2 would crash. Now it tries to create the path.

(U) Updates from previous v1.2 to v1.3

  1. Added the "Do Not Walk" functionality to skip collecting files from specified directories.
  2. Added a dialog box for choosing the Kamikaze output.
  3. Rearranged text boxes so they lined up better.
  4. Added "Generic File Collection" capability.
  5. Added "Next" and "Back" buttons for navigating the configation.
  6. Added ability to re-prioritize the file collection table.
  7. Added ability to edit the file collection table in-place.
  8. Added the ability to create a file showing collection finished.

(U) Updates from previous v1.0 to v1.1

  1. Fixed a bug causing crashes during post-processing Browser data
  2. Fixed a bug in the Internet Explorer history collection
  3. Added code to avoid Kaspersky alerting on out of the box settings
  4. Fixed some dialog in the tool tips.
  5. Moved the executable path from the main tab to "Kamkaze" under the execution vectors
  6. Moved the survey output text box to be closer to where the file output text box is on the file collection tab
  7. Added the DirectoryListProcessing tool.



(U) Known PSPPersonal Security Product (Anti-Virus) issues

  1. Kasperksy will pop yellow dialog boxes if it has been configured with high detection settings.
  2. If collecting *.evt files (event log files) Margarita does not collect all the files.




Attachments:


Previous versions:

| 1 empty | 2 |

e-Highlighter

Click to send permalink to address bar, or right-click to copy permalink.

Un-highlight all Un-highlight selectionu Highlight selectionh