Zum Inhalt springen

Wiki-Quellcode von 2. Automated Sign-in

Zuletzt geändert von teamwire001 am 2025/09/11 14:57
Zeige letzte Bearbeiter
1 Für Organisationen mit einer Großzahl von Benutzern ist die manuelle Anmeldung aller Benutzer nur schwer durchzuführen und zu verwalten. Für Systemadministratoren gibt es daher die Möglichkeit alle nötigen Daten für eine vollautomatische Benutzeranmeldung 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.
2
3
4 {{id name="windows"/}}
5
6 = Windows =
7
8 Um die automatische Anmeldung unter Windows einzurichten, stellen Sie die [[Erforderlichen Parameter>>doc:||anchor="mandatory"]] per Registry-Eintrag bereit:
9
10 {{tabs idsToLabels="registry1=Desktop 4, registry2=Bis Desktop 3.4.3"/}}
11
12 (% id="registry1" %)
13 (((
14 {{info}}
15 Um sicherzustellen, dass alle in der Vorlage verfügbaren Optionen unterstützt werden, aktualisieren Sie die Desktop App bitte immer auf die neuste Version.
16 {{/info}}
17
18 Registrypfad: ##HKEY_CURRENT_USER\SOFTWARE\teamwire\##
19
20 Eine Vorlage für den Eintrag in der Registry mit allen konfigurierbaren Optionen finden Sie unter
21 [[url:https://desktop.teamwire.eu/templates/teamwire-windows.reg||rel="noopener noreferrer" target="_blank"]]
22
23 Bitte kommentieren Sie nicht benötigte Parameter wie z.B. ##proxyUrl## aus.
24 )))
25
26 (% id="registry2" %)
27 (((
28 Registrypfad: ##HKEY_CURRENT_USER\Software\Teamwire\UserRegistration\##
29
30 Eine Vorlage für den Eintrag in der Registry mit allen konfigurierbaren Optionen finden Sie unter
31
32 [[url:http://desktop.teamwire.eu/templates/windows.reg||rel="noopener noreferrer" target="_blank"]]
33
34 Bitte kommentieren Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus.
35 )))
36
37 (% style="border-color:var(--gili_blue_300)" %)
38 ----
39
40
41 {{id name="macosandlinux"/}}
42
43 = macOS und Linux =
44
45 Um die automatische Anmeldung unter macOS oder Linux einzurichten, stellen Sie die [[Erforderlichen Parameter>>doc:||anchor="mandatory"]] über einer JSON Datei im Benutzerordner bereit:
46
47 {{tabs idsToLabels="config1=Desktop 4, config2=Bis Desktop 3.4.3"/}}
48
49 (% id="config1" %)
50 (((
51 {{info}}
52 Um sicherzustellen, dass alle in der Vorlage verfügbaren Optionen unterstützt werden, aktualisieren Sie die Desktop App bitte immer auf die neuste Version.
53 {{/info}}
54
55 Dateipfad: ##~~/.config/teamwire/teamwire.cfg##
56
57 Eine Vorlage für das JSON mit allen konfigurierbaren Optionen finden Sie unter
58 [[url:https://desktop.teamwire.eu/templates/teamwire.cfg||rel="noopener noreferrer" target="_blank"]]
59
60 Bitte löschen Sie nicht benötigte Parameter wie z.B. ##proxyUrl## aus der Datei.
61 )))
62
63 (% id="config2" %)
64 (((
65 Dateipfad: ##~~/.config/teamwire.cfg##
66
67 Eine Vorlage für das JSON mit allen konfigurierbaren Optionen finden Sie unter
68
69 [[url:http://desktop.teamwire.eu/templates/registration.json||rel="noopener noreferrer" target="_blank"]]
70
71 Bitte löschen Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus der Datei.
72 )))
73
74 (% style="border-color:var(--gili_blue_300)" %)
75 ----
76
77
78 {{id name="mandatory"/}}
79
80 = Erforderliche Parameter =
81
82 Die folgenden Parameter sind für die automatische Anmeldung zwingend notwendig:
83
84 {{tabs idsToLabels="parameter1=Desktop 4, parameter2=Bis Desktop 3.4.3"/}}
85
86 (% id="parameter1" %)
87 (((
88 * ##firstName##: Benutzer Vorname
89 * ##lastName##: Benutzer Nachname
90 * ##email##: Benutzer E-Mail-Adresse
91 * ##registrationToken##: Einmal-Token aus dem Dashboard
92 * ##serverHost##: Teamwire Server Name wie unter [[Erweiterte Konfiguration>>doc:Public.Applications.Desktop.Advanced-Configurations.WebHome||anchor="4-hostname"]] beschrieben (optional aber empfohlen)
93 )))
94
95 (% id="parameter2" %)
96 (((
97 * ##FirstName##: Benutzer Vorname
98 * ##LastName##: Benutzer Nachname
99 * ##Email##: Benutzer E-Mail-Adresse
100 * ##RegistrationToken##: Einmal-Token aus dem Dashboard
101 * ##BackendServerName##: Teamwire Server Name wie unter [[Erweiterte Konfiguration>>doc:Public.Applications.Desktop.Advanced-Configurations.WebHome||anchor="4-hostname"]] beschrieben (optional aber empfohlen)
102 )))
103
104 (% style="border-color:var(--gili_blue_300)" %)
105 ----
106
107
108 {{id name="securityadvice"/}}
109
110 = Sicherheitshinweis =
111
112 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.
113
114 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 Anmeldung. Dieses funktioniert parallel zum Organisationstoken. Detaillierte Informationen zum Einmal-Token finden Sie im [[Dashboard Handbuch>>doc:Customer.Administration.Dashboard-User-Manual.WebHome]] im Abschnitt [[Sammelbearbeitung für Benutzer>>doc:Customer.Administration.Dashboard-User-Manual.Users.WebHome||anchor="users-useroperations"]].
115
116 ## ##