Beveiliging van Konsolity CLI
Kan een token dat naar een andere machine is gekopieerd worden gebruikt?
Nee. Elke aanroep stuurt de machinevingerafdruk mee, berekend uit de systeemidentificatie. Een token dat vanaf een andere computer wordt gebruikt, wordt geweigerd, de gebeurtenis wordt vastgelegd in het beveiligingslogboek en je ontvangt een waarschuwing. Het lokale bestand met geheimen is bovendien versleuteld met een sleutel die is afgeleid van de machine-identificatie: elders gekopieerd is het onleesbaar.
De enige uitzondering: het langlevende token van konsolity setup-token, bedoeld voor kortstondige machines, is niet gebonden aan de vingerafdruk. Bewaar het in de geheimenbeheerder van je CI, geef het een zo beperkt mogelijk bereik en een korte geldigheidsduur.
Waarvoor dient de vingerafdruk die bij de activering wordt getoond?
Ze bewijst dat het verzoek dat je goedkeurt echt van de machine voor je komt. Ze wordt berekend uit de publieke sleutel van de machine; je apparaat berekent haar zelf opnieuw, zonder de server te vertrouwen. Als de twee vingerafdrukken verschillen, weiger je.
Wat ziet de server van Konsolity?
De server ziet de naam van de machine, haar systeem, haar IP-adres, haar bereik (domeinen, alleen lezen of volledig), haar sessies en het logboek van opdrachten (tekst van de opdracht, host, beslissing, afsluitcode, duur). Voor de Claude-connector (konsolity serve) vervoert hij ook, versleuteld opgeslagen en een uur na het antwoord verwijderd, de argumenten en resultaten van de aanroepen van Claude, net als voor de Claude-connector.
Hij ziet nooit de sleutel van je kluis, de machinesleutel, je SSH-sleutels, je wachtwoorden of de regels van de machine: de kopieën van de machinekluis zijn end-to-end versleuteld en de server bewaart ze alleen als ondoorzichtige blokken. De uitvoer van opdrachten die in een terminal worden uitgevoerd, gaat niet via de server.
Heeft de machine toegang tot mijn hele kluis?
Nee. Ze ontvangt nooit de sleutel van de kluis, alleen een machinesleutel en versleutelde kopieën van de hosts en snippets die je hebt gekozen. Een host buiten het bereik heeft geen kopie: zijn SSH-sleutel verlaat je kluis niet. De machine kan niet naar de kluis schrijven, haar eigen bereik niet wijzigen en niet aan je account of je abonnement komen.
Wat gebeurt er als de machine gecompromitteerd is?
Iemand die de volledige controle over de machine overneemt, kan gebruiken wat ze heeft ontvangen: de hosts en SSH-sleutels van haar bereik, binnen haar regels. Destructieve opdrachten vereisen nog steeds je bevestiging. Doe in dat geval het volgende:
- Trek de machine in (Instellingen › CLI-machines): ze wordt binnen 5 seconden afgesloten en de server verwijdert de kopieën van haar machinekluis.
- Wijzig de SSH-sleutels van de hosts die ze kon bereiken.
- Loop haar logboek van opdrachten na.
- Als de twijfel het account betreft, wijzig je je wachtwoord terwijl je de andere apparaten uitlogt: elke CLI-machine wordt ingetrokken.
Om het risico vanaf het begin te beperken: een zo beperkt mogelijk bereik, alleen lezen als dat volstaat, snippets in plaats van vrije opdrachten, geen "Elke opdracht", een korte geldigheidsduur, een speciale en bijgewerkte machine.
Hoe snel werkt een intrekking?
Binnen 5 seconden. Elke lopende opdracht meldt haar aanwezigheid elke 2 seconden bij de server; bij intrekking wordt de volgende melding geweigerd, verbreekt de CLI de SSH-verbindingen, stopt de opdracht, wist zijn geheimen en sluit af met code 77.
Ik ben mijn telefoon kwijt: wat moet ik doen?
Je CLI-machines zijn niet afhankelijk van je telefoon: ze blijven werken. Vanaf een ander apparaat of vanaf app.konsolity.com:
- Trek de telefoon in in de lijst met apparaten.
- Als de telefoon je TOTP-app of je passkey bevatte, gebruik je een herstelcode en registreer je daarna een nieuwe tweede factor onder Beveiliging.
- Trek bij twijfel ook de CLI-machines in (Alles intrekken) en activeer de machines die je nodig hebt opnieuw.
Zonder de tweede factor kan niemand een nieuwe machine goedkeuren of het bereik van een bestaande machine uitbreiden, zelfs niet met je ontgrendelde telefoon.
Waarom een tweede factor om goed te keuren?
Omdat een CLI-machine op je servers kan werken zonder dat er iemand achter zit. De TOTP-code of de passkey wordt gecontroleerd in hetzelfde verzoek als de goedkeuring: een open gelaten browsersessie of een onderschepte activeringscode is niet genoeg. Hij wordt ook gevraagd om een bereik uit te breiden; inperken vraagt niets.
Wat is het verschil met de app?
| Desktop-app | Konsolity CLI | |
|---|---|---|
| Interface | Grafisch | Opdrachtregel |
| Toegang tot de kluis | Hele kluis | Alleen de gekozen hosts en snippets |
| Moet open blijven | Ja | Nee, konsolity serve als service |
| Goedkeuring van een opdracht van Claude | "Eén keer toestaan", of altijd toestaan | Bereik en regels, bevestiging voor destructieve opdrachten |
| Interactieve terminal, bestanden | Ja | Nee |
| Systemen | macOS, Windows, Linux, iOS, Android | Linux, macOS, Windows |
Niet te verwarren met de relay van de terminal op afstand, een interne dienst die versleutelde SSH-bytes tussen je apparaten vervoert.
Welk abonnement is nodig?
Het abonnement Studio, of de gratis proefperiode daarvan. De server controleert het abonnement bij elke aanroep van de machine; de lijst met machines en het intrekken blijven altijd beschikbaar. konsolity serve gebruikt ook de Claude-connector, inbegrepen in Studio.