diff --git a/docs/administrator-manual/advanced/nethvoice_proxy.md b/docs/administrator-manual/advanced/nethvoice_proxy.md index fb253c9..499a25a 100644 --- a/docs/administrator-manual/advanced/nethvoice_proxy.md +++ b/docs/administrator-manual/advanced/nethvoice_proxy.md @@ -69,54 +69,51 @@ In this scenario: ## Installation {#installation} +### Recommended Installation {#installation-steps} + +NethVoice proxy is installed as part of the NethVoice module setup wizard. See [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence. + +### Manual Installation (not recommended) + :::note You can install only one NethVoice Proxy per node from the Software Center. ::: -NethVoice Proxy must be installed **before** deploying any NethVoice instances. See [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence. - -### Installation Steps {#installation-steps} +NethVoice Proxy must be installed **before** deploying any NethVoice instances. -1. **Open NethServer Management Interface** on your node +1. **Open NethServer Management Interface** 2. **Navigate to Software Center** 3. **Search for "NethVoice Proxy"** 4. **Click "Install"** and wait for installation to complete -5. **Proceed to Configuration** (see section below) - -:::warning Installation Order -Do not attempt to install NethVoice before installing and configuring NethVoice Proxy. The installation will fail if the proxy is not available. +5. **Proceed to configuration** (see section below) ## Configuration {#configuration} -Configuration of NethVoice Proxy is essential before installing NethVoice instances. The proxy requires a dedicated FQDN and proper network settings. - -:::warning Configuration Required -NethVoice Proxy must be fully configured and operational before installing NethVoice instances. Verify configuration is complete and proxy is running before proceeding to NethVoice installation. -::: - ### Prerequisites {#prerequisites} Before configuring NethVoice Proxy, ensure: 1. **DNS Records Created**: Create a DNS A/AAAA record for the proxy domain (e.g., `proxy.nethserver.org`) pointing to your public IP address -2. **Public IP Address**: Know the public IPv4 or IPv6 address where the proxy will be accessible from the internet +2. **Public IP Address**: Identify the public IPv4 or IPv6 address where the proxy will be accessible from the internet 3. **Network Interface**: Identify which network interface will handle VoIP traffic ### Configuration Steps {#configuration-steps} +NethVoice Proxy is usually configured during the setup wizard of a NethVoice module (see [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence). To review or modify the proxy configuration: + 1. **Access the proxy configuration page** in the NethServer management interface 2. **Enter the Proxy Domain**: Set a valid FQDN (e.g., `proxy.nethserver.org`) - This domain must have a valid DNS A/AAAA record pointing to your public IP - External VoIP devices and remote offices will use this domain to reach your system -3. **Select Network Interface**: Choose the network interface that will handle VoIP traffic from the dropdown menu - - Typically the interface connected to your WAN/Internet -4. **Configure Public IP Address**: +3. **Request SSL Certificate**: + - Enable Let's Encrypt to automatically manage SSL certificates for the proxy domain + - This requires the DNS record to be publicly resolvable +4. **Select Network Interface**: Choose the network interface that will handle VoIP traffic from the dropdown menu + - This is typically the interface connected to your WAN/Internet +5. **Configure Public IP Address**: - Enter the public IPv4 or IPv6 address if different from the interface IP - This is necessary if your node is behind a router/NAT - Leave blank if the interface has a direct public IP address -5. **Request SSL Certificate**: - - Enable Let's Encrypt if you want automatic SSL certificate management - - Requires the DNS record to be publicly resolvable ### Configuration Example {#configuration-example} @@ -154,14 +151,6 @@ If your node has multiple public IP addresses, configure the proxy with the spec 2. Enter the specific public IP in the "Public IP Address" field 3. Ensure DNS records point to this IP address -### Next Steps {#next-steps} - -Once NethVoice Proxy is fully configured and running: - -1. **Verify proxy is operational**: Check the proxy status in the NethServer management interface -2. **Proceed to install NethVoice**: See [NethVoice Installation](../install/nethvoice_install.md) -3. **Configure NethVoice instances**: Each instance requires separate configuration with dedicated FQDNs - :::info Network Diagram ``` External Users/Trunks @@ -177,5 +166,3 @@ External Users/Trunks The proxy acts as a gateway between external VoIP traffic and internal NethVoice instances. ::: - -Now, you can install and configure one or more NethVoice instances. See [NethVoice Installation](../install/nethvoice_install.md) for detailed steps. diff --git a/docs/administrator-manual/configuration/index.md b/docs/administrator-manual/configuration/index.md index 50e7ef1..a1f4e98 100644 --- a/docs/administrator-manual/configuration/index.md +++ b/docs/administrator-manual/configuration/index.md @@ -12,6 +12,7 @@ The Configuration section contains documentation for managing and monitoring you - **[Wizard](./configuration/wizard)** - Access the configuration wizard for system setup and customization - **[Dashboard](./configuration/dashboard)** - Monitor system status, users, and presence information - **[Applications](./configuration/applications/)** - Configure additional NethVoice applications and integrations +- **[NethServer 8 module](../install/nethvoice_install.md#module-configuration)** - Configure the NethVoice module :::info Getting Started For the initial NethVoice setup, start with the [configuration wizard](./configuration/wizard). diff --git a/docs/administrator-manual/index.md b/docs/administrator-manual/index.md index 5a91d1b..cfedf0b 100644 --- a/docs/administrator-manual/index.md +++ b/docs/administrator-manual/index.md @@ -20,7 +20,7 @@ This documentation covers the complete installation, configuration, and manageme Get started quickly by jumping to the most important sections: - **[Installation Guide](./install/index.md)** - Complete setup instructions from NethServer prerequisites to NethVoice deployment -- **[Configuration](./configuration/index.md)** - CTI, extensions, and user administration +- **[Configuration](./configuration/index.md)** - NethVoice management after the initial setup. - **[Phone Provisioning](./provisioning/index.md)** - Automated phone device management and provisioning - **[Advanced Resources](./advanced/index.md)** - System configuration and advanced topics @@ -91,20 +91,16 @@ Before deploying NethVoice, ensure you have: - ✅ **System Resources**: Minimum 2 vCPU, 2GB RAM, 40GB storage per instance - ✅ **Network Requirements**: Static IP, DNS configured, internet connectivity - ✅ **NethServer 8**: Fully installed and configured (see [Installation Guide](./install/index.md)) -- ✅ **User Domain**: Created for users and authentication (see [User Domains in NethServer Installation](./install/nethserver.md#user-domains)) -- ✅ **NethVoice Proxy**: Installed and configured with proper FQDN and DNS records (required for any NethVoice deployment) ### Deployment Steps {#deployment-steps} 1. **[Review System Requirements](./install/nethserver.md#system-requirements)** - Ensure your infrastructure meets requirements 2. **[Install NethServer 8](./install/nethserver.md)** - Deploy the base infrastructure platform -3. **[Create User Domain](./install/nethserver.md#user-domains)** - Set up LDAP for users and authentication -4. **[Install & Configure NethVoice Proxy](./advanced/nethvoice_proxy.md)** - Deploy the external VoIP gateway (REQUIRED before NethVoice) -5. **[Deploy NethVoice](./install/nethvoice_install.md)** - Install NethVoice module(s) on top of the proxy -6. **Configure Your System**: +3. **[Install & Configure NethVoice](./install/nethvoice_install.md)** - Install NethVoice Proxy and NethVoice modules +4. **Configure Your System**: - [Provision Phones](./provisioning/index.md) - Deploy and configure telephone devices - [Manage Extensions](../user-manual/nethcti/index.md) - Create extensions and assign to users -7. **[Advanced Configuration](./advanced/index.md)** - Configure trunks, gateways, routing, and advanced features +5. **[Advanced Configuration](./advanced/index.md)** - Configure trunks, gateways, routing, and advanced features ## Key Documentation Sections {#key-documentation-sections} diff --git a/docs/administrator-manual/install/index.md b/docs/administrator-manual/install/index.md index a535ec5..803f505 100644 --- a/docs/administrator-manual/install/index.md +++ b/docs/administrator-manual/install/index.md @@ -9,23 +9,10 @@ This section covers the complete installation process for NethVoice, from settin ## Overview {#overview} -NethVoice installation is a multi-step process: +NethVoice installation is a two-step process: 1. **[NethServer 8 Installation](nethserver.md)** - Install the NethServer 8 base platform -2. **[Create User Domain](nethserver.md#user-domains)** - Set up LDAP for users and authentication (in NethServer) -3. **[NethVoice Proxy Installation & Configuration](../advanced/nethvoice_proxy.md)** - Install and configure the external VoIP gateway (REQUIRED first) -4. **[NethVoice Installation](nethvoice_install.md)** - Install NethVoice on top of configured proxy -5. **[Module Configuration](nethvoice_install.md#module-configuration)** - Configure NethVoice with your requirements - -:::warning Installation Order -1. NethServer 8 must be installed first -2. User Domain must be created second (required by NethVoice) -3. NethVoice Proxy must be installed and configured third -4. NethVoice can only be installed after proxy is ready -5. NethVoice configuration uses the user domain created in step 2 - -See [NethVoice Proxy Installation](../advanced/nethvoice_proxy.md) for details on proxy requirements. -::: +2. **[NethVoice Installation](nethvoice_install.md)** - Install and configure NethVoice application ## What is NethServer 8? {#what-is-nethserver-8} @@ -62,47 +49,19 @@ Follow the [NethServer Installation guide](nethserver.md) to: - Access the web administration interface - Create your cluster -### Step 3: Create User Domain {#step-3-create-user-domain} - -Create a user domain for NethVoice users and extensions: -- Access NethServer 8 web interface → Domains and users -- Create domain (OpenLDAP recommended for NethVoice) -- Set admin credentials -- Note LDAP bind settings (needed for NethVoice configuration) - -See [User Domains setup](nethserver.md#user-domains) in the NethServer Installation guide for details. - -### Step 4: Install NethVoice Proxy {#step-4-install-nethvoice-proxy} - -After NethServer 8 and user domain are ready, install and configure the VoIP proxy: -- Access the Software Center -- Install NethVoice Proxy -- Configure proxy domain (FQDN) -- Set network interface and public IP -- Verify proxy is running - -See [NethVoice Proxy Installation Guide](../advanced/nethvoice_proxy.md) for detailed steps. - -### Step 5: Install NethVoice {#step-5-install-nethvoice} - -With NethVoice Proxy configured and running: -- Access the Software Center -- Install NethVoice -- Complete the NethVoice configuration wizard -- Select the user domain created in Step 3 -- Set up virtual hosts and certificates - -### Step 6: Configure NethVoice {#step-6-configure-nethvoice} +### Step 3: Install and configure NethVoice {#step-3-install-nethvoice} Follow the [NethVoice Installation guide](nethvoice_install.md) to: -- Configure NethVoice virtual hosts -- Verify user domain is selected -- Configure Let's Encrypt certificates -- Access NethVoice administration and CTI +- Install NethVoice +- Complete the setup configuration wizard: + - Configure an account provider + - Install and configure a NethVoice Proxy + - Set up virtual hosts, certificates and administration password +- Access NethVoice administration interface and CTI ## Quick Reference {#quick-reference} -### System Requirements (Minimum) {#system-requirements-minimum} +### Minimum System Requirements {#system-requirements-minimum} | Component | Requirement | |-----------|-------------| @@ -149,6 +108,19 @@ Complete guide covering: - Cluster configuration - Troubleshooting +### [NethVoice Installation](nethvoice_install.md) {#nethvoice-installation} + +Complete guide covering: +- NethVoice software installation +- Setup wizard: + - User domain + - NethVoice Proxy + - Virtual hosts (base hosts) + - Let's Encrypt certificates + - Administration password +- Administrator access +- Initial configuration + ### [NethVoice Proxy Installation](../advanced/nethvoice_proxy.md) {#nethvoice-proxy-installation} Complete guide covering: @@ -158,19 +130,7 @@ Complete guide covering: - Configuration (domain, interface, public IP) - SSL certificate setup - Verification and testing -- Must be installed BEFORE NethVoice - -### [NethVoice Installation](nethvoice_install.md) {#nethvoice-installation} - -Complete guide covering: -- Installation order (Proxy → NethVoice) -- NethVoice software installation -- Module configuration -- Virtual host setup -- User domain configuration -- Let's Encrypt certificate configuration -- Administrator access -- Initial configuration +- Must be installed before NethVoice ## Installation Checklist {#installation-checklist} @@ -185,17 +145,6 @@ Before you begin, ensure: - [ ] Internet connection is stable - [ ] You have administrative access to the server -During installation, ensure you complete: - -- [ ] NethServer 8 installation -- [ ] User Domain creation (OpenLDAP recommended) -- [ ] Note down LDAP bind settings -- [ ] NethVoice Proxy installation -- [ ] NethVoice Proxy configuration -- [ ] Verify proxy is running before NethVoice install -- [ ] NethVoice installation -- [ ] NethVoice configuration with user domain - ## Important Notes {#important-notes} :::info diff --git a/docs/administrator-manual/install/nethserver.md b/docs/administrator-manual/install/nethserver.md index 0084c39..f223e4c 100644 --- a/docs/administrator-manual/install/nethserver.md +++ b/docs/administrator-manual/install/nethserver.md @@ -137,66 +137,13 @@ After installation completes: - Password: `Nethesis,1234` Follow the wizard to create a cluster and configure the node. -More info available in the [official NethServerdocumentation](https://docs.nethserver.org/projects/ns8/en/latest/install.html#post-installation-steps). +More info available in the [official NethServer documentation](https://docs.nethserver.org/projects/ns8/en/latest/install.html#post-installation-steps). After cluster setup, you can: -1. **Install User Domain**: [Set up LDAP or Active Directory](#user-domains) -2. **Install NethVoice**: Proceed with [NethVoice installation](nethvoice_install) via the Software Center -3. **Register NethServer**: Activate your [Enterprise subscription](#register-nethserver) - - -## User Domains {#user-domains} - -User domains store users and groups in an LDAP database. NethVoice requires at least one user domain to manage extensions, users, and authentication. - -### Overview {#overview} - -NethServer 8 supports two types of LDAP account providers: - -| Provider | Type | Best For | Features | -|----------|------|----------|----------| -| **OpenLDAP (RFC2307)** | Internal | Unix/Linux clients, simple setup | Lightweight, easy configuration, smaller deployments, multiple instances per node | -| **Active Directory (Samba)** | Internal | Windows clients, SMB file sharing | Domain controller, Windows compatibility, higher complexity, one instance per node | -| **External LDAP** | External | Existing LDAP infrastructure | Connect to existing servers (Active Directory, OpenLDAP, etc.) | - - -:::info NethVoice Requirement -NethVoice requires at least one configured user domain. Choose **OpenLDAP (RFC2307)** for simpler deployments or **Active Directory** if you need Windows client support. -::: - -### Quick Setup: OpenLDAP (Recommended for NethVoice) {#quick-setup-openldap-recommended-for-nethvoice} - -OpenLDAP is the simplest option for NethVoice-only deployments: - -1. **Access the NethServer 8 web interface** after installation completes -2. **Navigate to Domains and users** section -3. **Click "Create domain"** and choose **"Internal"** -4. **Select "OpenLDAP"** as the provider -5. **Enter domain name** (e.g., `nethvoice.local`) - this is a logical name, not DNS-related -6. **Set OpenLDAP admin username and password** -7. **Click "Install provider"** - -The domain will be ready immediately. You can now: -- Create users and groups for NethVoice extensions -- Manage user authentication -- Configure NethVoice to use this domain - -:::tip -Keep the OpenLDAP admin credentials in a secure location. You'll need them for administrative tasks. -::: - - -For advanced scenarios (external LDAP, Active Directory, DNS setup, password policies, user management), see the [official NethServer 8 User Domains documentation](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.htm). - -Key topics in the official docs: -- **Active Directory Setup**: Complete domain controller configuration -- **External LDAP Connection**: Binding to existing LDAP servers -- **Password Policies**: Age, strength, and expiration settings -- **User Management Portal**: Self-service password changes -- **LDAP Provider Replicas**: Fault tolerance and redundancy -- **LDAP binding settings**: Connect external application to a local-running LDAP server +1. **Install NethVoice**: Proceed with [NethVoice installation](nethvoice_install) via the Software Center +2. **Register NethServer**: Activate your [Enterprise subscription](#register-nethserver) ## Register NethServer {#register-nethserver} diff --git a/docs/administrator-manual/install/nethvoice_install.md b/docs/administrator-manual/install/nethvoice_install.md index 4d96299..cfb48e1 100644 --- a/docs/administrator-manual/install/nethvoice_install.md +++ b/docs/administrator-manual/install/nethvoice_install.md @@ -13,17 +13,60 @@ If you want a ready-to-use NethVoice installation, please consider: - a **[VoiceBox Appliance](voicebox.md)**, a hardware appliance with NethServer and NethVoice pre-installed ::: -## Overview {#overview} +## Module Installation {#module-installation} -NethVoice is installed in two steps: +1. **Access the Software Center** on your NethServer 8 system. +2. **Search for "NethVoice"** in the Software Center search bar. +3. **Click "Install"** next to NethVoice. +4. **Wait for installation** to complete (this may take a few minutes). + +## First-time setup wizard {#setup-wizard} + +Open the NethVoice application from the **Applications** page or the **Application Launcher** (the 9-dot icon in the top-right corner, or press **Ctrl + Shift + A**) in NethServer 8. A first-time configuration wizard will appear and guide you through: +- Configuring an account provider for NethVoice +- Installing and configuring the NethVoice Proxy +- Configuring the NethVoice application + +### Account Provider {#user-domains} + +The first step of the setup wizard helps you configure the user domain used by NethVoice. + +User domains store users and groups in an LDAP database. NethVoice requires a user domain to manage extensions, users, and authentication. +NethServer 8 supports two types of LDAP account providers: + +| Provider | Type | Best For | Features | +|----------|------|----------|----------| +| **OpenLDAP (RFC2307)** | Internal | Unix/Linux clients, simple setup | Lightweight, easy configuration, smaller deployments, multiple instances per node | +| **Active Directory (Samba)** | Internal | Windows clients, SMB file sharing | Domain controller, Windows compatibility, higher complexity, one instance per node | +| **External LDAP** | External | Existing LDAP infrastructure | Connect to existing servers (Active Directory, OpenLDAP, etc.) | + + +:::info NethVoice Requirement +NethVoice requires at least one configured user domain. Choose **OpenLDAP (RFC2307)** for simpler deployments or **Active Directory** if you need Windows client support. +::: + +#### Quick Setup: OpenLDAP (Recommended for NethVoice) {#quick-setup-openldap-recommended-for-nethvoice} -1. **NethVoice Proxy** (required first) -2. **NethVoice** module(s) +The setup wizard lets you quickly and easily install an OpenLDAP account provider. To configure it, you have to: -The NethVoice Proxy is a mandatory component that must be installed and configured **before** deploying NethVoice instances. This applies even if you are installing only a single NethVoice instance. +- **Enter domain name** (e.g., `nethvoice.local`) - this is a logical name, not DNS-related +- **Set OpenLDAP admin username and password** -:::warning Installation Order -**NethVoice Proxy must be installed FIRST, before NethVoice.** +For advanced scenarios (external LDAP, Active Directory, DNS setup, password policies, user management), see the [official NethServer 8 User Domains documentation](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.html). + +Key topics in the official docs: +- **Active Directory Setup**: Complete domain controller configuration +- **External LDAP Connection**: Binding to existing LDAP servers +- **Password Policies**: Age, strength, and expiration settings +- **User Management Portal**: Self-service password changes +- **LDAP Provider Replicas**: Fault tolerance and redundancy +- **LDAP binding settings**: Connect external application to a local-running LDAP server + +### NethVoice Proxy + +The next step of the first setup wizard installs and configures the NethVoice Proxy. + +NethVoice Proxy is a component that must be installed and configured before deploying NethVoice application instances. Even with a single NethVoice installation, the proxy is essential for proper network traffic management. The proxy handles all external internet access and manages SIP/RTP traffic routing. It is required for: - External access from the internet @@ -31,120 +74,107 @@ The proxy handles all external internet access and manages SIP/RTP traffic routi - Managing SIP and RTP connections for all NethVoice instances - SSL/TLS termination for internet-facing VoIP traffic -Even with a single NethVoice installation, the proxy is essential for proper network traffic management. -::: - -## Installation Steps {#installation-steps} - -### Step 1: Install NethVoice Proxy {#step-1-install-nethvoice-proxy} +NethVoice Proxy is a standard NethServer 8 application: its settings can be reviewed and changed by accessing it from the **Applications** page or the **Application Launcher** (the 9-dot icon in the top-right corner, or press **Ctrl + Shift + A**). -1. **Access the Software Center** on your NethServer 8 system. -2. **Search for "NethVoice Proxy"** in the Software Center search bar. -3. **Click "Install"** next to NethVoice Proxy. -4. **Wait for installation** to complete (this may take a few minutes). -5. **Proceed to proxy configuration** before moving to the next step (see [NethVoice Proxy Configuration](#step-2-configure-nethvoice-proxy)). +#### Prerequisites -:::tip Important -Ensure NethVoice Proxy is fully installed and configured with proper FQDNs and DNS records before proceeding to install NethVoice instances. -::: +Before configuring NethVoice Proxy, ensure: -### Step 2: Configure NethVoice Proxy {#step-2-configure-nethvoice-proxy} +1. **DNS Records Created**: Create a DNS A/AAAA record for the proxy domain (e.g., `proxy.nethserver.org`) pointing to your public IP address +2. **Public IP Address**: Identify the public IPv4 or IPv6 address where the proxy will be accessible from the internet +3. **Network Interface**: Identify which network interface will handle VoIP traffic -Before installing NethVoice, you must configure the NethVoice Proxy: +The setup wizard detects automatically if there already is a proxy on the installation node of NethVoice and proposes to install it if needed. Then, to configure the NethVoice Proxy: -1. **Configure the proxy domain** this is the public FQDN where the proxy will be reachable. +1. **Configure the Proxy domain** this is the public FQDN where the proxy will be reachable. Do not enter NethServer FQDN but use a dedicated one, like `proxy.nethserver.org`. This name will be used by external clients to reach your VoIP services, but it will not be used directly by final users. -2. **Set the network interface** that will handle VoIP traffic -3. **Configure public IP address** if different from the interface IP +2. **Enable Request Let's Encrypt certificate** checkbox if needed: a Let's Encrypt certificate will be requested for the proxy domain. +3. **Set the Network interface** that will handle VoIP traffic +4. **Configure Public IP address** if different from the interface IP -Above configuration will be the entry point for all external VoIP traffic. +The above configuration will be the entrypoint for all external VoIP traffic. Make sure that: - the configured FQDN resolves correctly to the public IP address - any DNS records are properly set up to point to the proxy -Those requeirements are critical to obtain a valid SSL/TLS certificate for secure communications. +These requirements are critical to obtain a valid SSL/TLS certificate for secure communications. See [NethVoice Proxy Documentation](../advanced/nethvoice_proxy.md) for more info. -### Step 3: Install NethVoice {#step-3-install-nethvoice} +### NethVoice application -Once the NethVoice Proxy is running, you can install NethVoice instances: +:::warning DNS configuration +To set up NethVoice, you need to have two dedicated virtual hosts: -1. **Return to Software Center** on your NethServer 8 system. -2. **Search for "NethVoice"** in the Software Center search bar. -3. **Click "Install"** next to NethVoice. -4. **Wait for installation** to complete. -5. **Proceed with Module Configuration** as described in the next section. -6. **Access the NethVoice instance** and follow the initial configuration wizard to complete the setup. - -:::info Multiple Instances -You can install multiple NethVoice instances on the same node. Each will use the shared NethVoice Proxy for external access and traffic routing. Each instance requires separate configuration and dedicated FQDNs. -::: +- A **NethVoice base host** for the NethVoice administration interface, eg. `nethvoice.nethserver.org` +- A **NethVoice CTI base host** for the NethVoice CTI web application, eg. `cti.nethserver.org` +Before proceeding with the configuration, ensure that you have created the corresponding DNS records for these FQDNs in your DNS server. -## Module Configuration {#module-configuration} +If you plan to use a Let's Encrypt certificate as the default certificate, make sure you have the necessary public DNS records. +::: -:::warning Required Prerequisites -Before proceeding with the configuration of any NethVoice instance, ensure: +In the last step of the setup wizard, you will be prompted to provide the following information: -1. **NethVoice Proxy is installed** - See [NethVoice Proxy Installation](../advanced/nethvoice_proxy.md) -2. **NethVoice Proxy is configured** - Proxy domain (FQDN) must be set and DNS records created -3. **NethVoice Proxy is running** - Verify proxy status in the node management interface -4. **User Domain is created** - See [User Domains in NethServer Installation](./nethserver.md#user-domains) (required for NethVoice users and extensions) +- **NethVoice base host**: Enter a valid FQDN to access the application administration page; this is where you will manage NethVoice settings, e.g. `nethvoice.nethserver.org`. +- **NethVoice CTI base host**: Enter a valid FQDN for the NethVoice CTI web application, e.g. `cti.nethserver.org`. +- **Request Let's Encrypt certificate**: If enabled, a Let's Encrypt certificate will be requested for both the **NethVoice base host** and the **NethVoice CTI base host**. +- **Timezone**: Select the appropriate timezone for your NethVoice application; this is important for accurate call logging and scheduling. +- **Admin password to access user interface**: Sets the password for the NethVoice administration page. -The NethVoice module requires at least one user domain to manage users, extensions, and authentication. If you haven't created a user domain yet, follow the [User Domains setup guide](./nethserver.md#user-domains) before configuring NethVoice. -::: +### Next steps {#next-steps} +At the end of the first-time setup wizard, NethVoice will be accessible on the base host configured, e.g.: +``` +https://nethvoice.nethserver.org +``` -To set up NethVoice, you need to have two dedicated virtual hosts: +To access the NethVoice administration interface, use the following credentials: -- one for the NethVoice administration page, eg. `nethvoice.nethserver.org` -- one for the NethVoice CTI web application, eg. `cti.nethserver.org` +- User: `admin` +- Password: The password you have chosen in the first-time setup wizard +After completing NethVoice configuration in the administration interface, users can access NethVoice CTI on the base host configured, e.g.: +``` +https://cti.nethserver.org +``` -Before proceeding with the configuration, ensure that you have created the corresponding DNS records for these FQDNs in your DNS server. +## Module Configuration {#module-configuration} -If you plan to use a Let's Encrypt certificate as the default certificate, make sure you have the necessary public DNS records. +The settings of the NethVoice module can be reviewed and changed by accessing the NethVoice module of NethServer 8. To do this: -During the module configuration wizard, you will be prompted to provide the following information: +- Access the NethServer cluster administration page. +- Open the NethVoice application from the **Applications** page or the **Application Launcher** (the 9-dot icon in the top-right corner, or press **Ctrl + Shift + A**). +- Go to the specific configuration page you want to modify. -- **NethVoice base host**: Insert a valid FQDN to access the application administration page, this is where you will manage NethVoice settings, eg. `nethvoice.nethserver.org`. -- **NethVoice CTI base host**: Insert a valid FQDN to access the NethVoice CTI web application, eg. `cti.nethserver.org`. -- **User Domain**: Choose one of the [user domains](./nethserver.md#user-domains) already configured. -- **Timezone**: Select the appropriate timezone for your NethVoice instance, this is important for accurate call logging and scheduling. -- **Request Let's Encrypt certificate**: If enabled, a Let's Encrypt certificate will be requested for each of the two hosts. -- **Reports Prefix**: Insert the international telephone prefix to be considered local in the reporting system. -- **Reset NethVoice admin password to access user interface**: Insert a valid password for the NethVoice administrator user (optional, the default password is *Nethesis,1234*). +On the **Settings** page you can review and change most of the configuration parameters: -Advanced configuration options: +- **NethVoice base host**: virtual host for the NethVoice administration interface. +- **NethVoice CTI base host**: virtual host for NethVoice CTI web application. +- **Request Let's Encrypt certificate**: if enabled, a Let's Encrypt certificate will be requested for both the **NethVoice base host** and the **NethVoice CTI base host**. +- **Account provider**: user domain used by NethVoice. +- **Timezone**: timezone for your NethVoice application, this is important for accurate call logging and scheduling. +- **Reports prefix**: telephone prefix number used in reports +- **New admin password for NethVoice**: define a new password for the `admin` user -- **Deepgram API Key**: Insert your Deepgram API key to enable advanced speech recognition features and voice transcription. - - **Enable call transcription**: Enable this option to allow users to transcribe calls in real-time using Deepgram's speech-to-text service. This feature incurs additional costs based on your Deepgram usage. - - **Voicemail transcription**: Enable voicemail transcription to convert voicemail messages to text using Deepgram. This feature also incurs additional costs based on your Deepgram usage. +On the **Integrations** page you can configure call and voicemail transcription: +- **Deepgram API Key**: Enter your Deepgram API key to enable advanced speech recognition features and voice transcription. +- **Call transcription**: Enable this option to allow users to transcribe calls in real-time using Deepgram's speech-to-text service. This feature incurs additional costs based on your Deepgram usage. +- **Voicemail transcription**: Enable voicemail transcription to convert voicemail messages to text using Deepgram. This feature also incurs additional costs based on your Deepgram usage. :::info Voice Transcription For detailed information on how users can access and use voice transcription features, see [Voice Transcription](../../user-manual/nethcti/other.md#voice-transcription) in the User Manual. ::: -The following options are available only with an active Enterprise subscription: +On the **Rebranding** page you can customize the NethVoice user interface with the brand identity of your company. To enable this feature, you have to contact Nethesis sales team and have an active Enterprise subscription. + +On the **Hotel** page you can configure the Hotel module; an active subscription is required for this feature. -- **Enable Hotel module**: Activate the Hotel module for managing hotel-specific telephony features. - See [NethVoice Hotel Module Documentation](/docs/administrator-manual/nethhotel/index.md) for more details. +- **Status**: Activate the Hotel module for managing hotel-specific telephony features. - **Hotel FIAS server host**: Enter the IP address or hostname of the Hotel FIAS server. - **Hotel FIAS server port**: Specify the port number for the Hotel FIAS server connection. -## Next steps {#next-steps} - -After saving the configuration parameters, NethVoice will be accessible on its base host, eg: -``` -https://nethvoice.nethserver.org -``` - -To access the NethVoice administration interface, use the following credentials: - -- User: `admin` -- Password: `Nethesis,1234`, the default password if the *Reset NethVoice admin password to access user interface* option was not used during the configuration - +See [NethVoice Hotel Module Documentation](/docs/administrator-manual/nethhotel/) for more details. diff --git a/docs/administrator-manual/install/voicebox.md b/docs/administrator-manual/install/voicebox.md index 6cdc042..1b2171f 100644 --- a/docs/administrator-manual/install/voicebox.md +++ b/docs/administrator-manual/install/voicebox.md @@ -119,7 +119,7 @@ Register the NethServer 8 instance in the service center: - Complete the registration process :::note User Database -The appliance comes pre-configured with an internal LDAP user database. To use an existing user database instead, see [User Domains Configuration in NethServer](nethserver.md#user-domains). +The appliance comes pre-configured with an internal LDAP user database. To use an existing user database instead, see [User Domains Configuration](nethvoice_install.md#user-domains). ::: ### 3. Enable Let's Encrypt Certificates diff --git a/docs/tutorial/index.md b/docs/tutorial/index.md index 774954b..8d99bab 100644 --- a/docs/tutorial/index.md +++ b/docs/tutorial/index.md @@ -12,7 +12,7 @@ Designed to run on [NethServer](https://www.nethserver.org/), NethVoice supports This guide will walk you through the basic steps to set up NethVoice on your system. -## 1. Install NethServer 8 {#1-install-nethserver-8} +## 1. Install NethServer 8 {#install-nethserver-8} Begin by installing NethServer 8 on your server. - Download and follow the installation instructions from the [official guide](https://docs.nethserver.org/projects/ns8/en/latest/install.html). @@ -21,25 +21,17 @@ Begin by installing NethServer 8 on your server. - **Password:** `Nethesis,1234` - Create a cluster and ensure your server has a static IP address and a valid FQDN. -## 2. Install and Configure NethVoice Proxy {#2-install-and-configure-nethvoice-proxy} - -The NethVoice Proxy is required to enable secure remote access to NethVoice services. -- Install the NethVoice Proxy module from the Software Center. -- Assign a valid FQDN (e.g., `proxy.yourdomain.org`) and ensure the DNS record is configured. -- Configure the network interface and public IP as needed. -- Only one NethVoice Proxy can be installed per node. -- For detailed steps, refer to the [NethVoice Proxy documentation](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#step-1-install-nethvoice-proxy). - -## 3. Install NethVoice Module {#3-install-nethvoice-module} +## 2. Install NethVoice Module {#install-nethvoice-module} Once the proxy is configured, you can install the NethVoice module: - Open the **Software Center** from the web interface. - Search for the NethVoice application and click **Install**. - For more information, see the [Software Center documentation](https://docs.nethserver.org/projects/ns8/en/latest/software_center.html). -## 4. Configure NethVoice {#4-configure-nethvoice} +## 3. Configure NethVoice {#configure-nethvoice} After installation, configure your NethVoice instance: +- Follow the [first-time setup wizard](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#setup-wizard) - Follow the [NethVoice configuration guide](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#module-configuration) for detailed setup instructions. - Complete the initial configuration, add users, and set up your telephony environment as needed. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md index 2793a55..4ee7fe5 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md @@ -5,7 +5,7 @@ sidebar_position: 5 # NethVoice Proxy -## Panoramica +## Panoramica {#overview} NethVoice Proxy è un componente critico che gestisce tutto il traffico VoIP esterno per le istanze di NethVoice. Agisce come gateway per le connessioni SIP e RTP basate su Internet, abilitando l'accesso esterno sicuro al tuo sistema telefonico. @@ -20,7 +20,7 @@ NethVoice Proxy fornisce: **Importante**: NethVoice Proxy è richiesto per ogni distribuzione di NethVoice, anche con una singola istanza. Gestisce l'accesso a Internet esterno e deve essere installato e configurato prima di distribuire eventuali istanze di NethVoice. ::: -## Architettura +## Architettura {#architecture} Il modulo NethVoice Proxy è costruito su due componenti open-source principali: @@ -31,9 +31,9 @@ Il modulo NethVoice Proxy è costruito su due componenti open-source principali: Questi componenti lavorano insieme per gestire tutte le connessioni SIP e RTP in entrata e in uscita tra le tue istanze di NethVoice e le reti VoIP esterne (Internet, trunk, uffici remoti, utenti mobili). -## Ruolo nelle distribuzioni di NethVoice +## Ruolo nelle distribuzioni di NethVoice {#role-in-nethvoice-deployments} -### Distribuzione con singola istanza +### Distribuzione con singola istanza {#single-instance-deployment} Anche con una singola installazione di NethVoice, NethVoice Proxy è essenziale: - Agisce come interfaccia esterna per il traffico VoIP basato su Internet @@ -41,7 +41,7 @@ Anche con una singola installazione di NethVoice, NethVoice Proxy è essenziale: - Gestisce l'attraversamento NAT per le connessioni mobili e remote - Fornisce un singolo dominio affinché gli utenti esterni raggiungano il tuo PBX -### Distribuzione con più istanze +### Distribuzione con più istanze {#multi-instance-deployment} Con più istanze di NethVoice sullo stesso nodo, NethVoice Proxy fornisce: - **Punto di ingresso esterno unico**: I chiamanti esterni utilizzano un FQDN (il dominio proxy) @@ -67,58 +67,55 @@ In questo scenario: - Ogni istanza opera in modo indipendente mentre condivide l'accesso esterno ::: -## Installazione +## Installazione {#installation} -:::note -Puoi installare solo un NethVoice Proxy per nodo dal Software Center. -::: - -NethVoice Proxy deve essere installato **prima** di distribuire qualsiasi istanza di NethVoice. Vedi [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza di installazione completa. +### Installazione consigliata: {#installation-steps} -### Passaggi di installazione +Il NethVoice Proxy viene installato come parte della procedura guidata di configurazione del modulo NethVoice. Consulta [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza completa di installazione. -1. **Apri l'interfaccia di gestione di NethServer** sul tuo nodo -2. **Naviga a Software Center** -3. **Cerca "NethVoice Proxy"** -4. **Fai clic su "Installa"** e attendi il completamento dell'installazione -5. **Procedi alla configurazione** (vedi la sezione sottostante) +### Installazione manuale (non consigliata): -:::warning Ordine di installazione -Non tentare di installare NethVoice prima di installare e configurare NethVoice Proxy. L'installazione non riuscirà se il proxy non è disponibile. +:::note +È possibile installare un solo NethVoice Proxy per ogni nodo dal Software Center. +::: -## Configurazione +NethVoice Proxy deve essere installato **prima** di configurare qualsiasi istanza di NethVoice. -La configurazione di NethVoice Proxy è essenziale prima di installare le istanze di NethVoice. Il proxy richiede un FQDN dedicato e impostazioni di rete appropriate. +1. **Aprire l'interfaccia di gestione di NethServer** +2. **Navigare al Software Center** +3. **Cercare "NethVoice Proxy"** +4. **Fare clic su "Installa"** e attendere il completamento dell'installazione +5. **Procedere alla configurazione** (vedere la sezione seguente) -:::warning Configurazione richiesta -NethVoice Proxy deve essere completamente configurato e operativo prima di installare le istanze di NethVoice. Verifica che la configurazione sia completa e che il proxy sia in esecuzione prima di procedere all'installazione di NethVoice. -::: +## Configurazione {#configuration} -### Prerequisiti +### Prerequisiti {#prerequisites} Prima di configurare NethVoice Proxy, assicurati che: 1. **Record DNS creati**: Crea un record DNS A/AAAA per il dominio proxy (ad es. `proxy.nethserver.org`) che punta al tuo indirizzo IP pubblico -2. **Indirizzo IP pubblico**: Conosci l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet +2. **Indirizzo IP pubblico**: Identifica l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet 3. **Interfaccia di rete**: Identifica quale interfaccia di rete gestirà il traffico VoIP -### Passaggi di configurazione +### Passi di configurazione {#configuration-steps} -1. **Accedi alla pagina di configurazione del proxy** nell'interfaccia di gestione di NethServer -2. **Inserisci il dominio proxy**: Imposta un FQDN valido (ad es. `proxy.nethserver.org`) - - Questo dominio deve avere un record DNS A/AAAA valido che punta al tuo IP pubblico - - I dispositivi VoIP esterni e gli uffici remoti utilizzeranno questo dominio per raggiungere il tuo sistema -3. **Seleziona interfaccia di rete**: Scegli l'interfaccia di rete che gestirà il traffico VoIP dal menu a discesa - - Tipicamente l'interfaccia collegata alla tua WAN/Internet -4. **Configura indirizzo IP pubblico**: - - Immetti l'indirizzo IPv4 o IPv6 pubblico se diverso dall'IP dell'interfaccia - - Questo è necessario se il tuo nodo è dietro un router/NAT - - Lascia vuoto se l'interfaccia ha un indirizzo IP pubblico diretto -5. **Richiedi certificato SSL**: - - Abilita Let's Encrypt se desideri la gestione automatica dei certificati SSL - - Richiede che il record DNS sia risolvibile pubblicamente +NethVoice Proxy viene solitamente configurato durante la procedura guidata di configurazione di un modulo NethVoice (consultare [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza completa di installazione). Per rivedere o modificare la configurazione del proxy: -### Esempio di configurazione +1. **Accedere alla pagina di configurazione del proxy** nell'interfaccia di gestione di NethServer +2. **Inserire il dominio del proxy**: Impostare un FQDN valido (es. `proxy.nethserver.org`) + - Questo dominio deve avere un record DNS A/AAAA valido che punti al proprio IP pubblico + - I dispositivi VoIP esterni e gli uffici remoti utilizzeranno questo dominio per raggiungere il sistema +3. **Richiedere il certificato SSL**: + - Abilitare Let's Encrypt per gestire automaticamente i certificati SSL per il dominio del proxy + - Questo richiede che il record DNS sia risolvibile pubblicamente +4. **Selezionare l'interfaccia di rete**: Scegliere l'interfaccia di rete che gestirà il traffico VoIP dal menu a tendina + - Tipicamente questa è l'interfaccia connessa alla rete WAN/Internet +5. **Configurare l'indirizzo IP pubblico**: + - Inserire l'indirizzo IPv4 o IPv6 pubblico se diverso dall'IP dell'interfaccia + - Questo è necessario se il nodo si trova dietro un router/NAT + - Lasciare vuoto se l'interfaccia ha un IP pubblico diretto + +### Esempio di configurazione {#configuration-example} **Scenario**: Nodo singolo con interfaccia di rete privata, IP pubblico dietro NAT @@ -131,9 +128,9 @@ Prima di configurare NethVoice Proxy, assicurati che: **Risultato**: I dispositivi esterni si connettono a `proxy.example.com` (203.0.113.45), il traffico si instrada internamente a 192.168.1.10 -### Casi speciali +### Casi speciali {#special-cases} -#### Solo rete locale (senza accesso a Internet) +#### Solo rete locale (senza accesso a Internet) {#local-network-only-no-internet-access} Se il proxy è accessibile solo all'interno di una rete locale e non da Internet: @@ -146,7 +143,7 @@ Let's Encrypt: Disabilitato Utilizza l'indirizzo IP privato che i dispositivi sulla tua rete locale usano per raggiungere il proxy. -#### Più IP esterni +#### Più IP esterni {#multiple-external-ips} Se il tuo nodo ha più indirizzi IP pubblici, configura il proxy con l'IP pubblico specifico che desideri per il traffico VoIP: @@ -154,14 +151,6 @@ Se il tuo nodo ha più indirizzi IP pubblici, configura il proxy con l'IP pubbli 2. Inserisci l'IP pubblico specifico nel campo "Indirizzo IP pubblico" 3. Assicurati che i record DNS puntino a questo indirizzo IP -### Passaggi successivi - -Una volta che NethVoice Proxy è completamente configurato e in esecuzione: - -1. **Verifica che il proxy sia operativo**: Controlla lo stato del proxy nell'interfaccia di gestione di NethServer -2. **Procedi all'installazione di NethVoice**: Vedi [Installazione di NethVoice](../install/nethvoice_install.md) -3. **Configura istanze di NethVoice**: Ogni istanza richiede una configurazione separata con FQDN dedicati - :::info Diagramma di rete ``` Utenti/Trunk esterni @@ -177,5 +166,3 @@ Utenti/Trunk esterni Il proxy agisce come gateway tra il traffico VoIP esterno e le istanze interne di NethVoice. ::: - -Ora puoi installare e configurare una o più istanze di NethVoice. Vedi [Installazione di NethVoice](../install/nethvoice_install.md) per i passaggi dettagliati. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md index 51eb219..d345bcd 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md @@ -7,11 +7,12 @@ sidebar_position: 4 La sezione Configurazione contiene documentazione per la gestione e il monitoraggio del sistema NethVoice dopo la configurazione iniziale. -## Pagine chiave +## Pagine chiave {#key-pages} - **[Procedura guidata](./configuration/wizard)** - Accedi alla procedura guidata di configurazione per la configurazione e la personalizzazione del sistema - **[Dashboard](./configuration/dashboard)** - Monitora lo stato del sistema, gli utenti e le informazioni di presenza - **[Applicazioni](./configuration/applications/)** - Configura applicazioni e integrazioni aggiuntive di NethVoice +- **[Modulo NethServer 8](../install/nethvoice_install.md#module-configuration)** - Configurare il modulo NethVoice :::info Per iniziare Per la configurazione iniziale di NethVoice, inizia con la [procedura guidata di configurazione](./configuration/wizard). diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md index 9fbae31..1499d28 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md @@ -20,11 +20,10 @@ Questa documentazione copre l'installazione completa, la configurazione e la ges Iniziate velocemente passando alle sezioni più importanti: - **[Guida all'Installazione](./install/index.md)** - Istruzioni complete per l'installazione, dai prerequisiti di NethServer al deployment di NethVoice -- **[Configurazione](./configuration/index.md)** - CTI, interni e gestione utenti +- **[Configurazione](./configuration/index.md)** - Gestione di NethVoice dopo la configurazione iniziale. - **[Provisioning Telefoni](./provisioning/index.md)** - Gestione automatica dei dispositivi telefonici e provisioning - **[Risorse Avanzate](./advanced/index.md)** - Configurazione di sistema e argomenti avanzati - ## Componenti Principali NethVoice è costruito su sette principali componenti open-source: @@ -92,22 +91,18 @@ Prima di distribuire NethVoice, assicuratevi di avere: - ✅ **Risorse di Sistema**: Minimo 2 vCPU, 2GB RAM, 40GB storage per istanza - ✅ **Requisiti di Rete**: IP statico, DNS configurato, connettività internet - ✅ **NethServer 8**: Completamente installato e configurato (vedere [Guida all'Installazione](./install/index.md)) -- ✅ **Dominio Utente**: Creato per utenti e autenticazione (vedere [Domini Utente nell'Installazione NethServer](./install/nethserver.md#user-domains)) -- ✅ **Proxy NethVoice**: Installato e configurato con FQDN appropriato e record DNS (richiesto per qualsiasi distribuzione di NethVoice) -### Passaggi di Distribuzione +### Passaggi di configurazione {#deployment-steps} 1. **[Verificare i Requisiti di Sistema](./install/nethserver.md#system-requirements)** - Assicuratevi che la vostra infrastruttura soddisfi i requisiti 2. **[Installare NethServer 8](./install/nethserver.md)** - Distribuire la piattaforma infrastruttura base -3. **[Creare Dominio Utente](./install/nethserver.md#user-domains)** - Configurare LDAP per utenti e autenticazione -4. **[Installare e Configurare Proxy NethVoice](./advanced/nethvoice_proxy.md)** - Distribuire il gateway VoIP esterno (RICHIESTO prima di NethVoice) -5. **[Distribuire NethVoice](./install/nethvoice_install.md)** - Installare il modulo NethVoice sopra il proxy -6. **Configurare il Vostro Sistema**: +3. **[Installa e configura NethVoice](./install/nethvoice_install.md)** - Installa i moduli NethVoice Proxy NethVoice. +4. **Configurare il Vostro Sistema**: - [Provisioning Telefoni](./provisioning/index.md) - Distribuire e configurare dispositivi telefonici - [Gestire Interni](../user-manual/nethcti/index.md) - Creare interni e assegnare agli utenti -7. **[Configurazione Avanzata](./advanced/index.md)** - Configurare trunk, gateway, instradamento e funzionalità avanzate +5. **[Configurazione Avanzata](./advanced/index.md)** - Configurare trunk, gateway, instradamento e funzionalità avanzate -## Sezioni Documentazione Principale +## Sezioni Documentazione Principale {#key-documentation-sections} | Sezione | Scopo | Argomenti | |---------|-------|----------| @@ -121,15 +116,15 @@ Potete installare più istanze di NethVoice sullo stesso nodo NethServer 8 dal S ::: :::warning Prerequisiti -Il modulo NethVoice richiede che il **proxy NethVoice** sia già installato, configurato e in esecuzione sul sistema. +Il modulo NethVoice richiede che il **NethVoice Proxy** sia già installato, configurato e in esecuzione sul sistema. -**Perché?** Il Proxy NethVoice: +**Perché?** Il NethVoice Proxy: - Gestisce tutto il traffico VoIP esterno da internet - Gestisce instradamento del traffico SIP/RTP e delegazione - Abilita l'accesso esterno anche con una singola istanza di NethVoice - Instrada il traffico tra più installazioni di NethVoice sullo stesso nodo -Se non avete ancora configurato il proxy, fare riferimento alla [documentazione Proxy NethVoice](./advanced/nethvoice_proxy.md) prima di installare NethVoice. +Se non avete ancora configurato il proxy, fare riferimento alla [documentazione NethVoice Proxy](./advanced/nethvoice_proxy.md) prima di installare NethVoice. ::: ## Subscription {#subscription} @@ -193,4 +188,3 @@ Nethesis offre una suite completa di soluzioni ICT modulari e indipendenti che r - **[NethSpot](https://www.nethesis.it/soluzioni/nethspot)** — Gestione hotspot WiFi pubblici. Migliora l'esperienza guest con proximity marketing, login social, gestione centralizzata del WiFi e controllo della banda. Tutte le soluzioni sono indipendenti dalla modalità di distribuzione: installabili su appliance certificate, macchine virtuali, cloud privati o hardware compatibile. Per maggiori informazioni visitate [www.nethesis.it](https://www.nethesis.it) o contattate [marketing@nethesis.it](mailto:marketing@nethesis.it). - diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md index f20a654..bfbc1da 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md @@ -7,27 +7,14 @@ sidebar_position: 1 Questa sezione copre il processo di installazione completo per NethVoice, dall'installazione dell'infrastruttura NethServer 8 sottostante alla configurazione di NethVoice stesso. -## Panoramica +## Panoramica {#overview} -L'installazione di NethVoice è un processo multi-passaggio: +L'installazione di NethVoice è un processo in due fasi: -1. **[Installazione di NethServer 8](nethserver.md)** - Installa la piattaforma base di NethServer 8 -2. **[Crea dominio utente](nethserver.md#user-domains)** - Configura LDAP per utenti e autenticazione (in NethServer) -3. **[Installazione e configurazione di NethVoice Proxy](../advanced/nethvoice_proxy.md)** - Installa e configura il gateway VoIP esterno (RICHIESTO per primo) -4. **[Installazione di NethVoice](nethvoice_install.md)** - Installa NethVoice sopra il proxy configurato -5. **[Configurazione del modulo](nethvoice_install.md#module-configuration)** - Configura NethVoice con i tuoi requisiti +1. **[Installazione di NethServer 8](nethserver.md)** - Installa la piattaforma base NethServer 8 +2. **[Installazione di NethVoice](nethvoice_install.md)** - Installa e configurare l'applicazione NethVoice -:::warning Ordine di installazione -1. NethServer 8 deve essere installato per primo -2. Il dominio utente deve essere creato per secondo (richiesto da NethVoice) -3. NethVoice Proxy deve essere installato e configurato per terzo -4. NethVoice può essere installato solo dopo che il proxy è pronto -5. La configurazione di NethVoice utilizza il dominio utente creato nel passaggio 2 - -Vedi [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) per i dettagli sui requisiti del proxy. -::: - -## Cos'è NethServer 8? +## Cos'è NethServer 8? {#what-is-nethserver-8} NethServer 8 (NS8) è la piattaforma infrastruttura Linux sottostante su cui gira NethVoice. Fornisce: @@ -41,9 +28,9 @@ NethServer 8 (NS8) è la piattaforma infrastruttura Linux sottostante su cui gir NethVoice richiede che NethServer 8 sia installato per primo. Assicurati di completare l'installazione di NethServer 8 prima di procedere con NethVoice. ::: -## Percorso di installazione +## Percorso di installazione {#installation-path} -### Passaggio 1: Prerequisiti +### Passaggio 1: Prerequisiti {#step-1-prerequisites} Prima di iniziare, assicurati di avere: @@ -54,7 +41,7 @@ Prima di iniziare, assicurati di avere: - Connessione Internet funzionante - Nome di dominio completamente qualificato (FQDN) registrato e risolto -### Passaggio 2: Installa NethServer 8 +### Passaggio 2: Installa NethServer 8 {#step-2-install-nethserver-8} Segui la [guida all'installazione di NethServer](nethserver.md) per: - Installare i componenti core di NethServer 8 @@ -62,47 +49,19 @@ Segui la [guida all'installazione di NethServer](nethserver.md) per: - Accedere all'interfaccia di amministrazione web - Creare il tuo cluster -### Passaggio 3: Crea dominio utente - -Crea un dominio utente per gli utenti e gli interni di NethVoice: -- Accedi all'interfaccia web di NethServer 8 → Domini e utenti -- Crea dominio (OpenLDAP consigliato per NethVoice) -- Imposta le credenziali di amministrazione -- Annota le impostazioni di bind LDAP (necessarie per la configurazione di NethVoice) - -Vedi [Setup dei domini utente](nethserver.md#user-domains) nella guida all'installazione di NethServer per i dettagli. - -### Passaggio 4: Installa NethVoice Proxy - -Dopo che NethServer 8 e il dominio utente sono pronti, installa e configura il proxy VoIP: -- Accedi al Software Center -- Installa NethVoice Proxy -- Configura il dominio proxy (FQDN) -- Imposta l'interfaccia di rete e l'IP pubblico -- Verifica che il proxy sia in esecuzione - -Vedi [Guida all'installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) per i passaggi dettagliati. - -### Passaggio 5: Installa NethVoice +### Passaggio 3: Installare e configurare NethVoice {#step-3-install-nethvoice} -Con NethVoice Proxy configurato e in esecuzione: -- Accedi al Software Center -- Installa NethVoice -- Completa la procedura guidata di configurazione di NethVoice -- Seleziona il dominio utente creato nel Passaggio 3 -- Configura gli host virtuali e i certificati +Segui la [Guida all'installazione di NethVoice](nethvoice_install.md) per: +- Installare NethVoice +- Completare la configurazione guidata: + - Configurare un provider di account + - Installare e configurare un NethVoice Proxy + - Configurare virtual host, certificati e password di amministrazione +- Accedere all'interfaccia di amministrazione di NethVoice e CTI -### Passaggio 6: Configura NethVoice +## Quick Reference {#quick-reference} -Segui la [guida all'installazione di NethVoice](nethvoice_install.md) per: -- Configurare gli host virtuali di NethVoice -- Verificare che il dominio utente sia selezionato -- Configurare i certificati Let's Encrypt -- Accedere all'amministrazione e CTI di NethVoice - -## Riferimento veloce - -### Requisiti di sistema (Minimo) +### Requisiti minimi di sistema {#system-requirements-minimum} | Componente | Requisito | |-----------|-------------| @@ -113,7 +72,7 @@ Segui la [guida all'installazione di NethVoice](nethvoice_install.md) per: | OS | **Rocky Linux 9** (subscription supportato) - AlmaLinux 9, CentOS Stream 9, Debian 12 (community supportato) | | Browser | Firefox, Chrome o Chromium (versione attuale) | -### Metodi di installazione +### Metodi di installazione {#installation-methods} **NethServer 8** può essere installato tramite: - Script di installazione standard (consigliato) @@ -137,7 +96,7 @@ Cambia le credenziali predefinite immediatamente dopo il primo accesso per motiv ## Guide dettagliate -### [Installazione di NethServer 8](nethserver.md) +### [Installazione di NethServer 8](nethserver.md) {#nethserver-8-installation} Guida completa che copre: - Requisiti di sistema e consigli hardware @@ -149,7 +108,20 @@ Guida completa che copre: - Configurazione del cluster - Risoluzione dei problemi -### [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) +### [Installazione di NethVoice](nethvoice_install.md) {#nethvoice-installation} + +Guida completa che copre: +- Installazione del software NethVoice +- Configurazione guidata: + - Dominio utenti + - NethVoice Proxy + - Virtual host (host base) + - Certificati Let's Encrypt + - Password di amministrazione +- Accesso amministratore +- Configurazione iniziale + +### [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) {#nethvoice-proxy-installation} Guida completa che copre: - Panoramica del proxy e architettura @@ -158,21 +130,9 @@ Guida completa che copre: - Configurazione (dominio, interfaccia, IP pubblico) - Configurazione del certificato SSL - Verifica e test -- Deve essere installato PRIMA di NethVoice +- Deve essere installato prima di NethVoice -### [Installazione di NethVoice](nethvoice_install.md) - -Guida completa che copre: -- Ordine di installazione (Proxy → NethVoice) -- Installazione software di NethVoice -- Configurazione del modulo -- Configurazione dell'host virtuale -- Configurazione del dominio utente -- Configurazione del certificato Let's Encrypt -- Accesso amministratore -- Configurazione iniziale - -## Elenco di controllo dell'installazione +## Checklist dell'installazione {#installation-checklist} Prima di iniziare, assicurati che: @@ -185,18 +145,7 @@ Prima di iniziare, assicurati che: - [ ] La connessione Internet è stabile - [ ] Hai accesso amministrativo al server -Durante l'installazione, assicurati di completare: - -- [ ] Installazione di NethServer 8 -- [ ] Creazione del dominio utente (OpenLDAP consigliato) -- [ ] Annota le impostazioni di bind LDAP -- [ ] Installazione di NethVoice Proxy -- [ ] Configurazione di NethVoice Proxy -- [ ] Verifica che il proxy sia in esecuzione prima dell'installazione di NethVoice -- [ ] Installazione di NethVoice -- [ ] Configurazione di NethVoice con il dominio utente - -## Note importanti +## Note importanti {#important-notes} :::info **Solo piattaforme supportate**: Installa NethServer 8 solo su distribuzioni supportate. Sistemi desktop e server che eseguono altri servizi non sono supportati. @@ -225,9 +174,9 @@ Dopo l'installazione iniziale, NethServer 8 supporta: Vedi la [documentazione di NethServer 8](https://docs.nethserver.org/projects/ns8/) per i dettagli del clustering. -## Risoluzione dei problemi +## Risoluzione dei problemi {#troubleshooting} -### Problemi comuni +### Problemi comuni {#common-issues} **Non è possibile accedere all'interfaccia web** - Verifica la configurazione dell'indirizzo IP statico @@ -249,7 +198,7 @@ Vedi la [documentazione di NethServer 8](https://docs.nethserver.org/projects/ns Per ulteriore aiuto, consulta le guide dettagliate o la documentazione di NethServer 8. -## Passaggi successivi +## Passaggi successivi {#next-steps} Dopo l'installazione completata con successo: @@ -261,4 +210,4 @@ Dopo l'installazione completata con successo: --- -**Pronto per iniziare?** Inizia con la [guida all'installazione di NethServer 8](nethserver.md). +**Pronto per iniziare?** Inizia con la [guida all'installazione di NethServer 8](nethserver.md). \ No newline at end of file diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md index 29fa990..ddcea59 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md @@ -7,7 +7,6 @@ sidebar_position: 2 NethVoice gira sopra **NethServer 8 (NS8)**, una piattaforma infrastruttura Linux unificata open-source. Questa pagina ti guida attraverso l'installazione di NethServer 8, che è un prerequisito per l'installazione di NethVoice. - :::tip Se desideri un'installazione pronta all'uso di NethServer, prendi in considerazione il nostro servizio **[NethServer 8 SaaS](saas.md#nethserver-8-saas)**, che fornisce un'istanza NethServer completamente gestita nel cloud. ::: @@ -95,15 +94,15 @@ Per accedere all'interfaccia web di NethServer 8, utilizza una versione aggiorna - Chrome - Chromium -## Metodi di installazione +## Metodi di installazione {#installation-methods} NethServer 8 può essere installato utilizzando due metodi: -### Metodo 1: Procedura standard +### Metodo 1: Procedura standard {#method-1-standard-procedure} Per la maggior parte delle installazioni, utilizza la procedura di installazione standard. -#### Passaggi di installazione +#### Passaggi di installazione {#installation-steps} 1. **Installa curl** (se non già disponibile): ```bash @@ -117,13 +116,13 @@ curl https://raw.githubusercontent.com/NethServer/ns8-core/ns8-stable/core/insta 3. **Attendi il completamento**: Lo script installerà tutti i componenti core di NethServer 8. -### Metodo 2: Immagine di macchina virtuale pre-costruita +### Metodo 2: Immagine di macchina virtuale pre-costruita {#method-2-pre-built-virtual-machine-image} Un'immagine Rocky Linux 9 pre-costruita è disponibile per la distribuzione rapida su piattaforme virtuali. Vedi la documentazione ufficiale di NethServer per più dettagli: [Immagini pre-costruite di NethServer 8](https://docs.nethserver.org/projects/ns8/en/latest/install.html#pre-built-image). -## Passaggi post-installazione +## Passaggi post-installazione {#post-installation-steps} Dopo il completamento dell'installazione: @@ -141,60 +140,10 @@ Ulteriori informazioni disponibili nella [documentazione ufficiale di NethServer Dopo la configurazione del cluster, puoi: -1. **Installa dominio utente**: [Configura LDAP o Active Directory](#user-domains) -2. **Installa NethVoice**: Procedi con l'[installazione di NethVoice](nethvoice_install) tramite il Software Center -3. **Registra NethServer**: Attiva il tuo [abbonamento Enterprise](#register-nethserver) - -## Domini utente {#user-domains} - -I domini utente archiviano utenti e gruppi in un database LDAP. NethVoice richiede almeno un dominio utente per gestire interni, utenti e autenticazione. - -### Panoramica - -NethServer 8 supporta due tipi di provider di account LDAP: - -| Provider | Tipo | Ideale per | Funzionalità | -|----------|------|----------|----------| -| **OpenLDAP (RFC2307)** | Interno | Client Unix/Linux, setup semplice | Lightweight, configurazione facile, distribuzioni più piccole, più istanze per nodo | -| **Active Directory (Samba)** | Interno | Client Windows, condivisione file SMB | Domain controller, compatibilità Windows, complessità più elevata, un'istanza per nodo | -| **LDAP esterno** | Esterno | Infrastruttura LDAP esistente | Connessione a server esistenti (Active Directory, OpenLDAP, ecc.) | - -:::info Requisito di NethVoice -NethVoice richiede almeno un dominio utente configurato. Scegli **OpenLDAP (RFC2307)** per distribuzioni più semplici o **Active Directory** se hai bisogno del supporto del client Windows. -::: - -### Setup veloce: OpenLDAP (consigliato per NethVoice) - -OpenLDAP è l'opzione più semplice per distribuzioni solo NethVoice: - -1. **Accedi all'interfaccia web di NethServer 8** dopo il completamento dell'installazione -2. **Naviga alla sezione Domini e utenti** -3. **Fai clic su "Crea dominio"** e scegli **"Interno"** -4. **Seleziona "OpenLDAP"** come provider -5. **Immetti il nome del dominio** (ad es. `nethvoice.local`) - questo è un nome logico, non correlato a DNS -6. **Imposta il nome utente e la password dell'amministratore di OpenLDAP** -7. **Fai clic su "Installa provider"** - -Il dominio sarà pronto immediatamente. Puoi ora: -- Creare utenti e gruppi per gli interni di NethVoice -- Gestire l'autenticazione dell'utente -- Configurare NethVoice per utilizzare questo dominio - -:::tip -Mantieni le credenziali dell'amministratore di OpenLDAP in un luogo sicuro. Le avrai bisogno per attività amministrative. -::: - -Per scenari avanzati (LDAP esterno, Active Directory, setup DNS, policy di password, gestione utenti), vedi la [documentazione ufficiale dei domini utente di NethServer 8](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.htm). - -Argomenti chiave nella documentazione ufficiale: -- **Setup di Active Directory**: Configurazione completa del domain controller -- **Connessione LDAP esterna**: Binding a server LDAP esistenti -- **Policy di password**: Impostazioni di età, forza e scadenza -- **Portale di gestione utenti**: Modifiche della password self-service -- **Repliche del provider LDAP**: Tolleranza ai guasti e ridondanza -- **Impostazioni di binding LDAP**: Connessione di applicazione esterna a un server LDAP in esecuzione localmente +1. **Installare NethVoice**: Procedi con l'[installazione di NethVoice](nethvoice_install) tramite il Software Center +2. **Registrare NethServer**: Attiva il tuo [abbonamento Enterprise](#register-nethserver) -## Registra NethServer {#register-nethserver} +## Registrare NethServer {#register-nethserver} NethServer deve avere una subscription Enterprise per sbloccare tutte le funzionalità di NethVoice. Consulta la [sezione subscription](../index.md#subscription) per ulteriori informazioni. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md index d976171..6323e5b 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md @@ -13,134 +13,166 @@ Se desideri un'installazione di NethVoice pronta all'uso, prendi in considerazio - un **[VoiceBox Appliance](voicebox.md)**, l'appliance hardware con NethServer e NethVoice preinstallati ::: -## Panoramica +## Installazione modulo {#module-installation} -NethVoice è installato in due passaggi: - -1. **NethVoice Proxy** (richiesto per primo) -2. **Modulo/i NethVoice** - -NethVoice Proxy è un componente obbligatorio che deve essere installato e configurato **prima** di distribuire istanze di NethVoice. Ciò si applica anche se stai installando solo una singola istanza di NethVoice. +1. **Accedi al Software Center** nel tuo sistema NethServer 8. +2. **Cerca "NethVoice"** nella barra di ricerca del Software Center. +3. **Fai clic su "Installa"** accanto a NethVoice. +4. **Attendi il completamento dell'installazione** (potrebbe richiedere alcuni minuti). -:::warning Ordine di installazione -**NethVoice Proxy deve essere installato PER PRIMO, prima di NethVoice.** +## Procedura guidata di configurazione iniziale {#setup-wizard} -Il proxy gestisce tutto l'accesso a Internet esterno e gestisce l'instradamento del traffico SIP/RTP. È richiesto per: -- Accesso esterno da Internet -- Delega del traffico a più installazioni di NethVoice sullo stesso nodo -- Gestione dei collegamenti SIP e RTP per tutte le istanze di NethVoice -- Terminazione SSL/TLS per il traffico VoIP esposto a Internet +Apri l'applicazione NethVoice dalla pagina **Applicazioni** oppure dal **Menu Applicazioni** (icona a 9 punti in alto a destra, oppure premi **Ctrl + Shift + A**) in NethServer 8. Apparirà una procedura guidata di configurazione iniziale che ti guiderà attraverso: +- Configurazione di un provider di account per NethVoice +- Installazione e configurazione del NethVoice Proxy +- Configurazione dell'applicazione NethVoice -Anche con una singola installazione di NethVoice, il proxy è essenziale per una corretta gestione del traffico di rete. -::: +### Provider di account {#user-domains} -## Passaggi di installazione +Il primo passaggio della procedura guidata ti aiuta a configurare il dominio utenti utilizzato da NethVoice. -### Passaggio 1: Installa NethVoice Proxy +I domini utenti memorizzano utenti e gruppi in un database LDAP. NethVoice richiede un dominio utenti per gestire interni, utenti e autenticazione. +NethServer 8 supporta due tipi di provider di account LDAP: -1. **Accedi al Software Center** nel tuo sistema NethServer 8. -2. **Cerca "NethVoice Proxy"** nella barra di ricerca del Software Center. -3. **Fai clic su "Installa"** accanto a NethVoice Proxy. -4. **Attendi il completamento dell'installazione** (potrebbe richiedere alcuni minuti). -5. **Procedi alla configurazione del proxy** prima di passare al passaggio successivo (vedi [Configurazione di NethVoice Proxy](#step-2-configure-nethvoice-proxy)). +| Provider | Tipo | Ideale per | Funzionalità | +|----------|------|------------|--------------| +| **OpenLDAP (RFC2307)** | Interno | Client Unix/Linux, configurazione semplice | Leggero, configurazione semplice, distribuzioni di piccole dimensioni, istanze multiple per nodo | +| **Active Directory (Samba)** | Interno | Client Windows, condivisione file SMB | Controller di dominio, compatibilità Windows, maggiore complessità, una sola istanza per nodo | +| **LDAP Esterno** | Esterno | Infrastruttura LDAP esistente | Connessione a server esistenti (Active Directory, OpenLDAP, ecc.) | -:::tip Importante -Assicurati che NethVoice Proxy sia completamente installato e configurato con FQDN appropriate e record DNS prima di procedere all'installazione delle istanze di NethVoice. +:::info Requisiti di NethVoice +NethVoice richiede almeno un dominio utenti configurato. Scegli **OpenLDAP (RFC2307)** per distribuzioni più semplici o **Active Directory** se hai bisogno di supporto per client Windows. ::: -### Passaggio 2: Configura NethVoice Proxy {#step-2-configure-nethvoice-proxy} +#### Configurazione rapida: OpenLDAP (Consigliato per NethVoice) {#quick-setup-openldap-recommended-for-nethvoice} -Prima di installare NethVoice, devi configurare NethVoice Proxy: +La procedura guidata consente di installare facilmente un provider di account OpenLDAP. Per configurarlo, devi: -1. **Configura il dominio proxy** questo è l'FQDN pubblico dove il proxy sarà raggiungibile. - Non inserire l'FQDN di NethServer ma utilizzarne uno dedicato, come `proxy.nethserver.org`. - Questo nome verrà utilizzato dai client esterni per raggiungere i tuoi servizi VoIP, ma - non verrà utilizzato direttamente dagli utenti finali. -2. **Imposta l'interfaccia di rete** che gestirà il traffico VoIP -3. **Configura l'indirizzo IP pubblico** se diverso dall'IP dell'interfaccia +- **Inserire il nome del dominio** (es. `nethvoice.local`) - questo è un nome logico, non correlato al DNS +- **Impostare nome utente e password dell'amministratore di OpenLDAP** -La configurazione precedente sarà il punto di ingresso per tutto il traffico VoIP esterno. +Per scenari avanzati (LDAP esterno, Active Directory, configurazione DNS, politiche di password, gestione utenti), consulta la [documentazione ufficiale sui domini utenti di NethServer 8](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.html). -Assicurati che: -- l'FQDN configurato si risolva correttamente all'indirizzo IP pubblico -- eventuali record DNS siano configurati correttamente per puntare al proxy +Argomenti chiave nella documentazione ufficiale: +- **Configurazione di Active Directory**: Configurazione completa del controller di dominio +- **Connessione LDAP esterno**: Collegamento a server LDAP esistenti +- **Politiche di password**: Età, complessità e scadenza delle password +- **Portale di gestione utenti**: Modifica autonoma delle password da parte degli utenti +- **Repliche del provider LDAP**: Tolleranza ai guasti e ridondanza +- **Impostazioni di binding LDAP**: Collegamento di applicazioni esterne a un server LDAP locale -Questi requisiti sono critici per ottenere un certificato SSL/TLS valido per le comunicazioni sicure. +### NethVoice Proxy -Vedi [Documentazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) per ulteriori informazioni. +Il passaggio successivo della procedura guidata iniziale installa e configura il NethVoice Proxy. -### Passaggio 3: Installa NethVoice +Il NethVoice Proxy è un componente che deve essere installato e configurato prima di configurare le istanze applicative di NethVoice. Anche con una sola installazione di NethVoice, il proxy è essenziale per una corretta gestione del traffico di rete. -Una volta che NethVoice Proxy è in esecuzione, puoi installare le istanze di NethVoice: +Il proxy gestisce tutto l'accesso esterno a Internet e il routing del traffico SIP/RTP. È necessario per: +- Accesso esterno da Internet +- Delegazione del traffico verso più installazioni NethVoice sullo stesso nodo +- Gestione delle connessioni SIP e RTP per tutte le istanze di NethVoice +- Terminazione SSL/TLS per il traffico VoIP esposto a Internet -1. **Torna al Software Center** nel tuo sistema NethServer 8. -2. **Cerca "NethVoice"** nella barra di ricerca del Software Center. -3. **Fai clic su "Installa"** accanto a NethVoice. -4. **Attendi il completamento dell'installazione**. -5. **Procedi con la configurazione del modulo** come descritto nella sezione successiva. -6. **Accedi all'istanza di NethVoice** e segui la procedura guidata di configurazione iniziale per completare la configurazione. +Il NethVoice Proxy è un'applicazione standard di NethServer 8: le sue impostazioni possono essere riviste e modificate accedendo dalla pagina **Applicazioni** oppure dal **Menu Applicazioni** (icona a 9 punti in alto a destra, oppure premi **Ctrl + Shift + A**). -:::info Più istanze -Puoi installare più istanze di NethVoice sullo stesso nodo. Ognuna utilizzerà il NethVoice Proxy condiviso per l'accesso esterno e l'instradamento del traffico. Ogni istanza richiede una configurazione separata e FQDN dedicati. -::: +#### Prerequisiti {#prerequisiti} -## Configurazione del modulo {#module-configuration} +Prima di configurare il NethVoice Proxy: -:::warning Prerequisiti richiesti -Prima di procedere con la configurazione di qualsiasi istanza di NethVoice, assicurati che: +1. **Record DNS creati**: Crea un record DNS A/AAAA per il dominio del proxy (es. `proxy.nethserver.org`) che punti al tuo indirizzo IP pubblico +2. **Indirizzo IP pubblico**: Identifica l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet +3. **Interfaccia di rete**: Identifica quale interfaccia di rete gestirà il traffico VoIP -1. **NethVoice Proxy sia installato** - Vedi [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) -2. **NethVoice Proxy sia configurato** - Il dominio proxy (FQDN) deve essere impostato e i record DNS creati -3. **NethVoice Proxy sia in esecuzione** - Verifica lo stato del proxy nell'interfaccia di gestione del nodo -4. **Il dominio utente sia creato** - Vedi [Domini utente nell'installazione di NethServer](./nethserver.md#user-domains) (richiesto per gli utenti e gli interni di NethVoice) +La procedura guidata rileva automaticamente se esiste già un proxy sul nodo di installazione di NethVoice e propone di installarlo se necessario. Successivamente, per configurare il NethVoice Proxy: -Il modulo NethVoice richiede almeno un dominio utente per gestire utenti, interni e autenticazione. Se non hai ancora creato un dominio utente, segui la [guida alla configurazione dei domini utente](./nethserver.md#user-domains) prima di configurare NethVoice. -::: +1. **Configura il dominio del Proxy**: questo è il FQDN pubblico dove il proxy sarà raggiungibile. + Non inserire il FQDN di NethServer ma utilizza uno dedicato, come `proxy.nethserver.org`. + Questo nome sarà utilizzato dai client esterni per raggiungere i tuoi servizi VoIP, ma non sarà utilizzato direttamente dagli utenti finali. +2. **Abilita la richiesta del certificato Let's Encrypt** se necessario: verrà richiesto un certificato Let's Encrypt per il dominio del proxy. +3. **Imposta l'interfaccia di rete** che gestirà il traffico VoIP +4. **Configura l'indirizzo IP pubblico** se diverso dall'IP dell'interfaccia -Per configurare NethVoice, hai bisogno di due host virtuali dedicati: +La configurazione sopra sarà il punto di ingresso per tutto il traffico VoIP esterno. -- uno per la pagina di amministrazione di NethVoice, ad es. `nethvoice.nethserver.org` -- uno per l'applicazione web NethVoice CTI, ad es. `cti.nethserver.org` +Assicurati che: +- Il FQDN configurato risolva correttamente l'indirizzo IP pubblico +- Eventuali record DNS siano correttamente configurati per puntare al proxy -Prima di procedere con la configurazione, assicurati di aver creato i record DNS corrispondenti per questi FQDN nel tuo server DNS. +Questi requisiti sono fondamentali per ottenere un certificato SSL/TLS valido per comunicazioni sicure. -Se prevedi di utilizzare un certificato Let's Encrypt come certificato predefinito, assicurati di avere i necessari record DNS pubblici. +Consulta la [documentazione del NethVoice Proxy](../advanced/nethvoice_proxy.md) per maggiori informazioni. -Durante la procedura guidata di configurazione del modulo, ti verrà chiesto di fornire le seguenti informazioni: +### Applicazione NethVoice -- **Host base di NethVoice**: Inserisci un FQDN valido per accedere alla pagina di amministrazione dell'applicazione, qui è dove gestirai le impostazioni di NethVoice, ad es. `nethvoice.nethserver.org`. -- **Host base di NethVoice CTI**: Inserisci un FQDN valido per accedere all'applicazione web NethVoice CTI, ad es. `cti.nethserver.org`. -- **Dominio utente**: Scegli uno dei [domini utente](./nethserver.md#user-domains) già configurati. -- **Fuso orario**: Seleziona il fuso orario appropriato per la tua istanza di NethVoice, questo è importante per la registrazione e la pianificazione accurate delle chiamate. -- **Richiedi certificato Let's Encrypt**: Se abilitato, verrà richiesto un certificato Let's Encrypt per ognuno dei due host. -- **Prefisso report**: Inserisci il prefisso telefonico internazionale da considerare locale nel sistema di reporting. -- **Ripristina la password dell'amministratore di NethVoice per accedere all'interfaccia utente**: Inserisci una password valida per l'utente amministratore di NethVoice (facoltativo, la password predefinita è *Nethesis,1234*). +:::warning Configurazione DNS +Per configurare NethVoice, è necessario disporre di due virtual host dedicati: -Opzioni di configurazione avanzata: +- Un **Host base NethVoice** per l'interfaccia di amministrazione di NethVoice, ad esempio `nethvoice.nethserver.org` +- Un **Host base NethVoice CTI** per l'applicazione web NethVoice CTI, ad esempio `cti.nethserver.org` -- **Chiave API di Deepgram**: Inserisci la tua chiave API di Deepgram per abilitare funzionalità di riconoscimento vocale avanzate e trascrizione vocale. - - **Abilita trascrizione delle chiamate**: Abilita questa opzione per permettere agli utenti di trascrivere le chiamate in tempo reale utilizzando il servizio speech-to-text di Deepgram. Questa funzione comporta costi aggiuntivi in base al tuo utilizzo di Deepgram. - - **Trascrizione della segreteria telefonica**: Abilita la trascrizione della segreteria telefonica per convertire i messaggi della segreteria telefonica in testo utilizzando Deepgram. Questa funzione comporta anche costi aggiuntivi in base al tuo utilizzo di Deepgram. +Prima di procedere con la configurazione, assicurati di aver creato i corrispondenti record DNS per questi FQDN nel tuo server DNS. -:::info Trascrizione vocale -Per informazioni dettagliate su come gli utenti possono accedere e utilizzare le funzionalità di trascrizione vocale, vedi [Trascrizione Vocale](../../user-manual/nethcti/other.md#voice-transcription) nel Manuale Utente. +Se prevedi di utilizzare un certificato Let's Encrypt come certificato predefinito, assicurati di avere i necessari record DNS pubblici. ::: -Le seguenti opzioni sono disponibili solo con un abbonamento Enterprise attivo: +Nell'ultimo passaggio della procedura guidata, ti verrà richiesto di fornire le seguenti informazioni: -- **Abilita modulo hotel**: Attiva il modulo Hotel per la gestione delle funzionalità telefoniche specifiche dell'hotel. - Vedi [Documentazione del modulo NethVoice Hotel](../nethhotel/index.md) per ulteriori dettagli. -- **Host del server Hotel FIAS**: Inserisci l'indirizzo IP o il nome host del server Hotel FIAS. -- **Porta del server Hotel FIAS**: Specifica il numero di porta per la connessione al server Hotel FIAS. +- **Host base NethVoice**: Inserisci un FQDN valido per accedere alla pagina di amministrazione dell'applicazione; qui gestirai le impostazioni di NethVoice, ad esempio `nethvoice.nethserver.org`. +- **Host base NethVoice CTI**: Inserisci un FQDN valido per l'applicazione web NethVoice CTI, ad esempio `cti.nethserver.org`. +- **Richiedi certificato Let's Encrypt**: Se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'**host base NethVoice** che per l'**Host base NethVoice CTI**. +- **Fuso orario**: Seleziona il fuso orario appropriato per l'applicazione NethVoice; questo è importante per la registrazione accurata delle chiamate e la pianificazione. +- **Password amministratore per accedere all'interfaccia utente**: Imposta la password per la pagina di amministrazione di NethVoice. -## Passaggi successivi +### Passaggi successivi {#next-steps} -Dopo aver salvato i parametri di configurazione, NethVoice sarà accessibile al suo host base, ad es: +Al termine della procedura guidata di configurazione iniziale, NethVoice sarà accessibile sull'host base configurato, ad esempio: ``` -https://nethvoice.nethserver.org +https://nethvoice.nethserver.org +``` + +Per accedere all'interfaccia di amministrazione di NethVoice, utilizza le seguenti credenziali: + +- Utente: `admin` +- Password: La password scelta nella procedura guidata di configurazione iniziale + +Dopo aver completato la configurazione di NethVoice nell'interfaccia di amministrazione, gli utenti possono accedere al NethVoice CTI sull'host base configurato, ad esempio: ``` +https://cti.nethserver.org +``` + +## Configurazione del modulo {#module-configuration} + +Le impostazioni del modulo NethVoice possono essere riviste e modificate accedendo al modulo NethVoice di NethServer 8. Per farlo: + +- Accedi alla pagina di amministrazione del cluster NethServer. +- Apri l'applicazione NethVoice dalla pagina **Applicazioni** oppure dal **Menu Applicazioni** (icona a 9 punti in alto a destra, oppure premi **Ctrl + Shift + A**). +- Vai alla pagina di configurazione specifica che desideri modificare. + +Nella pagina **Impostazioni** puoi rivedere e modificare la maggior parte dei parametri di configurazione: + +- **Host base NethVoice**: virtual host per l'interfaccia di amministrazione di NethVoice. +- **Host base NethVoice CTI**: virtual host per l'applicazione web NethVoice CTI. +- **Richiedi certificato Let's Encrypt**: se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'**Host base NethVoice** che per l'**Host base NethVoice CTI**. +- **Provider di account**: dominio utenti utilizzato da NethVoice. +- **Fuso orario**: fuso orario per l'applicazione NethVoice, importante per la registrazione accurata delle chiamate e la pianificazione. +- **Prefisso dei report**: prefisso telefonico utilizzato nei report. +- **Nuova password amministratore per NethVoice**: definisci una nuova password per l'utente `admin`. + +Nella pagina **Integrazioni** puoi configurare la trascrizione di chiamate e messaggi vocali: +- **API Key Deepgram**: Inserisci la tua chiave API Deepgram per abilitare funzionalità avanzate di riconoscimento vocale e trascrizione. +- **Trascrizione delle chiamate**: Abilita questa opzione per consentire agli utenti di trascrivere le chiamate in tempo reale utilizzando il servizio di conversione vocale in testo di Deepgram. Questa funzionalità comporta costi aggiuntivi in base all'utilizzo di Deepgram. +- **Trascrizione dei messaggi vocali**: Abilita la trascrizione dei messaggi vocali per convertirli in testo utilizzando Deepgram. Anche questa funzionalità comporta costi aggiuntivi in base all'utilizzo di Deepgram. + +:::info Trascrizione vocale +Per informazioni dettagliate su come gli utenti possono accedere e utilizzare le funzionalità di trascrizione vocale, consulta [Trascrizione vocale](../../user-manual/nethcti/other.md#voice-transcription) nel Manuale Utente. +::: + +Nella pagina **Rebranding** puoi personalizzare l'interfaccia utente di NethVoice con l'identità del marchio della tua azienda. Per abilitare questa funzionalità, devi contattare il team commerciale di Nethesis e avere un abbonamento Enterprise attivo. + +Nella pagina **Hotel** puoi configurare il modulo Hotel; è richiesto un abbonamento attivo per questa funzionalità. -Per accedere all'interfaccia di amministrazione di NethVoice, utilizza le seguenti credenziali: +- **Stato**: Attiva il modulo Hotel per gestire funzionalità telefoniche specifiche per hotel. +- **Host server FIAS Hotel**: Inserisci l'indirizzo IP o il nome host del server FIAS dell'hotel. +- **Porta server FIAS Hotel**: Specifica il numero di porta per la connessione al server FIAS dell'hotel. -- Utente: `admin` -- Password: `Nethesis,1234`, la password predefinita se l'opzione *Ripristina la password dell'amministratore di NethVoice per accedere all'interfaccia utente* non è stata utilizzata durante la configurazione +Consulta la [documentazione del modulo Hotel di NethVoice](/docs/administrator-manual/nethhotel/) per maggiori dettagli. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/voicebox.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/voicebox.md index b8025ab..7bc59e9 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/voicebox.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/voicebox.md @@ -119,7 +119,7 @@ Registra l'istanza di NethServer 8 nel centro servizi: - Completa il processo di registrazione :::note Database utenti -L'appliance è pre-configurata con un database utenti LDAP interno. Per usare un database utenti esistente, vedi [Configurazione dei domini utente in NethServer](nethserver.md#user-domains). +L'appliance è pre-configurata con un database utenti LDAP interno. Per usare un database utenti esistente, vedi [Configurazione dei domini utente in NethServer](nethvoice_install.md#user-domains). ::: ### 3. Abilita i certificati Let's Encrypt diff --git a/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md b/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md index a01e91f..ac356c3 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md @@ -1,5 +1,7 @@ +--- title: Getting started sidebar_position: 1 +--- # Guida introduttiva a NethVoice @@ -10,7 +12,7 @@ Progettata per funzionare su [NethServer](https://www.nethserver.org/), NethVoic Questa guida ti accompagnerà nei passaggi fondamentali per configurare NethVoice sul tuo sistema. -## 1. Installare NethServer 8 {#1-install-nethserver-8} +## 1. Installare NethServer 8 {#install-nethserver-8} Inizia installando NethServer 8 sul tuo server. - Scarica e segui le istruzioni di installazione dalla [guida ufficiale](https://docs.nethserver.org/projects/ns8/it/latest/install.html). @@ -19,27 +21,19 @@ Inizia installando NethServer 8 sul tuo server. - **Password:** `Nethesis,1234` - Crea un cluster e assicurati che il server abbia un IP statico e un FQDN valido. -## 2. Installare e configurare il Proxy NethVoice {#2-install-and-configure-nethvoice-proxy} - -Il Proxy NethVoice è necessario per abilitare l'accesso remoto sicuro ai servizi NethVoice. -- Installa il modulo Proxy NethVoice dal Software Center. -- Assegna un FQDN valido (es. `proxy.tuodominio.org`) e verifica che il record DNS sia configurato. -- Configura l'interfaccia di rete e l'IP pubblico secondo necessità. -- Può essere installato un solo Proxy NethVoice per nodo. -- Per i passaggi dettagliati, consulta la [documentazione del Proxy NethVoice](https://docs.nethvoice.com/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md#step-1-install-nethvoice-proxy). - -## 3. Installare il modulo NethVoice {#3-install-nethvoice-module} +## 2. Installa il modulo NethVoice {#install-nethvoice-module} -Una volta configurato il proxy, puoi installare il modulo NethVoice: -- Apri il **Software Center** dall'interfaccia web. -- Cerca l'applicazione NethVoice e clicca su **Installa**. -- Per maggiori informazioni, consulta la [documentazione del Software Center](https://docs.nethserver.org/projects/ns8/it/latest/software_center.html). +Una volta configurato il proxy, è possibile installare il modulo NethVoice: +- Aprire il **Software Center** dall'interfaccia web. +- Cercare l'applicazione NethVoice e fare clic su **Install**. +- Per maggiori informazioni, consultare la [documentazione del Software Center](https://docs.nethserver.org/projects/ns8/en/latest/software_center.html). -## 4. Configurare NethVoice {#4-configure-nethvoice} +## 3. Configura NethVoice {#configure-nethvoice} -Dopo l'installazione, configura la tua istanza NethVoice: -- Segui la [guida alla configurazione di NethVoice](https://docs.nethvoice.com/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md#module-configuration) per istruzioni dettagliate. -- Completa la configurazione iniziale, aggiungi utenti e configura l'ambiente telefonico secondo le tue esigenze. +Dopo l'installazione, configurare l'istanza NethVoice: +- Seguire il [wizard di configurazione iniziale](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#setup-wizard) +- Seguire la [guida alla configurazione di NethVoice](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#module-configuration) per istruzioni dettagliate sulla configurazione. +- Completare la configurazione iniziale, aggiungere utenti e configurare l'ambiente di telefonia secondo necessità. ---