source: wiki/Overview.wiki @ 24

Last change on this file since 24 was 24, checked in by tmorgan, 12 years ago

more docs

File size: 2.1 KB
Line 
1Bletchley provides a variety of tools that make black box
2cryptanalysis easier by taking care of some of the more tedious
3engineering challenges. Bletchley is maintained by <a href="http://vsecurity.com/">VSR</a>.
4Bletchley is currently in the early stages of development, which means
5documentation may be lacking.  Contributions are welcome.
6
7*Contents*
8<wiki:toc max_depth="2" />
9
10
11= Command Line Tools =
12
13== bletchley-analyze ==
14
15Analyzes samples of encrypted data in an attempt to decode samples to
16binary and identify patterns useful in cryptanalysis.  The purpose of
17the tool is to provide an cryptanalyst with a variety of information
18that is useful in determining how a token is encoded, encrypted and
19formatted.
20<br />
21bletchley-analyze currently performs two primary functions: iterative
22encoding detection and ciphertext-only block analysis.  Encrypted tokens
23are processed in multiple rounds. Within each round, the following
24occurs:
25<ul>
26 <li>Token length analysis is performed to attempt to determine possible
27 ciphertext block sizes, where applicable</li>
28 <li>The tokens are analyzed for blocks of data that are repeated
29 throughout any of the tokens</li>
30 <li>A hexadecimal dump and escaped binary/ascii string is printed for
31 each token with repeated blocks highlighted</li>
32 <li>The full set of all known and possible data encodings is
33 determined<sup>1</sup></li>
34 <li>An educated guess is made as to the most likely encoding is</li>
35 <li>All tokens are decoded using the most likely encoding, and then the
36 process is repeated until no further encodings are detected</li>
37</ul>
38
39bletchley-analyze can read from stdin or from a file.  Tokens are
40delimited with newlines.  Various options are provided to give the
41analyst control over the block sizes and encoding used during analysis.
42See the tool's usage statement for more information.
43
441. <i>Bletchley's blobtools module currently supports 33 encoding variants,
45including various forms of hexadecimal, base32, base64, and percent
46encodings.</i>
47
48
49== bletchley-encode ==
50TODO
51
52== bletchley-decode ==
53TODO
54
55== bletchley-http2py ==
56TODO
57
58== bletchley-nextrand ==
59TODO
60
61
62= Libraries =
63
64TODO
Note: See TracBrowser for help on using the repository browser.