-
Notifications
You must be signed in to change notification settings - Fork 6
/
Copy pathapache-conf.html
177 lines (164 loc) · 10.4 KB
/
apache-conf.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
<!DOCTYPE html>
<html lang="en">
<head>
<title>HTTP Provisioning</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1,shrink-to-fit=no">
<link rel="shortcut icon" href="images/logo.svg">
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Roboto">
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:[email protected]">
<link rel="stylesheet" href="includes/theme.css">
<link rel="stylesheet" href="includes/prettify.css">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<script src="includes/prettify.js"></script>
<script src="includes/lang-apache.js"></script>
<script>
jQuery(window).on("load", function () {
prettyPrint();
});
</script>
</head>
<body>
<header>
<a href="/"><img src="images/logo.svg" alt=""></a>
<h2><<span>proxy</span>></h2><h1><span>USECALLMANAGER</span>.nz</h1><h2></<span>proxy</span>></h2>
</header>
<main>
<nav>
<ul>
<li><a href="documentation-overview.html"><span class="icon">home</span> Documentation Overview</a></li>
<li><a href="patching-asterisk.html"><span class="icon">build</span> Patching Asterisk</a></li>
</ul>
<ul>
<li><h3>Network Configuration</h3></li>
<li><a href="dhcpd-conf.html"><span class="icon">settings_ethernet</span> DHCP Options</a></li>
<li><span class="icon selected">file_download</span> <b>HTTP Provisioning</b></li>
<li><a href="tftpd-conf.html"><span class="icon">file_download</span> TFTP Provisioning</a></li>
</ul>
<ul>
<li><h3>Phone Configuration</h3></li>
<li><a href="sepmac-cnf-xml.html"><span class="icon">settings_phone</span> SEPMAC.cnf.xml</a></li>
<li><a href="dial-template-xml.html"><span class="icon">dialpad</span> Dial Templates</a></li>
<li><a href="app-dial-rules-xml.html"><span class="icon">bluetooth</span> Application Dial Rules</a></li>
<li><a href="soft-keys-xml.html"><span class="icon">power_input</span> Soft Keys</a></li>
<li><a href="line-keys-xml.html"><span class="icon">format_list_bulleted</span> Line Keys</a></li>
<li><a href="feature-policy-xml.html"><span class="icon">fact_check</span> Feature Policy</a></li>
<li><a href="network-locale.html"><span class="icon">language</span> Network Locale</a></li>
<li><a href="user-locale.html"><span class="icon">face</span> User Locale</a></li>
<li><a href="load-information.html"><span class="icon">file_upload</span> Firmware Load Information</a></li>
<li><a href="image-list-xml.html"><span class="icon">wallpaper</span> Background Images</a></li>
<li><a href="ring-list-xml.html"><span class="icon">ring_volume</span> Ring Tones</a></li>
<li><a href="itl-file-tlv.html"><span class="icon">security</span> Device Security</a></li>
<li><a href="trust-verification.html"><span class="icon">verified</span> Trust Verification</a></li>
<li><a href="certificate-enrollment.html"><span class="icon">card_membership</span> Certificate Enrollment</a></li>
<li><a href="vpn-group.html"><span class="icon">vpn_key</span> VPN Connection</a></li>
</ul>
<ul>
<li><h3>Asterisk Configuration</h3></li>
<li><a href="sip-conf.html"><span class="icon">dialer_sip</span> SIP Peers</a></li>
<li><a href="sip-notify-conf.html"><span class="icon">settings_power</span> SIP Notify Commands</a></li>
<li><a href="extensions-conf.html"><span class="icon">format_list_numbered</span> Dialplan Extensions</a></li>
<li><a href="res-parking-conf.html"><span class="icon">local_parking</span> Call Parking</a></li>
<li><a href="sippeer-options.html"><span class="icon">code</span> SIPPEER Options</a></li>
<li><a href="rtp-streaming.html"><span class="icon">volume_up</span> RTP Streaming</a></li>
<li><a href="command-line.html"><span class="icon">keyboard_arrow_right</span> Command Line</a></li>
<li><a href="freepbx-integration.html"><span class="icon">view_kanban</span> FreePBX Integration</a></li>
</ul>
<ul>
<li><h3>XML Services</h3></li>
<li><a href="phone-services-xml.html"><span class="icon">settings</span> Phone Services</a></li>
<li><a href="cgi-execute-xml.html"><span class="icon">phone_forwarded</span> CGI Execute</a></li>
</ul>
<ul>
<li><h3>Additional Features</h3></li>
<li><a href="as-feature-events.html"><span class="icon">extension</span> AS Feature Events</a></li>
</ul>
</nav>
<article>
<h1>HTTP Provisioning and Services</h1>
HTTP is used by the phone to download its configuration, background image and ring-tone and also for providing XML services.<br>
<br>
<h2 id="Provisioning">Provisioning <a href="#Provisioning" title="Link">link</a></h2>
The phone will use HTTP to download files from port <code class="literal">6970</code> on the server specified as the <code class="keyword">tftp-server-name</code> in the DHCP response first before falling-back to TFTP on failure. A sample tftpboot directory containing templates for <code class="literal">SEPMAC.cnf.xml</code>, <code class="literal">Softkeys.xml</code>, <code class="literal">FeaturePolicy.xml</code>, <code class="literal">DialTemplate.xml</code>, <code class="literal">AppDialRules.xml</code>, background images and ring-tones can be downloaded from the URL below.<br>
<br>
<a href="https://github.com/usecallmanagernz/tftpboot/archive/v1.7.tar.gz" download><span class="icon">file_download</span> tftpboot-1.7.tar.gz</a> (124K) <span class="icon">event</span> 21/06/2024 <span class="icon">security</span> SHA256:afe96ab7aabfb8b9e93b78aa0177aef45eefc6486c85140c3aae81542e3b485e.<br>
<br>
<code class="prettify lang-apache">Listen 6970
<Virtualhost *:6970>
# HTTP Provisioning
DocumentRoot /var/lib/tftpboot
<Directory /var/lib/tftpboot>
Options +FollowSymlinks
Require all granted
</Directory>
</Virtualhost></code>
<br>
<h2 id="Secure-Provisioning">Secure Provisioning <a href="#Secure-Provisioning" title="Link">link</a></h2>
If the <code class="literal">ITLFile.tlv</code> has a version of <code class="literal">1.1</code> the phone will use HTTPS to download <a href="sepmac-cnf-xml.html">SEPMAC.cnf.xml</a> from port <code class="literal">6971</code> on the server before falling back to HTTP on failure. The SSL certificate used by server must use an EC (Elliptic Curve) key and be included in <code class="literal">ITLFile.tlv</code> with the <code class="literal">TFTP</code> function or available via the Trust Verification Service. The remaining provisioning files like soft keys, dial template and ring-tones will be downloaded on port <code class="literal">6970</code>.<br>
<br>
When the EC key is included in <code class="literal">ITLFile.tlv</code> then the remaining provisioning files need to be signed using an RSA key with the <code class="literal">TFTP</code> role, see <a href="itl-file-tlv.html#sgnfile">Device Security</a> for more information. If the phone requests it's configuration file on port <code class="literal">6971</code> with a <code class="literal">.sgn</code> extension the response must contain an unsigned file.<br>
<br>
<code class="prettify lang-apache">Listen 6971
<Virtualhost *:6971>
# HTTPS Provisioning
DocumentRoot /var/lib/tftpboot
<Directory /var/lib/tftpboot>
Options +FollowSymlinks
Require all granted
</Directory>
<IfModule ssl_module>
SSLEngine on
# Must be a certificate that uses an EC key
SSLCertificateFile /etc/apache2/ssl-certs/apache-ec.pem
</IfModule>
<IfModule rewrite_module>
RewriteEngine on
# Phone requests a .sgn file but actually wants an unsigned file
RewriteRule ^/(SEP.+\.xml)\.sgn$ /$1 [last]
</IfModule>
</Virtualhost></code>
<br>
<h2 id="XML-Services">XML Services <a href="#XML-Services" title="Link">link</a></h2>
Example configuration for a WSGI application providing phone XML services on port <code class="literal">6972</code>, any port can be used. See <a href="phone-services-xml.html">Phone Services</a> for more information.<br>
<br>
<code class="prettify lang-apache">Listen 6972
<Virtualhost *:6972>
# For <servicesURL>, <directoryURL> and <authenticationURL>
DocumentRoot /var/www/services
<Directory /var/www/services>
Require all granted
</Directory>
<IfModule wsgi_module>
WSGIDaemonProcess services user=www-data group=www-data home=/var/www/services threads=5
WSGIProcessGroup services
WSGIScriptAlias / /var/www/services/application.wsgi
</IfModule>
</Virtualhost></code>
<br>
<h2 id="Secure-XML-Services">Secure XML Services <a href="#Secure-XML-Services" title="Link">link</a></h2>
Example configuration for a WSGI application providing phone XML services on port <code class="literal">6973</code>, any port can be used. The certificate used needs to be included in <code class="literal">ITLFile.tlv</code> with the <code class="literal">APP-SERVER</code> role or verifiable via TVS. See <a href="itl-file-tlv.html#tlvfile">Device Security</a> for more information.<br>
<br>
<code class="prettify lang-apache">Listen 6973
<Virtualhost *:6973>
# For <secureServicesURL>, <secureDirectoryURL> and <secureAuthenticationURL>
DocumentRoot /var/www/services
<Directory /var/www/services>
Require all granted
</Directory>
<IfModule ssl_module>
SSLEngine on
SSLCertificateFile /etc/apache2/ssl-certs/apache.pem
</IfModule>
<IfModule wsgi_module>
WSGIDaemonProcess services-ssl user=www-data group=www-data home=/var/www/services threads=5
WSGIProcessGroup services-ssl
WSGIScriptAlias / /var/www/services/application.wsgi
</IfModule>
</Virtualhost></code>
</article>
</main>
<footer>
<span class="icon">copyright</span> Gareth Palmer and individual contributors. Documentation distributed under <a href="LICENSE">CC BY 4.0</a>.
</footer>
</body>
</html>