Skip to content

Commit 63b10e2

Browse files
Stell0actions-user
andauthored
docs(wss): Add italian translation for wss transport (#31)
* docs(wss): Add italian translation for wss transport * docs: auto-sync translations for PR #31 --------- Co-authored-by: Translation Sync Bot <action@github.com>
1 parent d6d0270 commit 63b10e2

File tree

2 files changed

+83
-22
lines changed

2 files changed

+83
-22
lines changed

docs/administrator-manual/advanced/wss_transport.md

Lines changed: 20 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -8,58 +8,56 @@ sidebar_position: 7
88
NethVoice on NethServer 8 supports WebSocket Secure (WSS) transport for extensions. Each NethVoice instance exposes a specific WSS port dedicated to WebSocket connections.
99

1010
:::warning Network Constraint
11-
This configuration relies on direct connectivity and **does not function behind NAT**. Ensure NethVoice has direct network visibility to the client endpoints.
11+
This configuration relies on direct connectivity and **does not work behind NAT**. Ensure that NethVoice has direct network visibility to the client endpoints.
1212
:::
1313

1414
## Service Configuration {#service-configuration}
1515

16-
The WSS port assigned to the specific NethVoice instance is defined dynamically.
16+
The WSS port assigned to the specific NethVoice instance is dynamically defined.
1717

1818
* **Variable:** `ASTERISK_WSS_PORT`
19-
* **Location:** Inside the module environment variables.
19+
* **Location:** Within the module's environment variables.
2020

2121
Clients connecting to NethVoice via WebRTC or other WebSocket-based protocols must target this specific port.
2222

2323
## Extension Setup {#extension-setup}
2424

25-
To utilize WSS, the extension must be configured within the **Advanced Interface** (FreePBX).
26-
25+
To use WSS, the extension must be configured within the **Advanced Interface** (FreePBX).
2726

2827
### Prerequisites {#prerequisites}
2928

30-
1. Create a new **Custom Extension** or edit an existing one.
31-
2. Access the **Advanced Interface**.
29+
1. Create a new **Custom Device** or modify an existing one.
30+
2. Access the **Advanced Interface**.
3231

3332
### Transport Settings {#transport-settings}
3433

35-
Modify the extension `Advanced` settings with the following parameters to enable secure WebSocket transport:
34+
Modify the `Advanced` settings of the extension with the following parameters to enable secure WebSocket transport:
3635

37-
1. **Outbound Proxy:** Remove proxy configurations for this specific extension.
38-
2. **Transport:** Set to `0.0.0.0-wss`.
39-
3. **Enable AVPF:** Set to `Yes`.
40-
4. **Enable ICE Support:** Set to `Yes`.
41-
5. **Enable rtcp Mux:** Set to `Yes`.
42-
6. **Media Encryption:** Set to `DTLS`.
43-
7. **Enable WebRTC Defaults:** Enable this setting to apply standard WebRTC optimizations.
36+
1. **Outbound Proxy:** Remove proxy configurations for this specific extension.
37+
2. **Transport:** Set to `0.0.0.0-wss`.
38+
3. **Enable AVPF:** Set to `Yes`.
39+
4. **Enable ICE Support:** Set to `Yes`.
40+
5. **Enable rtcp Mux:** Set to `Yes`.
41+
6. **Media Encryption:** Set to `DTLS`.
42+
7. **Enable WebRTC Defaults:** Enable this setting to apply standard WebRTC optimizations.
4443

4544
## Client Configuration {#client-configuration}
4645

47-
Configure your client with the following settings. Ensure your client device has network access to the NethVoice instance.
46+
Configure your client with the following settings. Ensure that the client device has network access to the NethVoice instance.
4847

4948
| Parameter | Value / Instruction |
5049
| :--- | :--- |
5150
| **SIP Server / Domain** | The FQDN of your NethVoice instance. |
5251
| **SIP Proxy** | (Leave empty). |
5352
| **Transport Protocol** | **WSS** (Secure WebSocket). |
54-
| **Port** | The value of `ASTERISK_WSS_PORT` (check your module environment variables). |
55-
| **Path** | `/ws` (Default Asterisk WebSocket path). |
53+
| **Port** | The value of `ASTERISK_WSS_PORT` (check the module's environment variables). |
54+
| **Path** | `/ws` (Default WebSocket path for Asterisk). |
5655
| **Username / Extension** | The extension number (e.g., `1001`). |
57-
| **Password / Secret** | The extension secret defined in FreePBX. |
56+
| **Password / Secret** | The extension's secret defined in FreePBX. |
5857
| **Media Encryption** | **DTLS** (Mandatory for WebRTC/WSS). |
5958
| **AVPF** | Enabled / Yes. |
6059
| **ICE Support** | Enabled / Yes. |
6160

6261
:::warning SSL Certificate Trust
63-
WSS requires a valid SSL certificate. If you are using a self-signed certificate, the client device (or browser) **must explicitly trust the certificate Authority (CA)** before the connection can be established.
64-
:::
65-
62+
WSS requires a valid SSL certificate. If using a self-signed certificate, the client device (or browser) **must explicitly trust the Certificate Authority (CA)** before the connection can be established.
63+
:::
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
title: Trasporto WSS
3+
sidebar_position: 7
4+
---
5+
6+
# Trasporto WSS {#trasporto-wss}
7+
8+
NethVoice su NethServer 8 supporta il trasporto WebSocket Secure (WSS) per gli interni. Ogni istanza di NethVoice espone una porta WSS specifica dedicata alle connessioni WebSocket.
9+
10+
:::warning Vincolo di Rete
11+
Questa configurazione si basa sulla connettività diretta e **non funziona dietro NAT**. Assicurarsi che NethVoice abbia visibilità di rete diretta verso gli endpoint client.
12+
:::
13+
14+
## Configurazione del Servizio {#configurazione-del-servizio}
15+
16+
La porta WSS assegnata alla specifica istanza di NethVoice è definita dinamicamente.
17+
18+
* **Variabile:** `ASTERISK_WSS_PORT`
19+
* **Posizione:** All'interno delle variabili d'ambiente del modulo.
20+
21+
I client che si connettono a NethVoice via WebRTC o altri protocolli basati su WebSocket devono puntare a questa porta specifica.
22+
23+
## Impostazione dell'Interno {#impostazione-dell-interno}
24+
25+
Per utilizzare WSS, l'interno deve essere configurato all'interno dell'**Interfaccia Avanzata** (FreePBX).
26+
27+
### Prerequisiti {#prerequisiti}
28+
29+
1.  Creare un nuovo **Dispositivo Personalizzato** o modificarne uno esistente.
30+
2.  Accedere all'**Interfaccia Avanzata**.
31+
32+
### Impostazioni di Trasporto {#impostazioni-di-trasporto}
33+
34+
Modificare le impostazioni `Avanzate` dell'interno con i seguenti parametri per abilitare il trasporto WebSocket sicuro:
35+
36+
1.  **Outbound Proxy:** Rimuovere le configurazioni proxy per questo specifico interno.
37+
2.  **Transport:** Impostare su `0.0.0.0-wss`.
38+
3.  **Enable AVPF:** Impostare su `Yes`.
39+
4.  **Enable ICE Support:** Impostare su `Yes`.
40+
5.  **Enable rtcp Mux:** Impostare su `Yes`.
41+
6.  **Media Encryption:** Impostare su `DTLS`.
42+
7.  **Enable WebRTC Defaults:** Abilitare questa impostazione per applicare le ottimizzazioni WebRTC standard.
43+
44+
## Configurazione del Client {#configurazione-del-client}
45+
46+
Configurare il proprio client con le seguenti impostazioni. Assicurarsi che il dispositivo client abbia accesso di rete all'istanza NethVoice.
47+
48+
| Parametro | Valore / Istruzione |
49+
| :--- | :--- |
50+
| **SIP Server / Domain** | L'FQDN della vostra istanza NethVoice. |
51+
| **SIP Proxy** | (Lasciare vuoto). |
52+
| **Transport Protocol** | **WSS** (Secure WebSocket). |
53+
| **Port** | Il valore di `ASTERISK_WSS_PORT` (controllare le variabili d'ambiente del modulo). |
54+
| **Path** | `/ws` (Percorso WebSocket predefinito di Asterisk). |
55+
| **Username / Extension** | Il numero dell'interno (es. `1001`). |
56+
| **Password / Secret** | Il segreto dell'interno definito in FreePBX. |
57+
| **Media Encryption** | **DTLS** (Obbligatorio per WebRTC/WSS). |
58+
| **AVPF** | Abilitato / Yes. |
59+
| **ICE Support** | Abilitato / Yes. |
60+
61+
:::warning Fiducia nel Certificato SSL
62+
WSS richiede un certificato SSL valido. Se si utilizza un certificato autofirmato, il dispositivo client (o il browser) **deve esplicitamente considerare attendibile l'Autorità di Certificazione (CA)** prima che la connessione possa essere stabilita.
63+
:::

0 commit comments

Comments
 (0)