Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation on how to use wiresham with practical examples. #3

Closed
droidtrail opened this issue Jan 4, 2019 · 6 comments
Closed

Comments

@droidtrail
Copy link

Hello. I'm wondering how to use WireSham to do TCP Mocking. Reading the documentation in GitHub, I realized that the tool does not have a graphical interface, but a framework written in java that should be low and executed, for example, using the Eclipse IDE. Is that right?
If so, do you have any documentation that you can provide with the step-by-step guide on how to use WireSham?
If yes, please send them to my email: leandro.nares@gmail.com.

@rabelenda
Copy link
Collaborator

Hello, as you have noted Wiresham has no UI yet. The basic usage of the tool is described in the readme, you basically capture traffic between a client application and server application that you want to mock with Wireshark or Tcpdump, save the traffic dump, and then load it in Wiresham to emulate the server application.
Additionally, you can convert Wireshark and Tcpdump traffic dumps to a simplified version (a yaml file) with Wiresham, and use that in Wiresham instead of a traffic dump to configure the server mock. You can also manually create such yaml, but that would require knowing exactly the expected bytes from client application and server application which would be tricky, but you can get a converted dump (from Wireshark or Tcpdump) and modify it to test other things that are not contemplated in original traffic dump.
Regarding the "Java framework" that you mention, is just a small API which allows you to configure a mock server with a given dump and start/stop the server, which is really simple but useful when developing test to validate some client logic (with for example JUnit). Such tests may be implemented with Eclipse IDE or any other IDE or text editor.

Regarding step by step guid, there is the readme, and we have also demoed its usage in a webinar (to mock mainframe applications, but mainframe applications are just one kind of TCP app). You can find it here: https://youtu.be/Sr1BOi50xqg?t=2036. Wiresham is presented from minute 33 until minute 45.

If you have any further questions don't hesitate on asking them via this medium, and add a start to the project if you find it helpful :-)

@droidtrail
Copy link
Author

Thanks for the reply, rabelenda. I'll check the YouTube video on to try to understand better how the tool works.

@AhmedAljailani
Copy link

where is the practical example

@rabelenda
Copy link
Collaborator

@AhmedAljailani Have you checked the video I shared with @droidtrail in previous comment? We plan on adding a small gif/video in repo readme for reference in the near future.

@AhmedAljailani
Copy link

@AhmedAljailani Have you checked the video I shared with @droidtrail in previous comment? We plan on adding a small gif/video in repo readme for reference in the near future.

could you send it to me

@rabelenda
Copy link
Collaborator

It's in this same issue, the youtube video from the point wiresham is presented: https://youtu.be/Sr1BOi50xqg?t=2036

rabelenda pushed a commit that referenced this issue Jul 20, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants