Skip to Content
Last modified by teamwire001 on 2026/07/08 06:30
From version 6.1
edited by teamwire001
on 2026/07/08 06:29
Change comment: DOC-573
To version 2.1
edited by teamwire003
on 2023/11/07 14:34
Change comment: DOC-247

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.teamwire001
1 +XWiki.teamwire003
Content
... ... @@ -1,40 +1,112 @@
1 -{{id name="4-hostname"/}}
1 += Desktop 4.0.0 or newer =
2 2  
3 -= Server =
3 +These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]].
4 4  
5 -{{icon name="cog"/}} These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]].
6 6  
6 +{{id name="4-hostname"/}}
7 7  
8 -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.
8 +== Server ==
9 9  
10 -If your organisation is using the Teamwire Cloud Backend, please enter ##backend.teamwire.eu##.
10 +If required, please enter the custom backend hostname here. You must not enter the protocol or path but the **hostname only.** It is recommended to add this information in order to speed up the process and prevent registration failures.
11 11  
12 +If your organisation is using the Teamwire Cloud Backend, please enter {{code}}backend.teamwire.eu{{/code}}.
12 12  
14 +
13 13  {{id name="4-proxyurl"/}}
14 14  
15 -= Proxy server =
17 +== Proxy URL ==
16 16  
17 -{{icon name="cog"/}} These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]].
19 +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.**
18 18  
19 19  
22 +Please enter the complete URL incl. protocol (e.g. {{code}}http{{/code}} or {{code}}https{{/code}}) and port. The different types of proxy and their syntaxes are explained down below. For the following example we assume the proxy is running on a host named {{code}}your-proxy.com{{/code}} with port {{code}}9000{{/code}}. If your proxy needs basic HTTPS authentication, the credentials can be included in the URL as shown.
23 +
24 +* **HTTPS Proxy**
25 +{{code language="html"}}https://your-proxy.com:9000{{/code}}
26 +{{code language="html"}}https://username:password@your-proxy.com:9000{{/code}}
27 +
28 +* **PAC Proxy**
29 +{{code language="html"}}pac+http://file-provider.com/proxy.pac{{/code}}
30 +## ##
31 +
32 +----
33 +
34 +{{id name="desktop-previous"/}}
35 +
36 += Until Desktop 3.4.2 =
37 +
38 +These settings are accessible during the [[Login and Registration process>>doc:Public.Applications.Desktop.User-Manual.Login-and-Registration.WebHome]] or later by opening the app's [[Settings ~> Advanced options>>doc:Public.Applications.Desktop.User-Manual.Profile-and-Settings.WebHome||anchor="04-advanced"]].
39 +
40 +
41 +{{id name="hostname"/}}
42 +
43 +== Backend hostname ==
44 +
45 +If required, please enter the custom backend hostname here. You must not enter the protocol or path but the **hostname only.** It is recommended to add this information in order to speed up the process and prevent registration failures.
46 +
47 +If your organisation is using the Teamwire Cloud Backend, please enter {{code}}backend.teamwire.eu{{/code}}.
48 +
49 +
50 +{{id name="proxy"/}}
51 +
52 +== Proxy server ==
53 +
20 20  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.**
21 21  
22 -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.
23 23  
24 -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.
57 +{{id name="proxyurl"/}}
25 25  
59 +=== Apply proxy URL ===
60 +
61 +Please enter the complete URL incl. protocol (e.g. {{code}}http{{/code}} or {{code}}https{{/code}}) and port. The different types of proxy and their syntaxes are explained down below. For the following example we assume the proxy is running on a host named {{code}}your-proxy.com{{/code}} with port {{code}}9000{{/code}}. If your proxy needs basic HTTPS or SOCKS-5 authentication, the credentials can be included in the URL as shown.
62 +
26 26  * **HTTPS Proxy**
27 -##https:~/~/your-proxy.com:9000##
28 -##https:~/~/username:password@your-proxy.com:9000##
64 +{{code language="html"}}https://your-proxy.com:9000{{/code}}
65 +{{code language="html"}}https://username:password@your-proxy.com:9000{{/code}}
29 29  
67 +* **SOCKS-5 Proxy**
68 +{{code language="html"}}socks5://your-proxy.com:9000{{/code}}
69 +{{code language="html"}}socks5://username:password@your-proxy.com:9000{{/code}}
70 +
71 +* **SOCKS-4 Proxy**
72 +{{code language="html"}}socks4://your-proxy.com:9000{{/code}}
73 +
30 30  * **PAC Proxy**
31 -##pac+http:~/~/file-provider.com/proxy.pac##
75 +{{code language="html"}}pac+http://file-provider.com/proxy.pac{{/code}}
32 32  ## ##
33 33  
78 +{{id name="systemproxy"/}}
79 +
80 +=== Use system proxy ===
81 +
82 +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.
83 +
84 +
34 34  {{id name="certificate"/}}
35 35  
36 -= Server certificate =
87 +== Server certificate ==
37 37  
38 -Custom server certificates are currently not supported.
89 +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.
39 39  
91 +
92 +{{id name="customcertificatefile"/}}
93 +
94 +=== Choose custom certificate file ===
95 +
96 +Click the button and select the file containing the server's certificate chain (format: ##PEM##) via the file explorer.
97 +
98 +(% class="box infomessage" %)
99 +(((
100 +Please make sure to use the unix line feed {{code}}LF{{/code}} on your certificate. Any other control characters like ##CR## or Windows' ##CR LF## will not be valid.
101 +
102 +Also note, that the path used to refer to your certificate must not contain any spaces.
103 +)))
104 +
105 +
106 +{{id name="systemcertificatechain"/}}
107 +
108 +== Use system certificate chain (Windows) ==
109 +
110 +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.
111 +
40 40  ## ##