Teamwire Desktop Registrierung · 2018-11-02 · Teamwire Desktop Registrierung 4 / 15...
Transcript of 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
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.
Teamwire Desktop Registrierung 2 / 15
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
Teamwire Desktop Registrierung 3 / 15
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.
Teamwire Desktop Registrierung 4 / 15
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
Teamwire Desktop Registrierung 5 / 15
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.
Teamwire Desktop Registrierung 6 / 15
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".
Teamwire Desktop Registrierung 7 / 15
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.
Teamwire Desktop Registrierung 8 / 15
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.
Teamwire Desktop Registrierung 9 / 15
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
Teamwire Desktop Registrierung 10 / 15
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
Teamwire Desktop Registrierung 11 / 15
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\
Teamwire Desktop Registrierung 12 / 15
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
Teamwire Desktop Registrierung 13 / 15
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.
Teamwire Desktop Registrierung 14 / 15
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
Teamwire Desktop Registrierung 15 / 15
A.3 Linux
Die Logdateien werden unter folgenden Pfaden abgelegt:
~/.config/Teamwire/Default/registration_failure.txt
~/.config/Teamwire/Default/log.txt