Skip to content

Commit 4cabf45

Browse files
committed
doc: add some language around tls config
1 parent f1b41b3 commit 4cabf45

File tree

1 file changed

+34
-20
lines changed

1 file changed

+34
-20
lines changed

index.html

Lines changed: 34 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -555,16 +555,43 @@ <h3>
555555
</h3>
556556

557557
<p>
558-
At least TLS 1.2 should be configured to use only strong ciphers
559-
suites and to use sufficiently large key sizes. As recommendations may
560-
be volatile these days, only the very latest recommendations should be
561-
used. However, as a rule of thumb, the following must be used:
558+
Guidance from <a
559+
href="https://csrc.nist.gov/publications/detail/sp/800-52/rev-2/final">
560+
NIST SP 800-52 Rev. 2
561+
</a> or superceding, MUST be followed for delivery of a did web
562+
document.
563+
</p>
564+
565+
<p>
566+
It is additionally recommended to adhere to OWASP's Transport Layer
567+
Protection Cheat Sheet [[OWASP-TRANSPORT]] latest recommendations for
568+
hardening TLS configurations.
569+
</p>
570+
571+
<p>
572+
Ephemeral keys MUST be used.
573+
</p>
574+
575+
<p>
576+
At least SHA256 MUST be used in TLS configuration, but SHA384,
577+
POLY1305 or stronger is recommended, depending on the needs of your
578+
operating environment.
579+
</p>
580+
581+
<p>
582+
Delete action MAY be performed by domain name registrars or DNS lookup
583+
services.
584+
</p>
585+
586+
<p>
587+
At time of this writing, at least TLS 1.2 should be configured to use
588+
only strong ciphers suites and to use sufficiently large key sizes.
589+
As recommendations may be volatile these days, only the very latest
590+
recommendations should be used. However, as a rule of thumb,
591+
the following set of suites is a reasonable starting place:
562592
</p>
563593

564594
<ul>
565-
<li>
566-
Ephemeral keys are to be used.
567-
</li>
568595
<li>
569596
ECDHE with one of the strong curves {X25519, brainpoolP384r1, NIST
570597
P-384, brainpoolP256r1, NIST P-256} shall be used as key exchange.
@@ -581,10 +608,6 @@ <h3>
581608
Authenticated Encryption with Associated Data (AEAD) shall be used
582609
as Mac.
583610
</li>
584-
<li>
585-
At least SHA256 shall be used, but SHA384 or POLY1305 are
586-
recommended.
587-
</li>
588611
</ul>
589612

590613
<p>
@@ -611,16 +634,7 @@ <h3>
611634
</li>
612635
</ul>
613636

614-
<p>
615-
It is recommended to adhere to OWASP's Transport Layer Protection
616-
Cheat Sheet [[OWASP-TRANSPORT]] latest recommendations for hardening
617-
TLS configurations.
618-
</p>
619637

620-
<p>
621-
Delete action can be performed by domain name registrars or DNS lookup
622-
services.
623-
</p>
624638

625639
</section>
626640

0 commit comments

Comments
 (0)