Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove documentation on TLS / DTLS / QUIC #27

Merged
merged 1 commit into from
Dec 5, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 0 additions & 53 deletions draft-irtf-cfrg-aegis-aead.md
Original file line number Diff line number Diff line change
Expand Up @@ -1581,16 +1581,6 @@ IANA has assigned the following identifiers in the AEAD Algorithms Registry:
| `AEAD_AEGIS256` | `33` |
{: title="AEGIS entries in the AEAD Algorithms Registry"}

IANA has also assigned the following TLS cipher suites in the TLS Cipher Suite Registry:

| Cipher Suite Name | Value |
| ----------------------- | ------------- |
| `TLS_AEGIS_256_SHA512` | `{0x13,0x06}` |
| `TLS_AEGIS_128L_SHA256` | `{0x13,0x07}` |
{: title="AEGIS entries in the TLS Cipher Suite Registry"}

A 128-bit tag length must be used with these cipher suites.

IANA is requested to update the references of these entries to refer to the final version of this document.

IANA is also requested to register the following identifiers in the AEAD Algorithms Registry:
Expand All @@ -1600,49 +1590,6 @@ IANA is also requested to register the following identifiers in the AEAD Algorit
- `AEAD_AEGIS256X2`
- `AEAD_AEGIS256X4`

as well as the following identifiers in the TLS Cipher Suite Registry:

- `TLS_AEGIS_128X2_SHA256`
- `TLS_AEGIS_128X4_SHA256`
- `TLS_AEGIS_256X2_SHA512`
- `TLS_AEGIS_256X4_SHA512`

# QUIC and DTLS 1.3 Header Protection

## DTLS 1.3 Record Number Encryption

In DTLS 1.3, record sequence numbers are encrypted as specified in {{!RFC9147}}.

For AEGIS-128L and AEGIS-256, the mask is generated using the AEGIS `Stream` function with:

- a 128-bit tag length
- `sn_key`, as defined in {{!RFC9147, Section 4.2.3}}
- `ciphertext[0..16]`: the first 16 bytes of the DTLS ciphertext
- `nonce_len`: the AEGIS nonce length

The 5-byte mask is computed as follows:

~~~
mask = Stream(5, sn_key, ZeroPad(ciphertext[0..16], nonce_len))
~~~

## QUIC Header Protection

In QUIC, parts of the QUIC packet headers are encrypted as specified in {{!RFC9001}}.

For AEGIS-128L and AEGIS-256, the mask is generated using the AEGIS `Encrypt` function with:

- a 128-bit tag length
- `hp_key`, as defined in {{!RFC9001, Section 5.4}}
- `sample`: the 16 bytes QUIC ciphertext sample
- `nonce_len`: the AEGIS nonce length

The mask is computed as follows:

~~~
mask = Encrypt("", "", hp_key, ZeroPad(sample, nonce_len))
~~~

--- back

# Test Vectors
Expand Down