Zum Inhalt springen

Änderungen von Dokument 2. Automated Sign-in

Zuletzt geändert von teamwire001 am 2025/10/28 13:49
Von Version 3.4
bearbeitet von teamwire003
am 2024/08/13 12:51
Änderungskommentar: 3.4.2 changed to 3.4.3
Auf Version 4.1
bearbeitet von teamwire001
am 2025/08/19 08:13
Änderungskommentar: DOC-434

Zusammenfassung

Details

Seiteneigenschaften
Titel
... ... @@ -1,1 +1,1 @@
1 -2. Automatische Registrierung
1 +2. Automatische Anmeldung
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.teamwire003
1 +XWiki.teamwire001
Inhalt
... ... @@ -1,85 +1,107 @@
1 -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.
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 2  
3 3  
4 +{{id name="windows"/}}
5 +
4 4  = Windows =
5 5  
6 -Teamwire holt sich beim ersten Start die Informationen (sofern vorhanden) aus der Registrierungsstruktur des Benutzers unter
8 +Um die automatische Anmeldung unter Windows einzurichten, stellen Sie die [[Erforderlichen Parameter>>doc:||anchor="mandatory"]] per Registry-Eintrag bereit:
7 7  
8 -|(((
9 -**Desktop 4.0.10 oder neuer**
10 +{{tabs idsToLabels="registry1=Desktop 4, registry2=Bis Desktop 3.4.3"/}}
10 10  
11 -(% class="box infomessage" %)
12 +(% id="registry1" %)
12 12  (((
13 -**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.
14 -)))
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}}
15 15  
16 -##HKEY_CURRENT_USER\SOFTWARE\teamwire\##
18 +Registrypfad: ##HKEY_CURRENT_USER\SOFTWARE\teamwire\##
17 17  
18 18  Eine Vorlage für den Eintrag in der Registry mit allen konfigurierbaren Optionen finden Sie unter
19 -[[https:~~/~~/desktop.teamwire.eu/templates/teamwire-windows.reg>>https://desktop.teamwire.eu/templates/teamwire-windows.reg]]
21 +[[url:https://desktop.teamwire.eu/templates/teamwire-windows.reg||rel="noopener noreferrer" target="_blank"]]
20 20  
21 -Bitte kommentieren Sie nicht benötigte Parameter wie z.B.  ##proxyUrl##  aus.
23 +Bitte kommentieren Sie nicht benötigte Parameter wie z.B. ##proxyUrl## aus.
22 22  )))
23 -|(((
24 -**Bis Desktop 3.4.3**
25 25  
26 -##HKEY_CURRENT_USER\Software\Teamwire\UserRegistration\##
26 +(% id="registry2" %)
27 +(((
28 +Registrypfad: ##HKEY_CURRENT_USER\Software\Teamwire\UserRegistration\##
27 27  
28 28  Eine Vorlage für den Eintrag in der Registry mit allen konfigurierbaren Optionen finden Sie unter
29 29  
30 -[[http://desktop.teamwire.eu/templates/windows.reg||rel="noopener noreferrer" target="_blank"]]
32 +[[url:http://desktop.teamwire.eu/templates/windows.reg||rel="noopener noreferrer" target="_blank"]]
31 31  
32 -Bitte kommentieren Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus.
34 +Bitte kommentieren Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus.
33 33  )))
34 34  
37 +
38 +{{id name="macosandlinux"/}}
39 +
35 35  = macOS und Linux =
36 36  
37 -Für die automatische Registrierung wird eine JSON Datei im entsprechenden Benutzerordner benötigt:
42 +Um die automatische Anmeldung unter macOS oder Linux einzurichten, stellen Sie die [[Erforderlichen Parameter>>doc:||anchor="mandatory"]] über einer JSON Datei im Benutzerordner bereit:
38 38  
39 -|(((
40 -**Desktop 4.0.10 oder neuer**
44 +{{tabs idsToLabels="config1=Desktop 4, config2=Bis Desktop 3.4.3"/}}
41 41  
42 -(% class="box infomessage" %)
46 +(% id="config1" %)
43 43  (((
44 -**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.
45 -)))
48 +{{info}}
49 +Um sicherzustellen, dass alle in der Vorlage verfügbaren Optionen unterstützt werden, aktualisieren Sie die Desktop App bitte immer auf die neuste Version.
50 +{{/info}}
46 46  
47 -##~~/.config/teamwire/teamwire.cfg##
52 +Dateipfad: ##~~/.config/teamwire/teamwire.cfg##
48 48  
49 49  Eine Vorlage für das JSON mit allen konfigurierbaren Optionen finden Sie unter
50 -[[https:~~/~~/desktop.teamwire.eu/templates/teamwire.cfg>>https://desktop.teamwire.eu/templates/teamwire.cfg]]
55 +[[url:https://desktop.teamwire.eu/templates/teamwire.cfg||rel="noopener noreferrer" target="_blank"]]
51 51  
52 -Bitte löschen Sie nicht benötigte Parameter wie z.B.  ##proxyUrl##  aus der Datei.
57 +Bitte löschen Sie nicht benötigte Parameter wie z.B. ##proxyUrl## aus der Datei.
53 53  )))
54 -|(((
55 -**Bis Desktop 3.4.3**
56 56  
57 -##~~/.config/teamwire.cfg##
60 +(% id="config2" %)
61 +(((
62 +Dateipfad: ##~~/.config/teamwire.cfg##
58 58  
59 59  Eine Vorlage für das JSON mit allen konfigurierbaren Optionen finden Sie unter
60 60  
61 -[[http://desktop.teamwire.eu/templates/registration.json||rel="noopener noreferrer" target="_blank"]]
66 +[[url:http://desktop.teamwire.eu/templates/registration.json||rel="noopener noreferrer" target="_blank"]]
62 62  
63 -Bitte löschen Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus der Datei.
68 +Bitte löschen Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus der Datei.
64 64  )))
65 65  
66 -= Pflichtangaben =
67 67  
68 -Die folgenden Parameter sind für die vollautomatische Registrierung zwingend notwendig:
72 +{{id name="mandatory"/}}
69 69  
70 -* ##firstName##
71 -* ##lastName##
72 -* ##email##
73 -* ##registrationToken##
74 += Erforderliche Parameter =
74 74  
75 -## ##
76 +Die folgenden Parameter sind für die automatische Anmeldung zwingend notwendig:
76 76  
78 +{{tabs idsToLabels="parameter1=Desktop 4, parameter2=Bis Desktop 3.4.3"/}}
79 +
80 +(% id="parameter1" %)
81 +(((
82 +* ##firstName##: Benutzer Vorname
83 +* ##lastName##: Benutzer Nachname
84 +* ##email##: Benutzer E-Mail-Adresse
85 +* ##registrationToken##: Einmal-Token aus dem Dashboard
86 +* ##serverHost##: Teamwire Server Name wie unter [[Erweiterte Konfiguration>>doc:Public.Applications.Desktop.Advanced-Configurations.WebHome||anchor="4-hostname"]] beschrieben (optional aber empfohlen)
87 +)))
88 +
89 +(% id="parameter2" %)
90 +(((
91 +* ##FirstName##: Benutzer Vorname
92 +* ##LastName##: Benutzer Nachname
93 +* ##Email##: Benutzer E-Mail-Adresse
94 +* ##RegistrationToken##: Einmal-Token aus dem Dashboard
95 +* ##BackendServerName##: Teamwire Server Name wie unter [[Erweiterte Konfiguration>>doc:Public.Applications.Desktop.Advanced-Configurations.WebHome||anchor="4-hostname"]] beschrieben (optional aber empfohlen)
96 +)))
97 +
98 +
99 +{{id name="securityadvice"/}}
100 +
77 77  = Sicherheitshinweis =
78 78  
79 79  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.
80 80  
81 -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>>doc:Customer.Administration.Dashboard-User-Manual.WebHome]] im Bereich [[Benutzer ~> Benutzerbearbeitung>>doc:Customer.Administration.Dashboard-User-Manual.Users.WebHome||anchor="users-useroperations"]].
105 +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"]].
82 82  
83 83  ## ##
84 -
85 -## ##