Configuração do Conservador | Guia de instalação do ADM Cloud

« Instalador Conservador

⚠ Importante: O endereço IP ou o nome DNS servidor onde o Servidor deve permanecer fixo.
Se o IP ou o DNS alterar após a instalação, agentes eles perderão a conectividade, sendo necessário Reinstale-os ou reconfigure-os para restabelecer a comunicação.

1. Durante a instalação do Conserver, se você mantiver o caminho padrão, os arquivos serão salvos em C:\Program Files\Aranda\Conserver. Se você selecionar um caminho diferente, os arquivos estarão no local que você definir. Depois, configure o arquivo appsettings.json da seguinte maneira para se comunicar com o Repserver:

Caminho de configuração	Descrição
`Serilog:MinimumLevel`	Usado para definir o nível mínimo de log de eventos para a biblioteca de logs do Serilog.
`Serilog:WriteTo:0:Name`	Usado para especificar o primeiro destino de log a ser usado para Serilog. O valor “Arquivo” indica que os eventos de log serão gravados em um arquivo.
`Serilog:WriteTo:0:Args:path`	Ele é usado para especificar o caminho e o nome do arquivo onde os eventos de log serão gravados.
`Serilog:WriteTo:0:Args:shared`	Ele é usado para especificar se o arquivo de log deve ser compartilhado por vários processos ou não.
`Serilog:WriteTo:0:Args:rollingInterval`	Usado para especificar o intervalo de tempo no qual novos arquivos de log são criados.
`Logging:LogLevel:Default`	Ele é usado para definir o nível de log padrão para a biblioteca de log da Microsoft.
`Services:ServerAddress`	Endereço onde o Repserver está localizado.
`Services:CertificateSubject`	O nome do certificado que o Conservador vai usar.
`Services:EnableProxy`	Se você usar Proxy, a tag enableProxy é ativada com o valor “true”.
`Services:ProxyAddress`	Endereço proxy.
`Services:ProxyUser`	Usuário Proxy.
`Services:ProxyPassword`	Senha proxy.
`Services:PrivateIp`	Identificador na rede interna do Conservador, o IP deve desaparecer.
`Services:PublicIp`	Identificador da rede do Conservador de fora, o IP deve ser eliminado. (Se não for obrigatório, o mesmo endereço privado é usado).
`Services:MqttServerPort`	A porta de comunicação MQTT, por padrão, é parametrizada para “1884”.
`Services:MqttIp`	Identificador MQTT na rede interna, o IP deve ser eliminado.
`Services:PublicServerPort`	A porta pública de comunicação de rede do Conserver, por padrão “80”, é parametrizada.
`Services:PrivateServerPort`	Conserver a porta de comunicação privada de rede, por padrão, “80” é parametrizada.
`Services:MaxDistributionSleepMsPerThread`	-
`Services:MaxDistributionThreads`	Essas duas últimas etiquetas são usadas para o funcionamento interno do sistema, elas precisam ser modificadas.
`Services:EnableSecurityPrivateIp`	Permite validação de segurança para conexões feitas usando endereços IP privados.
`Services:EnableSecurityPublicIp`	Permite validação de segurança para conexões feitas usando endereços IP públicos.
`Services:SecondsPingRemoteServer`	Intervalo, em segundos, para verificar a disponibilidade do servidor remoto.

{
  "Serilog": {
    "Using": [ "Serilog.Sinks.File" ],
    "MinimumLevel": "Debug",
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "Logs\\Conserver-%COMPUTERNAME%.log",
          "shared": true,
          "rollingInterval": "Day",
          "retainedFileCountLimit": 7,
          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj} {Properties:j}{NewLine}{Exception}"
        }
      }
    ]
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Warning",
      "Quartz": "Warning",
      "System.Net.Http.HttpClient": "Warning"
    }
  },
  "Services": {
    "ServerAddress": "",
    "CertificateSubject": "",
    "EnableProxy": false,
    "ProxyAddress": "",
    "ProxyUser": "",
    "ProxyPassword": "",
    "PrivateIp": "",
    "PublicIp": "",
    "MqttServerPort": 1884,
    "MqttIp": "",
    "PrivateServerPort": 80,
    "PublicServerPort": 80,
    "MaxDistributionSleepMsPerThread": 8,
    "MaxDistributionThreads": 4,
    "EnableSecurityPrivateIp": false,
    "EnableSecurityPublicIp": false,
    "SecondsPingRemoteServer": 60
  }
}

2. Inicie o serviço Aranda Conserver V9, para permitir a comunicação com o Repserver.

—

Configurando o servidor para receber requisições via HTTPS

Para configurar o servidor para receber requisições via HTTPS, o HTTPS deve estar ativado no IIS com o certificado apropriado.

Importante proteger quaisquer nomes de host adicionais usando SNI.

Endereço IP: selecione “Todos não atribuídos”.

Ambiente IIS com certificado SSL

Quando seu ambiente já tiver IIS e um certificado SSL instalados, configure as configurações de arquivo appsettings.json como segue:

Parâmetro	Valor	Descrição
EndereçoServidor	`<https://<repserver>`	Endereço do Representante Preservador.
Assunto do certificado	`<nombre del certificado>`	O nome do certificado SSL que o Conserver irá usar.
enableProxy	`false`	Ativado somente se o Proxy for usado no ambiente.
privateIp	`<hostname>`	Nome do host ou IP privado do Conservador.
publicIp	`<hostname>`	Nome do host ou IP público do Conserver.
mqttServerPort	`1884`	Porta de comunicação MQTT (padrão 1884).
mqttIp	`<hostname>`	Nome do host ou IP onde o MQTT está localizado.
privateServerPort	`443`	Porta de comunicação segura na rede privada (HTTPS).
publicServerPort	`443`	Porta de comunicação segura na rede pública (HTTPS).
maxDistributionSleepMsPerThread	`8`	Parâmetro interno do sistema.
maxDistributionThreads	`4`	Parâmetro interno do sistema.
EnableSecurityPrivateIp	`true`	Permite validação de segurança para conexões de rede privada.
EnableSecurityPublicIp	`true`	Permite validação de segurança para conexões públicas de rede.
SecondsPingRemoteServer	`60`	Intervalo em segundos para verificar a disponibilidade do servidor remoto.

Exemplo de configuração JSON:

{
  "Serilog": {
    "Using": [ "Serilog.Sinks.File" ],
    "MinimumLevel": "Information",
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "Logs\\Conserver-%COMPUTERNAME%.log",
          "shared": true,
          "rollingInterval": "Day",
          "retainedFileCountLimit": 7,
          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj} {Properties:j}{NewLine}{Exception}"
        }
      }
    ]
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Warning",
      "Quartz": "Warning",
      "System.Net.Http.HttpClient": "Warning"
    }
  },
  "Services": {
    "ServerAddress": "<https://<repserver>",
    "CertificateSubject": "",
    "EnableProxy": false,
    "ProxyAddress": "",
    "ProxyUser": "",
    "ProxyPassword": "",
    "PrivateIp": "<hostnamePrivate>",
    "PublicIp": "<hostnamePublic>",
    "MqttServerPort": 1884,
    "MqttIp": "<hostnameMQTT>",
    "PrivateServerPort": 443,
    "PublicServerPort": 443,
    "MaxDistributionSleepMsPerThread": 8,
    "MaxDistributionThreads": 4,
    "EnableSecurityPrivateIp": true,
    "EnableSecurityPublicIp": true,
    "SecondsPingRemoteServer": 60
  }
}

⚠ Importante: O tráfego HTTPS será tratado inteiramente via IIS. Um certificado SSL válido deve estar associado ao site do Conserver no IIS e às portas PrivateServerPort e PublicServerPort deve ser definido como 443 para estabelecer comunicação segura. Os parâmetros EnableSecurityPrivateIp e EnableSecurityPublicIp deve ser definido como true para garantir a validação de segurança. Se o IIS já estiver usando a porta 443 e testes de conectividade forem necessários, pode ser necessário ser liberado temporariamente de acordo com o procedimento definido pela organização.

Ambiente sem IIS e com certificado

Quando o ambiente não possui IIS instalado, o Conservador cuidará diretamente da comunicação segura. Nesse caso, mantenha a configuração conforme descrita na seção inicial deste documento, usando as portas e parâmetros padrão:

PrivateServerPort: 443 (ou a porta configurada para a rede privada).
PublicServerPort: 443 (ou a porta configurada para a rede pública).
EnableSecurityPrivateIp: true (ajuste de acordo com a política de segurança da organização).
EnableSecurityPublicIp: true (ajuste de acordo com a política de segurança da organização).

Exemplo de configuração JSON para ambientes não IIS e certificados:

{
  "Serilog": {
    "Using": [ "Serilog.Sinks.File" ],
    "MinimumLevel": "Information",
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "Logs\\Conserver-%COMPUTERNAME%.log",
          "shared": true,
          "rollingInterval": "Day",
          "retainedFileCountLimit": 7,
          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj} {Properties:j}{NewLine}{Exception}"
        }
      }
    ]
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Warning",
      "Quartz": "Warning",
      "System.Net.Http.HttpClient": "Warning"
    }
  },
  "Services": {
    "ServerAddress": "",
    "CertificateSubject": "Nombre_certificado",
    "EnableProxy": false,
    "ProxyAddress": "",
    "ProxyUser": "",
    "ProxyPassword": "",
    "PrivateIp": "",
    "PublicIp": "",
    "MqttServerPort": 1884,
    "MqttIp": "",
    "PrivateServerPort": 443,
    "PublicServerPort": 443,
    "MaxDistributionSleepMsPerThread": 8,
    "MaxDistributionThreads": 4,
    "EnableSecurityPrivateIp": true,
    "EnableSecurityPublicIp": true,
    "SecondsPingRemoteServer": 60
  }
}

« Instalador Conservador