Änderungen von Dokument 2. Automated Sign-in

Zuletzt geändert von teamwire001 am 2025/10/28 13:49

Von Version 5.1
bearbeitet von teamwire001
am 2025/10/28 13:49
Änderungskommentar: Imported from XAR
Auf Version 3.1
bearbeitet von teamwire004
am 2024/07/12 13:40
Änderungskommentar: DOC-324

Zusammenfassung

Details

Seiteneigenschaften
Titel
... ... @@ -1,1 +1,1 @@
1 -2. Automatische Anmeldung
1 +2. Automatische Registrierung
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.teamwire001
1 +XWiki.teamwire004
Inhalt
... ... @@ -1,116 +1,83 @@
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.
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.
2 2  
3 3  
4 -{{id name="windows"/}}
5 -
6 6  = Windows =
7 7  
8 -Um die automatische Anmeldung unter Windows einzurichten, stellen Sie die [[Erforderlichen Parameter>>doc:||anchor="mandatory"]] per Registry-Eintrag bereit:
6 +Teamwire holt sich beim ersten Start die Informationen (sofern vorhanden) aus der Registrierungsstruktur des Benutzers unter
9 9  
10 -{{tabs idsToLabels="registry1=Desktop 4, registry2=Bis Desktop 3.4.3"/}}
8 +|(((
9 +**Desktop 4.0.10 oder neuer**
11 11  
12 -(% id="registry1" %)
11 +(% class="box infomessage" %)
13 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}}
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 +)))
17 17  
18 -Registrypfad: ##HKEY_CURRENT_USER\SOFTWARE\teamwire\##
16 +##HKEY_CURRENT_USER\SOFTWARE\teamwire\##
19 19  
20 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"]]
19 +[[https:~~/~~/desktop.teamwire.eu/templates/teamwire-windows.reg>>https://desktop.teamwire.eu/templates/teamwire-windows.reg]]
22 22  
23 -Bitte kommentieren Sie nicht benötigte Parameter wie z.B. ##proxyUrl## aus.
21 +Bitte kommentieren Sie nicht benötigte Parameter wie z.B.  ##proxyUrl##  aus.
24 24  )))
23 +|(((
24 +**Bis Desktop 3.4.2**
25 25  
26 -(% id="registry2" %)
27 -(((
28 -Registrypfad: ##HKEY_CURRENT_USER\Software\Teamwire\UserRegistration\##
26 +##HKEY_CURRENT_USER\Software\Teamwire\UserRegistration\##
29 29  
30 30  Eine Vorlage für den Eintrag in der Registry mit allen konfigurierbaren Optionen finden Sie unter
31 31  
32 -[[url:http://desktop.teamwire.eu/templates/windows.reg||rel="noopener noreferrer" target="_blank"]]
30 +[[http://desktop.teamwire.eu/templates/windows.reg||rel="noopener noreferrer" target="_blank"]]
33 33  
34 -Bitte kommentieren Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus.
32 +Bitte kommentieren Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus.
35 35  )))
36 36  
37 -(% style="border-color:var(--gili_blue_300)" %)
38 -----
39 -
40 -
41 -{{id name="macosandlinux"/}}
42 -
43 43  = macOS und Linux =
44 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:
37 +Für die automatische Registrierung wird eine JSON Datei im entsprechenden Benutzerordner benötigt:
46 46  
47 -{{tabs idsToLabels="config1=Desktop 4, config2=Bis Desktop 3.4.3"/}}
39 +|(((
40 +**Desktop 4.0.10 oder neuer**
48 48  
49 -(% id="config1" %)
42 +(% class="box infomessage" %)
50 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}}
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 +)))
54 54  
55 -Dateipfad: ##~~/.config/teamwire/teamwire.cfg##
47 +##~~/.config/teamwire/teamwire.cfg##
56 56  
57 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"]]
50 +[[https:~~/~~/desktop.teamwire.eu/templates/teamwire.cfg>>https://desktop.teamwire.eu/templates/teamwire.cfg]]
59 59  
60 -Bitte löschen Sie nicht benötigte Parameter wie z.B. ##proxyUrl## aus der Datei.
52 +Bitte löschen Sie nicht benötigte Parameter wie z.B.  ##proxyUrl##  aus der Datei.
61 61  )))
54 +|(((
55 +**Bis Desktop 3.4.2**
62 62  
63 -(% id="config2" %)
64 -(((
65 -Dateipfad: ##~~/.config/teamwire.cfg##
57 +##~~/.config/teamwire.cfg##
66 66  
67 67  Eine Vorlage für das JSON mit allen konfigurierbaren Optionen finden Sie unter
68 68  
69 -[[url:http://desktop.teamwire.eu/templates/registration.json||rel="noopener noreferrer" target="_blank"]]
61 +[[http://desktop.teamwire.eu/templates/registration.json||rel="noopener noreferrer" target="_blank"]]
70 70  
71 -Bitte löschen Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus der Datei.
63 +Bitte löschen Sie nicht benötigte Parameter wie z.B. ##ProxyURL## aus der Datei.
72 72  )))
73 73  
74 -(% style="border-color:var(--gili_blue_300)" %)
75 -----
66 += Pflichtangaben =
76 76  
68 +Die folgenden Parameter sind für die vollautomatische Registrierung zwingend notwendig:
77 77  
78 -{{id name="mandatory"/}}
70 +* ##firstName##
71 +* ##lastName##
72 +* ##email##
73 +* ##registrationToken##
79 79  
80 -= Erforderliche Parameter =
75 +## ##
81 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 110  = Sicherheitshinweis =
111 111  
112 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 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 im Abschnitt [[Sammelbearbeitung von Benutzern ( {{icon name="sign-in" size="1x" cssClass="fa-blue helpc" title="Dieses Dokument ist nur für angemeldete Nutzer verfügbar"/}})>>doc:Customer.Administration.Dashboard-User-Manual.Users.WebHome||anchor="users-useroperations" title="Dieses Dokument ist nur für angemeldete Nutzer verfügbar"]]
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"]].
115 115  
116 116  ## ##