[OpenSIPS-Users] [NEW] Stun Module

[Razvan Pistolea]

Hi to all,


There is a new STUN server(rfc 3489) module integrated in OpenSIPS.

Why an integrated STUN server module?
    A STUN server uses 2 ips and 2 ports to create 4 sockets on which to listen or respond.
    This integrated STUN module uses the SIPS sockets created by the OpenSIPS core:
    -one (or two) of the sockets will overlap with the SIP signaling socket
    -the rest will be created by this module for STUN only purposes.
    In the case of a bad behaving NATs (such as symmetric NAT) only this integrated STUN server will increase the likelihood of STUN to solve the NAT traversal for a wider range of NAT implementations. This translates into less need of media relaying (for NAT traversal purposes).

Note:
    It is important to set the primary_ip:primary_port to match the OpenSIPS signaling ip and ports.
    If OpenSIPS binds one more interface this module will use that too; so make sure you set the correct alternate_ip:primary_port.
    STUN requires 2 routable ip addresses; if in shortage create a virtual interface (i don't recommend because it destroys the purpose for some usages).


Example:
    Opensips listening for signaling traffic:
        89.89.89.12:5060
    for stun module we configure :
        primary_ip = 89.89.89.12; primary_port = 5060 - overlapping with signaling socket
        primary_ip = 89.89.89.12; alternate_port = 3478 - dedicated stun socket
        alternate_ip = 34.34.34.12; primary_port = 5060 - dedicated stun socket
        alternate_ip = 34.34.34.12; alternate_port = 3478 - dedicated stun socket


Documentation can be found here: http://www.opensips.org/html/docs/modules/devel/stun.html

Please post any bugs or questions.



Best regards,

Razvan