Configuration

Version 2 (Adrian Georgescu, 07/12/2012 04:42 pm)

1 1 Adrian Georgescu
h1. Configuration
2 1 Adrian Georgescu
3 1 Adrian Georgescu
h2. General settings
4 1 Adrian Georgescu
5 1 Adrian Georgescu
6 1 Adrian Georgescu
<pre>
7 2 Adrian Georgescu
; SylkServer configuration file
8 1 Adrian Georgescu
[Server]
9 1 Adrian Georgescu
10 1 Adrian Georgescu
; The following settings are the default used by the software, uncomment
11 1 Adrian Georgescu
; them only if you want to make changes
12 1 Adrian Georgescu
13 1 Adrian Georgescu
; default_application = conference
14 1 Adrian Georgescu
15 1 Adrian Georgescu
; Map user part of the Request URI to a specific application
16 1 Adrian Georgescu
; application_map = 123:conference,test:irc-conference
17 1 Adrian Georgescu
18 1 Adrian Georgescu
; trace_dir = /var/log/sylkserver
19 1 Adrian Georgescu
; trace_core = False
20 1 Adrian Georgescu
; trace_sip = False
21 1 Adrian Georgescu
; trace_msrp = False
22 1 Adrian Georgescu
; trace_notifications = False
23 1 Adrian Georgescu
24 1 Adrian Georgescu
; TLS can be used for encryption of SIP signaling and MSRP media. TLS is
25 1 Adrian Georgescu
; disabled by default.  To enable TLS, you must have a valid X.509
26 1 Adrian Georgescu
; certificate and configure it below, then set the local_tls_port in the SIP
27 1 Adrian Georgescu
; section and use_tls in MSRP section
28 1 Adrian Georgescu
29 1 Adrian Georgescu
; The X.509 Certificate Authorities file
30 1 Adrian Georgescu
; ca_file = /etc/sylkserver/tls/ca.crt
31 1 Adrian Georgescu
32 1 Adrian Georgescu
; The file containing X.509 certificate and private key in unencrypted format
33 1 Adrian Georgescu
; certificate = /etc/sylkserver/tls/default.crt
34 1 Adrian Georgescu
35 1 Adrian Georgescu
; verify_server = False
36 1 Adrian Georgescu
37 1 Adrian Georgescu
38 1 Adrian Georgescu
[SIP]
39 1 Adrian Georgescu
40 1 Adrian Georgescu
; SIP transport settings
41 1 Adrian Georgescu
; IP address used for SIP signaling; empty string or any means listen on interface used
42 1 Adrian Georgescu
; by the default route
43 1 Adrian Georgescu
; local_ip =
44 1 Adrian Georgescu
45 1 Adrian Georgescu
; Ports used for SIP transports, if not set to any value the transport will be disabled
46 1 Adrian Georgescu
; local_udp_port = 5060
47 1 Adrian Georgescu
; local_tcp_port = 5060
48 1 Adrian Georgescu
; local_tls_port = 5061
49 1 Adrian Georgescu
50 1 Adrian Georgescu
; If set all outbound SIP requests will be sent through this SIP proxy
51 1 Adrian Georgescu
; outbound_proxy =
52 1 Adrian Georgescu
53 1 Adrian Georgescu
; A comma-separated list of hosts or networks to trust.
54 1 Adrian Georgescu
; The elements can be an IP address in CIDR format, a
55 1 Adrian Georgescu
; hostname or an IP address (in the latter 2 a mask of 32
56 1 Adrian Georgescu
; is assumed), or the special keywords 'any' and 'none'
57 1 Adrian Georgescu
; (being equivalent to 0.0.0.0/0 and 0.0.0.0/32
58 1 Adrian Georgescu
; respectively). It defaults to 'any'.
59 1 Adrian Georgescu
; trusted_peers =
60 1 Adrian Georgescu
61 1 Adrian Georgescu
62 1 Adrian Georgescu
[MSRP]
63 1 Adrian Georgescu
64 1 Adrian Georgescu
; MSRP transport settings
65 1 Adrian Georgescu
66 1 Adrian Georgescu
; A valid X.509 certificate is required for MSRP to work over TLS.
67 1 Adrian Georgescu
; TLS is enabled by default, a default TLS certificate is provided with SylkServer.
68 1 Adrian Georgescu
; use_tls = True
69 1 Adrian Georgescu
70 1 Adrian Georgescu
71 1 Adrian Georgescu
[RTP]
72 1 Adrian Georgescu
73 1 Adrian Georgescu
; RTP transport settings
74 1 Adrian Georgescu
75 1 Adrian Georgescu
; Allowed codec list, valid values: G722, speex, PCMU, PCMA, iLBC, GSM
76 1 Adrian Georgescu
; audio_codecs = G722,speex,PCMU,PCMA
77 1 Adrian Georgescu
78 1 Adrian Georgescu
; Port range used for RTP
79 1 Adrian Georgescu
; port_range = 50000:50500
80 1 Adrian Georgescu
81 1 Adrian Georgescu
; SRTP valid values: disabled, mandatory, optional
82 1 Adrian Georgescu
; srtp_encryption = optional
83 1 Adrian Georgescu
84 1 Adrian Georgescu
; RTP stream timeout, session will be disconnected after this value
85 1 Adrian Georgescu
; timeout = 30
86 1 Adrian Georgescu
87 1 Adrian Georgescu
</pre>
88 1 Adrian Georgescu
89 1 Adrian Georgescu
h2. Conference settings
90 1 Adrian Georgescu
91 1 Adrian Georgescu
<pre>
92 1 Adrian Georgescu
; SylkServer Conference application configuration file
93 1 Adrian Georgescu
94 1 Adrian Georgescu
[Conference]
95 1 Adrian Georgescu
96 1 Adrian Georgescu
; The following settings are the default used by the software, uncomment them
97 1 Adrian Georgescu
; only if you want to make changes
98 1 Adrian Georgescu
99 1 Adrian Georgescu
; db_uri = sqlite:///var/lib/sylkserver/conference.sqlite
100 1 Adrian Georgescu
101 1 Adrian Georgescu
; Database table name for storing messages history
102 1 Adrian Georgescu
; history_table = message_history
103 1 Adrian Georgescu
104 1 Adrian Georgescu
; Replay last chat messages after joining a room
105 1 Adrian Georgescu
; replay_history = 20
106 1 Adrian Georgescu
107 1 Adrian Georgescu
; Directory for storing files transferred to rooms (a subdirectory for each room will be created)
108 1 Adrian Georgescu
; file_transfer_dir = /var/spool/sylkserver
109 1 Adrian Georgescu
110 1 Adrian Georgescu
; File transfer push support. If enabled files will be pushed to all active
111 1 Adrian Georgescu
; participants after receiving the file
112 1 Adrian Georgescu
; push_file_transfer = False
113 1 Adrian Georgescu
114 1 Adrian Georgescu
; Directory where images use by the Screen Sharing functionality will be stored
115 1 Adrian Georgescu
; screen_sharing_dir = /var/spool/sylkserver/screensharing
116 1 Adrian Georgescu
117 1 Adrian Georgescu
; IP address used for serving Screen Sharing HTTP requests, empty string means listen on interface used
118 1 Adrian Georgescu
; by the default route
119 1 Adrian Georgescu
; screen_sharing_ip =
120 1 Adrian Georgescu
121 1 Adrian Georgescu
; Port where Screen Sharing HTTP server will listen on, set to 0 for random
122 1 Adrian Georgescu
; screen_sharing_port = 0
123 1 Adrian Georgescu
124 1 Adrian Georgescu
; Use HTTPS instead of HTTP
125 1 Adrian Georgescu
; screen_sharing_use_https = True
126 1 Adrian Georgescu
127 1 Adrian Georgescu
; Server certificate for HTTPS connections
128 1 Adrian Georgescu
; screen_sharing_certificate = /etc/sylkserver/tls/default.crt
129 1 Adrian Georgescu
130 1 Adrian Georgescu
; Advertise the conference server and each room in Bonjour
131 1 Adrian Georgescu
; use_bonjour = False
132 1 Adrian Georgescu
133 1 Adrian Georgescu
; Access Lists Default Policy
134 1 Adrian Georgescu
; Apache-style access lists for the caller using SIP domains or SIP URIs
135 1 Adrian Georgescu
; https://httpd.apache.org/docs/2.2/mod/mod_authz_host.html#order
136 1 Adrian Georgescu
;
137 1 Adrian Georgescu
; access_policy = allow, deny
138 1 Adrian Georgescu
; allow = all
139 1 Adrian Georgescu
; deny = none
140 1 Adrian Georgescu
141 1 Adrian Georgescu
; Access Lists can be applied per room overriding the Default Policy
142 1 Adrian Georgescu
;
143 1 Adrian Georgescu
; [test@domain.com]
144 1 Adrian Georgescu
; access_policy = allow, deny
145 1 Adrian Georgescu
; allow = example.com, test@domain.com
146 1 Adrian Georgescu
; deny = all
147 1 Adrian Georgescu
148 1 Adrian Georgescu
</pre>
149 1 Adrian Georgescu
150 1 Adrian Georgescu
h2. XMPP gateway
151 1 Adrian Georgescu
152 1 Adrian Georgescu
<pre>
153 1 Adrian Georgescu
; SylkServer XMPP gateway application configuration file
154 1 Adrian Georgescu
155 1 Adrian Georgescu
[general]
156 1 Adrian Georgescu
157 1 Adrian Georgescu
; Comma-separated list of domains for which this server is responsible
158 1 Adrian Georgescu
; Add the xmmp-server records into the DNS server responsable for these domains
159 1 Adrian Georgescu
; At least one domain is required!
160 1 Adrian Georgescu
; domains =
161 1 Adrian Georgescu
162 1 Adrian Georgescu
; The following settings are the default used by the software, uncomment
163 1 Adrian Georgescu
; them only if you want to make changes
164 1 Adrian Georgescu
165 1 Adrian Georgescu
; Prefix that will be appended to all domains in the above setting, which will
166 1 Adrian Georgescu
; be used as a Multi User Chat (MUC) component
167 1 Adrian Georgescu
; muc_prefix = conference
168 1 Adrian Georgescu
169 1 Adrian Georgescu
; IP address used for listening to XMPP connections; empty string or any means listen on interface used
170 1 Adrian Georgescu
; by the default route
171 1 Adrian Georgescu
; local_ip =
172 1 Adrian Georgescu
173 1 Adrian Georgescu
; local_port = 5269
174 1 Adrian Georgescu
175 1 Adrian Georgescu
; If set to True (default) MSRP will be used to translate XMPP Instant Messaging, else SIP MESSAGE will be used
176 1 Adrian Georgescu
; Note: XMPP 'normal' messages (not chat messages) are always translated to SIP MESSAGE requests
177 1 Adrian Georgescu
; use_msrp_for_chat = True
178 1 Adrian Georgescu
179 1 Adrian Georgescu
; Timeout to terminate a SIP session if no chat traffic was received
180 1 Adrian Georgescu
; sip_session_timeout = 600
181 1 Adrian Georgescu
182 1 Adrian Georgescu
; Enable verbose logging of XMPP stantzas
183 1 Adrian Georgescu
; trace_xmpp = False
184 1 Adrian Georgescu
</pre>
185 1 Adrian Georgescu
186 1 Adrian Georgescu