Features/Auto Provisioning/PnP

From Snom User Wiki

Jump to: navigation, search

Overview Plug & Play

Plug & Play (PnP) provides a proprietory method to enable "Auto Provisioning" on all snom VoIP phones EXCEPT snom m3,. By default (Parameter pnp config = on) the phones send SIP SUBSCRIBES messages to a multicast address. Any SIP server understanding that message may reply with a SIP NOTIFY message containing the Auto Provisioning Server URL where the phones can request their configuration from.

SIP Flow

snom3x0/snom8xx phones send on boot-up a SIP SUBSCRIBE message to a multicast address: 

Sent to udp:224.0.1.75:5060 at 24/12/2001 00:00:19:248 (448 bytes):

SUBSCRIBE sip:MAC%3a00135E874B49@intern.snom.de SIP/2.0
Via: SIP/2.0/UDP 192.168.10.67:5060;rport
From: <sip:MAC%3a00135E874B49@intern.snom.de>;tag=658512961
To: <sip:MAC%3a00135E874B49@intern.snom.de>
Call-ID: 1930770594@192.168.10.67
CSeq: 1 SUBSCRIBE
Event: ua-profile;profile-type="device";vendor="OEM";model="OEM";version="7.1.19"
Expires: 0
Accept: application/url
Contact: <sip:192.168.10.67:5060>
Content-Length: 0

If any SIP application within one hop range understands this message a confirmation is sent: 

Received from udp:192.168.100.10:5060 at 24/12/2001 00:00:19:287 (480 bytes):

SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.10.67:5060;rport=5060
Record-Route: <sip:127.0.0.1;lr;transport=tcp;route-id=fb4fb92b7775c2a7>
Record-Route: <sip:192.168.100.10;lr;transport=UDP;route-id=fb4fb92b7775c2a7>
Contact: <sip:192.168.100.10;transport=TCP;handler=dum>
To: <sip:MAC%3a00135E874B49@intern.snom.de>;tag=91955270
From: <sip:MAC%3a00135E874B49@intern.snom.de>;tag=658512961
Call-ID: 1930770594@192.168.10.67
CSeq: 1 SUBSCRIBE
Expires: 0 
Content-Length: 0

followed by a SIP NOTIFY message containing the Auto Provisioning URL "http://192.168.100.10/sipphone/sipphoneconfig.xml?mac={mac}": 

Received from udp:192.168.100.10:5060 at 24/12/2001 00:00:19:293 (868 bytes):

NOTIFY sip:192.168.10.67:5060 SIP/2.0
Via: SIP/2.0/UDP 192.168.100.10:5060;branch=z9hG4bK-d8754z-c3ea5f0e74462613-1---d8754z-;rport
Via: SIP/2.0/TCP 127.0.0.1:5060;branch=z9hG4bK-d8754z-7ca96c30144f3e04-1---d8754z-;rport=40916
Max-Forwards: 20
Record-Route: <sip:192.168.100.10;lr;route-id=e3470eb400e9c0a4>
Record-Route: <sip:127.0.0.1;lr;transport=TCP;route-id=e3470eb400e9c0a4>
Contact: <sip:192.168.100.10;transport=TCP;handler=dum>
To: <sip:MAC%3a00135E874B49@intern.snom.de>;tag=658512961
From: <sip:MAC%3a00135E874B49@intern.snom.de>;tag=91955270
Call-ID: 1930770594@192.168.10.67
CSeq: 3 NOTIFY
Content-Type: application/url
Subscription-State: terminated;reason=timeout
Event: ua-profile;profile-type="device";vendor="OEM";model="OEM";version="7.1.19"
Content-Length: 59

http://192.168.100.10/sipphone/sipphoneconfig.xml?mac={mac}

The phone accepts this message and confirms: 

Sent to udp:192.168.100.10:5060 at 24/12/2001 00:00:19:315 (542 bytes):

SIP/2.0 200 Ok
Via: SIP/2.0/UDP 192.168.100.10:5060;branch=z9hG4bK-d8754z-c3ea5f0e74462613-1---d8754z-;rport=5060
Via: SIP/2.0/TCP 127.0.0.1:5060;branch=z9hG4bK-d8754z-7ca96c30144f3e04-1---d8754z-;rport=40916
Record-Route: <sip:192.168.100.10;lr;route-id=e3470eb400e9c0a4>
Record-Route: <sip:127.0.0.1;lr;transport=TCP;route-id=e3470eb400e9c0a4>
From: <sip:MAC%3a00135E874B49@intern.snom.de>;tag=91955270
To: <sip:MAC%3a00135E874B49@intern.snom.de>;tag=658512961
Call-ID: 1930770594@192.168.10.67
CSeq: 3 NOTIFY
Content-Length: 0

Test Tool

Our development provides a tool (Python Script) which can be installed on any OS platform which is supported by Python. The script will reply to any phone within the network, so please test it thoroughly before applying it to a live environment.

Installation

Usage 

python pnpserv.py -u http://url.of.the/settings.xml?mac={mac}

python pnpserv.py -u w/o argument defaults to "http://provisioning.snom.com/snom3x0/snom3x0.php?mac={mac}"
pnpserv.py -h --> prints the help
pnpserv.py -v --> verbose mode
Personal tools
Interoperability