https://github.com/earthboundkid/bletchley
Simple command line application for basic public key crypto
https://github.com/earthboundkid/bletchley
command-line-app cryptography-tools go rsa
Last synced: 12 months ago
JSON representation
Simple command line application for basic public key crypto
- Host: GitHub
- URL: https://github.com/earthboundkid/bletchley
- Owner: earthboundkid
- License: mit
- Created: 2018-05-18T20:14:09.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-05-21T13:22:16.000Z (about 8 years ago)
- Last Synced: 2025-02-01T08:45:40.609Z (over 1 year ago)
- Topics: command-line-app, cryptography-tools, go, rsa
- Language: Go
- Size: 15.6 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bletchley [](https://godoc.org/github.com/carlmjohnson/bletchley)
Bletchley is a simple command line application for basic public key based file exchange.
## Usage
Suppose **Alice** has a file of secret information that she wants to share with her coworker, **Bob**. They regularly communicate, so authentication is not an issue. The issue is that Alice does not want her secrets to be in some email attachment, Slack history, or S3 bucket for an indefinite period of time, and she doesn't necessarily trust the network not to eavesdrop on her file exchange. Alice and Bob agree to exchange the file using **bletchley**.
- Alice asks Bob to run `bletchley-create` to create a public/private key pair for himself.
- Bob sends Alice his `public.pem` file through their normal communication channel. She saves it as `bob.pem`.
- Alice runs `bletchley-encode -key-src bob.pem -msg-src secrets.txt -cipher-dest secrets.pem`.
- Alice sends Bob her `secrets.pem` file through their normal communication channel.
- Bob runs `bletchley-decode -key-src private.pem -cipher-src secrets.pem -msg-dst secrets.txt`.
- Alice and Bob go back to work.
## Installation
First install [Go](http://golang.org).
If you just want to install the binary to your current directory and don't care about the source code, run
```bash
GOBIN="$(pwd)" GOPATH="$(mktemp -d)" go get github.com/carlmjohnson/bletchley/...
```
## Screenshots
```bash
$ bletchley-create -h
bletchley-create generates a new public/private RSA key pair.
Use -src to extract the public component out of an existing private key PEM
file. In that case, -bit-size and -private-dest will be ignored.
Usage of bletchley-create:
-bit-size int
bit size for RSA key (default 4096)
-private-dest string
file to save private key to (default "private.pem")
-public-dest string
file to save public key to (default "public.pem")
-src string
private key to extract public key from
$ bletchley-encode -h
bletchley-encode generates a one time use password and encodes it with a public
RSA key so that only the possessor of the private key can decode it, then
encodes the message with the one time use password.
Usage of bletchley-encode:
-cipher-dest string
file to save encrypted ciphertext into (default "cipher.pem")
-key-src string
public key to encode message with (default "public.pem")
-msg-src string
file to encrypt (default "-")
$ bletchley-decode -h
bletchley-decode decodes a bletchley cipher PEM file.
Usage of bletchley-decode:
-cipher-src string
file to decrypt (default "cipher.pem")
-key-src string
private key to decode cipher with (default "private.pem")
-msg-dest string
file to save decrypted message into (default "-")
Bob $ bletchley-create -private-dest private.pem -public-dest public.pem
... Bob sends public.pem ...
Alice $ bletchley-encode -key-src public.pem -msg-src <(echo 'Hello, World!') -cipher-dest cipher.txt
... Alice sends cipher.txt ...
Bob $ bletchley-decode -key-src private.pem -cipher-src cipher.txt
Hello, World!
```
## Acknowledgements
Bletchley is based on code from [github.com/gtank/cryptopasta/](https://github.com/gtank/cryptopasta/blob/master/encrypt.go).