diff --git a/.github/ISSUE_TEMPLATE/other-issues---question.md b/.github/ISSUE_TEMPLATE/other-issues---question.md index 490a660..aaad44a 100644 --- a/.github/ISSUE_TEMPLATE/other-issues---question.md +++ b/.github/ISSUE_TEMPLATE/other-issues---question.md @@ -7,5 +7,12 @@ assignees: '' --- -**Which version are you referring to** -3.0.x or 3.2? (please check also how old your version is compare to the ones here) +**Which version are you referring to?** + + +**Did you read the [FAQ](https://github.com/testssl/testssl.sh/blob/3.3dev/FAQ.md)?** + diff --git a/CHANGELOG.md b/CHANGELOG.md index c199921..3179260 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,7 @@ * Bump SSLlabs rating guide to 2009r * Check for Opossum vulnerability * Enable IPv6 automagically, i.e. if target via IPv6 is reachable just (also) scan it +* Provide an FAQ ### Features implemented / improvements in 3.2 diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 0000000..6234910 --- /dev/null +++ b/FAQ.md @@ -0,0 +1,28 @@ +### FAQs + +This is a collection of frequently asked questions which should help to answer some of those. It is is recommended reading this before filing issues. + +#### Coding + +* Why are you using bash, everybody nowadays uses (python|Golang|Java|etc), it's much faster and modern! + * The project started in 2007 as series of OpenSSL commands in a shell script which was used for pen testing. OpenSSL then was the central part (and partly is) to do some basic operations for connections and certificates verification which would have been more tedious to implement in other programming languages. Over time the project became bigger and it in terms of resources it wasn't a viable option to convert it to (python|Golang|Java|etc). Besides, bash is easy to debug as opposed to a compiled binary. Personally, I believe its capabilities are often underestimated. + +* But why don't you now amend it with a (python|perl|Golang|Java|etc) function which does \ or \ much faster? + * The philosophy and the beauty of testssl.sh is that it runs *everywhere* with a minimal set of dependencies like typical Unix binaries. No worries about having a different version of libraries/ interpreter not installed. + + +#### Runtime + +* I believe I spotted a false positive as testssl.sh complained about a finding \ but my OpenSSL command `openssl s_client -connect -cipher 'DEFAULT@SECLEVEL=0'