The Tor Browser / annotate

security/nss/doc/nroff/ssltap.1@b8a032363ba2 (annotated)

security/nss/doc/nroff/ssltap.1

Thu, 22 Jan 2015 13:21:57 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 22 Jan 2015 13:21:57 +0100
branch
TOR_BUG_9701
changeset 15
b8a032363ba2
permissions
-rw-r--r--

Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6

michael@0 1 '\" t
michael@0 2 .\" Title: SSLTAP
michael@0 3 .\" Author: [see the "Authors" section]
michael@0 4 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
michael@0 5 .\" Date: 5 June 2014
michael@0 6 .\" Manual: NSS Security Tools
michael@0 7 .\" Source: nss-tools
michael@0 8 .\" Language: English
michael@0 9 .\"
michael@0 10 .TH "SSLTAP" "1" "5 June 2014" "nss-tools" "NSS Security Tools"
michael@0 11 .\" -----------------------------------------------------------------
michael@0 12 .\" * Define some portability stuff
michael@0 13 .\" -----------------------------------------------------------------
michael@0 14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
michael@0 15 .\" http://bugs.debian.org/507673
michael@0 16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
michael@0 17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
michael@0 18 .ie \n(.g .ds Aq \(aq
michael@0 19 .el .ds Aq '
michael@0 20 .\" -----------------------------------------------------------------
michael@0 21 .\" * set default formatting
michael@0 22 .\" -----------------------------------------------------------------
michael@0 23 .\" disable hyphenation
michael@0 24 .nh
michael@0 25 .\" disable justification (adjust text to left margin only)
michael@0 26 .ad l
michael@0 27 .\" -----------------------------------------------------------------
michael@0 28 .\" * MAIN CONTENT STARTS HERE *
michael@0 29 .\" -----------------------------------------------------------------
michael@0 30 .SH "NAME"
michael@0 31 ssltap \- Tap into SSL connections and display the data going by
michael@0 32 .SH "SYNOPSIS"
michael@0 33 .HP \w'\fBssltap\fR\ 'u
michael@0 34 \fBssltap\fR [\-fhlsvx] [\-p\ port] [hostname:port]
michael@0 35 .SH "STATUS"
michael@0 36 .PP
michael@0 37 This documentation is still work in progress\&. Please contribute to the initial review in
michael@0 38 \m[blue]\fBMozilla NSS bug 836477\fR\m[]\&\s-2\u[1]\d\s+2
michael@0 39 .SH "DESCRIPTION"
michael@0 40 .PP
michael@0 41 The SSL Debugging Tool
michael@0 42 \fBssltap\fR
michael@0 43 is an SSL\-aware command\-line proxy\&. It watches TCP connections and displays the data going by\&. If a connection is SSL, the data display includes interpreted SSL records and handshaking
michael@0 44 .SH "OPTIONS"
michael@0 45 .PP
michael@0 46 \-f
michael@0 47 .RS 4
michael@0 48 Turn on fancy printing\&. Output is printed in colored HTML\&. Data sent from the client to the server is in blue; the server\*(Aqs reply is in red\&. When used with looping mode, the different connections are separated with horizontal lines\&. You can use this option to upload the output into a browser\&.
michael@0 49 .RE
michael@0 50 .PP
michael@0 51 \-h
michael@0 52 .RS 4
michael@0 53 Turn on hex/ASCII printing\&. Instead of outputting raw data, the command interprets each record as a numbered line of hex values, followed by the same data as ASCII characters\&. The two parts are separated by a vertical bar\&. Nonprinting characters are replaced by dots\&.
michael@0 54 .RE
michael@0 55 .PP
michael@0 56 \-l prefix
michael@0 57 .RS 4
michael@0 58 Turn on looping; that is, continue to accept connections rather than stopping after the first connection is complete\&.
michael@0 59 .RE
michael@0 60 .PP
michael@0 61 \-p port
michael@0 62 .RS 4
michael@0 63 Change the default rendezvous port (1924) to another port\&.
michael@0 64 .sp
michael@0 65 The following are well\-known port numbers:
michael@0 66 .sp
michael@0 67 * HTTP 80
michael@0 68 .sp
michael@0 69 * HTTPS 443
michael@0 70 .sp
michael@0 71 * SMTP 25
michael@0 72 .sp
michael@0 73 * FTP 21
michael@0 74 .sp
michael@0 75 * IMAP 143
michael@0 76 .sp
michael@0 77 * IMAPS 993 (IMAP over SSL)
michael@0 78 .sp
michael@0 79 * NNTP 119
michael@0 80 .sp
michael@0 81 * NNTPS 563 (NNTP over SSL)
michael@0 82 .RE
michael@0 83 .PP
michael@0 84 \-s
michael@0 85 .RS 4
michael@0 86 Turn on SSL parsing and decoding\&. The tool does not automatically detect SSL sessions\&. If you are intercepting an SSL connection, use this option so that the tool can detect and decode SSL structures\&.
michael@0 87 .sp
michael@0 88 If the tool detects a certificate chain, it saves the DER\-encoded certificates into files in the current directory\&. The files are named cert\&.0x, where x is the sequence number of the certificate\&.
michael@0 89 .sp
michael@0 90 If the \-s option is used with \-h, two separate parts are printed for each record: the plain hex/ASCII output, and the parsed SSL output\&.
michael@0 91 .RE
michael@0 92 .PP
michael@0 93 \-v
michael@0 94 .RS 4
michael@0 95 Print a version string for the tool\&.
michael@0 96 .RE
michael@0 97 .PP
michael@0 98 \-x
michael@0 99 .RS 4
michael@0 100 Turn on extra SSL hex dumps\&.
michael@0 101 .RE
michael@0 102 .SH "USAGE AND EXAMPLES"
michael@0 103 .PP
michael@0 104 You can use the SSL Debugging Tool to intercept any connection information\&. Although you can run the tool at its most basic by issuing the ssltap command with no options other than hostname:port, the information you get in this way is not very useful\&. For example, assume your development machine is called intercept\&. The simplest way to use the debugging tool is to execute the following command from a command shell:
michael@0 105 .sp
michael@0 106 .if n \{\
michael@0 107 .RS 4
michael@0 108 .\}
michael@0 109 .nf
michael@0 110 $ ssltap www\&.netscape\&.com
michael@0 111 .fi
michael@0 112 .if n \{\
michael@0 113 .RE
michael@0 114 .\}
michael@0 115 .PP
michael@0 116 The program waits for an incoming connection on the default port 1924\&. In your browser window, enter the URL http://intercept:1924\&. The browser retrieves the requested page from the server at www\&.netscape\&.com, but the page is intercepted and passed on to the browser by the debugging tool on intercept\&. On its way to the browser, the data is printed to the command shell from which you issued the command\&. Data sent from the client to the server is surrounded by the following symbols: \-\-> [ data ] Data sent from the server to the client is surrounded by the following symbols: "left arrow"\-\- [ data ] The raw data stream is sent to standard output and is not interpreted in any way\&. This can result in peculiar effects, such as sounds, flashes, and even crashes of the command shell window\&. To output a basic, printable interpretation of the data, use the \-h option, or, if you are looking at an SSL connection, the \-s option\&. You will notice that the page you retrieved looks incomplete in the browser\&. This is because, by default, the tool closes down after the first connection is complete, so the browser is not able to load images\&. To make the tool continue to accept connections, switch on looping mode with the \-l option\&. The following examples show the output from commonly used combinations of options\&.
michael@0 117 .PP
michael@0 118 Example 1
michael@0 119 .sp
michael@0 120 .if n \{\
michael@0 121 .RS 4
michael@0 122 .\}
michael@0 123 .nf
michael@0 124 $ ssltap\&.exe \-sx \-p 444 interzone\&.mcom\&.com:443 > sx\&.txt
michael@0 125 .fi
michael@0 126 .if n \{\
michael@0 127 .RE
michael@0 128 .\}
michael@0 129 .PP
michael@0 130 Output
michael@0 131 .sp
michael@0 132 .if n \{\
michael@0 133 .RS 4
michael@0 134 .\}
michael@0 135 .nf
michael@0 136 Connected to interzone\&.mcom\&.com:443
michael@0 137 \-\->; [
michael@0 138 alloclen = 66 bytes
michael@0 139 [ssl2] ClientHelloV2 {
michael@0 140 version = {0x03, 0x00}
michael@0 141 cipher\-specs\-length = 39 (0x27)
michael@0 142 sid\-length = 0 (0x00)
michael@0 143 challenge\-length = 16 (0x10)
michael@0 144 cipher\-suites = {
michael@0 145
michael@0 146 (0x010080) SSL2/RSA/RC4\-128/MD5
michael@0 147 (0x020080) SSL2/RSA/RC4\-40/MD5
michael@0 148 (0x030080) SSL2/RSA/RC2CBC128/MD5
michael@0 149 (0x040080) SSL2/RSA/RC2CBC40/MD5
michael@0 150 (0x060040) SSL2/RSA/DES64CBC/MD5
michael@0 151 (0x0700c0) SSL2/RSA/3DES192EDE\-CBC/MD5
michael@0 152 (0x000004) SSL3/RSA/RC4\-128/MD5
michael@0 153 (0x00ffe0) SSL3/RSA\-FIPS/3DES192EDE\-CBC/SHA
michael@0 154 (0x00000a) SSL3/RSA/3DES192EDE\-CBC/SHA
michael@0 155 (0x00ffe1) SSL3/RSA\-FIPS/DES64CBC/SHA
michael@0 156 (0x000009) SSL3/RSA/DES64CBC/SHA
michael@0 157 (0x000003) SSL3/RSA/RC4\-40/MD5
michael@0 158 (0x000006) SSL3/RSA/RC2CBC40/MD5
michael@0 159 }
michael@0 160 session\-id = { }
michael@0 161 challenge = { 0xec5d 0x8edb 0x37c9 0xb5c9 0x7b70 0x8fe9 0xd1d3
michael@0 162
michael@0 163 0x2592 }
michael@0 164 }
michael@0 165 ]
michael@0 166 <\-\- [
michael@0 167 SSLRecord {
michael@0 168 0: 16 03 00 03 e5 |\&.\&.\&.\&.\&.
michael@0 169 type = 22 (handshake)
michael@0 170 version = { 3,0 }
michael@0 171 length = 997 (0x3e5)
michael@0 172 handshake {
michael@0 173 0: 02 00 00 46 |\&.\&.\&.F
michael@0 174 type = 2 (server_hello)
michael@0 175 length = 70 (0x000046)
michael@0 176 ServerHello {
michael@0 177 server_version = {3, 0}
michael@0 178 random = {\&.\&.\&.}
michael@0 179 0: 77 8c 6e 26 6c 0c ec c0 d9 58 4f 47 d3 2d 01 45 |
michael@0 180 wn&l\&.\(`i\&.\&.XOG\&.\-\&.E
michael@0 181 10: 5c 17 75 43 a7 4c 88 c7 88 64 3c 50 41 48 4f 7f |
michael@0 182
michael@0 183 \e\&.uC\(scL\&.\(,C\&.d<PAHO\&.
michael@0 184 session ID = {
michael@0 185 length = 32
michael@0 186
michael@0 187 contents = {\&.\&.}
michael@0 188 0: 14 11 07 a8 2a 31 91 29 11 94 40 37 57 10 a7 32 | \&.\&.\&.\(ad*1\&.)\&.\&.@7W\&.\(sc2
michael@0 189 10: 56 6f 52 62 fe 3d b3 65 b1 e4 13 0f 52 a3 c8 f6 | VoRb\(Tp=\(S3e\(+-\&.\&.\&.R\(Po\(`E\&.
michael@0 190 }
michael@0 191 cipher_suite = (0x0003) SSL3/RSA/RC4\-40/MD5
michael@0 192 }
michael@0 193 0: 0b 00 02 c5 |\&.\&.\&.\(oA
michael@0 194 type = 11 (certificate)
michael@0 195 length = 709 (0x0002c5)
michael@0 196 CertificateChain {
michael@0 197 chainlength = 706 (0x02c2)
michael@0 198 Certificate {
michael@0 199 size = 703 (0x02bf)
michael@0 200 data = { saved in file \*(Aqcert\&.001\*(Aq }
michael@0 201 }
michael@0 202 }
michael@0 203 0: 0c 00 00 ca |\&.\&.\&.\&.
michael@0 204 type = 12 (server_key_exchange)
michael@0 205 length = 202 (0x0000ca)
michael@0 206 0: 0e 00 00 00 |\&.\&.\&.\&.
michael@0 207 type = 14 (server_hello_done)
michael@0 208 length = 0 (0x000000)
michael@0 209 }
michael@0 210 }
michael@0 211 ]
michael@0 212 \-\-> [
michael@0 213 SSLRecord {
michael@0 214 0: 16 03 00 00 44 |\&.\&.\&.\&.D
michael@0 215 type = 22 (handshake)
michael@0 216 version = { 3,0 }
michael@0 217 length = 68 (0x44)
michael@0 218 handshake {
michael@0 219 0: 10 00 00 40 |\&.\&.\&.@
michael@0 220 type = 16 (client_key_exchange)
michael@0 221 length = 64 (0x000040)
michael@0 222 ClientKeyExchange {
michael@0 223 message = {\&.\&.\&.}
michael@0 224 }
michael@0 225 }
michael@0 226 }
michael@0 227 ]
michael@0 228 \-\-> [
michael@0 229 SSLRecord {
michael@0 230 0: 14 03 00 00 01 |\&.\&.\&.\&.\&.
michael@0 231 type = 20 (change_cipher_spec)
michael@0 232 version = { 3,0 }
michael@0 233 length = 1 (0x1)
michael@0 234 0: 01 |\&.
michael@0 235 }
michael@0 236 SSLRecord {
michael@0 237 0: 16 03 00 00 38 |\&.\&.\&.\&.8
michael@0 238 type = 22 (handshake)
michael@0 239 version = { 3,0 }
michael@0 240 length = 56 (0x38)
michael@0 241 < encrypted >
michael@0 242
michael@0 243 }
michael@0 244 ]
michael@0 245 <\-\- [
michael@0 246 SSLRecord {
michael@0 247 0: 14 03 00 00 01 |\&.\&.\&.\&.\&.
michael@0 248 type = 20 (change_cipher_spec)
michael@0 249 version = { 3,0 }
michael@0 250 length = 1 (0x1)
michael@0 251 0: 01 |\&.
michael@0 252 }
michael@0 253 ]
michael@0 254 <\-\- [
michael@0 255 SSLRecord {
michael@0 256 0: 16 03 00 00 38 |\&.\&.\&.\&.8
michael@0 257 type = 22 (handshake)
michael@0 258 version = { 3,0 }
michael@0 259 length = 56 (0x38)
michael@0 260 < encrypted >
michael@0 261
michael@0 262 }
michael@0 263 ]
michael@0 264 \-\-> [
michael@0 265 SSLRecord {
michael@0 266 0: 17 03 00 01 1f |\&.\&.\&.\&.\&.
michael@0 267 type = 23 (application_data)
michael@0 268 version = { 3,0 }
michael@0 269 length = 287 (0x11f)
michael@0 270 < encrypted >
michael@0 271 }
michael@0 272 ]
michael@0 273 <\-\- [
michael@0 274 SSLRecord {
michael@0 275 0: 17 03 00 00 a0 |\&.\&.\&.\&.
michael@0 276 type = 23 (application_data)
michael@0 277 version = { 3,0 }
michael@0 278 length = 160 (0xa0)
michael@0 279 < encrypted >
michael@0 280
michael@0 281 }
michael@0 282 ]
michael@0 283 <\-\- [
michael@0 284 SSLRecord {
michael@0 285 0: 17 03 00 00 df |\&.\&.\&.\&.\(ss
michael@0 286 type = 23 (application_data)
michael@0 287 version = { 3,0 }
michael@0 288 length = 223 (0xdf)
michael@0 289 < encrypted >
michael@0 290
michael@0 291 }
michael@0 292 SSLRecord {
michael@0 293 0: 15 03 00 00 12 |\&.\&.\&.\&.\&.
michael@0 294 type = 21 (alert)
michael@0 295 version = { 3,0 }
michael@0 296 length = 18 (0x12)
michael@0 297 < encrypted >
michael@0 298 }
michael@0 299 ]
michael@0 300 Server socket closed\&.
michael@0 301 .fi
michael@0 302 .if n \{\
michael@0 303 .RE
michael@0 304 .\}
michael@0 305 .PP
michael@0 306 Example 2
michael@0 307 .PP
michael@0 308 The \-s option turns on SSL parsing\&. Because the \-x option is not used in this example, undecoded values are output as raw data\&. The output is routed to a text file\&.
michael@0 309 .sp
michael@0 310 .if n \{\
michael@0 311 .RS 4
michael@0 312 .\}
michael@0 313 .nf
michael@0 314 $ ssltap \-s \-p 444 interzone\&.mcom\&.com:443 > s\&.txt
michael@0 315 .fi
michael@0 316 .if n \{\
michael@0 317 .RE
michael@0 318 .\}
michael@0 319 .PP
michael@0 320 Output
michael@0 321 .sp
michael@0 322 .if n \{\
michael@0 323 .RS 4
michael@0 324 .\}
michael@0 325 .nf
michael@0 326 Connected to interzone\&.mcom\&.com:443
michael@0 327 \-\-> [
michael@0 328 alloclen = 63 bytes
michael@0 329 [ssl2] ClientHelloV2 {
michael@0 330 version = {0x03, 0x00}
michael@0 331 cipher\-specs\-length = 36 (0x24)
michael@0 332 sid\-length = 0 (0x00)
michael@0 333 challenge\-length = 16 (0x10)
michael@0 334 cipher\-suites = {
michael@0 335 (0x010080) SSL2/RSA/RC4\-128/MD5
michael@0 336 (0x020080) SSL2/RSA/RC4\-40/MD5
michael@0 337 (0x030080) SSL2/RSA/RC2CBC128/MD5
michael@0 338 (0x060040) SSL2/RSA/DES64CBC/MD5
michael@0 339 (0x0700c0) SSL2/RSA/3DES192EDE\-CBC/MD5
michael@0 340 (0x000004) SSL3/RSA/RC4\-128/MD5
michael@0 341 (0x00ffe0) SSL3/RSA\-FIPS/3DES192EDE\-CBC/SHA
michael@0 342 (0x00000a) SSL3/RSA/3DES192EDE\-CBC/SHA
michael@0 343 (0x00ffe1) SSL3/RSA\-FIPS/DES64CBC/SHA
michael@0 344 (0x000009) SSL3/RSA/DES64CBC/SHA
michael@0 345 (0x000003) SSL3/RSA/RC4\-40/MD5
michael@0 346 }
michael@0 347 session\-id = { }
michael@0 348 challenge = { 0x713c 0x9338 0x30e1 0xf8d6 0xb934 0x7351 0x200c
michael@0 349 0x3fd0 }
michael@0 350 ]
michael@0 351 >\-\- [
michael@0 352 SSLRecord {
michael@0 353 type = 22 (handshake)
michael@0 354 version = { 3,0 }
michael@0 355 length = 997 (0x3e5)
michael@0 356 handshake {
michael@0 357 type = 2 (server_hello)
michael@0 358 length = 70 (0x000046)
michael@0 359 ServerHello {
michael@0 360 server_version = {3, 0}
michael@0 361 random = {\&.\&.\&.}
michael@0 362 session ID = {
michael@0 363 length = 32
michael@0 364 contents = {\&.\&.}
michael@0 365 }
michael@0 366 cipher_suite = (0x0003) SSL3/RSA/RC4\-40/MD5
michael@0 367 }
michael@0 368 type = 11 (certificate)
michael@0 369 length = 709 (0x0002c5)
michael@0 370 CertificateChain {
michael@0 371 chainlength = 706 (0x02c2)
michael@0 372 Certificate {
michael@0 373 size = 703 (0x02bf)
michael@0 374 data = { saved in file \*(Aqcert\&.001\*(Aq }
michael@0 375 }
michael@0 376 }
michael@0 377 type = 12 (server_key_exchange)
michael@0 378 length = 202 (0x0000ca)
michael@0 379 type = 14 (server_hello_done)
michael@0 380 length = 0 (0x000000)
michael@0 381 }
michael@0 382 }
michael@0 383 ]
michael@0 384 \-\-> [
michael@0 385 SSLRecord {
michael@0 386 type = 22 (handshake)
michael@0 387 version = { 3,0 }
michael@0 388 length = 68 (0x44)
michael@0 389 handshake {
michael@0 390 type = 16 (client_key_exchange)
michael@0 391 length = 64 (0x000040)
michael@0 392 ClientKeyExchange {
michael@0 393 message = {\&.\&.\&.}
michael@0 394 }
michael@0 395 }
michael@0 396 }
michael@0 397 ]
michael@0 398 \-\-> [
michael@0 399 SSLRecord {
michael@0 400 type = 20 (change_cipher_spec)
michael@0 401 version = { 3,0 }
michael@0 402 length = 1 (0x1)
michael@0 403 }
michael@0 404 SSLRecord {
michael@0 405 type = 22 (handshake)
michael@0 406 version = { 3,0 }
michael@0 407 length = 56 (0x38)
michael@0 408 > encrypted >
michael@0 409 }
michael@0 410 ]
michael@0 411 >\-\- [
michael@0 412 SSLRecord {
michael@0 413 type = 20 (change_cipher_spec)
michael@0 414 version = { 3,0 }
michael@0 415 length = 1 (0x1)
michael@0 416 }
michael@0 417 ]
michael@0 418 >\-\- [
michael@0 419 SSLRecord {
michael@0 420 type = 22 (handshake)
michael@0 421 version = { 3,0 }
michael@0 422 length = 56 (0x38)
michael@0 423 > encrypted >
michael@0 424 }
michael@0 425 ]
michael@0 426 \-\-> [
michael@0 427 SSLRecord {
michael@0 428 type = 23 (application_data)
michael@0 429 version = { 3,0 }
michael@0 430 length = 287 (0x11f)
michael@0 431 > encrypted >
michael@0 432 }
michael@0 433 ]
michael@0 434 [
michael@0 435 SSLRecord {
michael@0 436 type = 23 (application_data)
michael@0 437 version = { 3,0 }
michael@0 438 length = 160 (0xa0)
michael@0 439 > encrypted >
michael@0 440 }
michael@0 441 ]
michael@0 442 >\-\- [
michael@0 443 SSLRecord {
michael@0 444 type = 23 (application_data)
michael@0 445 version = { 3,0 }
michael@0 446 length = 223 (0xdf)
michael@0 447 > encrypted >
michael@0 448 }
michael@0 449 SSLRecord {
michael@0 450 type = 21 (alert)
michael@0 451 version = { 3,0 }
michael@0 452 length = 18 (0x12)
michael@0 453 > encrypted >
michael@0 454 }
michael@0 455 ]
michael@0 456 Server socket closed\&.
michael@0 457 .fi
michael@0 458 .if n \{\
michael@0 459 .RE
michael@0 460 .\}
michael@0 461 .PP
michael@0 462 Example 3
michael@0 463 .PP
michael@0 464 In this example, the \-h option turns hex/ASCII format\&. There is no SSL parsing or decoding\&. The output is routed to a text file\&.
michael@0 465 .sp
michael@0 466 .if n \{\
michael@0 467 .RS 4
michael@0 468 .\}
michael@0 469 .nf
michael@0 470 $ ssltap \-h \-p 444 interzone\&.mcom\&.com:443 > h\&.txt
michael@0 471 .fi
michael@0 472 .if n \{\
michael@0 473 .RE
michael@0 474 .\}
michael@0 475 .PP
michael@0 476 Output
michael@0 477 .sp
michael@0 478 .if n \{\
michael@0 479 .RS 4
michael@0 480 .\}
michael@0 481 .nf
michael@0 482 Connected to interzone\&.mcom\&.com:443
michael@0 483 \-\-> [
michael@0 484 0: 80 40 01 03 00 00 27 00 00 00 10 01 00 80 02 00 | \&.@\&.\&.\&.\&.\*(Aq\&.\&.\&.\&.\&.\&.\&.\&.\&.
michael@0 485 10: 80 03 00 80 04 00 80 06 00 40 07 00 c0 00 00 04 | \&.\&.\&.\&.\&.\&.\&.\&.\&.@\&.\&.\&.\&.\&.\&.
michael@0 486 20: 00 ff e0 00 00 0a 00 ff e1 00 00 09 00 00 03 00 | \&.\&.\&.\&.\&.\&.\&.\&.\('a\&.\&.\&.\&.\&.\&.\&.
michael@0 487 30: 00 06 9b fe 5b 56 96 49 1f 9f ca dd d5 ba b9 52 | \&.\&.\(Tp[V\&.I\&.\exd9 \&.\&.\&.\(Om\(S1R
michael@0 488 40: 6f 2d |o\-
michael@0 489 ]
michael@0 490 <\-\- [
michael@0 491 0: 16 03 00 03 e5 02 00 00 46 03 00 7f e5 0d 1b 1d | \&.\&.\&.\&.\&.\&.\&.\&.F\&.\&.\&.\&.\&.\&.\&.
michael@0 492 10: 68 7f 3a 79 60 d5 17 3c 1d 9c 96 b3 88 d2 69 3b | h\&.:y`\&.\&.<\&.\&.\(S3\&.\(`Oi;
michael@0 493 20: 78 e2 4b 8b a6 52 12 4b 46 e8 c2 20 14 11 89 05 | x\&.K\&.\(bbR\&.KF\(`e\&. \&.\&.\&.
michael@0 494 30: 4d 52 91 fd 93 e0 51 48 91 90 08 96 c1 b6 76 77 | MR\&.\('y\&.\&.QH\&.\&.\&.\&.\&.\(psvw
michael@0 495 40: 2a f4 00 08 a1 06 61 a2 64 1f 2e 9b 00 03 00 0b | *\(^o\&.\&.\(r!\&.a\(ctd\&.\&.\&.\&.\&.\&.
michael@0 496 50: 00 02 c5 00 02 c2 00 02 bf 30 82 02 bb 30 82 02 | \&.\&.\(oA\&.\&.\&.\&.\&.\&.0\&.\&.\&.0\&.\&.
michael@0 497 60: 24 a0 03 02 01 02 02 02 01 36 30 0d 06 09 2a 86 | $ \&.\&.\&.\&.\&.\&.\&.60\&.\&.\&.*\&.
michael@0 498 70: 48 86 f7 0d 01 01 04 05 00 30 77 31 0b 30 09 06 | H\&.\(di\&.\&.\&.\&.\&.\&.0w1\&.0\&.\&.
michael@0 499 80: 03 55 04 06 13 02 55 53 31 2c 30 2a 06 03 55 04 | \&.U\&.\&.\&.\&.US1,0*\&.\&.U\&.
michael@0 500 90: 0a 13 23 4e 65 74 73 63 61 70 65 20 43 6f 6d 6d | \&.\&.#Netscape Comm
michael@0 501 a0: 75 6e 69 63 61 74 69 6f 6e 73 20 43 6f 72 70 6f | unications Corpo
michael@0 502 b0: 72 61 74 69 6f 6e 31 11 30 0f 06 03 55 04 0b 13 | ration1\&.0\&.\&.\&.U\&.\&.\&.
michael@0 503 c0: 08 48 61 72 64 63 6f 72 65 31 27 30 25 06 03 55 | \&.Hardcore1\*(Aq0%\&.\&.U
michael@0 504 d0: 04 03 13 1e 48 61 72 64 63 6f 72 65 20 43 65 72 | \&.\&.\&.\&.Hardcore Cer
michael@0 505 e0: 74 69 66 69 63 61 74 65 20 53 65 72 76 65 72 20 | tificate Server
michael@0 506 f0: 49 49 30 1e 17 0d 39 38 30 35 31 36 30 31 30 33 | II0\&.\&.\&.9805160103
michael@0 507 <additional data lines>
michael@0 508 ]
michael@0 509 <additional records in same format>
michael@0 510 Server socket closed\&.
michael@0 511 .fi
michael@0 512 .if n \{\
michael@0 513 .RE
michael@0 514 .\}
michael@0 515 .PP
michael@0 516 Example 4
michael@0 517 .PP
michael@0 518 In this example, the \-s option turns on SSL parsing, and the \-h option turns on hex/ASCII format\&. Both formats are shown for each record\&. The output is routed to a text file\&.
michael@0 519 .sp
michael@0 520 .if n \{\
michael@0 521 .RS 4
michael@0 522 .\}
michael@0 523 .nf
michael@0 524 $ ssltap \-hs \-p 444 interzone\&.mcom\&.com:443 > hs\&.txt
michael@0 525 .fi
michael@0 526 .if n \{\
michael@0 527 .RE
michael@0 528 .\}
michael@0 529 .PP
michael@0 530 Output
michael@0 531 .sp
michael@0 532 .if n \{\
michael@0 533 .RS 4
michael@0 534 .\}
michael@0 535 .nf
michael@0 536 Connected to interzone\&.mcom\&.com:443
michael@0 537 \-\-> [
michael@0 538 0: 80 3d 01 03 00 00 24 00 00 00 10 01 00 80 02 00 | \&.=\&.\&.\&.\&.$\&.\&.\&.\&.\&.\&.\&.\&.\&.
michael@0 539 10: 80 03 00 80 04 00 80 06 00 40 07 00 c0 00 00 04 | \&.\&.\&.\&.\&.\&.\&.\&.\&.@\&.\&.\&.\&.\&.\&.
michael@0 540 20: 00 ff e0 00 00 0a 00 ff e1 00 00 09 00 00 03 03 | \&.\&.\&.\&.\&.\&.\&.\&.\('a\&.\&.\&.\&.\&.\&.\&.
michael@0 541 30: 55 e6 e4 99 79 c7 d7 2c 86 78 96 5d b5 cf e9 |U\&.\&.y\(,C\exb0 ,\&.x\&.]\(mc\(:I\('e
michael@0 542 alloclen = 63 bytes
michael@0 543 [ssl2] ClientHelloV2 {
michael@0 544 version = {0x03, 0x00}
michael@0 545 cipher\-specs\-length = 36 (0x24)
michael@0 546 sid\-length = 0 (0x00)
michael@0 547 challenge\-length = 16 (0x10)
michael@0 548 cipher\-suites = {
michael@0 549 (0x010080) SSL2/RSA/RC4\-128/MD5
michael@0 550 (0x020080) SSL2/RSA/RC4\-40/MD5
michael@0 551 (0x030080) SSL2/RSA/RC2CBC128/MD5
michael@0 552 (0x040080) SSL2/RSA/RC2CBC40/MD5
michael@0 553 (0x060040) SSL2/RSA/DES64CBC/MD5
michael@0 554 (0x0700c0) SSL2/RSA/3DES192EDE\-CBC/MD5
michael@0 555 (0x000004) SSL3/RSA/RC4\-128/MD5
michael@0 556 (0x00ffe0) SSL3/RSA\-FIPS/3DES192EDE\-CBC/SHA
michael@0 557 (0x00000a) SSL3/RSA/3DES192EDE\-CBC/SHA
michael@0 558 (0x00ffe1) SSL3/RSA\-FIPS/DES64CBC/SHA
michael@0 559 (0x000009) SSL3/RSA/DES64CBC/SHA
michael@0 560 (0x000003) SSL3/RSA/RC4\-40/MD5
michael@0 561 }
michael@0 562 session\-id = { }
michael@0 563 challenge = { 0x0355 0xe6e4 0x9979 0xc7d7 0x2c86 0x7896 0x5db
michael@0 564
michael@0 565 0xcfe9 }
michael@0 566 }
michael@0 567 ]
michael@0 568 <additional records in same formats>
michael@0 569 Server socket closed\&.
michael@0 570 .fi
michael@0 571 .if n \{\
michael@0 572 .RE
michael@0 573 .\}
michael@0 574 .SH "USAGE TIPS"
michael@0 575 .PP
michael@0 576 When SSL restarts a previous session, it makes use of cached information to do a partial handshake\&. If you wish to capture a full SSL handshake, restart the browser to clear the session id cache\&.
michael@0 577 .PP
michael@0 578 If you run the tool on a machine other than the SSL server to which you are trying to connect, the browser will complain that the host name you are trying to connect to is different from the certificate\&. If you are using the default BadCert callback, you can still connect through a dialog\&. If you are not using the default BadCert callback, the one you supply must allow for this possibility\&.
michael@0 579 .SH "SEE ALSO"
michael@0 580 .PP
michael@0 581 The NSS Security Tools are also documented at
michael@0 582 \m[blue]\fBhttp://www\&.mozilla\&.org/projects/security/pki/nss/\fR\m[]\&\s-2\u[2]\d\s+2\&.
michael@0 583 .SH "ADDITIONAL RESOURCES"
michael@0 584 .PP
michael@0 585 For information about NSS and other tools related to NSS (like JSS), check out the NSS project wiki at
michael@0 586 \m[blue]\fBhttp://www\&.mozilla\&.org/projects/security/pki/nss/\fR\m[]\&. The NSS site relates directly to NSS code changes and releases\&.
michael@0 587 .PP
michael@0 588 Mailing lists: https://lists\&.mozilla\&.org/listinfo/dev\-tech\-crypto
michael@0 589 .PP
michael@0 590 IRC: Freenode at #dogtag\-pki
michael@0 591 .SH "AUTHORS"
michael@0 592 .PP
michael@0 593 The NSS tools were written and maintained by developers with Netscape, Red Hat, Sun, Oracle, Mozilla, and Google\&.
michael@0 594 .PP
michael@0 595 Authors: Elio Maldonado <emaldona@redhat\&.com>, Deon Lackey <dlackey@redhat\&.com>\&.
michael@0 596 .SH "LICENSE"
michael@0 597 .PP
michael@0 598 Licensed under the Mozilla Public License, v\&. 2\&.0\&. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla\&.org/MPL/2\&.0/\&.
michael@0 599 .SH "NOTES"
michael@0 600 .IP " 1." 4
michael@0 601 Mozilla NSS bug 836477
michael@0 602 .RS 4
michael@0 603 \%https://bugzilla.mozilla.org/show_bug.cgi?id=836477
michael@0 604 .RE
michael@0 605 .IP " 2." 4
michael@0 606 http://www.mozilla.org/projects/security/pki/nss/
michael@0 607 .RS 4
michael@0 608 \%http://www.mozilla.org/projects/security/pki/nss/tools
michael@0 609 .RE

Mercurial Repository: The Tor Browser

Europalab SCM Repository Server

mercurial