From cb01148e6d102cc0d20803d3c4da34e966936b33 Mon Sep 17 00:00:00 2001 From: Heiko Schaefer Date: Tue, 12 Dec 2023 00:53:06 +0100 Subject: [PATCH] Use new diagrams in ch6 --- book/source/06-signatures.md | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/book/source/06-signatures.md b/book/source/06-signatures.md index 4d6b20b..d9fbcc0 100644 --- a/book/source/06-signatures.md +++ b/book/source/06-signatures.md @@ -14,13 +14,21 @@ Without {term}`signatures`, {term}`keys`* can have two different meanings: - **{term}`Cryptographic signature`**: a sequence of bytes created by {term}`cryptographic keys`, calculated according to a {term}`signature` scheme. + +```{figure} plain_svg/cryptographic_signature.svg +:name: fig-cryptographic-signature +:alt: Depicts a box on white background. In the box, a green seal symbol with the word "sig" is shown on the left side, connected to the text "Cryptographic signature" by a black dotted line. + +A {term}`cryptographic signature` +``` + - **{term}`OpenPGP signature packets`**: Defined in the [OpenPGP standard](https://www.ietf.org/archive/id/draft-ietf-openpgp-crypto-refresh-12.html#name-signature-packet-type-id-2), these {term}`packets` combine a raw {term}`cryptographic signature` along with a *{term}`type`* designation and additional {term}`metadata`. -```{figure} plain_svg/meaning_of_signatures.svg -:name: fig-meaning-of-signatures -:alt: Depicts a box on white background with the title "Meanings of signature in OpenPGP", "signature" in italics. The top half of the box shows a green seal symbol with the word "sig" in it on the left side. The symbol is connected to the text "Cryptographic signature" by a black dotted line. The bottom half of the box shows a diagram. On the left hand side a box with green dotted frame and white background provides the title "Signature type", while inside the box the text reads "Signature over Signature data, Signature metadata". The words "Signature metadata" serve as title for a yellow box at the lower half of the signature type box. The yellow box also contains a cryptographic signature symbol. Right of the signature type box, the text "OpenPGP signature packet" is shown, which is connected to the box by a green dotted line. Below the text a list is shown, which reads "signature type, signature over input data, additional metadata and cryptographic signature". The last item is connected to the cryptographic signature symbol in the yellow box by a black dotted line. +```{figure} plain_svg/OpenPGP_Signature_packet.svg +:name: fig-signature-packet-0 +:alt: Depicts a box on white background. In the top, the text OpenPGP signature packet is connected to a dotted box. Inside a yellow box is shown. It has the title "signature metadata" and two lines of content, reading "signature type" and "additional metadata". The yellow box is labeled with the green cryptographic signature symbol. The green symbol is labeled with a dotted line and the text "Cyptographic signature" to its right. On the left side of the box, connected with a dotted line, a small cion-sized representation of the yellow signature packet and its green cryptographic signature are shown. This introducedthe equivalence of the two representations. -Two meanings of the term "{term}`signature`" in OpenPGP +An "{term}`OpenPGP Signature Packet`" ``` In this document, "{term}`signature`" will refer to {term}`OpenPGP signature packets`. @@ -59,7 +67,7 @@ As outlined above, an {term}`OpenPGP signature` is a c - **{term}`Metadata`**: varies based, in part, on the {term}`signature type ID`; mostly encoded as "{term}`subpackets`" (see {ref}`signature_subpackets`) - **Raw {term}`cryptographic signature`** -```{figure} diag/signature_packet.png +```{figure} plain_svg/OpenPGP_Signature_packet_2.svg :name: fig-signature-packet :alt: Depicts a diagram with the title "A signature packet". On the left hand side a box with green dotted frame and white background provides the title "Signature type", while inside the box the text reads "Signature over Signature data, Signature metadata". The words "Signature metadata" serve as title for a yellow box at the lower half of the signature type box. The yellow box also contains a cryptographic signature symbol. Right of the signature type box, the text "OpenPGP signature packet" is shown, which is connected to the box by a green dotted line. Below the text a list is shown, which reads "signature type, signature over input data, additional metadata and raw cryptographic signature". The last item is connected to the cryptographic signature symbol in the yellow box by a black dotted line.