diff mbox series

[b4] Document patatt key selector

Message ID 20240817-selector-doc-v1-1-7c5c824a4e9d@skole.hr (mailing list archive)
State Accepted
Headers show
Series [b4] Document patatt key selector | expand

Commit Message

Duje Mihanović via B4 Relay Aug. 17, 2024, 8 a.m. UTC 
From: Duje Mihanović <duje.mihanovic@skole.hr>

This selector can be used to authorize multiple keys for one email
address, but hasn't been documented anywhere as far as I can tell.

Link: https://lore.kernel.org/all/20240729-macaque-of-inspiring-recreation-9e5c4b@lemur/
Signed-off-by: Duje Mihanović <duje.mihanovic@skole.hr>
---
 docs/contributor/send.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)


---
base-commit: 37811c93f50e70f325e45107a9a20ffc69f2f6dc
change-id: 20240817-selector-doc-e409184925f8

Best regards,

Comments

Konstantin Ryabitsev Sept. 6, 2024, 2:47 p.m. UTC | #1 
On Sat, 17 Aug 2024 10:00:53 +0200, Duje Mihanović wrote:
> This selector can be used to authorize multiple keys for one email
> address, but hasn't been documented anywhere as far as I can tell.
> 
> 

Applied, thanks!

[1/1] Document patatt key selector
      commit: 4c8d3ce60abaaf81b29c58f6ed77cccaafbe33e0

Best regards,
diff mbox series

Patch

diff --git a/docs/contributor/send.rst b/docs/contributor/send.rst
index a597ac5..54ed474 100644
--- a/docs/contributor/send.rst
+++ b/docs/contributor/send.rst
@@ -122,6 +122,23 @@  from the message::
 
 You should now be able to send patches via this web submission endpoint.
 
+Changing your attestation key
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+If you change your attestation key without changing your email address (e.g.
+switch from a ``patatt`` generated key to a PGP key or change your PGP keys),
+your previous authorization will stop working. Trying to reauthorize will also
+result in an error as changing the attestation key is `currently unsupported
+<https://lore.kernel.org/tools/4608818.LvFx2qVVIh@radijator/T/#m9aa19999463864341ed8be929f470e5439513256>`_.
+Instead, you can change the key selector to something other than ``default``
+with the following setting::
+
+    [patatt]
+       selector = something
+
+.. note::
+   The selector can be anything besides default or any previously used selector.
+   For example, you could use the creation date of your PGP key.
+
 Using your own SMTP server
 --------------------------
 If there is a ``sendmail`` section in your git configuration, B4 tries