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: » Latest version


The Seven Seas Transport

Description

The seven seas transport (7Seas)  is a transport for Galleon testing.   Systems meeting the Galleon interface specification can use 7Seas as a transport for testing.  It can modify files to create transport errors as a means to test system fault handling.

Contents

('toc' missing)

7Seas Components

This is some mid level detail about the programs, files, folders, and overall runtime structure.   Once installed,  only seasick is normally used directly.   Your Galleon system will interact only with ship.sh.

The seasick, setsail, and ship.sh usage is described in following sections. 

PROG is base program folder - defaults to /work

BASE is the base data folder - defaults to /work

DEST is a destination

SRC is a source

Component Type Description Location
install.sh bash script currently not executable, mostly notes on how to install and configure 7Seas PROG
ship.sh bash script

implements Galleon transport interface for sending files.   This is the program

your system calls.

PROG
7seas

service script

soft link

starts, stops, transport monitor dockwork

this is soft link to the PROG folder

PROG

/etc/init.d

SevenSeas package contains ahoythere.py and sail7seas.py PROG
ahoythere.py python script Main monitoring program for .docks   It uses pyinotify.  It is imported by 7seas.py PROG/SevenSeas
sail7seas.py pyhton script

Main program for  modifying, and transporting files.   It is imported by 7seas.py

PROG/SevenSeas
shiplog.py   utility program implementing shiplog class;  allows logging to console and syslog PROG/SevenSeas
7seas.py python script

Package level program for invoking sail7seas.py It is the target for

soft links  dockwork, atsea, seasick, and setsail

PROG

defaults to '/work'

-- seasick soft link

Configuration of transport at the destination and/or destination/source level

file modification settings.  Also keeps scp compatible destination addresses.

PROG
-- dockwork soft link Invoked by 7seas service, monitors files under DEST/.docks PROG
-- atsea soft link called from setsail this invokes scp to transport the (modified) file PROG
-- setsail soft link

Invoked by dockwork, applies file modifications and coordinates transport

of file.   Invokes atsea to send file via scp

 
thirdparty python package cross process locking support PROG
.docks folder

base folder monitored for write/close, delete, and move along with all its children

destinations are subfolders,  sources subfolders under destination folders

BASE
.onboard folder work folder where dockwork transfers files before invoking setsail BASE
DEST folder folder matching a Galleon destination label BASE/.doc,s
SRC folder folder matching a Galleon source label BASE/.docks/DEST
.treasuremap text file

one line text file. Required in destination folder or source folder or both.  The

format is a template for calling a subprocess whenever a file is moved or copied

into a monitored folder - see installation for details

BASE/.docks/DEST/SRC

or

BASE/.docks/DEST

 

Seven Seas Programs

The user level programs are the Galleon Send Interface program,  ship.sh, and the configuration program, seasick.

ship.sh

This is the program implementing the Galleon Send Interface.    The interface specifies the last three parameters.   The dock_path is the base directory where the .docks  monitored folder tree was placed during installation.   The program returns 1 if there are fewer than 3 parameters or if either/both of the source and destinations are not configured.  

Usage

usage: ./ship.sh [dock_path] <source> <destination> <filepath>
Transports file to destination, with return address as source
Arguments:
    dock_path     path assigned to folder used for .docks folder tree
                  defaults to '/work'
    destination   Galleon destination label
    source        Galleon source label

Notes

  • The program (via setsail) secure copies files to a destination / source folder structure configured/installed on the destination computer(s).
  • The folders are created manually.
  • Files are picked up and renamed every second.  Do not send multiple files with the same name more frequently than every two seconds
  • Each file may generate three Linux processes temporarily and one for the duration of the delay time.  If you are sending a file every 5 seconds and delaying 6 minutes,  at least 72 processes will be running.    Remember this if the sending system is sluggish.

seasick

This is the configuration program for the Seven Seas.  The only required parameters to set (using config) is the destination address  in scp format.   Only destination an sources on the sending side need to be configured using seasick.

On the receiving side  the minimal configuration is creating a .treasuremap file in each destination folder. 

Usage

usage: seasick [-h] COMMAND ...

Seven Seas Transport Configuration
optional arguments:
  -h, --help  show this help message and exit
Commands:
  COMMAND     transport modification to make
    config    configure settings for destination or destination/source
    list      list settings for destination or destination/source
    reset     reset settings for destination or destination/source
    delete    delete destination or destination/source

 

Usage for config command

usage: seasick config [-h] [--delay DELAY] [--extradelay EXTRA] [--dup DUP]
                      [--drop DROP] [--corrupt CORRUPT] [--truncate TRUNCATE]
                      [--order OOO] [--address DEST_IP]
                      destination [source]
positional arguments:
  destination          destination
  source               source
optional arguments:
  -h, --help           show this help message and exit
  --delay DELAY        minimum number of seconds to delay (0 - 3,600)
  --extradelay EXTRA   average extra number of seconds to delay (0 - 1,800)
  --dup DUP            'once' or num of transfers (of 1000) to dup
  --drop DROP          'once' or num of transfers (of 1000) to drop
  --corrupt CORRUPT    'once' or num of transfers (of 1000) to corrupt
  --truncate TRUNCATE  'once' or num of transfers (of 1000) to truncate
  --order OOO          once' or number of out-of-order transfers (of 1000)

    --address DEST_IP               ip address or hostname of destination

Notes

config
  • Configuration must be done on each system,  changes made to files are done on the sending side
  • Creates destination or destination/source if they do not exist, updates if they do.  Be sure to check your spelling.
  • Destination and settings must be acceptable Linux folder names.    The strings $SRC $DEST and $FILE are reserved, as is the character #
  • Any source level setting (e.g. dup) overrides any destination level setting.   The exception is a destination level once setting.
  • Settings are 0 - 1000,   as in baseball hitting stats   The represent the chance of each particular malady being applied
  • Maladies are cumulative,  and applied in this precedence (order, drop, corrupt, truncate, dup)   
  • Once (if) malady settings add up to 1000, one will be applied 100% of the time.  Any malady after that point will never be applied.   This is not error checked or reported.
  • A once setting forces the next file to exhibit that malady.   The setting then reverts to what it was previously.  The precedence is (order, drop, corrupt, truncate, dup)
  • A once setting at the destination level triggers on the first source (under that destination)  that sends a file.   The destination setting then reverts to what it was previously.
  • The file name is always changed, to a uuid string.
  • delay is the minimum amount of time in seconds before a file is sent
  • extradelay is the average amount of time in seconds in addition to the delay before a file is sent
  • drop deletes a file without sending it
  • truncate truncates a random number of bytes - up to the file size
  • corrupt overwrites1024 contiguous bytes (or file size, whichever is smaller) starting at a random seek position
  • dup sends a copy of  the file immediately  after the original.
  • order saves a file until another is sent, then sends them out of order,  the original file, immediately after the second
  • Setting a malady to 0 removes it from the configuration file.   It cannot override a destination level setting.
  • if order is set to 0 and a file is saved for out-of-order delivery it will be sent immediately
list
  • list without destination or source lists all the destinations
  • list with only a destination lists the destination address and all the sources under it (sources allowed to send to that destination)
  • list with destination and source list  the destination data and all the maladies (e.g.  dup) with their 1-1000 or once value
  • If a malady at source level is inherited from its destination parent its value will be listed in brackets -  e.g. [100]
  • If a file is reserved for out of order, the order malady will show the full file path to that file
reset
  • reset clears the maladies but does not remove destination or source
  • rest with only a destination clears/deletes the maladies at the destination level only.  The address is not cleared.
  • reset with destination and source clears the source maladies only
  • if a file is saved for out-of-order delivery it will be sent immediately
delete
  • delete removes a destination and all of its sources
  • delete with destination and source deletes the source
  • Deleting the .sick file removes everything.   The program will create a new one when a destination and/or source is configured.

Sea Sick Installation

Programs

  1. Designate a program folder - e.g.   /work/7Seas
  2. copy the distribution files to the  program folder
  3. create soft links within program folder
  4. ln -s 7seas.py atsea
  5. ln -s 7seas.py seasick
  6. ln -s 7seas.py setsail
  7. ln -s 7seas.py docwork

SSH Setup

  1. create ssh key pairs for each system at root level
  2. ssh-copy-id -i root@host_ip
  3. try to ssh to root@host_ip
  4. try a scp

Service Installation

7seas is a service wrapper script that runs the dockwork program.

  1. in folder /etc/init.d   (on ubuntu) create a soft link
    1. ln -s /work/7Seas  7seas
  2. sudo update-rc.d 7seas defaults
  3. setup the 7seas.conf file as described in the next section, number 2
  4. sudo service 7seas  [start | stop | restart | status]
    1. use start to enable monitoring

Dropbox (.docks) Setup

The 7seas service monitors the .docks folder tree.    It looks in each source folder for a .treasuremap file for a template on what to do with any file that is moved or written / copied into that folder.    The service moves every file to a .onboard folder, then invokes the substituted .treasuremap line as a non blocking process.  If you move, copy, edit, drop, or touch (but not move out)  a .treasuremap, the service will detect and update its cache.   The service does not need to be restarted.  See .treasuremap Format for more details.

  1. create a .docks folder   e.g.   /work/.docks  the default host location is /work
  2. in program folder (e.g. /work) create a text file
    1. name it 7seas.conf
    2. the single line is the host location filepath,  in the defauilt case /work
  3. for every destination create a folder under .docks with the exact same name
  4. for every source (on the local system) that might send to a destination create a folder under the destination folder
  5. in every destination folder create a .tresuremap text file - see below for format
  6. for destination folders where the destination is on a remote vm/computer use setsail  to invoke the Seven Seas transport
  7. for destination folders where the destination is a program on the host / current vm/computer use the Galleon receiver program
  8. If a file needs to be handled at the source level create a .treasuremap file in that destination/source folder

.treasuremap Format

A single line of text.  After substitutions dockwork executes the line without waiting/blocking

Bacus Naur

<program>[#[PARAMS]

\#  is used to separate parameters - this allows spaces to be used in source destination and arbitrary text parameters

PARAMS = PARAM  [PARAMS]

PARAM =  text | $SRC | $DEST | $FILE

$SRC = source is substituted by dockwork

$DEST = destination is substituted by dockwork

$FILE = full file path to file being sent

Examples

Example for sending file to a destination using Seven Seas Transport

/work/7Seas#$SRC#$DEST#$FILE

Example of receiving file from another system/computer/VM.  Here receiver is your Galleon Interface Receiver application

/work/receiver/$SRC#$DEST#$FILE

Logging

All Seven Seas Transport programs log to syslog, and to the console, if run manually.     The program generated portion of each line is comma separated for ease of import into Excel,  etc

grep shiplog /var/log/syslog   will output all log lines pertaining to Seven Seas

Line format

date hostname shiplog,verb,source,destination,filepath,filepath2,comment

verb =  execute | info | event | mv | map | list | config | reset | delete | dup | corrupt | truncate | drop | order | delay| sending| error | rm

source, destination =  source and destination if known/applicable

execute = invoking non blocking process using line in comment

info =  non critical informational message in comment - usually a transient file (swp) in monitor are caused by editing in place

event =  move, delete, or close/write file action in monitored folder

mv = rename of file in .onboard,   gives original and new names in filepath and filepath2

map = a new or changed .treasuremap has been detected,  It is being cached

list = seasick list has been run - the  .sick configuration filepath is in filepath

config = seasick config has been run - the  .sick configuration filepath is in filepath

reset= seasick rest has been run - the  .sick configuration filepath is in filepath

delete= seasick delete has been run - the  .sick configuration filepath is in filepath

dup = a file has been duplicated, renamed file (uuid name) will be in filepath

corrupt = a file has been corrupted,   the comment will give seek offset and size corrupted

truncate = a file was truncated,  new size in comment

drop = a file was deleted and not sent

order = a file is being saved for later out-of-order delivery or being sent out-of-order

delay = a file is being delayed, number of seconds in comment

sending = a file is being sent via scp

error = multipe e.g.  no destination address configured,  or scp returned fail status

rm = file has been deleted,  usually after being sent

Notes, Issues, and Known Errors

Development level testing determined that throughput is about 3 files per second between to VMs hosted on the same system.     Faster rates seem to cause scp failures.

Source level settings override the parent destination setting.   There are two exceptions,   when the destination setting is "once" or when the source setting is 0 out of 1000.    

 

e-Highlighter

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

Un-highlight all Un-highlight selectionu Highlight selectionh