2. Automatische Registrierung

Zuletzt geändert von teamwire003 am 2024/08/13 12:51

Für Organisationen mit einer Großzahl von Benutzern ist die manuelle Registrierung aller User nur schwer durchzuführen und zu 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 Registry erfolgen, in macOS und unter Linux wird eine Konfigurationsdatei im zugehörigen Benutzerordner verwendet.

Windows

Teamwire holt sich beim ersten Start die Informationen (sofern vorhanden) aus der Registrierungsstruktur des Benutzers unter

Desktop 4.0.10 oder neuer

Hinweis: Um sicherzustellen, dass alle in der Vorlage verfügbaren Optionen unterstützt werden, aktualisieren Sie die Desktop App bitte immer auf die neuste Version. 

HKEY_CURRENT_USER\SOFTWARE\teamwire\

Eine Vorlage für den Eintrag in der Registry mit allen konfigurierbaren Optionen finden Sie unter
https://desktop.teamwire.eu/templates/teamwire-windows.reg

Bitte kommentieren Sie nicht benötigte Parameter wie z.B.  proxyUrl  aus.

Bis Desktop 3.4.3

HKEY_CURRENT_USER\Software\Teamwire\UserRegistration\

Eine Vorlage für den Eintrag in der Registry mit allen konfigurierbaren Optionen finden Sie unter

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

Bitte kommentieren Sie nicht benötigte Parameter wie z.B.  ProxyURL  aus.

macOS und Linux

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

Desktop 4.0.10 oder neuer

Hinweis: Um sicherzustellen, dass alle in der Vorlage verfügbaren Optionen unterstützt werden, aktualisieren Sie die Desktop App bitte immer auf die neuste Version. 

~/.config/teamwire/teamwire.cfg

Eine Vorlage für das JSON mit allen konfigurierbaren Optionen finden Sie unter
https://desktop.teamwire.eu/templates/teamwire.cfg

Bitte löschen Sie nicht benötigte Parameter wie z.B.  proxyUrl  aus der Datei.

Bis Desktop 3.4.3

~/.config/teamwire.cfg

Eine Vorlage für das JSON mit allen konfigurierbaren Optionen finden Sie unter

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

Bitte löschen Sie nicht benötigte Parameter wie z.B.  ProxyURL  aus der Datei.

Pflichtangaben

Die folgenden Parameter sind für die vollautomatische Registrierung zwingend notwendig:

  • firstName
  • lastName
  • email
  • registrationToken

 

Sicherheitshinweis

Der Registrierungstoken ist eine höchst sensible Information und vor dem Zugriff Unbefugter zu schützen. Wir empfehlen daher den Übertragungskanal des Tokens auf die Verzeichnisse der jeweiligen Benutzer so sicher wie 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 Windows Registry und aus den Konfigurationsdateien in macOS und unter Linux von Benutzern eingesehen werden können. Der allgemeine Registrierungstoken ermöglicht den Benutzern sich theoretisch mit jeglichem Teamwire Benutzeraccount anzumelden und kann daher zu Datenmissbrauch führen. Verwenden Sie stattdessen das Token zur einmaligen Registrierung. Dieses funktioniert parallel zum Organisationstoken. Detaillierte Informationen zum Einmal-Token finden Sie unter Dashboard im Bereich Benutzer > Benutzerbearbeitung.