AdminGuide:Service:AutoProvisioning/en

Return to AdminGuide:Service

Description

The Auto Provisioning service generates the configuration file necessary for the correct operation of a device and transfers them to your phones. This file also contains information on the account and extension linked to the phone.

Configuration

This section collects all the configurations needed to perform auto-provisioning of a telephone device. You can also consult the list built-in devices for auto-provisioning

Device list

This page contains the list of all devices for which provisioning file generation has been configured.

The following table lists the configurable parameters for each device.

Parameter	Description	Value
-
Enabled	Allows you to disable the generation of the provisioning file associated with the device	Yes / No
Device model
Brand	List of manufacturers for which at least one device model has been defined	Brand
Model	List of devices associated with the selected manufacturer	Model
Template	List of templates associated with the selected template	Template
Redirection Server
Redirection Server for provisioning	List of redirection servers defined for the selected manufacturer	Redirection Server
Provisioned on the redirection server	Read-only field indicates whether the provisiong on the redirection server was successful	Yes / No
Device configuration
MAC Address	MAC address of the device (formats that are accepted AABBCCDDEEFF, AA:BB:CC:DD:EE:FF, AA-BB-CC-DD-EE-FF)	MAC Address
Notes	Free field containing annotations about the device	String
Enable DHCP	Set the placeholder value %%IPADDRMODE%% to on/off for this device. The placeholder may be used in the template to generate the configuration file with the with the required network settings.	Si / No
IP Address	Set the placeholder value %%IPADDR%% for this device. The placeholder may be used in the template to generate the configuration file with the required network settings.	IP Address
Subnetwork mask	Set the placeholder value %%IPNETMASK%% for this device. The placeholder may be used in the template to generate the configuration file with the required network settings.	Subnet Mask
Gateway	Set the placeholder value %%IPGATEWAY%% for this device. The placeholder may be used in the template to generate the configuration file with the required network settings.	IP Address
DNS1	Set the placeholder value %%IPDNS1%% for this device. The placeholder may be used in the template to generate the configuration file with the required network settings.	IP Address
DNS2	Set the placeholder value %%IPDNS2%% for this device. he placeholder may be used in the template to generate the configuration file with the required network settings.	IP Address
Username	Set the placeholder value %%PHONEUSERNAME%% for this device. The placeholder may be used in the template to set the phone login credentials. This same value will be used by KalliopePBX to drive the phone when a KalliopeCTI PRO application is associated with the device.	String
Password	Set the placeholder value %%PHONEPASSWORD%% for this device. The placeholder may be used in the template to set the phone login credentials. This same value will be used by KalliopePBX to drive the phone when a KalliopeCTI PRO application is associated with the device.	String
Remote control
Address	If defined, specifies the IP address at which the phone's web interface can be reached (by the PBX) (in HTTP) in order to perform remote control (via the KalliopeCTI Pro application) If empty, the PBX will use the IP address from which the account associated with this device is registered at the SIP level	IP Address
Port	Same as the previous field, but related to the port on which the phone web interface is visible by the PBX.	Integer (range 1-65535)
Device user
Account	Account and internal correspondent associated with the device (dynamic placeholders are calculated from this association). If the account is not associated the configuration file is not generated and the device is entered as Disabled.	Account

Template list

This page shows the list of templates on the KalliopePBX.

It is necessary to select a template for each phone model for which you wish to generate a provisioning file.

Parameter	Description	Value
-
Name	Template name	String
Device brand	List of manufacturers for which at least one device model has been defined	Brand
Device model	List of devices associated with the selected manufacturer	Model
Template content
Template	This free field should contain the template to be used for generating the provisioning file	Text

List of device models

This page contains the list of all models defined on KalliopePBX. Some models are distributed with the KalliopePBX firmware, while more can be added in order to generate configuration files for models that are not explicitly supported.

You can also specify rules to create provisioning files with arbitrary names. The filename can be composed of a prefix, a MAC address (in several formats) and a suffix.

The following table lists the configurable parameters for each model.

Parameter	Description	Value
-
Name	Device model name	String
Device brand
Choose Brand	Allows you to select an existing brand or create a new one by selecting New Brand	Brand
Brand name	In the case of New Brand contains the name to be associated with it	String
-
Name	Device model name	String
Device brand
Choose Brand	Allows you to select an existing brand or create a new one by selecting New Brand	Brand
Brand name	In the case of New Brand contains the name to be associated with it	String
Provisioning file name generation rule
Choose rule	Allows you to select an existing rule or create a new one by selecting the New Rule item	Brand
Rule name	In the case of New Rule contains the name to be associated	String
Prefix	Prefix to add to file name	String
MAC address format	Allows you to select the format of the MAC address to be included in the filename from a list	MAC Address Format
Suffix	Suffix to be added to file name	String

Custom placeholder list

This page shows the list of all placeholders specified by the user along with the default ones. Custom placeholders are formatted as %%_PLACEHOLDER%% and can be used inside a template.

You can create two types of placeholder:

• Static: used in order not to have to edit all templates which contain a specific value.
• Dynamic: used to dynamically update certain values associated to the KalliopePBX and not the specific user. For the time being, the only available dynamic placeholders are the ones relating to the IP addresses associated to the different network interfaces/VLANs.

Parmeter	Description	Value
-
Placeholder	Placeholder identifier. The placeholder to be used is %%_PLACEHOLDER%%	String
Type	Allows you to define the type of placeholder	Static/dynamic
In the case of static placeholder the value to be replaced in generation is entered, in the case of dynamic placeholder the attribute of the KPBX to be used for replacement.	String / KPBX Attribute

List of redirection servers

File:List Redirection Servers.png

This panel contains the list of all user-configured redirection servers on the KPBX. Currently, integration with redirection servers from the following manufacturers is supported:

• SNOM (https://sraps.snom.com/)
• Yealink (https://ymcs.yealink.com/)

N.B.:: Due to limitations of the APIs provided by Yealink/Escene, the configuration procedure is different when using the SNOM redirection server. Specifically, for Yealink/Escene, it is necessary to preemptively specify a server by accessing the RPS service web GUI. Its name will be referred to during the redirection server configuration phase.

Parametro	Descrizione	Valore
-
Marca del dispositivo	Marca del dispositivo per cui si sta definendo il redirection server	Snom / Yealink / Escene
Credenziali
Username	Utente per l’autenticazione sul server RPS del produttore	Stringa
Password	Password per l’autenticazione sul server RPS del produttore	Stringa
Impostazioni
Abilitato	Consente di disabilitare il redirection server senza perderne la configurazione	Si / No
Nome	Nome del redirection server da creare (se SNOM) o da utilizzare (nel caso Yealink / Escene)	Stringa
Indirizzo di provisioning	Nel caso SNOM URL a cui viene effettuata la redirezione (ad es. https://192.168.0.100/provisioning/ )	Stringa

Template

La generazione del file di configurazione per uno specifico dispositivo viene effettuata a partire da un template associato alla marca/modello di telefono che si intende utilizzare.

Il formato del template dipende dalla marca/modello del telefono utilizzato ma anche eventualmente dalla versione del firmware installata sul dispositivo.

Nella definizione del template è possibile utilizzare dei placeholder che il KalliopePBX sostituirà automaticamente in fase di generazione del file.
Questi placeholder includono:

• Attributi del KalliopePBX (ad es. porta SIP UDP/TCP del centralino)
• Attributi dell’account/interno associato al telefono (ad es. credenziali SIP, nome, cognome, etc.)
• Attributi del telefono (ad es. parametri di rete, credenziali di accesso, etc.)
  

Once the template has been defined, you must specify the MAC address of the device and the account/extensions you wish to link it to.

Once a file has been generated, it must be transferred to the phone. KalliopePBX provides the following file transfer protocols:

• TFTP: files are available directly in the root of the TFTP server for single-tenant KalliopePBX. For multitenant KalliopePBX, you must add the Tenant UUID to the path (e.g. <tenant_uuid>/snom370-0004167898B1.htm).
• HTTP / HTTPS: the files are published on http(s)://<ip_address>/provisioning/ for single-tenant KalliopePBX. For multitenant KalliopePBX, you must add the Tenant UUID to the path (e.g. http(s)://<ip_address>/provisioning/<tenant_uuid>/).

All generated files are also visible in the File Manager.

Per indicare al telefono quale protocollo deve essere utilizzato per scaricare il file di configurazione oltre all’indirizzo IP (ed eventuale path) del server di provisioning esistono diverse modalità la cui configurazione e ordine di esecuzione dipende dal modello di telefono utilizzato. Le modalità comunemente disponibili sono le seguenti:

• SIP PnP: il telefono all’avvio invia un messaggio SIP SUBSCRIBE ad un indirizzo multicast. Se sul KalliopePBX il servizio SIP PnP è abilitato il PBX risponde con una SIP NOTIFY contenente l’IP address del TFTP server da utilizzare. Questa modalità non è utilizzabile nel caso di KalliopePBX multitenant.
• Redirection Server: il telefono all’avvio prova a contattare il Redirection Server del produttore. Se il MAC Address del telefono è stato inserito il telefono viene rediretto al server indicato per il download del file di configurazione. In questa modalità è possibile utilizzare uno qualsiasi dei protocolli disponibili (in base al parametro configurato sul redirection server).
• DHCP OPTION 66: nel caso in cui in fase di assegnazione dell’indirizzo IP il DHCP Server comunichi al telefono anche la DHCP Option 66 contenente l’URL da contattare (incluso il protocollo da utilizzare), il telefono utilizzerà questa informazione per effettuare il download del file di configurazione.
• Manuale: è possibile avviare la configurazione anche manualmente dal telefono o dalla WEB GUI inserendo il protocollo da utilizzare e l’IP address (oltre eventualmente al path).