Glossary: adjust to appropriate syntax

As outlined in #15
This commit is contained in:
Heiko Schaefer 2023-09-21 11:36:05 +02:00
parent 6a37e6966d
commit 3a57e9b614
No known key found for this signature in database
GPG key ID: 4A849A1904CCBD7D
2 changed files with 38 additions and 19 deletions

View file

@ -1,19 +0,0 @@
# Glossary
This document aims to enumerate and clarify alternative terms that have been
used for the same concept in the OpenPGP space, as well as to document
terminology specific to OpenPGP CA.
- Authentication
- Bridge: Two instances of OpenPGP CA mark each other as (scoped) trusted
introducers, which means that users in both organizations see each other
as authenticated
- Certification ("Signature" on a certificate)
- Key / OpenPGP Key (Certificate)
- Key creation workflow: centralized/decentralized
- OpenPGP
- Revocation certificate
- Trust signature ("tsig"), a speficic type of certification for a
certificate, which marks that key as a "trusted introducer" (i.e. the
party that creates the trust signature signals that they will trust
certifications that the "trusted introducer" makes on certificates)

View file

@ -0,0 +1,38 @@
Glossary
========
.. glossary::
:sorted:
Authentication
Checking the validity of a claim (e.g. an identity claim). Making sure that a claim is "authentic".
Certification
"Third party Signature" on a certificate, making a statement about that certificate, or an identity in the certificate
Delegation
See :term:`Trust signature`
Revocation certificate
A type of signature that invalidates a previous statement made via a signature
Certificate
See :term:`OpenPGP Certificate`
Key
See :term:`OpenPGP Key`
OpenPGP Key
Used either for an OpenPGP Certificate (containing public key material and metadata), or for an See :term:`OpenPGP Private Key`
OpenPGP Private Key
The combination of an :term:`OpenPGP Certificate` and the associated private key material
OpenPGP Certificate
An OpenPGP certificate contains public key material, identity claims and third party certifications (but no private key material)
Trust signature
a specific type of certification for a certificate, which marks that key as a "trusted introducer" (i.e. the party that creates the trust signature signals that they will trust certifications that the "trusted introducer" makes on certificates)
tsig
See :term:`Trust signature`