AdminGuide:Service:SIPSettings/en - Cronologia

Troccoli: Creata pagina con "Thus, the use of ''in-band'' DTMF mode is discouraged because if the RTP stream suffers degradation due to losses or congestion, the tones, even using G.711 are distorted and..."

2022-09-03T13:48:40Z

Creata pagina con "Thus, the use of ''in-band'' DTMF mode is discouraged because if the RTP stream suffers degradation due to losses or congestion, the tones, even using G.711 are distorted and..."

Mostra modifiche

Troccoli: Creata pagina con "Return to AdminGuide:Service"

2022-09-03T13:42:30Z

Creata pagina con "Return to AdminGuide:Service"

← Versione meno recente		Versione delle 13:42, 3 set 2022
Riga 50:		Riga 50:
	The setting in this panel applies to all SIP accounts defined in the "Internal and Accounts" panel and is used as the default setting for all incoming and outgoing lines.		The setting in this panel applies to all SIP accounts defined in the "Internal and Accounts" panel and is used as the default setting for all incoming and outgoing lines.

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~		Unlike accounts, in the panel, there is no ability to go and change DTMFs: when you send a DTMF to an account, you send it with SIP settings, and the same occurs when a SIP account sends a DTMF.
	~~A differenza degli account~~, ~~nel pannello non c’è la possibilità di andare~~ a ~~cambiare i DTMF: quando si manda un~~ DTMF ~~verso un~~ account ~~lo si manda con le impostazioni~~ SIP ~~e lo stesso si verifica quando un~~ account ~~SIP manda un~~ DTMF.		Instead, you can change the DTMF mode in the [[AdminGuide:BasicConcepts:Outbound_lines/en#Configuration\|Inbound lines]] panel or leave it as default.
	~~Invece~~, ~~nel pannello delle~~ [[AdminGuide:BasicConcepts:Outbound_lines#~~Configurazione_del_servizio~~\|~~linee di ingresso e di uscita~~]] ~~si può cambiare la modalità DTMF o lasciarla come di~~ default.
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~
	[[File:Cambio modalità.png\|600px]]		[[File:Cambio modalità.png\|600px]]
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~		This mode is often referred to as AVB (Attribute Value Pair) on other equipment.
	~~Questa modalità è spesso indicata come~~ AVB (Attribute Value Pair) ~~su altri apparati~~.		** '''SIP INFO''': is a mode that does not send RTP or RTP event messages, but an info type SIP message. The info is a type of SIP message that contains a payload containing the key and duration, is transmitted only once, and has a network path that follows that of the SIP signaling which is different from the path that the RTP flow takes.
	** '''SIP INFO''': ~~è una modalità che non manda messaggi~~ RTP o RTP event, ~~ma un messaggio~~ SIP ~~di tipo~~ info~~. L’info è un tipo di messaggio~~ SIP ~~che contiene come~~ payload ~~contiene il tasto e la durata~~, ~~viene trasmesso una sola volta e ha un percorso di rete che segue quello della segnalazione~~ SIP ~~che è diverso dal percorso che effettua il flusso~~ RTP.		** '''In-band''': typed DTMF tones are sent as audio tones within the RTP stream.
	** '''In ~~banda~~''': ~~i toni~~ DTMF ~~digitati sono mandati sotto forma di toni~~ audio ~~all’interno del flusso~~ RTP.
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~		If you analyze the tracks containing DTMF tones, you can find RTP only. So you cannot distinguish whether they are tones or not.
	~~Infatti~~, ~~se si analizzano le tracce che contengono toni DTMF si trovano solo~~ RTP ~~e non si può distinguere se siano toni o meno~~.		The problem with DTMF transmission under audio tones is that if codecs other than G.711 are used, they introduce compression into the audio and distortion of the tones.
	~~Il problema della trasmissione~~ DTMF ~~sotto toni~~ audio ~~è che se vengono utilizzati dei codec diversi dal~~ G.711, ~~questi introducono una compressione nell’audio e una deformazione dei toni~~.		While a conversation is understandable, recognition of these tones may fail.
	~~Mentre una conversazione risulta comprensibile~~, ~~il riconoscimento di questi toni potrebbe fallire~~.
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~
	[[File:G711.png\|700px]]		[[File:G711.png\|700px]]
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw~~-~~content-ltr">~~		Thus, the use of ''in-band'' DTMF mode is discouraged because if the RTP stream suffers degradation due to losses or congestion, the tones, even using G.711 are distorted and may not be recognized.
	~~Quindi, l’utilizzo della modalità~~ DTMF ~~“in banda” è scoraggiato perché se il flusso~~ RTP ~~subisce un degrado per perdite o congestione~~, ~~i toni~~, ~~anche usando~~ G.711 ~~vengono deformati e possono non venire riconosciuti~~.		Thus, the use of DTMF in audio is recommended only in conjunction with a compressed '''PCM a-low''' or '''PCM u-low''' codec, but it may still be error-prone.
	~~Quindi l’utilizzo dei~~ DTMF in audio ~~è raccomandato solo~~ in ~~associazione ad un codec compresso~~ '''PCM a-low''' o '''PCM u-low''', ~~ma può comunque essere soggetto a errori~~.
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~		The most commonly used mode is RFC 2833.
	~~La modalità più utilizzata è la~~ RFC 2833.
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~		The following two fields are attributes that impact both SIP accounts and input and output lines; as in the case of DTMF mode, the next two are also modifiable from the default value in the input and output lines.
	~~I successivi due campi sono due attributi che impattano sia gli account~~ SIP ~~che le linee di ingresso e uscita, come nel caso della modalità~~ DTMF, ~~anche i seguenti due sono modificabili rispetto al valore di~~ default ~~nelle linee di ingresso e di uscita~~.		* '''Enable RPID (Remote Party ID) acceptance''': enables COLP acceptance (named thus in the inbound and outbound lines).
	* '''~~Abilita accettazione~~ RPID (Remote Party ID)''': ~~abilita accettazione~~ COLP (~~nominato così nelle linee di ingresso e uscita~~).
	~~</div>~~

	~~<div lang="~~it~~" dir="ltr" class="mw-content-ltr">~~		Enabling causes it to extract the caller's identity from the FROM it sends and the PAI, RPID, etc. headers.
	~~L’abilitazione fa in modo che si estragga l’identità del chiamante non solo dal~~ FROM ~~che manda, ma dagli header~~ PAI, RPID ~~ecc~~.		This is a SIP header that carries additional information that identifies the caller.
	~~Si tratta di un~~ header ~~SIP che trasporta un’informazione aggiuntiva che identifica il chiamante~~.		During a call, there are instances when the identifier of the person being talked to may change over time.
	~~Durante una chiamata~~, ~~ci sono dei casi in cui l’identificativo della persona con cui si parla possa cambiare nel tempo~~.		The COLP feature causes the exchange to notify that the caller has changed; there are some cases where it is necessary to provide this information to the caller, and others where it is not.
	~~La funzionalità del~~ COLP ~~fa in modo che la centrale notifichi che l’interlocutore è cambiato~~, ~~ci sono dei casi in cui è necessario fornire questa informazione all’interlocutore, e altri in cui non lo è~~.		This flag causes it to accept from telephones connected to the exchange, the caller ID present in the RPID or PAI (P-Asserted-Identity) header.
	~~Questo~~ flag ~~fa sì che si accetti dai telefoni collegati alla centrale~~, ~~l’identificativo chiamante presente nell’header~~ RPID o PAI (P-Asserted-Identity).
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~		'''N.B.''' At the output level, it is recommended that the entry be disabled since you do not want the pbx to change the identifier of the connected line.
	'''N.B.''' ~~A livello di uscita si raccomanda che la voce sia disabilitata poiché non si vuole che la centrale modifichi l’identificativo della linea connessa~~.
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~		* '''Send rpid mode''': Send COLP mode (named so in the input and output lines).
	* '''Send rpid mode''': ~~Modalità invio~~ COLP (~~nominato così nelle linee di ingresso e uscita~~).
	~~</div>~~

	~~<div lang="it" dir="ltr" class="mw-content-ltr">~~		It has three options: disabled / remote party ID / P-Asserted-Identity.
	~~Ha tre opzioni~~: ~~disabilitato~~ / remote party ID / P-Asserted-Identity.		In this case, the setting that is used for telephones and that is recommended is sending PAI. This flag causes the pbx to warn that the interlocutor being communicated with has changed, it sends a message that updates the information via the PAI header.
	In ~~questo caso~~, ~~l’impostazione che viene utilizzata verso i telefoni e che si raccomanda è l’invio del~~ PAI. ~~Questo~~ flag ~~fa sì che la centrale avverta che l’interlocutore con cui si comunica è cambiato~~, ~~manda un messaggio che aggiorna l’informazione tramite l’header~~ PAI.		The interlocutor change information is useful toward telephones, but generally, on an outgoing line it should be disabled.
	~~L’informazione di cambio interlocutore è utile verso i telefoni~~, ~~ma normalmente su una linea di uscita deve essere disabilitato~~.
	~~</div>~~

	<div lang="it" dir="ltr" class="mw-content-ltr">		<div lang="it" dir="ltr" class="mw-content-ltr">

Troccoli: Creata pagina con "The duration is useful because if the central unit has to convert this DTMF, when sending it to the interlocutor in a format other than RFC 233, it should play it back for a c..."

2022-09-03T13:34:45Z

Creata pagina con "The duration is useful because if the central unit has to convert this DTMF, when sending it to the interlocutor in a format other than RFC 233, it should play it back for a c..."

Nuova pagina

<languages />
Return to [[AdminGuide:Service/en|AdminGuide:Service]]

== Description ==
The SIP settings panel contains the specification of telephone engine settings. The SIP protocol governs the communication between the exchange and the telephones and between the exchange and other gateways.

== Configuration ==
[[File:PBX, impostazioni sip.png|destra|450px]]
The panel can be reached from the menu '''"PBX > SIP settings"'''.
In the case of a multitenant system, the panel is used by the PBX admin because even in a multitenant node, the SIP stack running on the machine is unique and shares settings among all tenants.
The tenants, however, can independently perform the configuration of their own extensions/groups/queues/accounts.

* '''Enable pedantic check of SIP messages''': this causes a stricter check of the formal correctness of SIP messages sent to the pbx to be carried out, and if this legal check indicates malformations within the SIP packet, it discards it.
This is a security measure to prevent malformed SIP packets from arriving at the exchange, creating malfunctions or attacks on the machine itself.
In cases where one interfaces with providers (gateways, telephones) that create SIP messages that are not formatted entirely correctly, it may be helpful to disable the flag. In this case, message parsing is relaxed and made acceptable.

* '''DTMF mode''': tones that can be sent during a telephone call to send commands or information to the other party. There are three modes provided in the SIP standard by which DTMFs sent by the other party or sent to the other party can be sent and acknowledged.

** '''RFC 2833''': can be considered side-by-side with 4733, which recalls and extends 2833.
This mode provides that DTMF tones are sent as '''RTP event''' packets within the RTP stream of a call. DTMF tones take the same path as the audio stream, but are not sent as tones, but as '''RTP event''' packets.
These '''RTP event''' messages are sent by sending an initial packet (beginning of the tone). Then, with periodicity typical of VoIP, another packet is sent that lengthens the duration of the tone.
These ''RTP event''' messages contain the number of keys pressed and the symbols *#.

Example:

The DTMF tone sent in RFC 2833 mode by the 10.0.20.100 central unit to the PBX can be displayed:

[[File:Rtp event.png|700px]]

This incoming RTP is passed back from the pbx to the interlocutor.

The audio packet is sent to a stream that has a source and destination port that contains the RTP stream.
When the station sends a DTMF in RTP event mode within the same stream, the port extremes do not change (the same as in the audio packet), but the payload type changes.

[[File:Payload type.png|700px]]

[[File:Payload type event.png|700px]]

In the second case the payload type is 101 because the RTP event changes the payload type.
Kalliope uses 101 by default for sending DTMFs.

The payload becomes explicit information of the key is pressed, the volume, and duration in samples.

UDP, in the case of a PBX with more than one network interface, causes VoIP service to be activated on all the interfaces in the PBX.
A second network interface can be added, or VLAN tags can be added.

[[File:Event duration (campioni).png|700px]]

The duration is useful because if the central unit has to convert this DTMF, when sending it to the interlocutor in a format other than RFC 233, it should play it back for a corresponding duration.
The setting in this panel applies to all SIP accounts defined in the "Internal and Accounts" panel and is used as the default setting for all incoming and outgoing lines.

<div lang="it" dir="ltr" class="mw-content-ltr">
A differenza degli account, nel pannello non c’è la possibilità di andare a cambiare i DTMF: quando si manda un DTMF verso un account lo si manda con le impostazioni SIP e lo stesso si verifica quando un account SIP manda un DTMF.
Invece, nel pannello delle [[AdminGuide:BasicConcepts:Outbound_lines#Configurazione_del_servizio|linee di ingresso e di uscita]] si può cambiare la modalità DTMF o lasciarla come di default.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
[[File:Cambio modalità.png|600px]]
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
Questa modalità è spesso indicata come AVB (Attribute Value Pair) su altri apparati.
** '''SIP INFO''': è una modalità che non manda messaggi RTP o RTP event, ma un messaggio SIP di tipo info. L’info è un tipo di messaggio SIP che contiene come payload contiene il tasto e la durata, viene trasmesso una sola volta e ha un percorso di rete che segue quello della segnalazione SIP che è diverso dal percorso che effettua il flusso RTP.
** '''In banda''': i toni DTMF digitati sono mandati sotto forma di toni audio all’interno del flusso RTP.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
Infatti, se si analizzano le tracce che contengono toni DTMF si trovano solo RTP e non si può distinguere se siano toni o meno.
Il problema della trasmissione DTMF sotto toni audio è che se vengono utilizzati dei codec diversi dal G.711, questi introducono una compressione nell’audio e una deformazione dei toni.
Mentre una conversazione risulta comprensibile, il riconoscimento di questi toni potrebbe fallire.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
[[File:G711.png|700px]]
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
Quindi, l’utilizzo della modalità DTMF “in banda” è scoraggiato perché se il flusso RTP subisce un degrado per perdite o congestione, i toni, anche usando G.711 vengono deformati e possono non venire riconosciuti.
Quindi l’utilizzo dei DTMF in audio è raccomandato solo in associazione ad un codec compresso '''PCM a-low''' o '''PCM u-low''', ma può comunque essere soggetto a errori.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
La modalità più utilizzata è la RFC 2833.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
I successivi due campi sono due attributi che impattano sia gli account SIP che le linee di ingresso e uscita, come nel caso della modalità DTMF, anche i seguenti due sono modificabili rispetto al valore di default nelle linee di ingresso e di uscita.
* '''Abilita accettazione RPID (Remote Party ID)''': abilita accettazione COLP (nominato così nelle linee di ingresso e uscita).
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
L’abilitazione fa in modo che si estragga l’identità del chiamante non solo dal FROM che manda, ma dagli header PAI, RPID ecc.
Si tratta di un header SIP che trasporta un’informazione aggiuntiva che identifica il chiamante.
Durante una chiamata, ci sono dei casi in cui l’identificativo della persona con cui si parla possa cambiare nel tempo.
La funzionalità del COLP fa in modo che la centrale notifichi che l’interlocutore è cambiato, ci sono dei casi in cui è necessario fornire questa informazione all’interlocutore, e altri in cui non lo è.
Questo flag fa sì che si accetti dai telefoni collegati alla centrale, l’identificativo chiamante presente nell’header RPID o PAI (P-Asserted-Identity).
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
'''N.B.''' A livello di uscita si raccomanda che la voce sia disabilitata poiché non si vuole che la centrale modifichi l’identificativo della linea connessa.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
* '''Send rpid mode''': Modalità invio COLP (nominato così nelle linee di ingresso e uscita).
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
Ha tre opzioni: disabilitato / remote party ID / P-Asserted-Identity.
In questo caso, l’impostazione che viene utilizzata verso i telefoni e che si raccomanda è l’invio del PAI. Questo flag fa sì che la centrale avverta che l’interlocutore con cui si comunica è cambiato, manda un messaggio che aggiorna l’informazione tramite l’header PAI.
L’informazione di cambio interlocutore è utile verso i telefoni, ma normalmente su una linea di uscita deve essere disabilitato.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
N.B. Se si va a fare un trunk verso un’altra centrale in cui configuro interni remoti, in questo caso la linea non è un trunk di uscita verso un operatore, ma è l’interconnessione con un’altra centrale sulla quale è utile attivare la modalità di aggiornamento del COLP.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
I tre campi successivi servono per impostare i parametri di qualità del servizio in uscita dalla centrale.
Sono presenti i valori esadecimali del TOS e i codici di priorità che nella rete servono per decidere in caso di congestione, quali pacchetti far viaggiare con priorità rispetto agli altri. Quindi, garantisce che flussi audio e video abbiano trattamento privilegiato rispetto all’invio della mail.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
* '''TOS SIP'''
* '''TOS Audio'''
* '''TOS Video'''
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
Questi valori possono essere cambiati se la rete in cui si trova a operare la centrale richiede che siano usati diversi valori di TOS per l’audio, la segnalazione e/o il video.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
* '''Abilita Video''': per abilitare a livello globale il supporto alle videochiamate
* '''Bitrate massimo per le chiamate video''': attributo che vale solo per le chiamate video e determina il bitrate massimo che la centrale accetta e offre per le videochiamate, di default è 384 Kbps per non occupare troppa banda. Spesso i valori possono essere alzati per aumentare la qualità.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
* '''Abilita supporto alla cifratura RTP (SRTP)''': abilita a livello di centrale la possibilità di attivare l’encryption dei flussi RTP che normalmente viaggiano in chiaro (chiunque riesca a intercettare il flusso RTP della chiamata può ascoltarne il contenuto).
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
SRPT è un protocollo che si basa sul preventivo scambio di chiavi tra chiamante e chiamato, il flusso è cifrato con un cifratore a chiave simmetrica. La chiave viene scambiata in fase di setup della chiamata e, se non si usa un protocollo di trasporto della segnalazione sicuro come TLS e si usa invece TCP o UDP, si può leggere in chiaro sul messaggio SIP. L’attivazione dell’SRPT ha senso se è accoppiata a un protocollo di segnalazione di tipo sicuro come TLS.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
'''ATTENZIONE''': L’abilitazione dell’SRTP nelle impostazioni SIP non abilita automaticamente l’effettivo utilizzo dell’SRTP, ma abilita il modulo da supporto SRPT. È necessario abilitarlo nel pannello degli “Interni e account”. Qui, è presente la spunta '''“Abilita SRPT”''': in questo modo può essere ereditato da tutti gli account che usano quel determinato template.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
[[File:Abilita SRPT interni.png|600px]]
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
I due campi successivi non sono necessari da configurare, se non quando si vuole esporre il servizio tramite WebRtc (tramite Web Socket) ed è necessario specificare un server STUN per acquisire l’informazione necessari aa far chiudere correttamente segnalazione e media.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
'''N.B.''' STUN è un protocollo che serve per distribuire l’informazione dell’IP pubblico utilizzato da un client che si trova dietro un NAT. Viene usato dai client web rtc (telefono web) per fare in modo che la centrale sappia qual è l’indirizzo IP a cui spedire i flussi media.
Va di pari passo con l’abilitazione del trasporto (protocollo per le segnalazioni SIP) tramite Web Socket e, una volta attivato il Web Socket Sicuro, c’è necessità di specificare un server STUN, che la centrale usa pere imparare quali sono le porte che utilizzerà per la segnalazione e per il media.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
* '''Indirizzo del server STUN'''
* '''Posta del server STUN'''
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
===NAT Helper===
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
Questa sezione è particolarmente importante per rendere la centrale disponibile in accesso dal pubblico.
* Host esterno: indirizzo IP pubblico
* Periodo di aggiornamento dell’host esterno (sec.)
* Porta UDP esterna
* Porta TCP esterna
* Porta TLS esterna
* Reti locali
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
Per tutti i messaggi inviati alle reti marcate come locali usa il proprio indirizzo privato come da routing, mentre ciò che è fuori dalle reti locali usa l’indirizzo IP che specificate nell’host esterno.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
===Codec video predefiniti===
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
Per abilitare il supporto alle videochiamate si spunta la sopracitata casella “Abilita video” e selezionare quali codec video sono supportati dalla centrale.
</div>

<div lang="it" dir="ltr" class="mw-content-ltr">
===Codec audio===
Anche per l’audio si può selezionare quali codec sono supportati dalle centrale.
</div>