AdminGuide:Service:AutoProvisioning

Altre lingue:

English
italiano

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.

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.

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

Return to AdminGuide:Service

Lista dei modelli di dispositivo

Questo pannello contiene l’elenco di tutti i modelli di dispositivo definiti sul KPBX. Alcuni modelli di dispositivo sono distribuiti con il firmware del KPBX. Altri modelli possono essere aggiunti dall’utente per generare file di configurazione per modelli/produttori non esplicitamente supportati.

E’ inoltre possibile definire delle regole che consentono di creare dei file di provisioning con nomi arbitrari. Il nome del file può essere composto da un prefisso, indirizzo MAC (in diversi formati) e un suffisso.

The following table lists the configurable parameters for each model.

Parametro	Descrizione	Valore
-
Nome	Nome del modello di dispositivo	Stringa
Marca del dispositivo
Scegli Marca	Consente di selezionare una marca esistente o crearne una nuova selezionando la voce Nuova Marca	Marca
Nome Marca	Nel caso di Nuova Marca contiene il nome da associare	Stringa
-
Nome	Nome del modello di dispositivo	Stringa
Marca del dispositivo
Scegli Marca	Consente di selezionare una marca esistente o crearne una nuova selezionando la voce Nuova Marca	Marca
Nome Marca	Nel caso di Nuova Marca contiene il nome da associare	Stringa
Regola di generazione del nome del file di provisioning
Scegli regola	Consente di selezionare una regola esistente o crearne una nuova selezionando la voce Nuova Regola	Marca
Nome regola	Nel caso di Nuova Regola contiene il nome da associare	Stringa
Prefisso	Prefisso da aggiungere al nome file	Stringa
Formato indirizzo MAC	Consente di selezionare il formato del MAC address da inserire nel nome file da una lista	Formato MAC Address
Suffisso	Suffisso da aggiungere al nome file	Stringa

Lista dei placeholder personalizzati

Questo pannello contiene l’elenco di tutti i placeholder definiti dall’utente sul KPBX in aggiunti a quelli presenti di default. I placeholder custom hanno un formato del tipo %%_PLACEHOLDER%% e possono essere utilizzati all’interno dei template.

E’ possibile definire due tipi di placeholder:

Statico: viene utilizzato per non modificare tutti i template in cui viene utilizzato uno specifico valore.
Dinamico: viene utilizzato per aggiornare dinamicamente alcuni valori associati al KPBX e non allo specifico utente. In questo momento gli unici placeholder dinamici disponibili sono quelli relativi agli IP address associati alle diverse interfacce di rete / VLAN.

Parametro	Descrizione	Valore
-
Placeholder	Identificativo del placeholder. Il placeholder da utilizzare è %%_PLACEHOLDER%%	Stringa
Tipo	Consente di definire il tipo di placeholder	Statico/dinamico
Valore	Nel caso di placeholder statico viene inserito il valore da sostituire in generazione, nel caso di placeholder dinamico l’attributo del KPBX da utilizzare per la sostituzione.	Stringa / Attributo KPBX

Lista dei redirection server

Questo pannello contiene l’elenco di tutti i redirection server configurati dall’utente sul KPBX. Attualmente è supportata l’integrazione con i redirection server dei seguenti produttori:

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

Nota: In virtù di alcune limitazioni delle API messe a disposizione da Yealink / Escene la procedura di configurazione è differente nel caso di utilizzo del redirection server SNOM rispetto a quello degli altri due produttori. In particolare, nel caso di Yealink / Escene è necessario definire preventivamente un server accedendo alla WEB GUI di gestione del servizio RPS. Il nome di questo server verrà riferito in fase di configurazione del redirection server.

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.