Teamwire Desktop Registrierung · 2018-11-02 · Teamwire Desktop Registrierung 4 / 15...

Teamwire Desktop Registrierung

Version 1.09 (20.09.2018)

grouptime GmbHTittmoninger Straße 11

81679 MünchenGermany

[email protected]

Teamwire Desktop Registrierung ii

Contents

1 Registrierungsschritte 1

1.1 Akzeptieren der AGBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.2 Telefonnummer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.3 Name und E-Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.4 Erweiterte Konfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.4.1 Fehlermeldung: "Die Registrierung konnte nicht abgeschlossen werden" . . . . . . . . . . . . . . . . . . . 4

1.5 E-Mail bestätigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.6 PIN eingeben . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1.7 Synchronisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2 Erweiterte Konfiguration 8

2.1 Backend Hostname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2 Proxy URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2.1 HTTPS Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2.2 Socks5 Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2.3 Socks4 Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2.4 PAC Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.3 Proxy Konfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.4 Benutzerdefinierte Zertifikate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3 Hintergrundinstallation in Windows 10

3.1 Datenablage in AppData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3.2 Datenablage in benutzerdefiniertem Ordner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4 Automatische Registrierung 12

4.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.2 OS X und Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.3 Pflichtangaben . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.4 Sicherheitshinweis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

A Fehlerberichte 14

A.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

A.2 OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

A.3 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Teamwire Desktop Registrierung iii

In diesem Dokument erhalten Sie Informationen zur Registrierung eines neuen Benutzers in der Teamwire Desktop App. Inden meisten Umgebungen ist der Registrierungsprozess unkompliziert, jedoch gibt es in einigen Organisationen komplexereNetzwerkstrukturen. Dieses Dokument soll Ihnen Antworten auf mögliche Fragen bei einer solchen Installation bieten.

Teamwire Desktop Registrierung 1 / 15

Chapter 1

Registrierungsschritte

1.1 Akzeptieren der AGBs

Bitte lesen und akzeptieren Sie die Nutzungsbedingungen und Datenschutzbestimmungen bevor Sie fortfahren.


1.2 Telefonnummer

Wählen Sie zuerst Ihr Land aus dem Drop-down-Menü und geben Sie Ihre Telefonnummer (ohne Landesvorwahl) ein.

z.B. Landesvorwahl: Deutschland (+49) und Telefonnummer: 017312345678


1.3 Name und E-Mail

Geben Sie Ihren Vor- und Nachnamen sowie Ihre E-Mail-Adresse der Organisation ein. Andere Benutzer werden Sie in Teamwireüber Ihren Vor- und Nachnamen wiederfinden.

Falls Ihr Systemadministrator bereits einen Benutzer mit Ihrer E-Mail-Adresse angelegt hat, werden Vor- und Nachname automa-tisch dem vorgefertigten Profil angepasst.


1.4 Erweiterte Konfiguration

Falls Sie hier eine Änderung vornehmen müssen, erhalten Sie die nötigen Informationen von Ihrem Systemadministrator. Detailszur Erweiterten Konfiguration, wie der Proxy URL oder einem benutzerdefinierten Zertifikat, erhalten Sie in Kapitel 2.

1.4.1 Fehlermeldung: "Die Registrierung konnte nicht abgeschlossen werden"

Unser System benötigt eine eindeutige DNS1-Zuordnung. Manche ISPs2 antworten nicht mit den korrekten DNS-Codes aufdie Serveranfrage. Dies führt zur Rückmeldung "Die Registrierung konnte nicht abgeschlossen werden" während der Reg-istrierung im Client.Bitte kontaktieren Sie Ihren Systemadministrator, wenn Sie diese Meldung erhalten, um zu klären ob Sie einen benutzerdefiniertenBackend Hostnamen für Teamwire in Ihrer Organisation verwenden. Sollte dies nicht der Fall sein, tragen Sie unter Erweitert fol-gende Adresse ein: backend.teamwire.eu

1 DNS: Domain Name System. Ein Dienst, der Domainnamen in IP-Adressen übersetzt.2 ISP: Internet Service Provider, ugs. Internetanbieter


1.5 E-Mail bestätigen

Sofern nicht bereits vom Systemadministrator erstellt, wird der Server Ihren neuen Account nach Eingabe der Informationenanlegen. Um sicherzustellen, dass Ihnen die verwendete E-Mail-Adresse gehört, erhalten Sie eine Nachricht mit Bestätigungslink.Bitte klicken Sie auf diesen Link und fahren Sie mit den nächsten Schritten fort.


1.6 PIN eingeben

Sie erhalten außerdem eine SMS mit einem PIN zur Verifizierung Ihrer Telefonnummer. Bitte tragen Sie den PIN ein und klickenSie dann auf "Weiter".


1.7 Synchronisation

Nachdem Sie E-Mail und Telefonnummer bestätigt haben, wird Teamwire mit dem Login fortfahren und Ihre Kollegen, Gruppenund Nachrichten synchronisieren. Bitte warten Sie bis der Prozess vollständig abgeschlossen ist. Die Chatoberfläche öffnet sichanschließend automatisch.


Chapter 2

Erweiterte Konfiguration

2.1 Backend Hostname

In diesem Feld muss der benutzerdefinierte Backend Hostname eingetragen werden. Bitte geben Sie nur den Hostnamen ohneProtkollart oder Pfad ein. Die Eingabe beschleunigt den Registrierungsprozess und dient zur Fehlervermeidung. Sollte Ihr Un-ternehmen das Teamwire Public Cloud Backend nutzen, tragen Sie bitte backend.teamwire.eu ein.

2.2 Proxy URL

Wenn Ihr Netzwerk über einen Proxy Server konfiguriert wird, tragen Sie bitte die komplette URL1 inkl. Protokollart (bspw.http oder https) und Port ein. Die unterschiedlichen Proxy Typen und deren Aufbau werden weiter unten erklärt. Für dasnachfolgende Beispiel nehmen wir einmal an, der Hostname lautet your-proxy.com und der Port ist 9000. Sollte Ihr ProxyHTTPS oder socks5 Authentifizierungen benötigen, fügen Sie die Benutzerdaten der URL wie im Beispiel bei.

2.2.1 HTTPS Proxy

https://your-proxy.com:9000

https://Benutzername:[email protected]:9000

2.2.2 Socks5 Proxy

socks5://your-proxy.com:9000

socks5://Benutzername:[email protected]:9000

2.2.3 Socks4 Proxy

socks4://your-proxy.com:9000

2.2.4 PAC Proxy

pac+http://file-provider.com/proxy.pac

1 URL: Uniform Resource Locator. Die Adresse einer einzelnen Webseite.


2.3 Proxy Konfiguration

Um die Verbindung von Teamwire mit einem Proxy Server zu gewährleisten, wird ein Proxy mit Unterstützung von HTTP CON-NECT und HTTP Upgrade, sowie der Freigabe aller Sec-Websockets-* Header benötigt.

2.4 Benutzerdefinierte Zertifikate

Sollte Ihr Backend Server ein selbstsigniertes oder ein von einer nicht weit verbreiteten Zertifizierungsstelle signierties Zertifikatverwenden, bitten wir Sie den Pfad zu den verketteten Zertifikaten bereitzustellen. Dieser sollte auf jegliche zugehörigen Zertifikateim PEM2 Format hinweisen.

ImportantBitte achten Sie darauf, den Unix-Zeilenvorschub LF in Ihrem Zertifikat zu verwenden. Alle anderen Steuerzeichen wieCR oder Windows’ CR LF sind nicht gültig.Beachten Sie außerdem, dass der Verzeichnispfad, welcher auf Ihr Zertifikat verweist, keine Leerzeichen enthaltendarf.

2 PEM: Privacy Enhanced Mail (.pem), Dateiformat


Chapter 3

Hintergrundinstallation in Windows

Über die Kommandozeile kann eine Hintergrundinstallation von Teamwire ganz ohne Benutzerinteraktion ausgeführt werden. Bittenutzen Sie hierfür folgenden Befehl:

start "" /WAIT Teamwire-setup.exe /S /D=COMPLETE_PATH

Ersetzen Sie COMPLETE_PATH mit dem gewünschten Zielordner der Installation (z.B. "C:\Program Files\"). Teamwireerzeugt einen eigenen Ordner im genannten Zielpfad.

NoteBitte beachten Sie, dass /D immer als letztes in der Kommandozeile steht und der Pfad ohne Anführungszeichengenannt wird, auch wenn er Leerzeichen enthält.

Für den Befehl funktionieren außerdem nur absolute Pfade, wie z.B.:

start "" /WAIT Teamwire-setup.exe /S /D=C:\Program Files (x86)\Teamwire

Sollte der angegebene Pfad aus COMPLETE_PATH ungültig sein oder nicht existieren, wird dieser ignoriert und Teamwire wirdin den systemspezifischen Standardordner installiert ("C:\Program Files (x86)\Teamwire")

3.1 Datenablage in AppData

Standardmäßig werden die Benutzerdaten in das Verzeichnis der %LOCALAPPDATA% geschrieben. In manchen Umgebungenoder virtuellen Systemen wird dieser Ordner nach einer Sitzung jedoch wieder gelöscht. Um die Daten in das %APPDATA%Verzeichnis zu schreiben, fügen Sie der Installation das Argument /APPDATA=TRUE hinzu.

Bitte beachten Sie, dass /D weiterhin als letztes in der Kommandozeile stehen bleibt. Setzen Sie daher /APPDATA=TRUE vorden Pfad. Beispiel:

start "" /WAIT Teamwire-setup.exe /S /APPDATA=TRUE /D=COMPLETE_PATH

3.2 Datenablage in benutzerdefiniertem Ordner

Sollten Sie aufgrund Ihrer Netzwerkumgebung oder Richtlinien zur Aufbewahrung lokaler Daten die Benutzerdaten auf einemanderen Pfad (bspw. einem automatisch gemappten Home-Verzeichnis je Benutzer) ablegen müssen, können Sie diesen selbstüber den Parameter /USERDATADIR definieren.

start "" /WAIT Teamwire-setup.exe /S /USERDATADIR=USERDATA_PATH /D=COMPLETE_PATH


Der Pfad des Parameter /USERDATADIR muss in Anführungszeichen gesetzt werden. Die Teamwire-Ordner des unter USERDATADIR genannte Verzeichnis werden erst beim Start und der Registrierung von Teamwire erstellt. Trotz der Definition desUSERDATADIR werden die ursprünglichen Verzeichnisse %LOCALAPPDATA%Teamwire\User Data\Default\ erstellt,enthalten jedoch keinerlei Daten.

Bitte beachten Sie, dass /D weiterhin als letztes in der Kommandozeile stehen bleibt. Er darf keine Anführungszeichen enthalten.Beispiel:

start "" /WAIT Teamwire-setup.exe /S /USERDATADIR="H:\TeamwireData\" /D=C:\Program ←↩Files (x86)\Teamwire\


Chapter 4

Automatische Registrierung

Für Organisationen mit einer Großzahl von Benutzern ist die manuelle Registrierung aller User nur schwer durchzuführen undzu verwalten. Für Systemadministratoren gibt es daher die Möglichkeit alle nötigen Daten für eine vollautomatische Benutzer-Registrierung der Teamwire Desktop Applikation mitzuliefern. Unter Windows muss ein entsprechender Eintrag in der Registryerfolgen, in OS X und unter Linux wird eine Konfigurationsdatei im zugehörigen Benutzerordner verwendet.

4.1 Windows

Teamwire holt sich beim ersten Start die Informationen (sofern vorhanden) aus der Registrierungsstruktur des Benutzers unterHKEY_CURRENT_USER\SOFTWARE\Teamwire\UserRegistration.

Eine Vorlage für den Eintrag in der Registry finden Sie unter http://desktop.teamwire.eu/templates/windows.reg. Bitte kommen-tieren Sie nicht benötigte Parameter wie z.B. CustomCAChain oder ProxyURL aus.

4.2 OS X und Linux

Für die automatische Registrierung wird eine JSON Datei im entsprechenden Benutzerordner benötigt:

~/config/teamwire.cfg

Eine Vorlage für das JSON finden Sie unter http://desktop.teamwire.eu/templates/registration.json. Bitte löschen Sie nicht benötigteParameter wie z.B. CustomCAChain oder ProxyURL aus der Datei.

4.3 Pflichtangaben

Die folgenden Parameter sind für die vollautomatische Registrierung zwingend notwendig:FirstName, LastName, Email, RegistrationToken

4.4 Sicherheitshinweis

Der Registrierungstoken (RegistrationToken) ist eine höchst sensible Information und vor dem Zugriff Unbefugter zuschützen. Wir empfehlen daher den Übertragungskanal des Tokens auf die Verzeichnisse der jeweiligen Benutzer so sicherwie möglich zu gestalten. Die übermittelten Daten sollten dort mit möglichst restriktiven Berechtigungsleveln abgelegt werden.

Verwenden Sie nicht das allgemeine Registrierungstoken Ihrer Organisation für Desktop Benutzer, da die Informationen der Win-dows Registry und aus den Konfigurationsdateien in OS X und unter Linux von Benutzern eingesehen werden können. Der all-gemeinen Registrierungstoken ermöglicht den Benutzern sich theoretisch mit jeglichem Teamwire Benutzeraccount anzumelden

http://desktop.teamwire.eu/templates/windows.reg

http://desktop.teamwire.eu/templates/registration.json


und kann daher zu Datenmissbrauch führen.Verwenden Sie stattdessen das Token zur einmaligen Registrierung. Dieses funktioniert parallel zum Organisationstoken. Detail-lierte Informationen zum Einmal-Token finden Sie in unserer Teamwire Administrations Portal Dokumentation unter Bulk Opera-tions.


Appendix A

Fehlerberichte

Natürlich hoffen wir, dass Sie Teamwire ohne größere Störungen verwenden können. Sollte es jedoch einmal zu Problemenkommen, hoffen wir auf Ihr Feedback. Denn nur so können wir unser Produkt noch besser machen.

Wenn ein Fehler auftritt, zeigt Teamwire für gewöhnlich genug technische Daten an, die uns bei der Problembehebung mit In-formationen versorgen. Sie können uns zudem mit weiteren Daten aus den Fehlerberichten helfen. Hierfür werden folgendeProtokolle erstellt: Registrierungsprobleme und Kritische Fehler.

Plattformabhängig sind diese Dokumente in unterschiedlichen Verzeichnissen wiederzufinden.

A.1 Windows

Unter Windows finden Sie die Logdateien entweder unter

%LOCALAPPDATA%\Teamwire\User Data\Default\

oder unter

%LOCALAPPDATA%\Teamwire\Default\

Um diesen Ordner bei sich auf dem Computer wiederzufinden, geben Sie %LOCALAPPDATA% in Ihr Suchfeld unter Start oder indie Adresszeile Ihres Windows Explorer ein. Den Ordner %LOCALAPPDATA% finden Sie normalerweise auch unter C:\Users\USERNAME\AppData\Local. Öffnen Sie dann den Ordner "Teamwire", "User Data" (sofern vorhanden) und schließlich"Default".

Die Dateinamen lauten registration_failure.txt und log.txt.

Bei der Installation mit dem Parameter /APPDATA=TRUE befinden sich die Daten nicht in %LOCALAPPDATA% sondern %APPDATA%. Gehen Sie hier wie oben beschrieben mit dem geänderten Wert vor. Den Ordner %APPDATA% finden Sie normalerweiseauch unter C:\Users\USERNAME\AppData\Roaming.

A.2 OS X

Die Logdateien werden unter folgenden Pfaden abgelegt:

~/Library/Application Support/Teamwire/Default/registration_failure.txt

~/Library/Application Support/Teamwire/Default/log.txt


A.3 Linux

Die Logdateien werden unter folgenden Pfaden abgelegt:

~/.config/Teamwire/Default/registration_failure.txt

~/.config/Teamwire/Default/log.txt

Date post:	28-Mar-2020
Category:	Documents
Upload:	others
View:	7 times
Download:	0 times

Teamwire Desktop Registrierung · 2018-11-02 · Teamwire Desktop Registrierung 4 / 15...

Documents