mirror of
https://codeberg.org/openpgp/notes.git
synced 2024-11-25 17:12:06 +01:00
Compare commits
No commits in common. "7b4031dc0a5b6d12038f710c2e7fda215b959023" and "ecf0bc1c7b49fa8976d2671a80b6a0d21ac3940d" have entirely different histories.
7b4031dc0a
...
ecf0bc1c7b
1 changed files with 46 additions and 46 deletions
|
@ -85,52 +85,6 @@ Strictly speaking, knowing just the hash algorithm would be sufficient to begin
|
||||||
|
|
||||||
Important to note, the {term}`signer`'s {term}`public key<OpenPGP Certificate>`, critical for the final {term}`verification` step, is not embedded in the message. Verifiers must acquire this {term}`key` externally (e.g., from a {term}`key server`) to authenticate the {term}`signature<OpenPGP Signature Packet>` successfully.
|
Important to note, the {term}`signer`'s {term}`public key<OpenPGP Certificate>`, critical for the final {term}`verification` step, is not embedded in the message. Verifiers must acquire this {term}`key` externally (e.g., from a {term}`key server`) to authenticate the {term}`signature<OpenPGP Signature Packet>` successfully.
|
||||||
|
|
||||||
#### Nesting of one-pass signatures
|
|
||||||
|
|
||||||
Signing a message using the one-pass mechanism involves prepending a *one-pass signature* (OPS) packet to the message and appending the corresponding signature, sandwiching the signed content.
|
|
||||||
|
|
||||||
An OpenPGP message can contain multiple signatures added that way.
|
|
||||||
|
|
||||||
```{note}
|
|
||||||
One-pass signatures are nested, meaning the outermost one-pass signature packet corresponds to the outermost signature packet.
|
|
||||||
```
|
|
||||||
|
|
||||||
When a message is signed, the signature is always calculated over the contents of the literal data packet, not the literal data packet itself.
|
|
||||||
This means that if a message, which is compressed using a compressed data packet is wrapped using a one-pass signature, the signature is still being calculated over the plaintext inside the literal data packet.
|
|
||||||
|
|
||||||
There is one exception, though.
|
|
||||||
```{note}
|
|
||||||
Of course there is.
|
|
||||||
```
|
|
||||||
|
|
||||||
The OPS packet has a "nested" flag[^nested-flag], which can either be `1` or `0`.
|
|
||||||
If this flag is set to `0`, it indicates that further OPSs will follow this packet, which are calculated over the same plaintext data as this OPS is. A value of `1` indicates, that either no further OPS packets will follow (this OPS is the last), or that this OPS is calculated over the the usual plaintext data, but wrapped inside any OPS+Signature combinations that follow this OPS.
|
|
||||||
|
|
||||||
[^nested-flag]: See [description of the nested flag](https://www.ietf.org/archive/id/draft-ietf-openpgp-crypto-refresh-12.html#section-5.4-3.8.1).
|
|
||||||
|
|
||||||
This mechanism enables attested signatures, where the signer signs an already one-pass signed message including the already contained signature.
|
|
||||||
|
|
||||||
As a practical example, consider the following notation:
|
|
||||||
* `LIT("Hello World")` represents a literal data packet with the content `Hello World`.
|
|
||||||
* `COMP(XYZ)` represents a compressed data packet over some other packet `XYZ`.
|
|
||||||
* `OPS₁` represents a one-pass signature packet with the nested flag set to `1`. Analogous, `OPS₀` has the nested flag set to `0`.
|
|
||||||
* `SIG` represents a signature packet.
|
|
||||||
|
|
||||||
A normal, one-pass signed message looks like this:
|
|
||||||
`OPS₁ LIT("Hello World") SIG`
|
|
||||||
|
|
||||||
Here, the signature is calculated over the plaintext `Hello World`, as is it in a message that has the following form: `OPS₁ COMP(LIT("Hello World")) SIG`.
|
|
||||||
|
|
||||||
A message, where multiple one-pass signatures are calculated over the same plaintext looks the following:
|
|
||||||
`OPS₀ OPS₀ OPS₁ LIT("Hello World") SIG SIG SIG`
|
|
||||||
|
|
||||||
All three signatures are calculated over the same plaintext `Hello World`.
|
|
||||||
|
|
||||||
Now, a message, where the signer attests an already signed message has the following format:
|
|
||||||
`OPS₁ OPS₁ LIT("Hello World") SIG SIG`
|
|
||||||
|
|
||||||
While the inner signature is calculated over the usual plaintext `Hello World`, the outer signature is instead calculated over `OPS₁ Hello World SIG`.
|
|
||||||
|
|
||||||
(prefixed-signature)=
|
(prefixed-signature)=
|
||||||
### Prefixed signed message
|
### Prefixed signed message
|
||||||
|
|
||||||
|
@ -159,3 +113,49 @@ However, when a signer creates a {term}`prefixed signed message`, the signed dat
|
||||||
|
|
||||||
- once reading it to calculate the cryptographic signature, and
|
- once reading it to calculate the cryptographic signature, and
|
||||||
- once more to store the data in the generated OpenPGP message, after the signature packet(s).
|
- once more to store the data in the generated OpenPGP message, after the signature packet(s).
|
||||||
|
|
||||||
|
## Nesting of one-pass signatures
|
||||||
|
|
||||||
|
Signing a message using the one-pass mechanism involves prepending a *One-Pass-Signature* (OPS) packet to the message and appending the corresponding signature, sandwiching the signed content.
|
||||||
|
|
||||||
|
An OpenPGP message can contain multiple signatures added that way.
|
||||||
|
|
||||||
|
```{note}
|
||||||
|
One-Pass-Signatures are nested, meaning the outermost One-Pass-Signature packet corresponds to the outermost signature packet.
|
||||||
|
```
|
||||||
|
|
||||||
|
When a message is signed, the signature is always calculated over the contents of the literal data packet, not the literal data packet itself.
|
||||||
|
This means that if a message, which is compressed using a compressed data packet is wrapped using a one-pass-signature, the signature is still being calculated over the plaintext inside the literal data packet.
|
||||||
|
|
||||||
|
There is one exception, though.
|
||||||
|
```{note}
|
||||||
|
Of course there is.
|
||||||
|
```
|
||||||
|
|
||||||
|
The OPS packet has a "nested" flag[^nested-flag], which can either be `1` or `0`.
|
||||||
|
If this flag is set to `0`, it indicates that further OPSs will follow this packet, which are calculated over the same plaintext data as this OPS is. A value of `1` indicates, that either no further OPS packets will follow (this OPS is the last), or that this OPS is calculated over the the usual plaintext data, but wrapped inside any OPS+Signature combinations that follow this OPS.
|
||||||
|
|
||||||
|
[^nested-flag]: See [description of the nested flag](https://www.ietf.org/archive/id/draft-ietf-openpgp-crypto-refresh-12.html#section-5.4-3.8.1).
|
||||||
|
|
||||||
|
This mechanism enables attested signatures, where the signer signs an already one-pass-signed message including the already contained signature.
|
||||||
|
|
||||||
|
As a practical example, consider the following notation:
|
||||||
|
* `LIT("Hello World")` represents a literal data packet with the content `Hello World`.
|
||||||
|
* `COMP(XYZ)` represents a compressed data packet over some other packet `XYZ`.
|
||||||
|
* `OPS₁` represents a one-pass-signature packet with the nested flag set to `1`. Analogous, `OPS₀` has the nested flag set to `0`.
|
||||||
|
* `SIG` represents a signature packet.
|
||||||
|
|
||||||
|
A normal, one-pass-signed message looks like this:
|
||||||
|
`OPS₁ LIT("Hello World") SIG`
|
||||||
|
|
||||||
|
Here, the signature is calculated over the plaintext `Hello World`, as is it in a message that has the following form: `OPS₁ COMP(LIT("Hello World")) SIG`.
|
||||||
|
|
||||||
|
A message, where multiple one-pass-signatures are calculated over the same plaintext looks the following:
|
||||||
|
`OPS₀ OPS₀ OPS₁ LIT("Hello World") SIG SIG SIG`
|
||||||
|
|
||||||
|
All three signatures are calculated over the same plaintext `Hello World`.
|
||||||
|
|
||||||
|
Now, a message, where the signer attests an already signed message has the following format:
|
||||||
|
`OPS₁ OPS₁ LIT("Hello World") SIG SIG`
|
||||||
|
|
||||||
|
While the inner signature is calculated over the usual plaintext `Hello World`, the outer signature is instead calculated over `OPS₁ Hello World SIG`.
|
||||||
|
|
Loading…
Reference in a new issue