Differences between revisions 4 and 5
Revision 4 as of 2019-07-26 21:58:30
Size: 5742
Editor: PeterWu
Comment:
Revision 5 as of 2019-07-26 22:05:19
Size: 5712
Editor: PeterWu
Comment:
Deletions are marked like this. Additions are marked like this.
Line 27: Line 27:
 * Add support for dissection of new message structures that are now available in decrypted form.  * Add support for dissection of the decrypted message structures.
Line 44: Line 44:
 * Continuous integration testing on multiple platforms (Travis CI, Buildbot, AppVeyor, Gitlab) and operating systems.  * Continuous integration testing on multiple platforms (Travis CI, Buildbot, !AppVeyor, Gitlab) and operating systems.

Open-Source Software Engineering (Fall 2019)

This page collects information about the Wireshark project in CS 5152 (Fall 2019) - Open-Source Software Engineering.

Course description: https://www.cs.cornell.edu/courses/cs5152/2019fa/

Project description

Mentor: Peter Wu

Team Size: 4-5

Summary: Add decryption support to the SSH dissector.

Description: Wireshark is an open-source network protocol analyzer. It is used in education to provide a visual and practical understanding of networking concepts, and in industry for network-related troubleshooting and to facilitate development of new products and standards.

As increasingly more network traffic is encrypted, decryption is required to enable users to achieve an optimal understanding of application behavior. Wireshark is able to decrypt several protocols, including TLS, QUIC, and WireGuard. Decryption does require additional key material to be extracted from applications, see the previously linked protocol pages for examples.

The Secure Shell (SSH) protocol is commonly used for managing remote systems, ranging from a Raspberry Pi to a global fleet of servers. OpenSSH is the most popular implementation, while Dropbear is a smaller implementation that is found in some routers.

Wireshark has basic support for dissection of SSH protocol messages. However, most of the interesting details (commands, input/output, file transfers) are present in the encrypted fields. Tasks:

  • Study the SSH specifications (see the references at SSH) with a focus on understanding message flow, the key exchange, and decryption.

  • Build a mechanism to extract session secrets from OpenSSH, Dropbear, or your favorite SSH application into a text file.
  • Modify the SSH dissector (epan/dissectors/packet-ssh.c) to support decryption using these secrets.
  • Add support for dissection of the decrypted message structures.

If time permits, one could add even more functionaliy:

  • Investigate the feasibility to implement "Follow Stream" for individual SSH channels, similar to "Follow TCP". This could be used to see the command input/output from an interactive session. This also affects the GUI.
  • Work with other projects (libssh?) to upstream changes that make it easier to dump the secrets.
  • Make it possible to embed these secrets in a pcapng capture file using the Decryption Secrets Block (example for TLS).

  • Add support for various key exchange algorithms and ciphers supported in SSH.

Skills: You will learn about:

  • Practical cryptography engineering.
  • Development of a cross-platform application in C. Ideally on Linux or macOS, but Windows also works.
  • (Optional) GUI development in Qt (C++).
  • Efficiently read internet standards.
  • Extending or developing new protocol dissectors in Wireshark.
  • Development workflow using Git and Gerrit Code Review.
  • Continuous integration testing on multiple platforms (Travis CI, Buildbot, AppVeyor, Gitlab) and operating systems.

  • (Optional) Use of tools that support development, including a debugger (GDB) and sanitizers (ASAN, UBSAN).

Timeline

  • 29 August 2019 - Start of classes/projects
  • 14 and 15 September - Kickoff Hackathon
  • mid-October - mentors should provide midterm assessments and feedback.
  • 10 December - End of classes/projects
  • mid-December - mentors should provide final evaluations and feedback.
  • 14 to 21 December - group presentations on the project for the class.

Ideas

The above project description is a proposal, but feel free to make other suggestions. This is an open-source project anyway :-)

There are many places where people can help. For inspiration:

Some examples:

  • Modernize Lua API internals, removing weird C macros and use more idiomatic constructions.
  • UI/UX improvements (external/remote capture interfaces, statistics, interaction, ...)
  • Accessibility improvements, configurable key bindings, ....
  • Implementing new protocols or extend an existing dissector with support for newer versions or extensions
  • Improve sharkd, a daemon that enables implementing new user interfaces (for example, for Android or websites).
  • Improve the fuzzer integration to speed it up and find more bugs.
  • "Fix bugs/feature requests". Quite an open-ended task, but the process of triaging a bug, investigating the issue and coming up with a fix is very educative and helpful skill.
  • Improve documentation. We have a User's Guide which could always benefit from updates. There are also some plaintext developer documentation files, maybe it could be integrated into the Developer's Guide. Might be considered boring as writing coding is more fun, but it is also very appreciated.
  • Conversation tracking in Lua dissectors. https://bugs.wireshark.org/bugzilla/show_bug.cgi?id=15396

  • Add process information for TCP/UDP packets https://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1184

OpenSourceSoftwareEngineeringFall2019 (last edited 2019-09-15 16:11:57 by PeterWu)