feat: tls

[salmad3]

Context

• Adds content for libp2p TLS
• Part of Populate secure communication section: Noise & TLS #19

Latest preview

Please view the latest Fleek preview here.

[p-shahi]

@thomaseizinger can you help review this?

(Took liberty of unassigning Marten to help spread the load.)

[thomaseizinger]

Who is the audience of this document?

It starts out very high-level ("What is TLS") but gets detailed fairly quickly, explaining the messages in the handshake. Hence, for someone who's got no idea what TLS is, most of this document is probably overwhelming.

Given that libp2p is just using libp2p in a particular configuration, (i.e. we didn't build it from scratch) I'd recommend the following:

• Retain the super high-level description (i.e. "What is TLS"). This provides some context on what we are talking about.
• From there, link to useful material for people that want to understand TLS in detail (RFC, perhaps Wikipedia for the historical bit)
• Describe that libp2p uses a particular subset, most notably TLS 1.3+
• For any details, we can link to our spec: https://github.com/libp2p/specs/blob/master/tls/tls.md

Hope this helps :)

[thomaseizinger]

LGTM! Thanks for incorporating the review :)

[salmad3]

thanks @thomaseizinger and @marten-seemann!

available to re-review @marten-seemann

[marten-seemann]

It would be nice to have an introduction sentence saying that TLS is one of the security handshakes used to secure transports that don't have built-in security (TCP, WebSocket), and also mention that Noise is an alternative option. That would motivate the rest of this document.

Other than that, this looks good to me.

[salmad3]

Added an introductory statement. Based on the feedback here, I'll also simplify and update the Noise document I worked.

additional statement added in the introduction and checked off by reviewers