Differenze tra le versioni di "AdminGuide:Service:AutoProvisioning/en"
(Creata pagina con "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 t...") |
(Creata pagina con "==List of device models== miniatura This page contains the list of all models defined on KalliopePBX. Some models are distributed with t...") |
||
Riga 191: | Riga 191: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! | ! Parameter!! Description!! Value | ||
|- | |- | ||
|colspan="3"| <div style = 'text-align: center; color: transparent> - | |colspan="3"| <div style = 'text-align: center; color: transparent> - | ||
|- | |- | ||
| | | Device brand || Brand of the device for which the redirection server is being defined || Snom / Yealink / Escene | ||
|- | |- | ||
!colspan="3"| <div style = 'text-align: left> ''''' | !colspan="3"| <div style = 'text-align: left> '''''Credentials''''' | ||
|- | |- | ||
| Username|| | | Username||User for authentication on the manufacturer's RPS server || String | ||
|- | |- | ||
| Password|| Password | | Password|| Password for authentication on the manufacturer's RPS server || String | ||
|- | |- | ||
!colspan="3"| <div style = 'text-align: left> ''''' | !colspan="3"| <div style = 'text-align: left> '''''Settings''''' | ||
|- | |- | ||
| | | Enabled || Allows you to disable the redirection server without losing its configuration || Yes / No | ||
|- | |- | ||
| | | Name|| Name of the redirection server to be created (if SNOM) or to be used (in the case of Yealink / Escene) || String | ||
|- | |- | ||
| | | Provisioning address|| In the case SNOM URL to which the redirection is made. (example: https://192.168.0.100/provisioning/ ) || String | ||
|} | |} | ||
Versione delle 14:13, 20 set 2022
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
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.
Parameter | Description | Value |
---|---|---|
-
| ||
Device brand | Brand of the device for which the redirection server is being defined | Snom / Yealink / Escene |
Credentials
| ||
Username | User for authentication on the manufacturer's RPS server | String |
Password | Password for authentication on the manufacturer's RPS server | String |
Settings
| ||
Enabled | Allows you to disable the redirection server without losing its configuration | Yes / No |
Name | Name of the redirection server to be created (if SNOM) or to be used (in the case of Yealink / Escene) | String |
Provisioning address | In the case SNOM URL to which the redirection is made. (example: https://192.168.0.100/provisioning/ ) | String |
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).