Skip to Content

Wiki source code of 3. Advanced Configurations

Last modified by teamwire001 on 2025/09/11 14:58
Show last authors
1 {{id name="4-hostname"/}}
2
3 = Server =
4
5 {{tabs idsToLabels="server1=Desktop 4, server2=Until Desktop 3.4.3"/}}
6
7 (% id="server1" %)
8 (((
9 {{icon name="cog"/}} These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]].
10
11
12 If required, please enter the custom **server name** here. You must not enter the protocol or path but the name only. It is recommended to add this information in order to speed up the process and prevent registration failures.
13
14 If your organisation is using the Teamwire Cloud Backend, please enter ##backend.teamwire.eu##.
15 )))
16
17 (% id="server2" %)
18 (((
19 {{icon name="cog"/}} These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]], and in the app's [[Settings ~> Advanced options>>doc:Public.Applications.Desktop.User-Manual.Profile-and-Settings.WebHome||anchor="04-advanced"]] when you are logged in.
20
21
22 If required, please enter the custom **backend hostname** here. You must not enter the protocol or path but the name only. It is recommended to add this information in order to speed up the process and prevent registration failures.
23
24 If your organisation is using the Teamwire Cloud Backend, please enter ##backend.teamwire.eu##.
25 )))
26
27 (% style="border-color:var(--gili_blue_300)" %)
28 ----
29
30
31 {{id name="4-proxyurl"/}}
32
33 = Proxy server =
34
35 {{tabs idsToLabels="proxy1=Desktop 4, proxy2=Until Desktop 3.4.3"/}}
36
37 (% id="proxy1" %)
38 (((
39 {{icon name="cog"/}} These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]].
40
41
42 In order to work properly with a proxy server, Teamwire needs your proxy to support the **HTTP CONNECT method,** the **HTTP Upgrade mechanism** and has to allow all **Sec-Websocket-* headers.**
43
44 Please enter the complete URL incl. protocol (e.g. ##http## or ##https##) and port. The different types of proxy and their syntaxes are explained down below.
45
46 For the following example we assume the proxy is running on a host named ##your-proxy.com## with port 9000. If your proxy needs basic HTTPS authentication, the credentials can be included in the URL as shown.
47
48 * **HTTPS Proxy**
49 ##https:~/~/your-proxy.com:9000##
50 ##https:~/~/username:password@your-proxy.com:9000##
51
52 * **PAC Proxy**
53 ##pac+http:~/~/file-provider.com/proxy.pac##
54 )))
55
56 (% id="proxy2" %)
57 (((
58 {{icon name="cog"/}} These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]], and in the app's [[Settings ~> Advanced options>>doc:Public.Applications.Desktop.User-Manual.Profile-and-Settings.WebHome||anchor="04-advanced"]] when you are logged in.
59
60
61 In order to work properly with a proxy server, Teamwire needs your proxy to support the **HTTP CONNECT method,** the **HTTP Upgrade mechanism** and has to allow all **Sec-Websocket-* headers.**
62
63 Please enter the complete URL incl. protocol (e.g. ##http## or ##https##) and port. The different types of proxy and their syntaxes are explained down below.
64
65 For the following example we assume the proxy is running on a host named ##your-proxy.com## with port 9000. If your proxy needs basic HTTPS or SOCKS-5 authentication, the credentials can be included in the URL as shown.
66
67 * **HTTPS Proxy**
68 ##https:~/~/your-proxy.com:9000##
69 ##https:~/~/username:password@your-proxy.com:9000##
70
71 * **SOCKS-5 Proxy**
72 ##socks5:~/~/your-proxy.com:9000##
73 ##socks5:~/~/username:password@your-proxy.com:9000##
74
75 * **SOCKS-4 Proxy**
76 ##socks4:~/~/your-proxy.com:9000##
77
78 * **PAC Proxy**
79 ##pac+http:~/~/file-provider.com/proxy.pac##
80 ## ##
81
82 (% class="box-title" %)
83 System Proxy
84
85 If the proxy data are already provided to the (Windows) system, you can select **Use system proxy** to apply the operating system's internet settings.
86 )))
87
88 (% style="border-color:var(--gili_blue_300)" %)
89 ----
90
91
92 {{id name="certificate"/}}
93
94 = Server certificate =
95
96 {{tabs idsToLabels="certificate1=Desktop 4, certificate2=Until Desktop 3.4.3"/}}
97
98 (% id="certificate1" %)
99 (((
100 Custom server certificates are currently not supported by Desktop version 4.
101 )))
102
103 (% id="certificate2" %)
104 (((
105 {{icon name="cog"/}} These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]].
106
107
108 If the backend server uses a self-signed certificate or if it is signed by a Certificate Authority (CA), that is not well known, you will have to provide the certificate chain.
109
110
111 {{id name="customcertificatefile"/}}
112
113 (% class="box-title" %)
114 Use a custom certificate file
115
116 Click the button and select the file containing the server's certificate chain (format: ##PEM##) via the file explorer.
117
118 {{info}}
119 Please make sure to use the unix line feed ##LF## on your certificate. Any other control characters like ##CR## or Windows' ##CR LF## will not be valid.
120
121 Also note, that the path used to refer to your certificate must not contain any spaces.
122 {{/info}}
123
124
125 {{id name="systemcertificatechain"/}}
126
127 (% class="box-title" %)
128 Use system certificate chain (Windows)
129
130 Select this option if the custom certificate has been applied to the Microsoft Management Console. Teamwire will automatically check the so-called Certificate Trust Store for any necessary information.
131 )))
132
133 (% style="border-color:var(--gili_blue_300)" %)
134 ----
135
136 ## ##