SipDeviceConfiguration

Version 64 (Adrian Georgescu, 05/26/2012 03:38 pm)

1 51 Adrian Georgescu
h1. Device Configuration
2 1 Adrian Georgescu
3 35 Adrian Georgescu
There are thousands of SIP devices on the market, for how to configure them we advise you to consult the support forum of the device manufacturer. 
4 1 Adrian Georgescu
5 35 Adrian Georgescu
Please do not open a ticket related to how a particular device must be configured.
6 1 Adrian Georgescu
7 1 Adrian Georgescu
Setup your SIP device as follows:
8 1 Adrian Georgescu
9 51 Adrian Georgescu
h2.  Account Credentials
10 1 Adrian Georgescu
 
11 1 Adrian Georgescu
Account credentials are used for authentication and authorization of SIP requests performed by the SIP device.
12 49 Adrian Georgescu
13 51 Adrian Georgescu
| Username| XXX|
14 1 Adrian Georgescu
| Password| YYY|
15 52 Adrian Georgescu
| Domain/Realm|sip2sip.info|
16 1 Adrian Georgescu
17 1 Adrian Georgescu
Register must be turned On in order to receive incoming calls.
18 1 Adrian Georgescu
19 64 Adrian Georgescu
If your SIP devices is smart enough, there is no need to set manually anything else than the above settings. If you need to manually fine tune the configuration read below.
20 51 Adrian Georgescu
21 64 Adrian Georgescu
[[SipDevices|Specific SIP devices configuration]]
22 1 Adrian Georgescu
23 1 Adrian Georgescu
h2. Outbound Proxy
24 1 Adrian Georgescu
25 62 Adrian Georgescu
There are multiple SIP servers distributed in multiple geographic locations. To locate them, the SIP device must always perform DNS lookups as defined in SIP standard "RFC3263":http://www.ietf.org/rfc/rfc3263.txt (NAPTR + SRV + A DNS lookups)
26 59 Adrian Georgescu
27 62 Adrian Georgescu
You should never set manually an IP address belonging to SIP2SIP server infrastructure into your SIP device as it may change. You must use proper DNS lookups  instead of hardwiring these setting into your SIP device.
28 38 Adrian Georgescu
29 51 Adrian Georgescu
| Host | Port | Protocol |
30 51 Adrian Georgescu
| proxy.sipthor.net| 5060| UDP |
31 1 Adrian Georgescu
| proxy.sipthor.net| 5060| TCP |
32 1 Adrian Georgescu
| proxy.sipthor.net| 5061| TLS |
33 57 Adrian Georgescu
34 63 Adrian Georgescu
h2. TLS Settings
35 60 Adrian Georgescu
36 63 Adrian Georgescu
You may use TLS transport, the SIP servers have a valid X.509 certificate issued by "RapidSSL":http://www.rapidssl.com corresponding to the proxy.sipthor.net hostname of the proxy. If the client does not RapidSSL certificate authority loaded, it may fail to validate the certificate. If the client allows it you can download the "RapidSSL root CA":http://www.geotrust.com/resources/root_certificates/certificates/Equifax_Secure_Certificate_Authority.cer  into it. Turn TLS certificate validation off to circumvent the problem. 
37 34 Adrian Georgescu
38 50 Adrian Georgescu
39 51 Adrian Georgescu
h2. XCAP Root
40 51 Adrian Georgescu
41 34 Adrian Georgescu
If you use SIMPLE presence you need to set XCAP root:
42 1 Adrian Georgescu
43 54 Adrian Georgescu
| XCAP Root | https://xcap.sipthor.net/xcap-root/|
44 51 Adrian Georgescu
45 51 Adrian Georgescu
h2. MSRP Relay
46 1 Adrian Georgescu
47 1 Adrian Georgescu
If you use SIMPLE instant messaging based on MSRP, a relay is available for helping traverse the NAT. You need to use the relay if you are the receiving party and you are behind a NAT-ed router. The MSRP relays can be found in the DNS by using SRV lookup for _msrps._tcp.sip2sip.info.
48 53 Adrian Georgescu
49 53 Adrian Georgescu
h2. STUN Servers
50 1 Adrian Georgescu
51 56 Adrian Georgescu
You may use STUN for ICE NAT traversal. The STUN servers can be found in the DNS by using SRV lookup for _stun._udp.sip2sip.info.
52 56 Adrian Georgescu
53 56 Adrian Georgescu
h2. NAT Traversal
54 56 Adrian Georgescu
55 56 Adrian Georgescu
SIP2SIP infrastructure is smart enough to handle the NAT traversal for both SIP signaling and RTP and MSRP media sessions. Practically you should not set any NAT traversal feature in the client, some people do this and can only break things.
56 56 Adrian Georgescu
57 56 Adrian Georgescu
 * Do not use STUN for Register purposes
58 56 Adrian Georgescu
 * Do not set your client to discover a global IP address