Update documentation on keys/identities

loewenheim

Jun 16, 2023, 3:05 PM

UAWTPPQXPT5S2G5AKLFCLY4PIXA4AS3456MOLDSYQTZTYFDGP2XAC

Dependencies

• [2] NT22VBIW Add key and configuration info
• [3] AFXHW7MX Swapped associativity figures
• [4] VLTCDWTC Moved files (new permissions format)
• [5] SCSV2FNS Reboot
• [6] GLUD3ZVF Generating the reference
• [7] AJ32E5LB Add custom.css to justify align content paragraphs and enable hyphenation
• [8] LYR3UWPM Add workflows chapter with page about channels
• [9] HKJIGLCD Conflict resolution

Change contents

• file move: keys.md (----------) → identities.md (----------)
  [3.6]

  [2.47]
• replacement in src/identities.md at line 1
  [2.47]→[2.48:61](∅→∅)
  − # Pijul keys
  [2.47]

  [2.61]
  + # Pijul identities
• replacement in src/identities.md at line 3
  [2.62]→[2.62:584](∅→∅)
  − Pijul keys are used to identify patch authors in a manner which provides greater security and control than simply mapping authors to a name and email address. The inclusion of a name and email address can be spoofed in a way that a key signature cannot. In addition, Pijul plans to take advantage of the fact that a user's name and e-mail address are no longer tied to their submitted patches, allowing users to later change the name and e-mail address that other users see when they look at previously submitted patches.
  [2.62]

  [2.584]
  + Pijul identities are used to identify patch authors in a manner which provides greater security and control than simply mapping authors to a name and email address. The inclusion of a name and email address can be spoofed in a way that a key signature cannot. In addition, Pijul plans to take advantage of the fact that a user's name and e-mail address are no longer tied to their submitted patches, allowing users to later change the name and e-mail address that other users see when they look at previously submitted patches.
• replacement in src/identities.md at line 7
  [2.840]→[2.840:859](∅→∅)
  − ## Generating keys
  [2.840]

  [2.859]
  + ## Generating identities
• replacement in src/identities.md at line 9
  [2.860]→[2.860:1311](∅→∅)
  − Users can generate a new key using `pijul key generate <name>`. The name used for this key is not required to bear any relationship to a nest username or SSH identity. During key generation, users will be asked for a password; on success, the location of the generated key will be displayed to the user (it should be the same directory as your [global configuration](configuration.md)). Pijul currently allows for the generation of one key at a time.
  [2.860]

  [2.1311]
  + Users can generate a new identity using `pijul identity new [name]`. The name used for this identity is not required to bear any relationship to a nest username or SSH identity. During identity generation, users will be asked for a password; on success, the location of the generated key will be displayed to the user (it should be the same directory as your [global configuration](configuration.md)). Pijul currently allows for the generation of one identity at a time.
• replacement in src/identities.md at line 11
  [2.1312]→[2.1312:1328](∅→∅)
  − ## Proving keys
  [2.1312]

  [2.1328]
  + ## Proving identities
• replacement in src/identities.md at line 13
  [2.1329]→[2.1329:1505](∅→∅)
  − `pijul key prove [options] <remote>` is used to associate a key with a remote/nest identity. Patches submitted before using `pijul prove` will show only the key as the author.
  [2.1329]

  [2.1505]
  + `pijul identity prove [options] <remote>` is used to associate an identity with a remote/nest identity. Patches submitted before using `pijul prove` will show only the key as the author.
• replacement in src/identities.md at line 15
  [2.1506]→[2.1506:1539](∅→∅)
  − Example (after key generation) :
  [2.1506]

  [2.1539]
  + Example (after identity generation) :
• replacement in src/identities.md at line 17
  [2.1543]→[2.1543:1589](∅→∅)
  − pijul key prove <your_username>@ssh.pijul.com
  [2.1543]

  [2.1589]
  + pijul identity prove <your_username>@ssh.pijul.com
• replacement in src/getting_started.md at line 21
  [2.1686]→[2.1686:1759](∅→∅)
  − Users can read more about keys in [the manual section on keys](keys.md).
  [2.1686]

  [3.322325]
  + Users can read more about keys in [the manual section on identities](identities.md).
• replacement in src/SUMMARY.md at line 8
  [3.503322]→[2.3090:3116](∅→∅)
  − - [Pijul keys](./keys.md)
  [3.503322]

  [2.3116]
  + - [Pijul identities](./identities.md)