diff options
Diffstat (limited to 'src/content/docs/guides/key-server-operations.md')
| -rw-r--r-- | src/content/docs/guides/key-server-operations.md | 48 |
1 files changed, 25 insertions, 23 deletions
diff --git a/src/content/docs/guides/key-server-operations.md b/src/content/docs/guides/key-server-operations.md index f11dd4d..ab58439 100644 --- a/src/content/docs/guides/key-server-operations.md +++ b/src/content/docs/guides/key-server-operations.md @@ -26,7 +26,7 @@ straightforward for all users.  -### How to Import: +### How to Import 1. Choose a key server from the drop-down list. 2. Enter a **Key ID**, **Fingerprint**, or **Email Address** into the search @@ -70,13 +70,13 @@ After v2.1.6, **GpgFrontend uses by default. This server uses the **Verifying Keyserver (VKS) Interface**, which provides extra protection against spam and key poisoning. -### Key Points: +### Key Points -- 🔐 **Only public keys are uploaded**, never private keys. -- ✅ **Master key is required** to export. -- ✉️ `keys.openpgp.org` requires email verification before your key becomes +- **Only public keys are uploaded**, never private keys. +- **Master key is required** to export. +- `keys.openpgp.org` requires email verification before your key becomes publicly searchable. -- 🧱 Uploaded keys are **propagated through the VKS protocol** and cannot be + Uploaded keys are **propagated through the VKS protocol** and cannot be deleted. To export: @@ -101,14 +101,16 @@ GpgFrontend will: - Compare the server copy with your local one. - Indicate if any update is applied. -> ⚠️ Synchronization is **not available** if you have the private key locally. -> In this case, you are expected to **publish** updates, not pull them. +:::caution[Sync/Publish] -## Key Server Related Settings +Synchronization is **not available** if you have the private key locally. In +this case, you are expected to **publish** updates, not pull them. + +::: -You can configure your key server preferences in: +## Key Server Related Settings -> **Settings → Key Servers** +You can configure your key server preferences in: Settings → Key Servers  @@ -141,14 +143,12 @@ Setting a default key server **only affects key searches/imports**. This behavior ensures improved security and global consistency in public key management. -::: - -### Want to restore previous behavior? - -You can disable the `KeyServerSync` module in the module controller. This will -prevent GpgFrontend from forcing export/sync operations to use +Restore: You can disable the `KeyServerSync` module in the module controller. +This will prevent GpgFrontend from forcing export/sync operations to use `keys.openpgp.org`, allowing custom server logic to take effect again. +::: + ## Tips about Key Servers | Key Server | Fuzzy Search | VKS Interface | Notes | @@ -159,10 +159,14 @@ prevent GpgFrontend from forcing export/sync operations to use > 🔎 `keys.openpgp.org` does **not** support fuzzy search — you must use the > **exact email**, **full fingerprint**, or **full key ID**. -> ⚠️ **Don't confuse search servers with export/sync servers** — even if you -> perform key searches using a custom server like `keyserver.ubuntu.com`, -> **Export** and **Sync** operations will still use `keys.openpgp.org` by -> default in **GpgFrontend v2.1.6 and later**. +:::caution[Confusing Concepts] + +**Don't confuse `search servers` with `export/sync servers`** — even if you perform +key searches using a custom server like `keyserver.ubuntu.com`, **Export** and +**Sync** operations will still use `keys.openpgp.org` by default in +**GpgFrontend v2.1.6 and later**. + +::: ## Automatically Check Key Publish Status @@ -181,8 +185,6 @@ helping users keep track of their key visibility on the VKS-based keyserver. ### How to Enable -To activate this: - 1. Go to `Settings → Network` tab. 2. Under **Network Ability**, check the box: `Automatically fetch key publish status from key server` |