Page 1
Auto Provisioning
via snom‘s Redirection
Service
1
© 2011 snom technology AG
Author: Alexander Feldt , Christian Niemczik
snomIPP - ST314: Auto Provisioning via snom’s Redirection Service
Page 2
Challenges and Objectives (1)
You’re the admin and you have managed to configure3
snom phones manually - congratulation!
Well, there are 1000 more waiting for you…
but don’t panic, we’ll show you how!
2
snomIPP - ST314: Auto Provisioning via snom’s Redirection Service
© 2011 snom technology AG
Author: Alexander Feldt , Christian Niemczik
Page 3
Challenges and Objectives (2)
SIP Server
‣
There is NO SIP server capable of
handling PnP SUBSCRIBE/NOTIFY in
your network?
‣
There is NO DHCP server capable of
delivering option 66/67 in your network?
‣
Question: How may auto provisioning
work in this case?
‣
Answer: Relax, snom takes care about it
– and redirects your phone on boot-up
time to your auto provisioning server.
This is what we call snom’s redirection
service.
with PnP
with option 66
D HCP Server
snom‘s public
AP Server
3
3
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
Author: Alexander Feldt , Christian Niemczik
Page 4
Boot-Up Priority:
snom Redirection Service
Pow
er
Up
Send SIP
Multicast
Wait for
reply
SIP
NOTIFY
received?
Yes
No
setting_server:=
URL in SIP NOTIFY body
Use URL of setting_server
This scenario has
third highest
Scenario.
Is
setting_se
rver set?
Yes
DHCP
option
43/66/67?
Use URL received in
DHCP Option
No
Yes
No
Manual change of
setting_server via WUI
Contact
provisioning.snom.com
Scenario 3
4
4
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
Author: Alexander Feldt , Christian Niemczik
snomEssentials - ST314: Auto Provisioning Redirection
Page 5
‣
The redirection service allows any customer to
‣
register/list/unregister the MAC addresses of their
purchased snom IP phones on snom‘s public Auto
Provisioning Server (APS)
‣
assign individual redirection URL‘s pointing to
different Auto Provisioning Servers (APS)
‣
implement an easy to use interface (XMLRPC) for
secure interaction (HTTPS) with remote client
applications
‣
Well, there’s still something left you have to prepare
in advance, let’s take a look…
5
5
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
Author: Alexander Feldt , Christian Niemczik
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Page 6
Configuration & troubleshooting
tasks
‣
Si g n th e e n d u s e r a g r e e m e n t a n d r e c e i v e y o u r
XML R PC l o g i n c r e d e n ti a l s
‣
Enter the MAC addresses of your purchased phones
into your database
‣
Register the MAC addresses on snom‘s APS using
XMLRPC interface and create MAC address specific
configuration files on your APS
‣
Send the phones to your customer‘s premises and
install them
‣
Phones will be redirected to your APS and request
all customer specific configuration.
‣
Check the phone‘s configuration and system log
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
6
6
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 7
Step 1: Sign the end user agreement
and receive your XMLRPC login
credentials
1a - Purchase
snom phones
1b – Sign End
user Agreement
1c – Receive
XMLRPC
credentials
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
7
7
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 8
Configuration & troubleshooting
tasks
‣
Sign the end user agreement and receive your
XMLRPC login credentials
‣
En te r th e MA C a d d r e s s e s o f y o u r p u r c h a s e d p h o n e s
i n to y o u r d a ta b a s e
‣
Register the MAC addresses on snom‘s APS using
XMLRPC interface and create MAC address specific
configuration files on your APS
‣
Send the phones to your customer‘s premises and
install them
‣
Phones will be redirected to your APS and request
all customer specific configuration.
‣
Check the phone‘s configuration and system log
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
6
8
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 9
1a - Purchase
Step 2: Enter the MAC addresses of
the purchased phones to be
redirected into your database
snom phones
into your
database
2 - Enter MAC‘s
Your CRM
Database
1b – Sign End
user Agreement
1c – Receive
XMLRPC
credentials
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
9
9
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 10
Configuration & troubleshooting
tasks
‣
Sign the end user agreement and receive your
XMLRPC login credentials
‣
Enter the MAC addresses of your purchased phones
into your database
‣
R e g i s te r th e MA C a d d r e s s e s o n s n o m ‘ s A PS u s i n g
XML R PC i n te r fa c e a n d c r e a te MA C a d d r e s s s p e c i fi c
c o n fi g u r a ti o n fi l e s o n y o u r A PS
‣
Send the phones to your customer‘s premises and
install them
‣
Phones will be redirected to your APS and request
all customer specific configuration.
‣
Check the phone‘s configuration and system log
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
6
10
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 11
1a - Purchase
<? xml ve rsi o n =' 1 . 0 ' ? >
<me t h o d C a l l >
<me t h o d N a me >re d i re ct . re g i st e rPh o n e </ me t h o d N a me >
<p a ra ms>
<p a ra m><va l u e >
<st ri n g >0 0 0 4 1 3 2 4 4 3 2 1 </ st ri n g >
</ va l u e ></ p a ra m>
<p a ra m><va l u e >
<st ri n g > h t t p : / / f o x. sn o m. co m/ p rv2 . p h p ? ma c={ma c} </
st ri n g >
</ va l u e ></ p a ra m>
</ p a ra ms>
</ me t h o d C a l l >
Step 3: Register the MAC addresses
on snom‘s APS using XMLRPC
interface and create MAC address
specific configuration files on your
APS
snom phones
into your
database
2 - Enter MAC‘s
11
11
Your CRM
Database
1b – Sign End
user Agreement
1c – Receive
XMLRPC
credentials
3a - Access CRM
database
3c – Register MACs
and assign APS URL
XMLRPC
Interface
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
3b - Create MAC based
configuration for
customer phones
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
Author: Alexander Feldt , Christian Niemczik
snomEssentials - ST314: Auto Provisioning Redirection
Your APServer
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 12
Configuration & troubleshooting
tasks
‣
Sign the end user agreement and receive your
XMLRPC login credentials
‣
Enter the MAC addresses of your purchased phones
into your database
‣
Register the MAC addresses on snom‘s APS using
XMLRPC interface and create MAC address specific
configuration files on your APS
‣
Se n d th e p h o n e s to y o u r c u s to m e r ‘ s p r e m i s e s a n d
i n s ta l l th e m
‣
Phones will be redirected to your APS and request
all customer specific configuration.
‣
Check the phone‘s configuration and system log
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
6
12
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 13
4a – Send phones to customer
Step 4: Send the phones to your
customer‘s premises and install
them
premises
1a - Purchase
snom phones
into your
database
2 - Enter MAC‘s
Your CRM
Database
1b – Sign End
user Agreement
1c – Receive
XMLRPC
credentials
3a - Access CRM
database
4b – Install phones at customer
premises
3c – Register MACs
and assign APS URL
3b - Create MAC based
configuration for
customer phones
Your APServer
XMLRPC
Interface
13
13
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
Author: Alexander Feldt , Christian Niemczik
Page 14
Configuration & troubleshooting
tasks
‣
Sign the end user agreement and receive your
XMLRPC login credentials
‣
Enter the MAC addresses of your purchased phones
into your database
‣
Register the MAC addresses on snom‘s APS using
XMLRPC interface and create MAC address specific
configuration files on your APS
‣
Send the phones to your customer‘s premises and
install them
‣
Ph o n e s w i l l b e r e d i r e c te d to y o u r A PS a n d r e q u e s t
a l l c u s to m e r s p e c i fi c c o n fi g u r a ti o n .
‣
Check the phone‘s configuration and system log
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
6
14
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 15
4a – Send phones to customer
Step 5: The phones will be
redirected to your APS and request
all customer specific configuration
premises
1a - Purchase
snom phones
into your
database
2 - Enter MAC‘s
Your CRM
Database
1b – Sign End
user Agreement
1c – Receive
XMLRPC
credentials
3a - Access CRM
database
4b – Install phones at customer
5a - Request
snom‘s APS
5b - Receive
APS URL
3c – Register MACs
and assign APS URL
3b - Create MAC based
configuration for
customer phones
premises
from APS
5c – Request
configuration files
Your APServer
XMLRPC
Interface
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
15
15
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 16
Process Flow: snom Redirection
DHCP Request
DHCP Offer: IP, Netmask, etc.
Internet Connectivity
Request Configuration Files
Receive new AP Server URL
Request Configuration Files
Send Configuration Parameters
1
snom‘s public
AP Server
2
3
16
snomEssentials - ST112: Auto Provisioning Overview
© 2011 snom technology AG
Author: Alexander Feldt , Christian Niemczik
Page 17
Configuration & troubleshooting
tasks
‣
Sign the end user agreement and receive your
XMLRPC login credentials
‣
Enter the MAC addresses of your purchased phones
into your database
‣
Register the MAC addresses on snom‘s APS using
XMLRPC interface and create MAC address specific
configuration files on your APS
‣
Send the phones to your customer‘s premises and
install them
‣
Phones will be redirected to your APS and request
all customer specific configuration.
‣
C h e c k th e p h o n e ‘ s c o n fi g u r a ti o n a n d s y s te m l o g
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
6
17
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
snomEssentials - ST314: Auto Provisioning Redirection
Author: Alexander Feldt , Christian Niemczik
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2011 snom technology AG
Page 18
Check the phone‘s system log
‣
Open the System Log page (e.g. http://10.11.106.4/
log.htm) for checking the boot-up events. You
should see something like this:
20
18
sn o mI PP - ST 3 1 4 : Au t o Pro vi si o n i n g vi a sn o m’ s R e d i re ct i o n Se rvi ce
© 2 0 1 1 sn o m t e ch n o l o g y AG
© 2 0 1 1 sn o m t e c hnology AG
Au t h o r: Al e xa n d e r F e l d t , C h ri st i a n N i e mczi k
Au t h o r: Al e xa n d e r F e l d t , C h ri st i an Niemczik
sn o mEsse n t i a l s - ST 3 1 4 : Au t o Pro vi si o n i n g Redirection
Page 19
How to manage redirections
‣
snom offers a free python script to manage
redirections via XML RPC:
‣
http://www.snom.com/uploads/docu/example.py
‣
A .NET based implementation of a GUI for Windows
is available for licensing, also ready for OCS
‣
http://snomtastic.codeplex.com/
‣
A full web-based configuration tool will be offered by
snom soon
19
snomIPP - ST314: Auto Provisioning via snom’s Redirection Service
© 2011 snom technology AG
Author: Alexander Feldt , Christian Niemczik
Page 20
Auto Provisioning
‣
Thank you for attending this introduction course
“Auto Provisioning via snom’s redirection service”.
We hope you enjoyed it and recommend to continue
with the next course:
Server & XML Structure
See you there… Your snom Training Team
20
snomIPP - ST314: Auto Provisioning via snom’s Redirection Service
Author: Alexander Feldt , Christian Niemczik
© 2011 snom technology AG