From 69c4fc3fa98502e962477a21b7719b3b87bfcf84 Mon Sep 17 00:00:00 2001 From: saturneric Date: Fri, 5 Apr 2024 20:46:30 +0800 Subject: feat: initial commit --- src/content/docs/guides/import-export-key-pair.md | 115 ++++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 src/content/docs/guides/import-export-key-pair.md (limited to 'src/content/docs/guides/import-export-key-pair.md') diff --git a/src/content/docs/guides/import-export-key-pair.md b/src/content/docs/guides/import-export-key-pair.md new file mode 100644 index 0000000..d8f35d0 --- /dev/null +++ b/src/content/docs/guides/import-export-key-pair.md @@ -0,0 +1,115 @@ +--- +title: Import & Export Key Pair +--- + +GpgFrontend provides various methods for importing or exporting key pairs, some +of which are outlined below. Please refer to the guide for more information. + +## Import Key Pair + +To access the import options, navigate to the toolbar and select the desired +method based on your specific requirements. Additionally, you can access +additional options by selecting the action menu in the key management section. + +![Import Key Pair](https://image.cdn.bktus.com/i/2023/11/16/7c24bd6d-6e50-0eb8-943e-3447b96894b3.webp) + +In fact, you can find the action menu in the key management section, which +provides access to additional key management options beyond those available in +the toolbar. + +![Import Key Pair 2](https://image.cdn.bktus.com/i/2023/11/16/15595b17-3a88-d790-c475-cf8c5c7ee4a5.webp) + +### File + +This option allows you to select a public or private key file in text format +with any extension to import. + +### Editor + +You can paste the contents of a key file onto a blank text label page and +GpgFrontend will automatically recognize and import the corresponding key. + +### Clipboard + +You can copy the contents of a key to your system clipboard and then select this +option to import the corresponding key. + +### Key server + +This feature enables users to search for and import public keys from a key +server. Users must first enter the email or ID associated with the desired key +and select the appropriate key server. Upon clicking the search button, a list +of public keys that can be imported from the server will be displayed. Users can +choose to import multiple keys together or double-click on a specific table row +to import a corresponding public key. It is important to note that when using +this method, only public keys can be imported. + +A detailed description of this part can be found +[Here](./key-server-operations.md). + +### Dropdown on Key Toolbox + +You can drag the key file directly to the key toolbox, and then follow the +prompts of GpgFrontend to import the key. + +## Export Key Pair + +When deriving the public key of a key pair using the private key, you can derive +either the public key or the private key or both of all the keys present in the +key pair. However, if there are numerous keys in the key pair, the exported data +can be lengthy. Multiple export methods are available, which are similar to the +import process. + +In Gpg Frontend, the exported data is encoded in ASCII to ensure compatibility +between computers. + +### Export Public Key + +You can find this operation in many places. The following will introduce them +one by one. + +#### Append Public Key to Editor + +To append a public key to the editor in GpgFrontend, right-click on a row in the +key toolbox and select "Append Select Key(s) to Editor" from the pop-up menu. +This will add the public key of the selected key to the end of the text label +page. You can then copy the content to any location as needed. + +#### Export on the Key Pair at Operations Tab + +To export a public key using the Key Pair at Operations Tab, follow the steps +shown in the screenshot below. This will save the data to a file. Before +proceeding, please make sure to choose a suitable directory to store the file +containing the public key data. + +![Export on the Key Pair at Operations Tab](https://image.cdn.bktus.com/i/2023/11/16/5f7a4dbc-d261-c395-31eb-a1bc55cb4d55.webp) + +### Export multiple public keys at once + +To export public key data for multiple key pairs at once, select the desired key +pairs on the key management interface and click on the "Export to Clipboard" +option. This will copy the data to your system clipboard, which you can then +paste into any application or file. + +![Export multiple public keys at once](https://image.cdn.bktus.com/i/2023/11/16/fae0706d-8836-5ffe-804e-c21b06f1b445.webp) + +### Export Private Key + +Private key options are available in various locations on the detail page that +contains the private key (either the primary key or subkey). From there, you can +select a destination and GpgFrontend will export the corresponding private key +content to that location. + +![Export Private Key](https://image.cdn.bktus.com/i/2023/11/16/a453e2cd-3489-6403-8a89-13faa4dd6b32.webp) + +Exporting the private key also exports both the public key and private key data, +as the private key data alone is meaningless without the corresponding public +key. Thus, the private key content is typically bundled with the public key +content during export. However, it's essential to note that the private key file +should never be disclosed to others. If leaked, it could compromise the security +of all ciphertexts encrypted by the key. + +You can export the private key data in your key pair in two ways. + +1. Full export: Include all key data and UID and UID signature in the key pair. +2. Minimal export: Only all key data in the key pair is included. -- cgit v1.2.3