kurogeek
f58da21d15
Add a flake check `phonebox-global-sync` that exercises phonebox-sync.py: yggdrasil address derivation (fixed vector plus cross-check against the yggdrasil binary), record verification (foreign address, bad or forged signature, malformed tags, number format), collision tie-breaking, and the files written for the dialplan including stale entry removal.
A peer to peer phone relay network built on top of yggdrasil.
Successor of the phonebox service with a global, decentralized number
directory. Every box is reachable from any yggdrasil node running this
service, not only from members of the same clan. A machine runs either
phonebox or phonebox-global, not both (they share the asterisk setup).
Regenerate vars with clan vars generate --generator phonebox-global.
Numbers
Each box gets a random 6 digit number (100000-999999) when its vars are
generated. The number is signed with the box's yggdrasil private key, so a
number is cryptographically bound to the yggdrasil address it belongs to;
nobody can claim a number for an address they do not own. Regenerate the
phonebox vars to get a new number.
Dialing from a phone plugged into the ATA:
| dialed | reaches |
|---|---|
NNNNNN |
the phone on box NNNNNN (line 00) |
NNNNNNXX |
line XX on box NNNNNN |
00, 01... |
local lines on this box |
888 |
fax of the current number directory |
000 |
fax echo test |
999 |
hello world |
Caller ID on the callee is the caller's box number followed by its line, so calling it back works.
Directory
There is no central registry. Each box runs a serf agent on yggdrasil port
7946 that gossips its signed number record (number, key, sig, owner
tags) to every other box it knows about. On every membership change the
phonebox-sync handler verifies all records and writes the resulting
number -> yggdrasil address map to /run/phonebox/numbers/, which the
asterisk dialplan reads at call time.
Bootstrapping: boxes of the same clan join each other automatically. To
connect to boxes outside the clan add one of their yggdrasil addresses to
extraPeers; after the first successful join the agent remembers the whole
membership in /var/lib/phonebox/serf.snapshot and rejoins on its own.
serf members -rpc-addr 127.0.0.1:7373 shows the live directory.