diff --git a/.github/ISSUE_TEMPLATE/other-issues---question.md b/.github/ISSUE_TEMPLATE/other-issues---question.md index 490a660..ea778c2 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.2/FAQ.md)?** + diff --git a/CHANGELOG.md b/CHANGELOG.md index d9452db..b70b1f3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -69,7 +69,7 @@ * CI run against a target with known configuration as a change canary * Updated client handshakes as new browsers and OpenSSL 3.5.x show KEMs * Start using client handshakes include ja3/ja4 so that similar handshakes will be recognized - +* Provide an FAQ ### Features implemented / improvements in 3.0 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'