crypt

README

crypt

Universal cryptographic tool with AWS KMS, GCP KMS and Azure Key Vault support.

• Installation
  • Binaries
  • Via Go
  • Via homebrew (macOS)
• Usage
  • Examples
• Development
• Contribution

Maturity

Provider	Maturity
AWS KMS	beta
Azure Key Vault	beta
GCP KMS	alpha
GPG (GnuPG)	alpha

Installation

Binaries

Downloading binaries with bash:

OS=$(uname -s | tr '[A-Z]' '[a-z]')
ARCH=amd64
curl -SLf# -o ${HOME}/bin/crypt https://github.com/VirtusLab/crypt/releases/download/v0.2.6/crypt-${OS}-${ARCH}
chmod +x ${HOME}/bin/crypt
crypt --version

Popular links:

• Mac OS 64 bit
• Linux 64 bit
• Windows 64 bit

For more binaries please visit the Releases Page.

Via Go

go get github.com/VirtusLab/crypt

Via Homebrew

# Will be installed as cloudcrypt
brew tap virtuslab/cloud && brew install cloudcrypt

Usage

NAME:
   crypt - Universal cryptographic tool with AWS KMS, GCP KMS and Azure Key Vault support

USAGE:
   crypt [global options] command [command options] [arguments...]

VERSION:
   v0.2.6

AUTHOR:
   VirtusLab

COMMANDS:
     encrypt, enc, en, e  Encrypts files and/or strings
     decrypt, dec, de, d  Decrypts files and/or strings
     help, h              Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --debug, -d    run in debug mode
   --help, -h     show help
   --version, -v  print the version

Examples

Please find usage examples below:

• Getting Started with AWS KMS
• Getting Started with Azure Key Vault
• Getting Started with Google GCP KMS
• Getting Started with GPG (GnuPG)

Development

export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

mkdir -p $GOPATH/src/github.com/VirtusLab
cd $GOPATH/src/github.com/VirtusLab
git clone git@github.com:VirtusLab/crypt.git
cd crypt

go get -u github.com/golang/dep/cmd/dep
make all

Testing

make test

Integration testing

Update properties in the Makefile and run:

make integrationtest

Contribution

Feel free to file issues or pull requests.