File: README.md

package info (click to toggle)
glome 0.3.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 716 kB
  • sloc: ansic: 2,468; python: 508; sh: 149; makefile: 20
file content (46 lines) | stat: -rw-r--r-- 1,027 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# GLOME CLI

This is a CLI utility to facilitate GLOME operations from the command line.

## Usage

Generating two key pairs:

```shell
$ glome genkey | tee Alice | glome pubkey >Alice.pub
$ glome genkey | tee Bob   | glome pubkey >Bob.pub
```

Alice calculates a tag and send it together with message and counter to Bob:

```shell
$ tag=$(echo "Hello world!" | glome tag --key Alice --peer Bob.pub)

$ echo "${tag?}"
_QuyLz_nkj5exUJscocS8LDnCMszvSmp9wpQuRshi30=
```

Bob can verify that the tag matches:

```shell
$ echo "Hello world!" | glome verify --key Bob --peer Alice.pub --tag "${tag?}"

$ echo $?
0
```

Both parties can agree to shorten the tag to reduce the protocol overhead:

```shell
$ echo "Hello world!" | glome verify --key Bob --peer Alice.pub --tag "${tag:0:12}"

$ echo $?
0
```

CLI also supports ganerating tags for the GLOME Login requests:

```shell
$ glome login --key Bob v1/AYUg8AmJMKdUdIt93LQ-91oNvzoNJjga9OukqY6qm05q0PU=/my-server.local/shell/root/
MT_Zc-hucXRjTXTBEo53ehoeUsFn1oFyVadViXf-I4k=
```