diff options
| author | Alex Nik <rage.iz.me@gmail.com> | 2021-02-03 19:08:05 +0100 |
|---|---|---|
| committer | Peter Wu <peter@lekensteyn.nl> | 2021-02-20 22:45:41 +0000 |
| commit | bddd03418651c98a4a42207a4fb68dd4e9e2a606 (patch) | |
| tree | 73b658acb3592726591e89e24f190d40454efc3c | |
| parent | 94488fc509c7b4b5901962e8dce6b90c20a78ea2 (diff) | |
added the description for the exporting TLS session keys dialog
applied the SME suggestions
implemented the SME suggestions
minor fix
| -rw-r--r-- | docbook/wsug_graphics/ws-tls-session-keys.png | bin | 0 -> 39511 bytes | |||
| -rw-r--r-- | docbook/wsug_src/WSUG_chapter_io.adoc | 21 |
2 files changed, 20 insertions, 1 deletions
diff --git a/docbook/wsug_graphics/ws-tls-session-keys.png b/docbook/wsug_graphics/ws-tls-session-keys.png Binary files differnew file mode 100644 index 0000000000..ba0084f13b --- /dev/null +++ b/docbook/wsug_graphics/ws-tls-session-keys.png diff --git a/docbook/wsug_src/WSUG_chapter_io.adoc b/docbook/wsug_src/WSUG_chapter_io.adoc index 58697624fb..eccb0b01bf 100644 --- a/docbook/wsug_src/WSUG_chapter_io.adoc +++ b/docbook/wsug_src/WSUG_chapter_io.adoc @@ -828,7 +828,26 @@ NOTE: You can add any dissector to the existing list, or define a new entry in t ==== The “Export TLS Session Keys...” Dialog Box -{missing} +Transport Layer Security (TLS) encrypts the communication between a client and a server. The most common use for it is web browsing via HTTPS. + +Decryption of TLS traffic requires TLS secrets. You can get them in the form of stored session keys in a "key log file", or by using an RSA private key file. For more details, see the link:{wireshark-wiki-url}TLS[TLS wiki page]. + +The menu:File[Export TLS Session Keys…] menu option generates a new "key log file" which contains TLS session secrets known by Wireshark. This feature is useful if you typically decrypt TLS sessions using the RSA private key file. The RSA private key is very sensitive because it can be used to decrypt other TLS sessions and impersonate the server. Session keys can be used only to decrypt sessions from the packet capture file. However, session keys are the preferred mechanism for sharing data over the Internet. + +To export captured TLS session keys, follow the steps below: + +. In the main menu select menu:File[Export TLS Session Keys...]. Wireshark will open a corresponding dialog <<TlsSessionKeys>>. ++ +[[TlsSessionKeys]] ++ +.Export TLS Session Keys window +image::wsug_graphics/ws-tls-session-keys.png[{screenshot-attrs}] + +. Type the desired file name in the `Save As` field. + +. Choose the destination folder for your file in the `Where` field. + +. Press the btn:[Save] button to complete the export file procedure. [[ChIOExportObjectsDialog]] |
