Mercurial > libervia-backend

comparison doc/libervia-cli/pubsub_signature.rst @ 3966:9f85369294f3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc (encryption, cli): pubsub signing documentation: - add a `Pubsub Signature` section to `encryption` documentation - document `-X, --sign` flag where it's used - document `pubsub/signature` subcommands fix 381
author Goffi <goffi@goffi.org>
date Sun, 30 Oct 2022 01:06:58 +0200
parents
children
comparison
equal deleted inserted replaced
3965:2695dafc5c4d 3966:9f85369294f3
1 .. _libervia-cli_pubsub_signature:
2
3 =================================================
4 pubsub/signature: Sign and Check Items Signatures
5 =================================================
6
7 ``signature`` group commands to handle pubsub item cryptographic signatures:
8
9 You can check :ref:`pubsub-encryption` to have overview on how it works.
10
11 sign
12 =====
13
14 Sign a pubsub item using OpenPGP keys of the profile.
15
16 example
17 -------
18
19 Louise want to sign an item on her blog::
20
21 $ li pubsub signature sign -s louise@example.net -n urn:xmpp:microblog:0 -i about_feminism
22
23 check
24 =====
25
26 Check validity of a signature found in attachments. For now, the attachments data JSON as
27 found in attachments must be used, it is planned to make this command simpler in the close
28 future.
29
30 example
31 -------
32
33 Pierre wants to check that a blog post is really from Louise::
34
35 $ li pubsub signature check -s louise@example.net -n urn:xmpp:microblog:0 -i about_feminism '{"timestamp": 1667079677.0, "signers": ["louise@example.net"], "signature": "iQGzBAABCAAdFiEEeTqK7iUsJz97sLSEgjG1Of9Gvi0FAmNdnf0ACgkQgjG1Of9Gvi293Qv+IWe6gkaAPzGI6fis9yg9biSdFE9qf9oi+jyTiZuTR1QjjZYE7x+vsj3KewKBUMOyqxKMk1WVKmimDb3yCqfF852lEox3OQuBMP46G9UHDNII6D+oqe4VVWZhqe3s3twWYc08nrvAUH4tMI96xml4wuEk6Fv8PwBcNEEzX8zNwLYeY6tsR72XErBDn5oY06OGhZeLBn6FkUI1QZ3jT0djjH87CuH+9gOS6vEIpO+UnCqvB3aqxwhHIIOh5X9bUyEyxINb3kA6WpYumlc92vE8ROndPZGEni9OfouTjJL7+tUmcNz4RJdbEzBpETtzJ4B3r/kbJWKi5YDpZZOI1k/W/eKXFIg6Aycc0iG/THSEwvYMFGrmyQYosdC+mbjSE4DvYE1aSHOLW3ut5kNuDqLH17/kyOh+VoR4FAkRtGoa34sQN2jaRG8m/Gl+98Ha67k8OisnrHOx7FKGGcrpEp+BCUgvNP0IRFCz26xSaZ6aXK2SQkcvlbVXf6o0BkE5Hwcn"}'