Skip to content

ezgh keys

Keys: encryption keys, and the operations that use them.

Updated View as Markdown
ezgh keys <command>

EZGH Keys holds symmetric encryption keys in a project (--project, EZGH_PROJECT or the profile’s). You create, rotate, disable and delete them, and use them to encrypt small values and to generate data keys, without ever seeing a key’s material.

A <key> is its ID (kms_…), its UUID or alias:<name>.

Plaintext is read from stdin or --file, never from an argument, which would land in shell history and process lists. --context does land there; --context-file doesn’t.

Flags

This command also takes the global flags.

Subcommands

Command Description
ezgh keys aliases Names that point at keys
ezgh keys cancel-deletion Cancel a key’s deletion
ezgh keys create Create a key
ezgh keys decrypt Decrypt a ciphertext, from stdin or a file
ezgh keys disable Disable a key
ezgh keys enable Enable a disabled key
ezgh keys encrypt Encrypt up to 4 KiB, from stdin or a file
ezgh keys generate-data-key Make a data key, shown open and sealed
ezgh keys generate-data-key-without-plaintext Make a data key, shown only sealed
ezgh keys generate-random Generate random bytes
ezgh keys get Show a key
ezgh keys grants A key’s grants: use by a user or bot, without changing its policy
ezgh keys list List the project’s keys
ezgh keys policy A key’s policy: who may use and manage it, within what IAM allows
ezgh keys re-encrypt Move a ciphertext to another key, without showing its plaintext
ezgh keys rotate Rotate a key now
ezgh keys schedule-deletion Schedule a key’s deletion
ezgh keys update Rename, describe or tag a key
Navigation

Type to search…

↑↓ navigate↵ selectEsc close