⚠ Importante: La dirección IP o el nombre DNS del servidor donde se instale el ConServer debe permanecer fija.
Si la IP o el DNS cambian después de la instalación, los agentes perderán la conectividad, siendo necesario reinstalarlos o reconfigurarlos para restablecer la comunicación.
1. Durante la instalación de Conserver, si mantiene la ruta predeterminada, los archivos se guardarán en C:\Program Files\Aranda\Conserver. Si selecciona una ruta diferente, los archivos quedarán en la ubicación que usted defina. Luego, configure el archivo appsettings.json. de la siguiente manera para que se comunique con el Repserver:
| Configuración appSettings | |
|---|---|
| add key=”Serilog:MinimumLevel” value=”Debug” | Se utiliza para establecer el nivel mínimo de registro de eventos para la biblioteca de registro Serilog. |
| add key=”Serilog:WriteTo:0:Name” value=”File” | Se utiliza para especificar el primer destino de registro que se utilizará para Serilog. El valor “File” indica que los eventos de registro se escribirán en un archivo. |
| add key=”Serilog:WriteTo:0:Args:path” value=”Logs\log.txt” | Se utiliza para especificar la ruta y el nombre del archivo donde se escribirán los eventos de registro. |
| add key=”Serilog:WriteTo:0:Args:shared” value=”true” | Se utiliza para especificar si el archivo de registro debe ser compartido por varios procesos o no. |
| add key=”Serilog:WriteTo:0:Args:rollingInterval” value=”Day” | Se utiliza para especificar el intervalo de tiempo en el que se crean nuevos archivos de registro. |
| add key=”Logging:LogLevel:Default” value=”Information” | Se utiliza para establecer el nivel de registro predeterminado para la biblioteca de registro de Microsoft. |
| add key=”serverAddress” value=”” | Dirección donde se encuentra el Repserver |
| add key=”CertificateSubject” value=”” | Nombre identificador del certificado que utilizará Conserver |
| add key=”enableProxy” value=”false” | En caso de usar Proxy se habilita la etiqueta enableProxy con valor “true” |
| add key=”proxyAddress” value=”” | Dirección del proxy |
| add key=”proxyUser” value=”” | Usuario del Proxy |
| add key=”proxyPassword” value=”” | Contraseña del Proxy |
| add key=”privateIp” value=”” | Identificador en la red interna del Conserver, deber ia la ip |
| add key=”publicIp” value=”” | Identificador de la red del conserver desde el exterior, debe ir la ip. (En caso de que no se requiera se utiliza la misma dirección privada) |
| add key=”mqttServerPort” value=”1884” | Puerto de Comunicación de mqtt, por defecto se encuentra parametrizado el “1884” |
| add key=”mqttIp” value=”” | Identificador de Mqtt en la red interna, debe ir la IP |
| add key=”publicServerPort” value=”80” | Puerto de comunicación red pública de Conserver, por defecto se encuentra parametizado el “80”. |
| add key=”privateServerPort” value=”80” | Puerto de comunicación red privada de Conserver, por defecto se encuentra parametizado el “80”. |
| add key=”maxDistributionSleepMsPerThread” value=”8” | - |
| add key=”maxDistributionThreads” value=”4” | Estos dos últimos tags son utilizados para el funcionamiento interno del sistema, se deben modificar. |
| add key=”EnableSecurityPrivateIp” value=”false” | Habilita la validación de seguridad para conexiones realizadas mediante direcciones IP privadas. |
| add key=”EnableSecurityPublicIp” value=”false” | Habilita la validación de seguridad para conexiones realizadas mediante direcciones IP públicas. |
| add key=”SecondsPingRemoteServer” value=”60” | Intervalo, en segundos, para verificar la disponibilidad del servidor remoto. |
<appSettings>
<add key="Serilog:MinimumLevel" value="Debug" />
<add key="Serilog:WriteTo:0:Name" value="File" />
<add key="Serilog:WriteTo:0:Args:path" value="Logs\\Conserver-%COMPUTERNAME%.log" />
<add key="Serilog:WriteTo:0:Args:shared" value="true" />
<add key="Serilog:WriteTo:0:Args:rollingInterval" value="Day" />
<add key="Logging:LogLevel:Default" value="Information" />
<add key="serverAddress" value="" />
<add key="CertificateSubject" value="" />
<add key="enableProxy" value="false" />
<add key="proxyAddress" value="" />
<add key="proxyUser" value="" />
<add key="proxyPassword" value="" />
<add key="privateIp" value="" />
<add key="publicIp" value="" />
<add key="mqttServerPort" value="1884" />
<add key="mqttIp" value="" />
<add key="privateServerPort" value="80" />
<add key="publicServerPort" value="80" />
<add key="maxDistributionSleepMsPerThread" value="8" />
<add key="maxDistributionThreads" value="4" />
<add key="EnableSecurityPrivateIp" value= "false" />
<add key="EnableSecurityPublicIp" value= "false" />
<add key="SecondsPingRemoteServer" value="60" />
</appSettings>
2. Inicie el servicio Aranda Conserver V9, para permitir la comunicación con el Repserver.
Configuración del conserver para recibir peticiones por https
Para configurar el conserver para recibir peticiones por https, en el IIS debe estar habilitado https con el debido certificado.
Importante asegurar cualquier nombre de host adicional utilizando SNI
Dirección IP: seleccione «All unassigned».
Ambiente con IIS y certificado SSL
Cuando el ambiente ya cuenta con IIS y un certificado SSL instalado, configure los parámetros del archivo appsettings.json de la siguiente manera:
| Parámetro | Valor | Descripción |
|---|---|---|
| serverAddress | http://<repserver> |
Dirección del Repserver |
| CertificateSubject | <nombre del certificado> |
Nombre identificador del certificado SSL que utilizará Conserver |
| enableProxy | false |
Se habilita solamente si se utiliza Proxy en el ambiente |
| privateIp | <hostname> |
Nombre del host o IP privada del Conserver |
| publicIp | <hostname> |
Nombre del host o IP pública del Conserver |
| mqttServerPort | 1884 |
Puerto de comunicación MQTT (por defecto 1884) |
| mqttIp | <hostname> |
Nombre del host o IP donde se encuentra MQTT |
| privateServerPort | 443 |
Puerto de comunicación segura en red privada (HTTPS) |
| publicServerPort | 443 |
Puerto de comunicación segura en red pública (HTTPS) |
| maxDistributionSleepMsPerThread | 8 |
Parámetro interno del sistema |
| maxDistributionThreads | 4 |
Parámetro interno del sistema |
| EnableSecurityPrivateIp | true |
Habilita validación de seguridad para conexiones en red privada |
| EnableSecurityPublicIp | true |
Habilita validación de seguridad para conexiones en red pública |
| SecondsPingRemoteServer | 60 |
Intervalo en segundos para verificar disponibilidad del servidor remoto |
Ejemplo de configuración XML:
<appSettings>
<add key="Serilog:MinimumLevel" value="Debug" />
<add key="Serilog:WriteTo:0:Name" value="File" />
<add key="Serilog:WriteTo:0:Args:path" value="Logs\\Conserver-%COMPUTERNAME%.log" />
<add key="Serilog:WriteTo:0:Args:shared" value="true" />
<add key="Serilog:WriteTo:0:Args:rollingInterval" value="Day" />
<add key="Logging:LogLevel:Default" value="Information" />
<add key="serverAddress" value="" />
<add key="CertificateSubject" value="" />
<add key="enableProxy" value="false" />
<add key="proxyAddress" value="" />
<add key="proxyUser" value="" />
<add key="proxyPassword" value="" />
<add key="privateIp" value="" />
<add key="publicIp" value="" />
<add key="mqttServerPort" value="1884" />
<add key="mqttIp" value="" />
<add key="privateServerPort" value="443" />
<add key="publicServerPort" value="443" />
<add key="maxDistributionSleepMsPerThread" value="8" />
<add key="maxDistributionThreads" value="4" />
<add key="EnableSecurityPrivateIp" value= "false" />
<add key="EnableSecurityPublicIp" value= "false" />
<add key="SecondsPingRemoteServer" value="60" />
</appSettings>
⚠ Importante: El tráfico HTTPS será manejado completamente a través de IIS. Debe existir un certificado SSL válido asociado al sitio web de Conserver en IIS, y los puertos PrivateServerPort y PublicServerPort deben configurarse en
443para establecer la comunicación segura. Los parámetros EnableSecurityPrivateIp y EnableSecurityPublicIp deben estar configurados entruepara garantizar la validación de seguridad. Si IIS ya está utilizando el puerto 443 y se requiere realizar pruebas de conectividad, puede ser necesario liberarlo temporalmente según el procedimiento definido por la organización.
Ambiente sin IIS y con certificado
Cuando el ambiente no cuenta con IIS instalado, el Conserver gestionará directamente la comunicación segura. En este caso, mantenga la configuración según lo descrito en la sección inicial de este documento, utilizar los puertos y parámetros por defecto:
- PrivateServerPort:
443(o el puerto configurado para la red privada) - PublicServerPort:
443(o el puerto configurado para la red pública) - EnableSecurityPrivateIp:
true(ajuste según política de seguridad de la organización) - EnableSecurityPublicIp:
true(ajuste según política de seguridad de la organización)
Ejemplo de configuración XML para ambiente sin IIS y con certificado:
<appSettings>
<add key="Serilog:MinimumLevel" value="Debug" />
<add key="Serilog:WriteTo:0:Name" value="File" />
<add key="Serilog:WriteTo:0:Args:path" value="Logs\\Conserver-%COMPUTERNAME%.log" />
<add key="Serilog:WriteTo:0:Args:shared" value="true" />
<add key="Serilog:WriteTo:0:Args:rollingInterval" value="Day" />
<add key="Logging:LogLevel:Default" value="Information" />
<add key="serverAddress" value="" />
<add key="CertificateSubject" value="Nombre_certificado" />
<add key="enableProxy" value="false" />
<add key="proxyAddress" value="" />
<add key="proxyUser" value="" />
<add key="proxyPassword" value="" />
<add key="privateIp" value="" />
<add key="publicIp" value="" />
<add key="mqttServerPort" value="1884" />
<add key="mqttIp" value="" />
<add key="privateServerPort" value="443" />
<add key="publicServerPort" value="443" />
<add key="maxDistributionSleepMsPerThread" value="8" />
<add key="maxDistributionThreads" value="4" />
<add key="EnableSecurityPrivateIp" value= "true" />
<add key="EnableSecurityPublicIp" value= "true" />
<add key="SecondsPingRemoteServer" value="60" />
</appSettings>