Geräte entfernen

juist remove nimmt ein Gerät aus dem Netz, etwa ein verlorenes Handy. Jedes Gerät baut seinen Tunnel ab, sobald es von der Entfernung erfährt, und ein von den anderen abgeschnittenes spätestens, wenn seine Frische abläuft.

Worum es geht

Ein Gerät zu entfernen ist eine Änderung am Log des Netzes, der signierten Liste, wer dazugehört (siehe So funktioniert juist). Wie jede Änderung braucht sie die Bestätigung deiner Admins, der Personen, deren Schlüssel Änderungen bestätigen.

Sobald die Entfernung im Log steht, baut jedes Gerät, das sie erhält, den Tunnel zum entfernten Gerät ab. Das Netz bekommt außerdem ein neues Gruppengeheimnis, einen Schlüssel, den alle Mitglieder teilen. So findet das entfernte Gerät die anderen nicht mehr.

Ein Gerät entfernen

1auf dem Gerät eines Admins

Das Gerät über seinen Namen, seine Adresse oder seinen Schlüssel (juist devices --keys) entfernen:

juist remove phone

$ juist remove phone
remove phone (198.18.36.4  fd4c:8a21:e3f:e83:5a7d:f12c:9b46:d371) from "home"? [y/N] y
removed phone

Braucht eine Änderung mehr als einen Admin, gibt es stattdessen pending … aus und wartet, bis die anderen juist approve ausführen (Änderungen bestätigen).

juist log listet jetzt device removal: phone, mit den Admins, die es bestätigt haben.

Was das entfernte Gerät sieht

Ist es erreichbar, wenn die Entfernung angewendet wird, erfährt es davon:

phone

$ juist status
home · removed
hint: rejoin with a new invite, or start over: juist reset

Um es wieder zu nutzen, lade es neu ein, oder führe juist reset aus, damit es in keinem Netz ist, wie nach einer frischen Installation.

Ein Gerät, das in dem Moment offline war, erfährt es nicht. Es zeigt sich vielleicht weiter als verbunden, obwohl kein Mitglied es mehr annimmt, oder sagt the network's devices refuse this one: most likely it was removed.

Warum es nicht überall sofort wirkt

Es gibt keinen Server, der allen Geräten auf einmal Bescheid gibt. Die Geräte reichen Änderungen untereinander weiter. Ein Gerät, das offline oder von den anderen abgeschnitten ist, erfährt von der Entfernung also erst, wenn es wieder Kontakt hat. Bis dahin könnte es einen Tunnel zum entfernten Gerät halten.

Die Frische setzt dem eine Grenze. Ein Voucher ist ein Gerät, das stündlich bestätigt, dass der Stand des Netzes aktuell ist. Das Gerät, das das Netz angelegt hat, ist einer. Ein Gerät, das 48 Stunden lang keine Bestätigung von einem Voucher bekommen hat, hält nur noch Tunnel zu Vouchern. So kann es kein entferntes Gerät mitschleppen. Sein juist status zeigt dann den Zustand limited und Freshness expired; vouchers only.

Das gilt nur, solange die Voucher nicht zusammen mit dem Gerät abgeschnitten sind: Ein Voucher hält jedes Gerät aktuell, das er noch erreicht.

2auf dem Gerät eines Admins

Ein Gerät, das immer läuft, etwa einen VPS, zum Voucher machen:

juist grant vps voucher

Die Rolle ist kein Admin-Schlüssel. Mit ihr bestätigt das Gerät den Stand des Netzes und ändert nichts.

Ohne weitere Einstellung reicht ein Voucher. Ein Voucher, der lügt, könnte die Geräte, die er erreicht, dann auf einem alten Stand halten. Dagegen hilft es, mehrere zu verlangen:

juist admins vouchers 2

Jetzt traut ein Gerät seiner Sicht nur, wenn zwei Voucher sie innerhalb von 48 Stunden bestätigt haben. Ein unehrlicher Voucher reicht dann nicht, aber es müssen zwei Voucher online sein.

Gut zu wissen

juist remove lehnt es ab, einen der Voucher zu entfernen, die juist admins vouchers verlangt, und sagt, wie du die Zahl vorher senkst.
Wer den letzten Voucher entfernt, wird gewarnt, dass die Frische dann nicht mehr geprüft wird.
Hielt das entfernte Gerät einen Admin-Schlüssel, wie ein verlorener Laptop, nimm diesem Schlüssel auch seine Stimme: juist admins remove. Siehe Admins.
juist remove auf dem Gerät selbst warnt, dass es das Netz endgültig verlässt.
juist reset auf einem Gerät, das das Netz noch listet, braucht --force. Entferne es vorher, wo du kannst.

Wenn etwas nicht klappt

Freshness expired; vouchers only heißt, dass 48 Stunden lang kein Voucher erreichbar war. Bring einen Voucher wieder online; das Gerät ist wieder aktuell, sobald dessen Bestätigung ankommt. Siehe Fehlersuche.