Differenze tra le versioni di "AdminGuide:BasicConcepts:Extensions and SIP accounts"

Da Kalliope Wiki.
Jump to navigation Jump to search
(Creata pagina con "en:AdminGuide:BasicConcepts:Extensions and SIP accounts <div style="float: right">__TOC__</div> = Extensions and SIP Accounts = The '''Extensions''' are the primary tel...")
 
 
(26 versioni intermedie di 4 utenti non mostrate)
Riga 1: Riga 1:
<languages />
<translate>
<!--T:1-->
[[en:AdminGuide:BasicConcepts:Extensions and SIP accounts]]
[[en:AdminGuide:BasicConcepts:Extensions and SIP accounts]]
<div style="float: right">__TOC__</div>
Torna a [[AdminGuide:BasicConcepts]]
{{#evu:https://vimeo.com/806304997
|alignment=right|dimensions=305
}}
<!--T:2-->
<!--
;Related WEB GUI panels:
: [[AdminGuide:GUI:Operation_Menu:PBX:Extensions and Accounts|AdminGuide:GUI:Operation_Menu:PBX:Extensions and Accounts]]
: [[AdminGuide:GUI:Operation_Menu:PBX:Edit Extension|AdminGuide:GUI:Operation_Menu:PBX:Edit Extension]]
: [[AdminGuide:GUI:Operation_Menu:PBX:Edit Extension Template|AdminGuide:GUI:Operation_Menu:PBX:Edit Extension Template]]
: [[AdminGuide:GUI:Operation_Menu:PBX:Edit Account|AdminGuide:GUI:Operation_Menu:PBX:Edit Account]]
: [[AdminGuide:GUI:Operation_Menu:PBX:Edit Account Template|AdminGuide:GUI:Operation_Menu:PBX:Edit Account Template]]
-->
== Interni e account SIP == <!--T:3-->
<!--T:4-->
Gli '''interni''' sono le principali entità telefoniche. Un interno è un'entità '''logica''' associata ad un '''numero''' che viene usato come identificativo per tutte le chiamate effettuate dall'interno ed è il numero digitato da chi vuole contattare l'interno. Ogni interno ha alcuni '''attributi''' che ne definiscono i permessi (per le chiamate uscenti dall'interno) e il comportamento (per chiamante entranti all'interno), insieme a certe informazioni identificative (nome e cognome, ente, ecc.).
<!--T:5-->
Gli '''account SIP''' sono entità di "servizio" e consistono delle credenziali (username e secret) che devono essere configurate su un terminale SIP (hardphone o softphone) per l'autenticazione sul PBX. L'autenticazione è effettuata dai dispositivo con due procedure: "registrazione SIP" e l'esecuzione di una nuova chiamata.
<!--T:6-->
Il rapporto fra gli '''interni''' e gli '''account SIP''' è '''uno a molti''': ogni interno può essere associato a più di un account SIP, che si comorteranno tutto come un'unica entità telefonica per quanto riguarda identità, presentazione, permessi, ecc.


<div style="float: right">__TOC__</div>
<!--T:7-->
È anche possibile creare un '''utente''' unico per ciascun '''interno'''; a questi utenti si possono assegnare permessi e ruoli diversi per permettergli di accedere alla propria pagina web personale, eseguire certe mansioni di amministrazione o di configurazione, utilizzare le applicazione KalliopeCTI (Desktop o Mobile) e invocare le API REST disponibili. Per ulteriori dettagli, vedere la pagina su [[AdminGuide:BasicConcepts:Users and roles|utenti e ruoli]].
 
== Registrazione SIP e più dispositivi per interno == <!--T:8-->
La '''registrazione SIP''' fornisce al PBX le informazioni sull'attuale '''posizione''' dell'account SIP, cioè l'indirizzo IP e la porta (insieme al protocollo, per esempio  UDP, TCP, TLS o WebSocket) dove si può trovare l'account SIP quando il PBX deve mandargli un messaggio (per esempio un INVITE relativo ad una chiamata entrante). La registrazione è eseguita dal dispositivo durante l'attivazione (se l'account è configurato correttamente) e viene aggiornata periodicamente prima che ne scada la validità; ogni registrazione periodica richiede la ripetizione della procedura di autenticazione. Il tempo di validità della registrazione viene stabilito durante la procedura. Il dispositivo inserisce un valore di "Proposed Expiry" (in secondi, solitamente 3600 di default) nella richiesta REGISTER; se l'autenticazione ha successo, il PBX risponde con un messaggio "200 OK" che notifica l'effettivo tempo di registrazione al dispositivo, che quindi deve mandare una nuova registrazione prima della scadenza (solitamente questa registrazione viene effettuata quando è passato circa metà del tempo, per avere tempo di rimandarla in caso di fallimenti). Se il timeout di registrazione scade senza che la registrazione sia aggiornata, la posizione dell'account viene scartata dal PBX e le chiamate destinate a quell'account falliranno perché il dispositivo risulterà "non disponibile".
 
<!--T:9-->
KalliopePBX salva un''''unica posizione''' per ogni account SIP configurato; se lo stesso account SIP è configurato su più dispositivi attivi contemporaneamente, i messaggi periodici di registrazione mandati di ciascun dispositivo cambieranno ripetutamente la posizione salvata sul KalliopePBX. Una chiamata destinata all'account SIP verrà quindi presentata '''solo''' al dispositivo che ha eseguito la registrazione per ultimo. È però possibile avere '''più dispositivi''' che si comportano come un '''unico interno''' definendo '''un''' account SIP per '''ogni''' dispositivo desiderato e associando ciascuno di essi allo stesso interno.
 
== Attributi e template degli interni == <!--T:10-->
Ogni interno ha il proprio insieme di attributi che ne descrivono l'identità e il comportamento telefonico. Alcuni attributi sono specifici per ciascun dispositivo e devono essere configurati individualmente, mentre altri possono essere in comune ad un sottoinsieme di interni. I primi includono il numero di interno stesso (che deve essere unico nel PBX, o in ciascun tenant in sistemi multi-tenant) e dettagli personali come nome e cognome, indirizzo e-mail, e il codice PIN personale usato per l'autenticazione per accedere certi servizi del PBX. I secondi includono limiti e permessi di chiamata e le azioni di trabocco da eseguire  quando una chiamata all'interno fallisce, che dipendono dall'origine della chiamata e dalla causa del fallimento.
 
<!--T:11-->
Per facilitare la gestione di questi attributi comuni, KalliopePBX introduce il concetto di '''template di interno''': un insieme di attributi e impostazioni che possono essere assegnati a più interni. Definendo più di un template (con diverse impostazioni per ogni ''tipo'' di interno), si può ridurre il numero di impostazioni da specificare per ciascun interno e permette di modificare facilmente la stessa impostazione per ogni interno che condivide lo stesso template semplicemente modificando il valore dell'impostazione ne relativo template.
 
<!--T:12-->
Nel pannello di configurazione per ogni interno si può sovrascrivere qualunque impostazione ereditata dal template se è necessaria un'eccezione. Le impostazioni sovrascritte non cambiano quando viene modificato il template.
 
== Attributi degli account SIP == <!--T:13-->
Come gli interni, gli account SIP hanno attributi specifici (principalmente lo username, che deve essere unico nel PBX, e il SIP secret) e attributi che possono essere comuni ad una "classe" di account. Questi includono i protocolli di trasporto, emdia e codec supportati, l'ACL autorizzato, e altri; some per gli interni, si possono usare template di account SIP con impostazioni comuni.
 
 
== Configurazione Interni == <!--T:14-->
[[File:PBX, interni e account.png|destra|300px]]
[[File:Pagina Interni.png|miniatura]]
Nel pannello interni sono definiti gli attributi associati ad un utente che utilizza i servizi messi a disposizione dal KalliopePBX. L’attributo principale che identifica l’utente è l’interno telefonico (Telephone Extension).
Nel caso in cui più apparati (Account) siano associati allo stesso utente questi condivideranno l’identità telefonica definita in questo pannello.
Questo significa ad esempio che le chiamate verso l’interno telefonico saranno presentate a tutti gli apparati associati all’utente e che le chiamate effettuate da qualsiasi apparato dell’utente presenteranno la stessa identità telefonica.
 
<!--T:15-->
Per configurare gli interni basta aprire il menu operativo e cliccare su PBX > Interni e Account. <br>
Per creare un nuovo interno procedere cliccando su "Aggiungi interno".
 
<!--T:16-->
* '''Abilitato''': Consente di disabilitare un interno senza perderne la configurazione
* '''Interno''': Indica il numero telefonico interno al PBX al quale è possibile contattare l’utente
* '''Nome''': Utilizzato per costruire il Display Name visualizzato dai telefoni e per la pubblicazione dell’utente in rubrica
* '''Cognome''': Utilizzato per costruire il Display Name visualizzato dai telefoni e per la pubblicazione dell’utente in rubrica.
* '''Indirizzo e-mail''': Indirizzo e-mail utilizzato per la pubblicazione dell’utente in rubrica
* '''Numero mobile''': Numero telefonico utilizzato per la pubblicazione nella rubrica interni e per i servizi [[AdminGuide:Service:Fork2Mobile|Fork2Mobile]] e [[AdminGuide:Service:FastTransfer|FastTransfer]]
* '''PIN dei serivizi''': Codice da utilizzare per l’accesso ai servizi telefonici che possono richiedere autenticazione ([[AdminGuide:Service:Voicemail|casella vocale]], [[AdminGuide:Service:ChecktimeAndSwitches#Configurazione_degli_interruttori|interruttori]], [[AdminGuide:Service:Paging|paging]], [[AdminGuide:Service:ElectronicLock|lucchetto elettronico]])
 
===Account=== <!--T:26-->
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Account'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Aggiungi account esistente || Consente di associare all'interno uno o più account SIP precedentemente creati || Account
|-
| Crea account || Consente di  creare un nuovo account SIP da associare all'interno || Account
|}
===Casella vocale===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Casella vocale'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Crea casella vocale || Consente di creare la casella vocale dell’interno || Si / No
|-
| Indirizzo e-mail || Indica l’indirizzo e-mail da utilizzare per ricevere le e-mail di notifica ricezione messaggi in casella vocale con opzionalmente allegati i file audio contenenti i messaggi registrati. || xxxxx@dominio.yy
|-
| Notifica nuovi messaggi in casella vocale tramite email || Se questa opzione è abilitata viene inviata via e-mail la notifica di ricezione di un messaggio in casella vocale || Si / No
|-
| Inoltra i messaggi vocali come allegati || Se questa opzione è abilitata viene allegato all'e-mail il file audio contenente il messaggio registrato  || Si / No
|-
| Cancella da Kalliope i messaggi vocali inoltrati || Se questa opzione è abilitata una volta effettuato l’invio via e-mail le registrazioni vengono cancellate dal KalliopePBX e non saranno quindi più accessibili da telefono o dall'app KalliopeCTI Mobile  || Si / No
|-
| Abilitato || Consente di abilitare o disabilitare la casella vocale senza perderne la configurazione <br> ed i messaggi ricevuti || Si / No
|}
===Impostazioni utente locale===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Impostazioni utente locale'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Crea utente locale || Consente di creare un utente locale sul KalliopePBX nel caso in cui sia necessario abilitare l’accesso GUI o CTI || Si / No
|-
| Abilita accesso GUI || Abilita l'accesso utente alla WEB GUI con [[AdminGuide:BasicConcepts:Users_and_roles#Ruoli|ruolo]] standard Utente di Tenant. Il ruolo associato all'utente può essere modificato nel pannello [[AdminGuide:BasicConcepts:Users_and_roles#Utentit|Gestione utenti]] || Si / No
|-
| Abilita accesso CTI || Abilita l’utente ad utilizzare i client KalliopeCTI. Nel caso in cui sia richiesta la modalità di utilizzo KalliopeCTI PRO o KalliopeCTI PHONE è necessario assegnare la [[AdminGuide:BasicConcepts:Licenses|licenza]] all'utente nel pannello [[AdminGuide:BasicConcepts:Users_and_roles#Utenti|Gestione utenti]]  ||Si / No
|-
| Nome utente || Nome utente da utilizzare per il login della GUI o dei [[KalliopeCTI|client CTI]] || Alfa-numerico
|-
| Password || Password da utilizzare per il login della GUI o dei client CTI || Alfa-numerico
|}
===Template===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Template'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Template dell’interno ||Indica il [[Template |template]] contenente i parametri di default da utilizzare per la tipologia di interno prescelta. Tutti gli attributi successivamente presenti nel pannello importano i valori di default ma è possibile sovrascriverli se necessario || [[Template Interni |Template Interni]]
|}
 
===Rubrica telefonica=== <!--T:27-->
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Rubrica telefonica'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Mostra nella rubrica locale || Abilita o disabilita la visualizzazione dell’interno nella rubrica degli interni|| Si / No
|-
| Modalità di pubblicazione LDAP || Indica la modalità di pubblicazione dell’interno in LDAP tra le varie opzioni disponibili. La regola di pubblicazione LDAP generale è definita nel pannello Impostazioni LDAP
|| Disabilitato / Regola pubblicazione LDAP /<br> Presentando il  numero sottoindicato / <br>Regola di pubblicazione LDAP applicata<br> all'interno sottoindicato
|-
| Interno LDAP personalizzato || Interno su cui viene applicata la regola di pubblicazione LDAP. Questo campo viene visualizzato solo se l’opzione ''Regola di pubblicazione LDAP applicata all’interno sottoindicato'' è selezionata
|| Numerico
|-
| Numero LDAP personalizzato || Numero telefonico associato all’utente nella rubrica LDAP. Questo campo viene visualizzato solo se l’opzione ''Presentando il numero sottoindicato'' è selezionata
|| Numerico
|-
| Ente || Utilizzato nella pubblicazione in rubrica (corrisponde all’attributo ''organization'' nella pubblicazione sulla rubrica LDAP)  || Alfa-numerico
|-
| Reparto || Utilizzato nella pubblicazione in rubrica (corrisponde all'attributo ''organizationUnit'' nella pubblicazione sulla rubrica LDAP). E' il reparto di riferimento dell’interno || Alfa-numerico
|}
===Classi di servizio===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Classi di servizio '''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Classe di instradamento in uscita standard  || Indica la [[AdminGuide:Service:OutboundRouting|classe di instradamento]] associata all'utente quando il lucchetto elettronico è sbloccato. Nel caso in cui la modalità di sblocco del lucchetto elettronico sia impostata ad Aperto questa è la classe applicata a tutte le chiamate. || Classi di instradamento in uscita
|-
| Classe di instradamento in uscita ristretta || Indica la classe di instradamento associata all’utente quando il lucchetto elettronico è bloccato. Nel caso in cui la modalità di sblocco del lucchetto elettronico sia impostata ad Aperto questa classe non viene mai utilizzata. || Classi di instradamento in uscita
|}
===Limiti===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Limiti'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Limite chiamate contemporanee || Numero massimo di chiamate contemporanee (in ingresso e in uscita) su tutti gli account associati all'interno ammesse per l’interno. Impostare questo limite ad 1 impedisce all'interno di utilizzare servizi quali il trasferimento con offerta poiché la chiamata in attesa di essere trasferita risulta comunque come chiamata attiva. || Numerico (0 = nessun limite)
|-
| Livello di occupato || Numero di chiamate su tutti gli account associati all'interno a partire dal quale l’utente viene considerato occupato (il PBX quindi non presenta la chiamata ai dispositivi ma risponde con il SIP Message 486 Busy Here). Impostare questo limite ad 1 nel caso di singolo account blocca le notifiche di chiamate in ingresso sul telefono anche se il Call Waiting è abilitato sull'apparato  || Numerico (0 = nessun limite)
|}
===Lucchetto elettronico===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Lucchetto elettronico'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Modalità di sblocco || Consente di scegliere la modalità di sblocco per l’interno.
 
<!--T:17-->
''Aperto'' – Il lucchetto elettronico è sempre sbloccato
 
<!--T:18-->
''Codice'' – Il lucchetto elettronico può essere sbloccato con il codice di sblocco definito nel piano di numerazione
 
<!--T:19-->
''Password'' - Il lucchetto elettronico può essere sbloccato utilizzando il codice di sblocco e digitando successivamente il PIN dei servizi  per l’interno
|| Aperto / Codice / Password
|-
| Politica di sblocco || Consente di scegliere la politica di sblocco per l’interno.
 
<!--T:20-->
''Per chiamata'' – Il lucchetto deve essere sbloccato prima di effettuare ogni chiamata


= Extensions and SIP Accounts =
<!--T:21-->
''Blocca automaticamente dopo il numero di minuti sottoindicato'' – Il lucchetto viene bloccato automaticamente allo scadere dell’intervallo indicato


The '''Extensions''' are the primary telephony entities. An Extension is a '''logical''' entity identified by its '''number''', which is used as the identity for all the calls performed by the extension, and that is usually dialed by other users to contact the extension. Each extension has a number of '''attributes''' which define its permissions (e.g. for outgoing calls from the extension) and behaviour (e.g. for incoming calls to the extension), as well as a few
''Sbloccato finché l’utente lo blocca nuovamente'' – Il lucchetto una volta sbloccato deve essere bloccato esplicitamente dall'utente
identity records (e.g. first and last name of the person to whom the extenion is assigned, its organizational unit, and so on).
|| Per chiamata / Blocca automaticamente dopo il numero di minuti sottoindicato /<br> Sbloccato finché l’utente lo blocca nuovamente
|-
| Durata dello sblocco (sec.) || Tempo dopo il quale l’interno viene bloccato. Applicabile solo se la politica di sblocco è ''Blocca automaticamente dopo il numero di minuti sottoindicato'' || Numerico
|}
===Prelievo di chiamata di gruppo=== <!--T:22-->
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''[[AdminGuide:Service:Group Call Pickup|Prelievo di chiamata di gruppo]]'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Gruppi di appartenenza ||Elenco dei gruppi autorizzati a prelevare le chiamate dirette all’interno (le chiamate dirette a questo interno possono essere prelevate da tutti gli interni con autorizzazione al prelievo su uno di questi gruppi). || Gruppo di prelievo
|-
| Autorizzazione al prelievo || Elenco dei gruppi su cui l’interno è autorizzato a prelevare chiamate (l’interno può prelevare le chiamate dirette ad interni che hanno tra i gruppi di appartenenza un gruppo su cui l’interno è autorizzato al prelievo) || Gruppo di prelievo
|}
===Trabocchi===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Trabocchi'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Interno || colspan="2" |Azione di trabocco su chiamate provenienti da un interno (anche remoto)
|-
| Esterno || colspan="2" | Azione di trabocco sulle chiamate provenienti dall’esterno
|-
| Trasferimento || colspan="2" | Azione di trabocco sui trasferimenti di chiamata
|-
| Timeout (sec.) || Tempo alla scadenza del quale viene eseguita l’azione di trabocco configurata  in caso di nessuna risposta || Numerico
|-
| Nessuna risposta || La chiamata è considerata senza risposta alla scadenza del timeout  || rowspan="3"| Riaggancia / Selezione personalizzata /<br> Chiedi selezione / Numero esterno /<br> Interno / Gruppo / Coda / Controllo orario /<br> IVR / Casella vocale / Stanza MeetMe
|-
| Occupato || L’interno è considerato occupato se è stato raggiunto il Busy Level impostato per l’interno oppure se il terminale invia il SIP Response 486 Busy Here
|-
| Non disponibile || L’interno è considerato non disponibile se il terminale non è registrato o non è raggiungibile a livello IP oppure se il terminale invia il SIP Response 480 Temporarily Unavailable
|}


The '''SIP accounts''' are "service" entities, and can be seen just as the credentials (username and secret) that needs to be configured on a SIP terminal (hardphone or softphone) to allow it to authenticate to the PBX. Authentication is performed by the devices mainly in two procedures, which are the "SIP registration" and the execution of a new call.


The relationship between '''Extension''' and '''SIP account''' entities is '''1-to-many''', meaning that each Extension can have multiple associated SIP accounts which all behave as the '''same telephone entity''', in terms of identity, presentation, permissions, etc. .
== Configurazione Account == <!--T:23-->
[[File:PBX, interni e account.png|destra|300px]]
[[File:Nuovo_account_sip.png|miniatura]]


== SIP Registration and multiple device per Extension ==
<!--T:28-->
'''SIP registration''' informs the PBX of the current '''location''' of a SIP account, i.e. the IP address and port (plus the protocol, e.g. UDP, TCP, TLS or WebSocket) where the SIP account can be reached (when the PBX needs to send a message - i.e. an INVITE related to an incoming call - to that account). Registration is performed by the device at boot time (if the account is correctly configured) and then refreshed periodically, before its validity expires; each periodic registration requires the repetition of the authentication procedure. The lifetime of the registration is established during the registration procedure itself. The device insert a "Proposed Expiry" value (in seconds, usually defaults to 3600) in its REGISTER request; upon successful authentication, the PBX responds with a "200 OK" message which notifies the actual registration lifetime to the device, which then must ensure to send a new registration before the timeout expiration (usually this new registration is performed at about half time, to allow for retransmission in case of failures). If the registration timeout expires without the reception of a registration refresh, then the location of the account is discarded by the PBX and the calls destined to that account will fail with cause "unavailable".
Nel pannello Account sono definite le credenziali SIP utilizzabili  da un dispositivo per registrarsi ed effettuare / ricevere chiamate tramite il KalliopePBX.
A queste credenziali sono associati attributi per incrementare la sicurezza e modifiche del comportamento del KalliopePBX in termini di segnalazione e flussi audio da associare ad uno specifico dispositivo.
Questi attributi sono definiti a livello di account e non di interno perché due account associati allo stesso interno ma a dispositivi differenti possono avere requisiti differenti.
'''''Esempio''''': ad un interno posso associare un account utilizzato su un telefono fisico ed uno utilizzato su un softphone. Mentre per il telefono fisico posso utilizzare codec con maggior consumo di banda ad es. G711a per il softphone che viene utilizzato ad esempio in telelavoro posso scegliere di utilizzare codec quali il G729 che ottimizzano l’utilizzo della banda.


KalliopePBX keeps a '''single location''' for each configured SIP account; hence, if the same SIP account is configured on multiple devices, all active at the same time, the periodic registration messages from each of them continuously modify the location stored in KalliopePBX; a call destined to the SIP account is therefore presented '''only''' to the device which registered last. It is however possible to have '''multiple devices''' which behave as a '''single extension''', just by defining '''one''' SIP account for '''each''' of the desired devices, and associating all these SIP accounts to the same extension.
<!--T:24-->
Per configurare gli account basta aprire il menu operativo e cliccare su PBX > Interni e Account.
Per creare un nuovo account procedere cliccando su "Account" nella barra in alto e successivamente su "Aggiungi Account SIP"


== Extensions attributes and templates ==
<!--T:25-->
Each extension has its own set of attributes which describe its identity and its telephony behaviour. Some of these attributes are specific and has to be configured explicitly whereas some other can be common to all or a subset of extensions. The former ones include the extension number itself (which must be unique within the PBX - or within each tenant in case of a multi-tenant PBX) as well as the personal details, such as first and last name or e-mail address, but also the personal PIN code used for authentication when accessing some PBX services; the latter ones include, as an example, call limits and permissions, or the actions to be performed on a failed call destined to the extension based on the origin of the call and the cause of failure.
* '''Abilitato''': Consente di disabilitare un account senza perderne la configurazione
* '''KCTI Mobile App''': Consente di utilizzare questo account con l'app mobile KalliopeCTI abilitando l'invio dei messaggi push per la segnalazione delle chiamate
* '''Nome utente''': Username utilizzato per l’autenticazione SIP del dispositivo || Alfa-numerico
* '''Password''': Password utilizzata per l’autenticazione SIP del dispositivo || Alfa-numerico
* '''Template dell'account''': Indica il template account contenente i parametri di default da utilizzare per la tipologia di interno prescelta
* '''Abilita verifica di registrazione''': Quando questa opzione è abilitata il KalliopePBX verifica che la richiesta di setup di chiamata (SIP INVITE) provenga dallo stesso IP:porta da cui ha ricevuto la richiesta di registrazione (SIP REGISTER)
* '''Indirizzo abilitato''': Indica l’indirizzo ip o la subnet da cui il KalliopePBX accetta richieste di registrazione e setup di chiamata 
* '''Maschera di sottorete abilitata''': Completa l’informazione della ACL su base IP per le richieste di registrazione e setup di chiamata
* '''Abilita NAT''': Quando questa opzione è abilitata il KalliopePBX ignora gli indirizzi IP presenti negli header SIP e SDP e risponde sempre all'indirizzo IP e porta da cui ha ricevuto la richiesta . Questa opzione deve essere abilitata solo per dispositivi si trovano dietro un NAT rispetto al KalliopePBX e che non risolvono il problema dell’attraversamento NAT (tramite STUN / ICE / ALG SIP).
* '''Abilita direct media''': Questa opzione consente di instaurare dei flussi audio tra 2 PBX che si trovano in condizioni di visibilità diretta (no NAT). Se questa funzione  è abilitata i servizi che richiedono il monitoraggio del flusso RTP (ad es. registrazione chiamate, trasferimento di chiamata e parcheggio con codici di servizio del KalliopePBX) sono disabilitati.
* '''Abilita SRTP''': Questa opzione consente di abilitare il supporto alla cifratura dei flussi RTP. Poiché lo scambio delle chiavi avviene all’interno dei messaggi SIP / SDP in plaintext è opportuno utilizzare SRTP insieme alla cifratura della segnalazione mediante TLS. (vedi [[Configurazione TLS/SRTP]]) 


To ease the administration of such common attributes, KalliopePBX introduce the concept of '''extensions template''', which are a collection of attributes and settings that can be assigned to multiple extensions. Defining multiple templates (with different settings based on the ''type'' of the extensions) allows to reduce the number of settings which need to be specified for each single extension, and permits to quickly modify the same setting for all the extension which are based on the same template, just by changing the value of the setting in the related template.
===Impostazioni di outbound proxy=== <!--T:29-->
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Impostazioni di outbound proxy'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Indirizzo dell'outbound proxy || Consente di impostare l'indirizzo IP/hostname dell'outbound proxy da utilizzare || Alfa-numerico
|-
| Porta dell'outbound proxy || Consente di impostare la porta dell'outbound proxy da utilizzare || Numerico
|-
| Protocollo dell'outbound proxy || Consente di impostare il protocollo da utilizzare per comunicare con l'outbound proxy. È possibile impostare solamente protocolli abilitati nelle Impostazioni SIP  || UDP / TCP / TLS / WS / WSS
|}
===Impostazioni di trasporto===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Impostazioni di trasporto'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Abilita trasporto UDP || Consente di abilitare il protocollo di trasporto UDP per la segnalazione SIP. Questa opzione non è presente se il trasporto UDP non è abilitato nelle Impostazioni SIP || Si / No
|-
| Abilita trasporto TCP || Consente di abilitare il protocollo di trasporto TCP per la segnalazione SIP. Questa opzione non è presente se il trasporto TCP non è abilitato nelle Impostazioni SIP  || Si / No
|-
| Abilita trasporto TLS || Consente di abilitare il protocollo di trasporto TLS per la segnalazione SIP. Questa opzione non è presente se il trasporto TLS non è abilitato nelle Impostazioni SIP || Si / No
|-
| Abilita trasporto Web Socket|| Consente di abilitare il protocollo di trasporto Web Socket (HTTP) per la segnalazione SIP. Questa opzione non è presente se il trasporto Web Socket (HTTP)  non è abilitato nelle Impostazioni SIP|| Si / No
|-
| Abilita trasporto Web Socket sicuro || Consente di abilitare il protocollo di trasporto Web Socket sicuro (HTTPS) per la segnalazione SIP. Questa opzione non è presente se il trasporto Web Socket sicuro (HTTPS)  non è abilitato nelle Impostazioni SIP || Si / No
|}
===Codec audio===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Codec audio'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Aggiungi codec || In questa sezione è possibile selezionare e ordinare i codec audio utilizzabili dall'account (e che quindi verranno inseriti nella media description del protocollo SDP) || PCM a-law / G.722 / G.726 / G.729 /<br> GSM / Opus / PCM u-law
|}
===Codec video===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Codec video'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Aggiungi codec || In questa sezione è possibile selezionare e ordinare i codec video utilizzabili dall'account (e che quindi verranno inseriti nella media description del protocollo SDP) || H.261 / H.263 / H.263+ / H.264 /VP8
|}
===Interno===
{| class="wikitable" style="width:80%;"
!colspan="3"| <div style = 'text-align: left> '''''Interno'''''
|-
! <div style = 'text-align: left> '''Parametro''' !! <div style = 'text-align: left> '''Descrizione''' !! <div style = 'text-align: left> '''Valore'''
|-
| Interno || In questa sezione è possibile selezionare l'interno al quale associare l'account SIP || Interno
|}


In the configuration panel of each extension, it is possible to override any setting inherited by the associated template, if a specific exception is needed. The overridden settings are not affected by changes of the same settings in the template.


== SIP Accounts attributes ==
</translate>
Like the extensions, SIP accounts have some specific attributes (mainly the username - which must be unique within the PBX - and the SIP secret) and some other which may be common to a "class" of accounts. These include the supported transport protocols, media or codecs, the authorized ACL and others; SIP account templates can be used to define classes of SIP accounts with common settings, according to the same mechanism described for extensions.

Versione attuale delle 12:11, 9 mar 2023

Altre lingue:

Torna a AdminGuide:BasicConcepts



Interni e account SIP

Gli interni sono le principali entità telefoniche. Un interno è un'entità logica associata ad un numero che viene usato come identificativo per tutte le chiamate effettuate dall'interno ed è il numero digitato da chi vuole contattare l'interno. Ogni interno ha alcuni attributi che ne definiscono i permessi (per le chiamate uscenti dall'interno) e il comportamento (per chiamante entranti all'interno), insieme a certe informazioni identificative (nome e cognome, ente, ecc.).

Gli account SIP sono entità di "servizio" e consistono delle credenziali (username e secret) che devono essere configurate su un terminale SIP (hardphone o softphone) per l'autenticazione sul PBX. L'autenticazione è effettuata dai dispositivo con due procedure: "registrazione SIP" e l'esecuzione di una nuova chiamata.

Il rapporto fra gli interni e gli account SIP è uno a molti: ogni interno può essere associato a più di un account SIP, che si comorteranno tutto come un'unica entità telefonica per quanto riguarda identità, presentazione, permessi, ecc.

È anche possibile creare un utente unico per ciascun interno; a questi utenti si possono assegnare permessi e ruoli diversi per permettergli di accedere alla propria pagina web personale, eseguire certe mansioni di amministrazione o di configurazione, utilizzare le applicazione KalliopeCTI (Desktop o Mobile) e invocare le API REST disponibili. Per ulteriori dettagli, vedere la pagina su utenti e ruoli.

Registrazione SIP e più dispositivi per interno

La registrazione SIP fornisce al PBX le informazioni sull'attuale posizione dell'account SIP, cioè l'indirizzo IP e la porta (insieme al protocollo, per esempio UDP, TCP, TLS o WebSocket) dove si può trovare l'account SIP quando il PBX deve mandargli un messaggio (per esempio un INVITE relativo ad una chiamata entrante). La registrazione è eseguita dal dispositivo durante l'attivazione (se l'account è configurato correttamente) e viene aggiornata periodicamente prima che ne scada la validità; ogni registrazione periodica richiede la ripetizione della procedura di autenticazione. Il tempo di validità della registrazione viene stabilito durante la procedura. Il dispositivo inserisce un valore di "Proposed Expiry" (in secondi, solitamente 3600 di default) nella richiesta REGISTER; se l'autenticazione ha successo, il PBX risponde con un messaggio "200 OK" che notifica l'effettivo tempo di registrazione al dispositivo, che quindi deve mandare una nuova registrazione prima della scadenza (solitamente questa registrazione viene effettuata quando è passato circa metà del tempo, per avere tempo di rimandarla in caso di fallimenti). Se il timeout di registrazione scade senza che la registrazione sia aggiornata, la posizione dell'account viene scartata dal PBX e le chiamate destinate a quell'account falliranno perché il dispositivo risulterà "non disponibile".

KalliopePBX salva un'unica posizione per ogni account SIP configurato; se lo stesso account SIP è configurato su più dispositivi attivi contemporaneamente, i messaggi periodici di registrazione mandati di ciascun dispositivo cambieranno ripetutamente la posizione salvata sul KalliopePBX. Una chiamata destinata all'account SIP verrà quindi presentata solo al dispositivo che ha eseguito la registrazione per ultimo. È però possibile avere più dispositivi che si comportano come un unico interno definendo un account SIP per ogni dispositivo desiderato e associando ciascuno di essi allo stesso interno.

Attributi e template degli interni

Ogni interno ha il proprio insieme di attributi che ne descrivono l'identità e il comportamento telefonico. Alcuni attributi sono specifici per ciascun dispositivo e devono essere configurati individualmente, mentre altri possono essere in comune ad un sottoinsieme di interni. I primi includono il numero di interno stesso (che deve essere unico nel PBX, o in ciascun tenant in sistemi multi-tenant) e dettagli personali come nome e cognome, indirizzo e-mail, e il codice PIN personale usato per l'autenticazione per accedere certi servizi del PBX. I secondi includono limiti e permessi di chiamata e le azioni di trabocco da eseguire quando una chiamata all'interno fallisce, che dipendono dall'origine della chiamata e dalla causa del fallimento.

Per facilitare la gestione di questi attributi comuni, KalliopePBX introduce il concetto di template di interno: un insieme di attributi e impostazioni che possono essere assegnati a più interni. Definendo più di un template (con diverse impostazioni per ogni tipo di interno), si può ridurre il numero di impostazioni da specificare per ciascun interno e permette di modificare facilmente la stessa impostazione per ogni interno che condivide lo stesso template semplicemente modificando il valore dell'impostazione ne relativo template.

Nel pannello di configurazione per ogni interno si può sovrascrivere qualunque impostazione ereditata dal template se è necessaria un'eccezione. Le impostazioni sovrascritte non cambiano quando viene modificato il template.

Attributi degli account SIP

Come gli interni, gli account SIP hanno attributi specifici (principalmente lo username, che deve essere unico nel PBX, e il SIP secret) e attributi che possono essere comuni ad una "classe" di account. Questi includono i protocolli di trasporto, emdia e codec supportati, l'ACL autorizzato, e altri; some per gli interni, si possono usare template di account SIP con impostazioni comuni.


Configurazione Interni

PBX, interni e account.png
Pagina Interni.png

Nel pannello interni sono definiti gli attributi associati ad un utente che utilizza i servizi messi a disposizione dal KalliopePBX. L’attributo principale che identifica l’utente è l’interno telefonico (Telephone Extension). Nel caso in cui più apparati (Account) siano associati allo stesso utente questi condivideranno l’identità telefonica definita in questo pannello. Questo significa ad esempio che le chiamate verso l’interno telefonico saranno presentate a tutti gli apparati associati all’utente e che le chiamate effettuate da qualsiasi apparato dell’utente presenteranno la stessa identità telefonica.

Per configurare gli interni basta aprire il menu operativo e cliccare su PBX > Interni e Account.
Per creare un nuovo interno procedere cliccando su "Aggiungi interno".

  • Abilitato: Consente di disabilitare un interno senza perderne la configurazione
  • Interno: Indica il numero telefonico interno al PBX al quale è possibile contattare l’utente
  • Nome: Utilizzato per costruire il Display Name visualizzato dai telefoni e per la pubblicazione dell’utente in rubrica
  • Cognome: Utilizzato per costruire il Display Name visualizzato dai telefoni e per la pubblicazione dell’utente in rubrica.
  • Indirizzo e-mail: Indirizzo e-mail utilizzato per la pubblicazione dell’utente in rubrica
  • Numero mobile: Numero telefonico utilizzato per la pubblicazione nella rubrica interni e per i servizi Fork2Mobile e FastTransfer
  • PIN dei serivizi: Codice da utilizzare per l’accesso ai servizi telefonici che possono richiedere autenticazione (casella vocale, interruttori, paging, lucchetto elettronico)

Account

Account
Parametro
Descrizione
Valore
Aggiungi account esistente Consente di associare all'interno uno o più account SIP precedentemente creati Account
Crea account Consente di creare un nuovo account SIP da associare all'interno Account

Casella vocale

Casella vocale
Parametro
Descrizione
Valore
Crea casella vocale Consente di creare la casella vocale dell’interno Si / No
Indirizzo e-mail Indica l’indirizzo e-mail da utilizzare per ricevere le e-mail di notifica ricezione messaggi in casella vocale con opzionalmente allegati i file audio contenenti i messaggi registrati. xxxxx@dominio.yy
Notifica nuovi messaggi in casella vocale tramite email Se questa opzione è abilitata viene inviata via e-mail la notifica di ricezione di un messaggio in casella vocale Si / No
Inoltra i messaggi vocali come allegati Se questa opzione è abilitata viene allegato all'e-mail il file audio contenente il messaggio registrato Si / No
Cancella da Kalliope i messaggi vocali inoltrati Se questa opzione è abilitata una volta effettuato l’invio via e-mail le registrazioni vengono cancellate dal KalliopePBX e non saranno quindi più accessibili da telefono o dall'app KalliopeCTI Mobile Si / No
Abilitato Consente di abilitare o disabilitare la casella vocale senza perderne la configurazione
ed i messaggi ricevuti		 Si / No

Impostazioni utente locale

Impostazioni utente locale
Parametro
Descrizione
Valore
Crea utente locale Consente di creare un utente locale sul KalliopePBX nel caso in cui sia necessario abilitare l’accesso GUI o CTI Si / No
Abilita accesso GUI Abilita l'accesso utente alla WEB GUI con ruolo standard Utente di Tenant. Il ruolo associato all'utente può essere modificato nel pannello Gestione utenti Si / No
Abilita accesso CTI Abilita l’utente ad utilizzare i client KalliopeCTI. Nel caso in cui sia richiesta la modalità di utilizzo KalliopeCTI PRO o KalliopeCTI PHONE è necessario assegnare la licenza all'utente nel pannello Gestione utenti Si / No
Nome utente Nome utente da utilizzare per il login della GUI o dei client CTI Alfa-numerico
Password Password da utilizzare per il login della GUI o dei client CTI Alfa-numerico

Template

Template
Parametro
Descrizione
Valore
Template dell’interno Indica il template contenente i parametri di default da utilizzare per la tipologia di interno prescelta. Tutti gli attributi successivamente presenti nel pannello importano i valori di default ma è possibile sovrascriverli se necessario Template Interni

Rubrica telefonica

Rubrica telefonica
Parametro
Descrizione
Valore
Mostra nella rubrica locale Abilita o disabilita la visualizzazione dell’interno nella rubrica degli interni Si / No
Modalità di pubblicazione LDAP Indica la modalità di pubblicazione dell’interno in LDAP tra le varie opzioni disponibili. La regola di pubblicazione LDAP generale è definita nel pannello Impostazioni LDAP Disabilitato / Regola pubblicazione LDAP /
Presentando il numero sottoindicato /
Regola di pubblicazione LDAP applicata
all'interno sottoindicato
Interno LDAP personalizzato Interno su cui viene applicata la regola di pubblicazione LDAP. Questo campo viene visualizzato solo se l’opzione Regola di pubblicazione LDAP applicata all’interno sottoindicato è selezionata Numerico
Numero LDAP personalizzato Numero telefonico associato all’utente nella rubrica LDAP. Questo campo viene visualizzato solo se l’opzione Presentando il numero sottoindicato è selezionata Numerico
Ente Utilizzato nella pubblicazione in rubrica (corrisponde all’attributo organization nella pubblicazione sulla rubrica LDAP) Alfa-numerico
Reparto Utilizzato nella pubblicazione in rubrica (corrisponde all'attributo organizationUnit nella pubblicazione sulla rubrica LDAP). E' il reparto di riferimento dell’interno Alfa-numerico

Classi di servizio

Classi di servizio
Parametro
Descrizione
Valore
Classe di instradamento in uscita standard Indica la classe di instradamento associata all'utente quando il lucchetto elettronico è sbloccato. Nel caso in cui la modalità di sblocco del lucchetto elettronico sia impostata ad Aperto questa è la classe applicata a tutte le chiamate. Classi di instradamento in uscita
Classe di instradamento in uscita ristretta Indica la classe di instradamento associata all’utente quando il lucchetto elettronico è bloccato. Nel caso in cui la modalità di sblocco del lucchetto elettronico sia impostata ad Aperto questa classe non viene mai utilizzata. Classi di instradamento in uscita

Limiti

Limiti
Parametro
Descrizione
Valore
Limite chiamate contemporanee Numero massimo di chiamate contemporanee (in ingresso e in uscita) su tutti gli account associati all'interno ammesse per l’interno. Impostare questo limite ad 1 impedisce all'interno di utilizzare servizi quali il trasferimento con offerta poiché la chiamata in attesa di essere trasferita risulta comunque come chiamata attiva. Numerico (0 = nessun limite)
Livello di occupato Numero di chiamate su tutti gli account associati all'interno a partire dal quale l’utente viene considerato occupato (il PBX quindi non presenta la chiamata ai dispositivi ma risponde con il SIP Message 486 Busy Here). Impostare questo limite ad 1 nel caso di singolo account blocca le notifiche di chiamate in ingresso sul telefono anche se il Call Waiting è abilitato sull'apparato Numerico (0 = nessun limite)

Lucchetto elettronico

Lucchetto elettronico
Parametro
Descrizione
Valore
Modalità di sblocco Consente di scegliere la modalità di sblocco per l’interno.

Aperto – Il lucchetto elettronico è sempre sbloccato

Codice – Il lucchetto elettronico può essere sbloccato con il codice di sblocco definito nel piano di numerazione

Password - Il lucchetto elettronico può essere sbloccato utilizzando il codice di sblocco e digitando successivamente il PIN dei servizi per l’interno

Aperto / Codice / Password
Politica di sblocco Consente di scegliere la politica di sblocco per l’interno.

Per chiamata – Il lucchetto deve essere sbloccato prima di effettuare ogni chiamata

Blocca automaticamente dopo il numero di minuti sottoindicato – Il lucchetto viene bloccato automaticamente allo scadere dell’intervallo indicato

Sbloccato finché l’utente lo blocca nuovamente – Il lucchetto una volta sbloccato deve essere bloccato esplicitamente dall'utente

Per chiamata / Blocca automaticamente dopo il numero di minuti sottoindicato /
Sbloccato finché l’utente lo blocca nuovamente
Durata dello sblocco (sec.) Tempo dopo il quale l’interno viene bloccato. Applicabile solo se la politica di sblocco è Blocca automaticamente dopo il numero di minuti sottoindicato Numerico

Prelievo di chiamata di gruppo

Parametro
Descrizione
Valore
Gruppi di appartenenza Elenco dei gruppi autorizzati a prelevare le chiamate dirette all’interno (le chiamate dirette a questo interno possono essere prelevate da tutti gli interni con autorizzazione al prelievo su uno di questi gruppi). Gruppo di prelievo
Autorizzazione al prelievo Elenco dei gruppi su cui l’interno è autorizzato a prelevare chiamate (l’interno può prelevare le chiamate dirette ad interni che hanno tra i gruppi di appartenenza un gruppo su cui l’interno è autorizzato al prelievo) Gruppo di prelievo

Trabocchi

Trabocchi
Parametro
Descrizione
Valore
Interno Azione di trabocco su chiamate provenienti da un interno (anche remoto)
Esterno Azione di trabocco sulle chiamate provenienti dall’esterno
Trasferimento Azione di trabocco sui trasferimenti di chiamata
Timeout (sec.) Tempo alla scadenza del quale viene eseguita l’azione di trabocco configurata in caso di nessuna risposta Numerico
Nessuna risposta La chiamata è considerata senza risposta alla scadenza del timeout Riaggancia / Selezione personalizzata /
Chiedi selezione / Numero esterno /
Interno / Gruppo / Coda / Controllo orario /
IVR / Casella vocale / Stanza MeetMe
Occupato L’interno è considerato occupato se è stato raggiunto il Busy Level impostato per l’interno oppure se il terminale invia il SIP Response 486 Busy Here
Non disponibile L’interno è considerato non disponibile se il terminale non è registrato o non è raggiungibile a livello IP oppure se il terminale invia il SIP Response 480 Temporarily Unavailable


Configurazione Account

PBX, interni e account.png
Nuovo account sip.png

Nel pannello Account sono definite le credenziali SIP utilizzabili da un dispositivo per registrarsi ed effettuare / ricevere chiamate tramite il KalliopePBX. A queste credenziali sono associati attributi per incrementare la sicurezza e modifiche del comportamento del KalliopePBX in termini di segnalazione e flussi audio da associare ad uno specifico dispositivo. Questi attributi sono definiti a livello di account e non di interno perché due account associati allo stesso interno ma a dispositivi differenti possono avere requisiti differenti.

Esempio: ad un interno posso associare un account utilizzato su un telefono fisico ed uno utilizzato su un softphone. Mentre per il telefono fisico posso utilizzare codec con maggior consumo di banda ad es. G711a per il softphone che viene utilizzato ad esempio in telelavoro posso scegliere di utilizzare codec quali il G729 che ottimizzano l’utilizzo della banda.

Per configurare gli account basta aprire il menu operativo e cliccare su PBX > Interni e Account. Per creare un nuovo account procedere cliccando su "Account" nella barra in alto e successivamente su "Aggiungi Account SIP"

  • Abilitato: Consente di disabilitare un account senza perderne la configurazione
  • KCTI Mobile App: Consente di utilizzare questo account con l'app mobile KalliopeCTI abilitando l'invio dei messaggi push per la segnalazione delle chiamate
  • Nome utente: Username utilizzato per l’autenticazione SIP del dispositivo || Alfa-numerico
  • Password: Password utilizzata per l’autenticazione SIP del dispositivo || Alfa-numerico
  • Template dell'account: Indica il template account contenente i parametri di default da utilizzare per la tipologia di interno prescelta
  • Abilita verifica di registrazione: Quando questa opzione è abilitata il KalliopePBX verifica che la richiesta di setup di chiamata (SIP INVITE) provenga dallo stesso IP:porta da cui ha ricevuto la richiesta di registrazione (SIP REGISTER)
  • Indirizzo abilitato: Indica l’indirizzo ip o la subnet da cui il KalliopePBX accetta richieste di registrazione e setup di chiamata
  • Maschera di sottorete abilitata: Completa l’informazione della ACL su base IP per le richieste di registrazione e setup di chiamata
  • Abilita NAT: Quando questa opzione è abilitata il KalliopePBX ignora gli indirizzi IP presenti negli header SIP e SDP e risponde sempre all'indirizzo IP e porta da cui ha ricevuto la richiesta . Questa opzione deve essere abilitata solo per dispositivi si trovano dietro un NAT rispetto al KalliopePBX e che non risolvono il problema dell’attraversamento NAT (tramite STUN / ICE / ALG SIP).
  • Abilita direct media: Questa opzione consente di instaurare dei flussi audio tra 2 PBX che si trovano in condizioni di visibilità diretta (no NAT). Se questa funzione è abilitata i servizi che richiedono il monitoraggio del flusso RTP (ad es. registrazione chiamate, trasferimento di chiamata e parcheggio con codici di servizio del KalliopePBX) sono disabilitati.
  • Abilita SRTP: Questa opzione consente di abilitare il supporto alla cifratura dei flussi RTP. Poiché lo scambio delle chiavi avviene all’interno dei messaggi SIP / SDP in plaintext è opportuno utilizzare SRTP insieme alla cifratura della segnalazione mediante TLS. (vedi Configurazione TLS/SRTP)

Impostazioni di outbound proxy

Impostazioni di outbound proxy
Parametro
Descrizione
Valore
Indirizzo dell'outbound proxy Consente di impostare l'indirizzo IP/hostname dell'outbound proxy da utilizzare Alfa-numerico
Porta dell'outbound proxy Consente di impostare la porta dell'outbound proxy da utilizzare Numerico
Protocollo dell'outbound proxy Consente di impostare il protocollo da utilizzare per comunicare con l'outbound proxy. È possibile impostare solamente protocolli abilitati nelle Impostazioni SIP UDP / TCP / TLS / WS / WSS

Impostazioni di trasporto

Impostazioni di trasporto
Parametro
Descrizione
Valore
Abilita trasporto UDP Consente di abilitare il protocollo di trasporto UDP per la segnalazione SIP. Questa opzione non è presente se il trasporto UDP non è abilitato nelle Impostazioni SIP Si / No
Abilita trasporto TCP Consente di abilitare il protocollo di trasporto TCP per la segnalazione SIP. Questa opzione non è presente se il trasporto TCP non è abilitato nelle Impostazioni SIP Si / No
Abilita trasporto TLS Consente di abilitare il protocollo di trasporto TLS per la segnalazione SIP. Questa opzione non è presente se il trasporto TLS non è abilitato nelle Impostazioni SIP Si / No
Abilita trasporto Web Socket Consente di abilitare il protocollo di trasporto Web Socket (HTTP) per la segnalazione SIP. Questa opzione non è presente se il trasporto Web Socket (HTTP) non è abilitato nelle Impostazioni SIP Si / No
Abilita trasporto Web Socket sicuro Consente di abilitare il protocollo di trasporto Web Socket sicuro (HTTPS) per la segnalazione SIP. Questa opzione non è presente se il trasporto Web Socket sicuro (HTTPS) non è abilitato nelle Impostazioni SIP Si / No

Codec audio

Codec audio
Parametro
Descrizione
Valore
Aggiungi codec In questa sezione è possibile selezionare e ordinare i codec audio utilizzabili dall'account (e che quindi verranno inseriti nella media description del protocollo SDP) PCM a-law / G.722 / G.726 / G.729 /
GSM / Opus / PCM u-law

Codec video

Codec video
Parametro
Descrizione
Valore
Aggiungi codec In questa sezione è possibile selezionare e ordinare i codec video utilizzabili dall'account (e che quindi verranno inseriti nella media description del protocollo SDP) H.261 / H.263 / H.263+ / H.264 /VP8

Interno

Interno
Parametro
Descrizione
Valore
Interno In questa sezione è possibile selezionare l'interno al quale associare l'account SIP Interno


Estratto da "https://www.kalliope.com/wiki/index.php?title=AdminGuide:BasicConcepts:Extensions_and_SIP_accounts&oldid=18455"