Thursday, June 1, 2023

ChopChop - ChopChop Is A CLI To Help Developers Scanning Endpoints And Identifying Exposition Of Sensitive Services/Files/Folders


ChopChop is a command-line tool for dynamic application security testing on web applications, initially written by the Michelin CERT.

Its goal is to scan several endpoints and identify exposition of services/files/folders through the webroot. Checks/Signatures are declared in a config file (by default: chopchop.yml), fully configurable, and especially by developers.



"Chop chop" is a phrase rooted in Cantonese. "Chop chop" means "hurry" and suggests that something should be done now and without delay.


Building

We tried to make the build process painless and hopefully, it should be as easy as:

$ go mod download
$ go build .

There should be a resulting gochopchop binary in the folder.


Using Docker

Thanks to Github Container Registry, we are able to provide you some freshly-build Docker images!

docker run ghcr.io/michelin/gochopchop scan https://foobar.com -v debug

But if you prefer, you can also build it locally, see below:


Build locally
docker build -t gochopchop .

Usage

We are continuously trying to make goChopChop as easy as possible. Scanning a host with this utility is as simple as :

$ ./gochopchop scan https://foobar.com

Using Docker
docker run gochopchop scan https://foobar.com

Custom configuration file
docker run -v ./:/app chopchop scan -c /app/chopchop.yml https://foobar.com

What's next

The Golang rewrite took place a couple of months ago but there's so much to do, still. Here are some features we are planning to integrate : [x] Threading for better performance [x] Ability to specify the number of concurrent threads [x] Colors and better formatting [x] Ability to filter checks/signatures to search for [x] Mock and unit tests [x] Github CI And much more!


Testing

To quickly end-to-end test chopchop, we provided a web-server in tests/server.go. To try it, please run go run tests/server.go then run chopchop with the following command ./gochopchop scan http://localhost:8000 --verbosity Debug. ChopChop should print "no vulnerabilities found".

There are also unit test that you can launch with go test -v ./.... These tests are integrated in the github CI workflow.


Available flags

You can find the available flags available for the scan command :

Flag Full flag Description
-h --help Help wizard
-v --verbosity Verbose level of logging
-c --signature Path of custom signature file
-k --insecure Disable SSL Verification
-u --url-file Path to a specified file containing urls to test
-b --max-severity Block the CI pipeline if severity is over or equal specified flag
-e --export Export type of the output (csv and/or json)
--export-filename Specify the filename for the export file(s)
-t --timeout Timeout for the HTTP requests
--severity-filter Filter Plugins by severity
--plugin-filter Filter Plugins by name of plugin
--threads Number of concurrent threads

Advanced usage

Here is a list of advanced usage that you might be interested in. Note: Redirectors like > for post processing can be used.

  • Ability to scan and disable SSL verification
$ ./gochopchop scan https://foobar.com --insecure
  • Ability to scan with a custom configuration file (including custom plugins)
$ ./gochopchop scan https://foobar.com --insecure --signature test_config.yml
  • Ability to list all the plugins or by severity : plugins or plugins --severity High
$ ./gochopchop plugins --severity High
  • Ability to specify number of concurrent threads : --threads 4 for 4 workers
$ ./gochopchop plugins --threads 4
  • Ability to block the CI pipeline by severity level (equal or over specified severity) : --max-severity Medium
$ ./gochopchop scan https://foobar.com --max-severity Medium
  • Ability to specify specific signatures to be checked
./gochopchop scan https://foobar.com --timeout 1 --verbosity --export=csv,json --export-filename boo --plugin-filters=Git,Zimbra,Jenkins
  • Ability to list all the plugins
$ ./gochopchop plugins
  • List High severity plugins
$ ./gochopchop plugins --severity High
  • Set a list or URLs located in a file
$ ./gochopchop scan --url-file url_file.txt
  • Export GoChopChop results in CSV and JSON format
$ ./gochopchop scan https://foobar.com  --export=csv,json --export-filename results

Creating a new check

Writing a new check is as simple as :

  - endpoint: "/.git/config"
checks:
- name: Git exposed
match:
- "[branch"
remediation: Do not deploy .git folder on production servers
description: Verifies that the GIT repository is accessible from the site
severity: "High"

An endpoint (eg. /.git/config) is mapped to multiple checks which avoids sending X requests for X checks. Multiple checks can be done through a single HTTP request. Each check needs those fields:

Attribute Type Description Optional ? Example
name string Name of the check No Git exposed
description string A small description for the check No Ensure .git repository is not accessible from the webroot
remediation string Give a remediation for this specific "issue" No Do not deploy .git folder on production servers
severity Enum("High", "Medium", "Low", "Informational") Rate the criticity if it triggers in your environment No High
status_code integer The HTTP status code that should be returned Yes 200
headers List of string List of headers there should be in the HTTP response Yes N/A
no_headers List of string List of headers there should NOT be in the HTTP response Yes N/A
match List of string List the strings there should be in the HTTP response Yes "[branch"
no_match List of string List the strings there should NOT be in the HTTP response Yes N/A
query_string GET parameters that have to be passed to the endpoint String Yes query_string: "id=FOO-chopchoptest"

External Libraries
Library Name Link License
Viper https://github.com/spf13/viper MIT License
Go-pretty https://github.com/jedib0t/go-pretty MIT License
Cobra https://github.com/spf13/cobra Apache License 2.0
strfmt https://github.com/go-openapi/strfmt Apache License 2.0
Go-homedir https://github.com/mitchellh/go-homedir MIT License
pkg-errors https://github.com/pkg/errors BSD 2 (Simplified License)
Go-runewidth https://github.com/mattn/go-runewidth MIT License

Please, refer to the third-party.txt file for further information.


Talks

License

ChopChop has been released under Apache License 2.0. Please, refer to the LICENSE file for further information.


Authors
  • Paul A.
  • David R. (For the Python version)
  • Stanislas M. (For the Golang version)


More information

  1. Android Hack Tools Github
  2. How To Hack
  3. Hack Tools For Pc
  4. Pentest Tools Port Scanner
  5. Hack Website Online Tool
  6. Hacking Apps
  7. Hacks And Tools
  8. Hacker Tools Mac
  9. Hacking Tools Pc
  10. Hacking App
  11. Pentest Tools Subdomain
  12. Hack Tools Mac
  13. Hack Tools Pc
  14. Pentest Tools Linux
  15. Hacker Security Tools
  16. Hacking Tools And Software
  17. Hacker
  18. Hacking Tools And Software
  19. Pentest Tools Online
  20. Hacking Tools Software
  21. Pentest Tools Nmap
  22. Hacker Tools Github
  23. Hacking Tools 2020
  24. Hacker Tools Github
  25. How To Hack
  26. Hack Tools
  27. Hack Tools Mac
  28. Pentest Automation Tools
  29. Hacker Tools Free
  30. Hacker Techniques Tools And Incident Handling
  31. Hacker Tools Apk
  32. Hacking Tools Name
  33. Physical Pentest Tools
  34. Hack Tools 2019
  35. Best Hacking Tools 2020
  36. Pentest Tools Download
  37. Hacker Tools List
  38. Hack Tool Apk
  39. Nsa Hacker Tools
  40. Usb Pentest Tools
  41. Hacker Tools Github
  42. Pentest Tools Open Source
  43. Pentest Tools Port Scanner
  44. Hacking Tools Windows 10
  45. Wifi Hacker Tools For Windows
  46. Hacking Tools For Windows 7
  47. Hacking Tools
  48. Wifi Hacker Tools For Windows
  49. What Are Hacking Tools
  50. Pentest Tools Framework
  51. Pentest Tools Linux
  52. Hacking Tools Usb
  53. Hacker Security Tools
  54. Hacker Techniques Tools And Incident Handling
  55. Pentest Recon Tools
  56. Hack Tools For Ubuntu
  57. Hacking Tools Mac
  58. Beginner Hacker Tools
  59. What Are Hacking Tools
  60. Hack And Tools
  61. Nsa Hack Tools Download
  62. Hacker Tools
  63. Hacking Tools Software
  64. Hacker Tools Free Download
  65. Pentest Tools Kali Linux
  66. Hacking Tools For Windows 7
  67. Tools 4 Hack
  68. Pentest Tools Apk
  69. Best Pentesting Tools 2018
  70. Hack Tools For Ubuntu
  71. Hacking Tools Usb
  72. Kik Hack Tools
  73. World No 1 Hacker Software
  74. Pentest Tools Review
  75. Hack Tools
  76. Nsa Hacker Tools
  77. Underground Hacker Sites
  78. New Hack Tools
  79. Hacking App
  80. Best Pentesting Tools 2018
  81. Hacking Tools Software
  82. Hacking Tools Windows 10
  83. Hack Rom Tools
  84. Hacking Tools For Games
  85. Pentest Recon Tools
  86. Hacker Tools For Windows
  87. What Are Hacking Tools
  88. Hacking Tools Mac
  89. Hack Tools For Games
  90. Hacking Tools Name
  91. Pentest Tools For Ubuntu
  92. Hack And Tools
  93. Pentest Tools Apk
  94. Hacking Tools For Kali Linux
  95. Hacker Tools Online
  96. Hacker Hardware Tools
  97. Hacker Tools For Pc
  98. Pentest Tools List
  99. Hacker Tools For Pc
  100. Pentest Tools Online
  101. Termux Hacking Tools 2019
  102. Termux Hacking Tools 2019
  103. Hacking Apps
  104. Hacking Tools For Windows 7
  105. Hacker Tools For Pc
  106. Hacks And Tools
  107. Hack Tool Apk No Root
  108. Pentest Tools Bluekeep
  109. Hack Tools For Ubuntu
  110. New Hack Tools
  111. Hacker Tools Hardware
  112. Hack Tools 2019
  113. How To Install Pentest Tools In Ubuntu
  114. Hacker Tools 2019
  115. Computer Hacker
  116. Pentest Tools Linux
  117. Install Pentest Tools Ubuntu
  118. Nsa Hacker Tools
  119. Hacker Tools Free
  120. Hack App
  121. Hacking Tools Free Download
  122. Pentest Tools Tcp Port Scanner
  123. Pentest Tools Free
  124. Growth Hacker Tools
  125. Pentest Tools Linux
  126. Hack Tool Apk
  127. Pentest Tools Windows
  128. Hack Tools Download
  129. Pentest Tools Find Subdomains
  130. Tools 4 Hack
  131. Hack Tool Apk
  132. What Is Hacking Tools
  133. New Hack Tools
  134. Usb Pentest Tools
  135. Hacker Search Tools
  136. Hacker Techniques Tools And Incident Handling
  137. Pentest Tools For Mac
  138. Pentest Tools Free
  139. Pentest Tools Nmap
  140. Black Hat Hacker Tools
  141. Hacking Tools For Mac
  142. Pentest Tools Tcp Port Scanner
  143. Hack Tools Online
  144. Hacking Tools For Kali Linux
  145. Hacking Tools For Kali Linux
  146. Hacking Tools
  147. Pentest Tools Windows
  148. Hack And Tools
  149. Android Hack Tools Github
  150. Hacking Tools 2020
  151. Hackers Toolbox
  152. Hacking Tools Online
  153. Hacker Tools 2019
  154. Hack And Tools

No comments: