turnkey/openpgp-card
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Move cardholder URL options to tools/README.md, to keep the guide short.

Browse source
This commit is contained in:
Heiko Schaefer 2022-04-21 18:22:20 +02:00
parent 9057ad516f
commit 9b4a603ace
No known key found for this signature in database
GPG key ID: 4A849A1904CCBD7D
2 changed files with 22 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
guide/src/opgpcard.md
View file

@ -109,26 +109,7 @@ Some software may use this URL to obtain a copy of the corresponding public key
`$ opgpcard admin -c FFFE:12345678 url <url>`
If you do use the URL field, the URL should serve a copy of your public key.
For most use cases, you don't need to set the URL.
### Using `keys.openpgp.org` for the URL
If you have uploaded (or plan to upload) your certificate to the `keys.openpgp.org` keyserver, you can set the URL
field on your card to point to that server:
If the fingerprint of your certificate is `0123456789ABCDEF0123456789ABCDEF01234567`, then you can set the URL
as follows:
`$ opgpcard admin -c FFFE:12345678 url "https://keys.openpgp.org/vks/v1/by-fingerprint/0123456789ABCDEF0123456789ABCDEF01234567"`
### Other URLs
You can use any URL that serves your public key, including a link to your certificate on:
- gitlab (`https://gitlab.com/<username>.gpg`) or github (`https://github.com/<username>.gpg`)
- any other keyserver, such as https://keyserver.ubuntu.com/,
- a WKD server,
- a copy of your certificate on your personal website, ...
For most use cases, you don't need to set this URL.
# Importing a key to a card

21
tools/README.md
View file

@ -307,6 +307,27 @@ or interactively
$ opgpcard admin -c ABCD:01234567 url "https://key.url.example"
```
##### Using `keys.openpgp.org` for the URL
If you have uploaded (or plan to upload) your certificate to the `keys.openpgp.org` keyserver, you can set the URL
field on your card to point to that server:
If the fingerprint of your certificate is `0123456789ABCDEF0123456789ABCDEF01234567`, then you can set the URL
as follows:
`$ opgpcard admin -c FFFE:12345678 url "https://keys.openpgp.org/vks/v1/by-fingerprint/0123456789ABCDEF0123456789ABCDEF01234567"`
##### Other URLs
You can use any URL that serves your public key, including a link to your certificate on:
- gitlab (`https://gitlab.com/<username>.gpg`) or github (`https://github.com/<username>.gpg`)
- any other keyserver, such as https://keyserver.ubuntu.com/,
- a WKD server,
- a copy of your certificate on your personal website, ...
#### Import keys
Import private key onto a card. This works if at most one (sub)key per role