Live-Ansicht von deinem Runner | kanman Dokumentation

Im Chat eines Teams kannst du eine Ebene tiefer in jeden Agenten gehen: Wähle ihn in n aktive Agenten über dem Eingabefeld, im Tab Agenten oder in der Story, an der er arbeitet. Der Chat zeigt dann die Sitzung dieses Agenten: was er denkt, welche Befehle er ausführt und was sie ausgeben, welche Dateien er ändert, seine Pushes und Ergebnisse, live. Das Eingabefeld schreibt an diesen Agenten, und Stoppen und Übernehmen stehen oben in der Sitzung.

Für Teams auf kanman Cloud zeigt die Sitzung die Schritte und das Log des Agenten über kanman. Für Teams auf euren eigenen Runnern kann das vollständige Transkript direkt vom Runner in deinen Browser kommen. Das ist die Live-Ansicht von deinem Runner, und diese Seite ist für alle, die entscheiden, ob ihr sie erlaubt.

Kurz gesagt

Standardmäßig aus. Ein Team-Admin schaltet sie pro Team unter Team > Agent > Live-Ansicht von deinem Runner ein. Jede Änderung steht im Audit-Log.
Nichts wird aus dem Internet geöffnet. Runner und Browser bauen nur ausgehende Verbindungen auf. Es gibt keine Portweiterleitung, keinen öffentlichen Endpunkt und kein Relay.
Der Stream läuft nie über kanman. kanman reicht nur die Verbindungsangebote beider Seiten weiter und signiert, wer zusehen darf. Code, Befehlsausgaben und Diffs gehen verschlüsselt direkt vom Runner zum Browser.
Nur Browser, die das Netz des Runners erreichen, verbinden sich (euer VPN oder Büronetz). Alle anderen sehen „Live-Details siehst du im Firmennetz“ und die verdichtete Zeitleiste.
Nur zum Ansehen. Der Runner nimmt über die Verbindung nichts an außer dem signierten Ticket des Zuschauers und einem Schließen. Er führt nie etwas aus, was ein Zuschauer sendet, und leitet es nicht weiter.
Jede Zuschauer-Sitzung ist eine Zeile im Log des Teams: wer welchem Agenten wie lange zugesehen hat.

So verbindet sich ein Zuschauer

Jemand öffnet in der App die Sitzung eines Agenten. Der Browser bereitet ein WebRTC-Verbindungsangebot vor (nur ein Datenkanal, keine Kamera und kein Mikrofon), ohne einen öffentlichen Server.
Der Browser schickt das Angebot an kanman. kanman prüft, dass die Person Mitglied des Teams ist, dass das Team die Live-Ansicht eingeschaltet hat, auf eigenen Runnern läuft und gerade eine Runde läuft.
kanman signiert ein Ticket für genau diesen Zuschauer: die Person, das Team, den Agenten, den Verschlüsselungs-Fingerabdruck des Browsers und einen Ablauf nach zwei Minuten. Die Signatur nutzt einen Schlüssel, dessen öffentliche Hälfte dein Runner bei der Registrierung bekommt.
Der Runner, der für seine Arbeit ohnehin eine ausgehende Verbindung zu kanman hält, holt das Angebot ab. Er prüft die Signatur des Tickets, den Ablauf, das Team und dass der Fingerabdruck im Angebot der aus dem Ticket ist. Stimmt etwas nicht, lehnt er ab, und nichts hört zu.
Der Runner antwortet nur mit seinen lokalen Netzadressen. kanman reicht die Antwort an den Browser zurück.
Browser und Runner verbinden sich direkt. Die Verbindung ist Ende zu Ende mit DTLS verschlüsselt; der Runner prüft, dass das Zertifikat des Browsers den Fingerabdruck aus dem Ticket hat, und der Browser schickt das Ticket über die Verbindung noch einmal.
Der Runner streamt die Ereignisse genau dieses Agenten. Die App zeigt Direkt von deinem Runner, solange die Verbindung steht.

Was dein Security-Team wissen muss


Protokoll	WebRTC-Datenkanal: ICE, DTLS 1.2 oder neuer, SCTP. Kein Audio, kein Video.
Ports am Runner	UDP 50000 bis 50100 auf dem Runner-Host, nur für Verbindungen aus eurem eigenen Netz. Nichts wird ins Internet geöffnet; an eurer Perimeter-Firewall ist keine eingehende Regel nötig. Hat der Runner-Host eine eigene Firewall, erlaube diesen UDP-Bereich aus euren VPN- und Büro-Adressbereichen.
Angebotene Adressen	Nur die lokalen Schnittstellenadressen des Runners (Host-Kandidaten). Mit Über Netzgrenzen hinweg verbinden fragen Runner und Browser zusätzlich einen öffentlichen STUN-Server (`stun.l.google.com:19302`) nach ihrer Außenadresse; auch dann gibt es nie ein Relay (TURN).
Was über kanman läuft	Die beiden Verbindungsangebote (Sitzungsbeschreibungen mit den lokalen Adressen des Runners und den Fingerabdrücken), das signierte Ticket, und wann die Sitzung endete, mit Dauer und Größe. Nie der Stream.
Was der Stream enthält	Das Transkript eines Agenten: seinen Text und seine Überlegungen, Werkzeugaufrufe, Befehle und ihre Ausgabe, Dateiänderungen, Testergebnisse. Bekannte Tokens der Runde werden vor dem Senden entfernt.
Wer zusehen darf	Mitglieder des Teams, ein signiertes Ticket pro Zuschauer und Agent, zwei Minuten gültig für den Verbindungsaufbau. Eine Sitzung endet spätestens nach zwei Stunden; der Browser verbindet sich bei Bedarf neu.
Grenzen	Höchstens 8 Zuschauer pro Runde, höchstens 256 KB/s pro Zuschauer.
Audit	Das Ein- und Ausschalten ist eine Richtlinienänderung im Audit-Log. Jede Zuschauer-Sitzung ergibt eine Zeile im Log des Teams: wer welchem Agenten wie lange zugesehen hat.
Schlüssel	kanmans Ticket-Schlüssel wird aus seinem Deployment-Geheimnis abgeleitet; dein Runner bekommt bei der Registrierung nur die öffentliche Hälfte.

Ein- und ausschalten

Öffne dein Team und geh zu Team > Agent.
Such die Karte Live-Ansicht von deinem Runner.
Schalte Live-Ansicht von deinem Runner ein. Schalte optional Über Netzgrenzen hinweg verbinden ein, wenn auch Leute außerhalb eures Netzes eine direkte Verbindung versuchen dürfen.

Nur Team-Admins können diese Schalter ändern. Zum Abschalten schaltest du die Live-Ansicht in derselben Karte aus: kanman reicht ab sofort keine Angebote mehr weiter, und der Runner bedient in keiner späteren Runde einen Zuschauer. Dein Runner arbeitet weiter wie bisher; nur der direkte Stream fällt weg.

Wenn der Runner nicht erreichbar ist

Ist dein Browser nicht im Netz des Runners, öffnet sich die direkte Verbindung nicht. Die Sitzung sagt dann Live-Details siehst du im Firmennetz und zeigt weiter die verdichtete Zeitleiste: die Schritte des Agenten, Starts, Ergebnisse, Merge Requests und Reviews. Nachrichten, Stoppen und Übernehmen funktionieren überall, weil sie über kanman laufen, nicht über den Stream.