SSL example for HttpUrlConnection

[kubinio123]

Before submitting pull request:

• Check if the project compiles by running sbt compile
• Verify docs compilation by running sbt compileDocs
• Check if tests pass by running sbt test
• Format code by running sbt scalafmt

[adamw]

Looks great! Couple of questions:

• what is described here is importing certificates for a server, and hence implementing one way SSL, right? If so, it would be good to explicitly mention that - I suspect people might look for docs on "how to implement one way SSL" or "how to implement mutual SSL"
• sometimes you need to disable SSL - only during development of course ;) - I think a section on that would be helpful as well

[kubinio123]

• It's actually a mutual SSL example since we have both client key store (.p12 file) and trust store with server certificate imported. So server identifies client and vice versa. I can add an example without trust store (one way)
• I could add a code sample on how to disable SSL

[adamw]

great :) I think it would be best to have sections on one-way / mutual / disabled SSL - I'm guessing that's what people will be looking for in the docs in the first place

[kubinio123]

Done, but i didn't add explicit section about disabled SSL because that depends on server config as well.
On the client side we can disable validation of server certificates and that's included in "One way SSL" section.

[adamw]

looks good, thank you!

[adamw]

can we enable mdoc here? (using scala mdoc:silent)

that would verify that the code compiles (at least :) ) see the readme how to run docs generation localy

[kubinio123]

I can use mdoc:compile-only here but variables are out of scope for mdoc in further code samples so I haven't used it at first

[adamw]

According to the docs: https://scalameta.org/mdoc/docs/modifiers.html, mdoc:silent accumulates the definitions. Would be good to enable it as much as possible, it really helps in keeping the docs up-to-date :)