diff --git a/pages/common/age-keygen.md b/pages/common/age-keygen.md new file mode 100644 index 000000000..c3cbabd9c --- /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 a4ec995cc..a2b5f9609 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):