From c48bddf76c3f5a087f295991e1e4eacba92ec458 Mon Sep 17 00:00:00 2001 From: Lena <126529524+acuteenvy@users.noreply.github.com> Date: Wed, 9 Aug 2023 16:01:20 +0200 Subject: [PATCH] age-keygen: add page; age: update page (#10424) * age-keygen: add page; age: update page * age: remove `_` before numbers in placeholders * age: update `--recipient` example --- pages/common/age-keygen.md | 13 +++++++++++++ pages/common/age.md | 9 +++------ 2 files changed, 16 insertions(+), 6 deletions(-) create mode 100644 pages/common/age-keygen.md diff --git a/pages/common/age-keygen.md b/pages/common/age-keygen.md new file mode 100644 index 0000000000..c3cbabd9c7 --- /dev/null +++ b/pages/common/age-keygen.md @@ -0,0 +1,13 @@ +# age-keygen + +> Generate `age` key pairs. +> See `age` for how to encrypt/decrypt files. +> More information: . + +- Generate a key pair, save it to an unencrypted file and print the public key to `stdout`: + +`age-keygen --output {{path/to/file}}` + +- Convert an identity to a recipient and print the public key to `stdout`: + +`age-keygen -y {{path/to/file}}` diff --git a/pages/common/age.md b/pages/common/age.md index a4ec995ccd..a2b5f9609f 100644 --- a/pages/common/age.md +++ b/pages/common/age.md @@ -1,19 +1,16 @@ # age > A simple, modern and secure file encryption tool. +> See `age-keygen` for how to generate key pairs. > More information: . - Generate an encrypted file that can be decrypted with a passphrase: `age --passphrase --output {{path/to/encrypted_file}} {{path/to/unencrypted_file}}` -- Generate a key pair, saving the private key to an unencrypted file and printing the public key to `stdout`: +- Encrypt a file with one or more public keys entered as literals (repeat the `--recipient` flag to specify multiple public keys): -`age-keygen --output {{path/to/file}}` - -- Encrypt a file with one or more public keys that are entered as literals: - -`age --recipient {{public_key_1}} --recipient {{public_key_2}} --output {{path/to/encrypted_file}} {{path/to/unencrypted_file}}` +`age --recipient {{public_key}} --output {{path/to/encrypted_file}} {{path/to/unencrypted_file}}` - Encrypt a file to one or more recipients with their public keys specified in a file (one per line):