Teamarbeit (gemeinsame Verbindungen)¶

Teilen Sie SSH-Verbindungen mit Ihrem Team, indem Sie sie aus einem Git-Repository oder einer freigegebenen Datei synchronisieren. Teamwork-Quellen werden zusammen mit Ihren lokalen Verbindungen in den Connection Manager geladen, automatisch synchronisiert und sicher von Inline-Passwörtern befreit, sodass Anmeldeinformationen nur aus Ihrem lokalen verschlüsselten Speicher stammen.

Übersicht¶

Teamwork ermöglicht es Teams, eine zentrale Bibliothek von Verbindungskonfigurationen zu verwalten:

• Git-Repositorys – Klonen Sie ein Git-Repository, das eine kortty-teamwork-connections.xml-Datei (oder eine ältere Datei connections.xml) enthält, und bleiben Sie mit diesem synchron.
• Shared files — Load connections from a local or network path (read-only or read-write).
• Automatic sync — Background syncing at a configurable interval checks for updates.
• Credential security — Shared connections do NOT carry inline passwords; only credential IDs and SSH key references.
• Local overrides — Your local credentials and SSH keys are merged with shared connection definitions.
• Read-only mode — Mark sources as read-only to prevent accidental writes back.

Einrichten von Teamwork-Quellen¶

Open Teamwork → Teamwork Settings… (or Configuration → Global Settings… → Teamwork) to configure sources.

Fügen Sie eine Quelle hinzu¶

1. Klicken Sie auf Hinzufügen, um eine neue Quelle zu erstellen.
2. Wählen Sie die Quelle Typ:
3. Git — Clone from an HTTPS, SSH, or git:// URL.
4. Shared File — Read from a local or network path (e.g., file:///mnt/share/connections.xml or //host/share/connections.xml).
5. Geben Sie den Standort ein:
6. Für Git: die Klon-URL.
7. Für freigegebene Dateien: ein lokaler/Netzwerk-Dateipfad (kann ein file://-URI oder ein UNC-Pfad sein).
8. Legen Sie das Prüfintervall fest (1–1440 Minuten; Standard: 15).
9. Aktivieren Sie optional Schreibgeschützt, um Rückschreibvorgänge zu verhindern (nur Git-Quellen).
10. Klicken Sie zum Speichern auf OK.

Quellen verwalten¶

Im Dialogfeld „Teamwork-Einstellungen“ werden alle Quellen mit Typ, Standort und Synchronisierungsintervall aufgelistet:

Verwenden Sie die Schaltflächen, um: - Hinzufügen – Erstellen Sie eine neue Quelle. - Bearbeiten – Ändern Sie die ausgewählte Quelle. - Entfernen – Die ausgewählte Quelle löschen. - Aktivieren/Deaktivieren – Schaltet den aktivierten Status für die ausgewählten Quellen um.

Legen Sie unten das Standardprüfintervall fest (gilt für neue Quellen, die keins angeben).

So funktioniert die Synchronisierung¶

Hintergrundsynchronisierung¶

Sobald Sie die Teamwork-Einstellungen gespeichert haben:

1. KorTTY startet einen Hintergrundsynchronisierungsthread.
2. Alle N Minuten (basierend auf dem Mindestintervall zwischen aktivierten Quellen) geschieht Folgendes:
3. Zieht/klont jede Quelle (Git) oder liest die Datei (Shared File).
4. Lädt die XML-Verbindungen.
5. Führt die Ergebnisse im Cache und im Verbindungsmanager zusammen.
6. Wenn eine Quellaktualisierung fehlschlägt, wird die vorherige zwischengespeicherte Version beibehalten.

Manuelle Synchronisierung¶

Verwenden Sie Teamwork → Teamwork-Einstellungen… und klicken Sie auf OK, um sofort eine Synchronisierung auszulösen.

Konflikterkennung¶

Bei jeder Synchronisierung wird ein Versionstoken aufgezeichnet: - Git – Der aktuelle Commit-Hash. - Freigegebene Datei – Der zuletzt geänderte Zeitstempel der Datei.

Wenn sich das Versionstoken einer gemeinsam genutzten Verbindung zwischen Synchronisierungen ändert, wurde eine neue Version abgerufen. Wenn Sie lokale Änderungen an einer Teamwork-Verbindung vorgenommen haben und die Quelle mit einer widersprüchlichen Änderung aktualisiert wird, bleiben die lokalen Änderungen erhalten (kein automatisches Überschreiben).

Gemeinsam genutztes Verbindungsdateiformat¶

Erstellen Sie eine kortty-teamwork-connections.xml-Datei (oder connections.xml für Abwärtskompatibilität) im Stammverzeichnis Ihres Git-Repositorys oder Ihrer freigegebenen Datei:

<?xml version="1.0" encoding="UTF-8"?>
<connections>
  <connection id="prod-web-1">
    <name>Prod Web Server 1</name>
    <host>web1.example.com</host>
    <port>22</port>
    <username>deploy</username>
    <group>Production/Web</group>
    <authMethod>SSH_KEY</authMethod>
    <sshKeyId>key-prod-deploy</sshKeyId>
    <credentialId>cred-prod-user</credentialId>
  </connection>
</connections>

Wenn in der freigegebenen Datei Inline-Geheimnisse gefunden werden, entfernt KorTTY diese automatisch (sie werden nicht geladen).

Teamwork-Verbindungen nutzen¶

Sobald eine Quelle synchronisiert ist:

1. Öffnen Sie Verbindungen verwalten… (oder drücken Sie Ctrl+M).
2. Teamwork-Verbindungen werden in der Baumstruktur mit der Bezeichnung [Teamwork] und ihrer Quell-ID angezeigt.
3. Klicken Sie auf eine Teamwork-Verbindung, um sie anzuzeigen oder zu verwenden.
4. Kann nicht direkt bearbeitet werden – Teamwork-Verbindungen sind schreibgeschützt, es sei denn, ihre Quelle ist als beschreibbar markiert und Sie besitzen Bearbeitungsrechte (bestimmt durch teamworkRole).

Lokale Überschreibungen¶

• Die zusammengeführten Anmeldeinformationen und SSH-Schlüsselreferenzen werden aus Ihrem lokalen Speicher aufgelöst.
• Wenn lokal keine Anmeldeinformationen oder Schlüssel gefunden werden, werden Sie beim Herstellen der Verbindung aufgefordert, diese anzugeben.
• Ihre lokale Kopie einer Teamwork-Verbindung kann die Authentifizierung außer Kraft setzen, indem sie andere Anmeldeinformationen oder Schlüssel zuweist.

Quellen unterscheiden¶

Im Connection Manager werden Teamwork-Verbindungen anhand ihrer Quell-ID gekennzeichnet. Bewegen Sie den Mauszeiger über die Verbindungseigenschaften oder überprüfen Sie sie, um zu sehen, von welcher Teamwork-Quelle sie stammt.

Git-Repository-Setup¶

So teilen Sie Verbindungen über Git:

1. Erstellen Sie ein Repository (z. B. ssh-connections).
2. Fügen Sie eine kortty-teamwork-connections.xml-Datei mit Ihren Verbindungsdefinitionen zum Stammverzeichnis hinzu.
3. Commit und Push.
4. Teilen Sie die Repository-URL (HTTPS oder SSH) mit den Teammitgliedern.
5. Teammitglieder fügen die URL unter Teamwork → Teamwork-Einstellungen… → Hinzufügen hinzu.

SSH vs. HTTPS¶

• HTTPS – Funktioniert ohne SSH-Schlüsseleinrichtung; Möglicherweise ist ein GitHub Personal Access Token oder ein Benutzername/Passwort erforderlich (bewahren Sie das Token sicher auf).
• SSH – Erfordert git und einen lokalen SSH-Schlüssel in ~/.ssh/id_rsa (oder konfiguriert in ssh-add).

Beispiel-Repository-Layout¶

ssh-connections/
├── kortty-teamwork-connections.xml
├── .gitignore
└── README.md

Optional: Versionen in Git speichern¶

Verwenden Sie den Commit-Hash als Versionstoken, damit KorTTY Updates erkennen kann:

git log -1 --pretty=%H

Einrichtung einer freigegebenen Datei¶

So teilen Sie Verbindungen über eine Datei:

1. Exportieren Sie Ihre Verbindungen in eine Datei: Verbindungen → Exportieren… → Verbindungen auswählen → Speichern als .xml.
2. Platzieren Sie die Datei auf einem freigegebenen Netzwerkpfad (z. B. //server/share/connections.xml).
3. Legen Sie die Lese-/Schreibberechtigungen nach Bedarf fest.
4. Teammitglieder fügen den Dateipfad unter Teamwork → Teamwork-Einstellungen… → Hinzufügen hinzu.

Beispielpfade¶

Sicherheitsüberlegungen¶

Fehlerbehebung¶

Quelle wird nicht synchronisiert¶

1. Öffnen Sie Teamwork → Teamwork-Einstellungen….
2. Stellen Sie sicher, dass die Quelle Aktiviert ist.
3. Überprüfen Sie, ob der Standort korrekt und zugänglich ist:
4. Git – Führen Sie git clone <url> zum Testen manuell aus.
5. Freigegebene Datei – Stellen Sie sicher, dass die Datei vorhanden und auf Ihrem Computer lesbar ist.
6. Klicken Sie auf OK, um eine manuelle Synchronisierung auszulösen.
7. Überprüfen Sie das Anwendungsprotokoll (~/.kortty/kortty.log) auf Fehler.

Verbindungen werden angezeigt, aber Anmeldeinformationen fehlen¶

1. Öffnen Sie Sicherheit → Anmeldeinformationen… und Sicherheit → SSH-Schlüssel….
2. Stellen Sie sicher, dass die Anmeldeinformations-IDs oder SSH-Schlüssel-IDs in den gemeinsam genutzten Verbindungen lokal vorhanden sind.
3. Wenn sie fehlen, fügen Sie sie manuell hinzu oder bitten Sie Ihren Teamadministrator, die IDs bereitzustellen.

Änderungen können nicht an das Git-Repository übertragen werden¶

1. Stellen Sie sicher, dass die Git-URL SSH oder ein HTTPS-Token verwendet (nicht Benutzername/Passwort).
2. Stellen Sie sicher, dass Ihr SSH-Schlüssel bei der Fernbedienung registriert ist (GitHub, GitLab usw.).
3. Markieren Sie in den Teamwork-Einstellungen die Quelle als Schreibgeschützt, wenn Sie nicht zurückschreiben müssen.

Dateipfad wird nicht erkannt (Windows/UNC)¶

Verwenden Sie Schrägstriche oder das URI-Format „file://“:

• //server/share/connections.xml ✓
• \\server\share\connections.xml ✗ (Backslashes werden möglicherweise nicht richtig analysiert)
• file:////server/share/connections.xml ✓ (UNC-Notation)