# Configuração

> O nome do aplicativo, a porta de escuta, o nome de rede e a autenticação do cliente do servidor OPC UA embutido, e o Aplicar que os guarda e os põe em vigor.

Configuração é o segundo cartão do painel do servidor OPC UA no Connector. Os campos dele são um rascunho: eles são editáveis enquanto o servidor não está escutando (desligado, ou ligado e recusado na última partida), e nada muda até o **Aplicar** guardar o rascunho. Um servidor desligado o guarda para a próxima vez que for ligado ("Configuração do servidor OPC UA salva. O servidor inicia com ela na próxima vez que for habilitado."); com o servidor ligado o botão diz **Aplicar e reiniciar** e traz o servidor de volta sobre ele. O cartão diz isso sob o botão: "Desabilite o servidor para editar o endpoint dele. As mudanças valem a partir do próximo início." Ver Connector lê o cartão; Configurar Connector o edita, e desligar o servidor é o Desabilitar da [barra de comandos](connector-opcua-server#the-commands).

## Os campos {#the-fields}

| Campo | O que é | Valores / padrão | Efeito |
| --- | --- | --- | --- |
| Nome do aplicativo | O nome que o servidor anuncia aos clientes, e o titular do certificado de aplicativo dele. | Qualquer texto; padrão **GanterLab OPC UA Server**. Um nome em branco é salvo como o padrão; os espaços em volta são aparados. | Os clientes o veem como o nome de aplicativo do servidor. Ele não faz parte do endereço do endpoint. Mudar o nome troca o certificado do próprio servidor, como mudar o nome de rede, então os clientes confiam no novo antes de reconectar; uma estação que lê este servidor como equipamento para de lê-lo e mostra "Certificado mudou: `<nome>`" no seu [Acesso de equipamentos](driver-opc-ua#equipment-access) até o novo ser aprovado lá. |
| Porta de escuta | A porta TCP em que o servidor escuta. | De 1 a 65535; padrão **4840**. Um texto que não é número é ignorado enquanto você digita; um número fora da faixa, tenha quantos dígitos tiver, é recusado embaixo do campo com "A porta de escuta precisa estar entre 1 e 65535." e o campo volta à porta em vigor. A porta de outro serviço desta estação, ou uma que outro programa segura, é recusada quando você pressiona Aplicar (veja abaixo). | Muda os dois endereços em Endereços de conexão, no Acesso de clientes, e pede uma permissão de firewall nova ali, já que a regra do Windows está presa à porta. |
| Nome de rede | O nome que o endereço do endpoint carrega, para o cliente discar a estação por um nome que chega até ela: um nome de DNS pelo qual os clientes conectam, ou o endereço de um computador cujo nome a rede não resolve. | Vazio por padrão, e vazio significa o nome do próprio computador. Fora isso, um nome de host: letras, dígitos, hifens, sublinhados e pontos, ou um endereço, sem opc.tcp:// na frente, sem porta e sem caminho. O campo confirma ao perder o foco ou com Enter; qualquer outra coisa é recusada embaixo do campo, dizendo que não é um nome de host, e o campo volta ao nome em vigor. | Da partida seguinte em diante, o endereço de rede em Endereços de conexão, no Acesso de clientes, carrega esse nome, e o certificado do próprio servidor responde por ele ao lado de `localhost`. Mudar o nome troca esse certificado, então os clientes confiam no novo antes de reconectar. |
| Autenticação de cliente | Quais sessões o servidor aceita depois que um certificado é confiável. | **Anônima** (padrão): aceita sessões sem credenciais e rejeita as de usuário. **Usuário e senha**: aceita só o par configurado e rejeita as sessões anônimas. | Aplicada na partida seguinte; o servidor sempre anuncia as duas políticas de token e impõe a escolha quando uma sessão é ativada. Para recusar toda sessão, desligue o servidor. |
| Usuário | O único usuário aceito. | De 1 a 64 caracteres, aparados. Editável só sob Usuário e senha. | Junto com a senha, a única credencial que entra. |
| Senha | A senha a aceitar. O campo é só de escrita: ele abre vazio, haja o que houver guardado, e o rótulo dele diz em que estado está, **Senha (guardada)** ou **Senha (nenhuma guardada)**. O alternador **Mostrar a senha** revela só o que você digita ali. | De 8 a 128 caracteres, não em branco. Deixar em branco mantém a senha guardada, o que a linha sob o campo diz assim que existe uma: "Deixe em branco para manter a senha guardada." Editável só sob Usuário e senha; a regra de comprimento também está escrita sob o campo: "Usuário: 1–64 caracteres. Senha: 8–128 caracteres." | Guardada como texto cifrado preso ao usuário e à máquina Windows (veja abaixo). |

Os botões de opção e os três campos de texto ficam esmaecidos enquanto o servidor escuta ("Desabilite o servidor OPC UA para mudar o endpoint dele."), enquanto outro comando do servidor roda, e enquanto uma unidade está em execução. O rascunho é semeado a partir da configuração guardada quando o painel abre, e semeado de novo, descartando as edições não salvas, quando a configuração muda em outro lugar, quando uma unidade toma a estação, e quando o runtime para. A senha é a exceção: ela é semeada vazia toda vez, porque a guardada nunca é entregue ao navegador.

## Aplicar {#apply}

| Comando | O que ele faz | Esmaecido quando (situação) | Não aparece quando (papel) |
| --- | --- | --- | --- |
| Aplicar / Aplicar e reiniciar | Valida o rascunho e o guarda como uma operação de engenharia só. Com o servidor desligado ele diz **Aplicar**: "Salvando a configuração do servidor OPC UA…" e depois "Configuração do servidor OPC UA salva. O servidor inicia com ela na próxima vez que for habilitado." Com o servidor ligado ele diz **Aplicar e reiniciar** e inicia o servidor de novo sobre os valores novos: "Reiniciando o servidor OPC UA com a configuração nova…" e depois "Configuração do servidor OPC UA aplicada. Escutando em `<endpoint>`." Um nome de aplicação ou nome de rede novo muda o certificado próprio da estação, com o qual o [driver OPC UA](driver-opc-ua) também lê equipamentos, então ele reinicia o Connector inteiro, cujos dispositivos voltam a ler um instante depois, com o servidor ligado ou desligado; qualquer outra mudança toca só o servidor, e o Connector lê o tempo todo. | Enquanto o servidor escuta, enquanto outro comando do servidor roda, enquanto uma unidade está em execução, e enquanto a configuração guardada não pôde ser lida. | Para um papel sem **Configurar Connector**. |

A validação acontece antes de qualquer coisa ser salva, nesta ordem: a porta ("A porta de escuta precisa estar entre 1 e 65535."); uma porta diferente da que está em vigor é recusada em seguida quando é a porta do servidor web, definida em [Acesso remoto](remote-access) ("A porta N já é a do servidor web. Escolha outra porta, ou mova o servidor web antes."), a porta definida para o acesso de agente na página [Agente](agent), com o acesso de agente ligado ou desligado ("A porta N já é a do acesso de agente. Escolha outra porta, ou mova o acesso de agente antes."), a porta do [servidor Modbus](connector-modbus-server) na página Connector, ligado ou desligado ("A porta N já é a do servidor Modbus. Escolha outra porta, ou mova o servidor Modbus antes."), a porta do [broker MQTT](connector-mqtt-broker) na página Connector, ligado ou desligado ("A porta N já é a do broker MQTT. Escolha outra porta, ou mova o broker MQTT antes."), ou uma porta que outra coisa nesta máquina já segura ("A porta N está em uso nesta máquina. Feche o que a está segurando, ou escolha outra porta."), cada uma dita embaixo do campo Porta de escuta, como a recusa da faixa, com o campo de volta à porta em vigor; depois o nome de rede, dito embaixo do campo Nome de rede, com o campo de volta ao nome em vigor; depois, sob Usuário e senha, o usuário ("O usuário precisa ter de 1 a 64 caracteres."), um campo vazio sem senha guardada para manter ("Ainda não há senha guardada, então digite uma antes de aplicar."), o comprimento da senha ("A senha precisa ter de 8 a 128 caracteres.") e uma senha em branco ("A senha não pode ficar em branco."). Um rascunho recusado não persiste nada. Um reinício que deixa o servidor parado, tipicamente porque outro programa segura a porta em vigor, que Aplicar e reiniciar não confere de novo, é relatado como "O servidor OPC UA não conseguiu iniciar. Pode ser que ele não consiga ocupar a porta N. Consulte o diário."; a configuração foi salva, então corrija a causa e pressione Reiniciar na barra de comandos. Uma partida que falha com um erro em vez de voltar parada é relatada como "Erro do servidor OPC UA: …". Aconteça o que acontecer, os campos releem os valores guardados depois.

## Quando a configuração guardada não pôde ser lida {#when-the-stored-configuration-could-not-be-read}

Se o banco de configuração não conseguiu devolver a linha do servidor na partida, o cartão abre com o aviso "A configuração guardada do servidor não pôde ser lida. Os valores abaixo são os padrões desta partida, e salvar está desabilitado para que eles não sobrescrevam a configuração guardada. Consulte o diário e reinicie o aplicativo." O servidor roda sobre os padrões naquela partida, o Aplicar fica esmaecido, e um toque é respondido com a mesma frase na barra de status.

## Quando o servidor não consegue abrir a porta dele na partida {#when-the-server-cannot-open-its-port-at-start}

Quando a estação parte e o servidor não consegue abrir a porta de escuta dele, porque outro programa já a ocupa (num computador industrial a 4840 costuma estar tomada) ou porque o Windows a recusa (uma porta dentro de uma faixa que Hyper-V, WSL ou Docker reservam), só o servidor fica parado: o Connector lê os dispositivos, e a Logic e as gravações continuam. Um cartão diz por quê: "O servidor não pôde iniciar", e depois "A porta 4840 já está em uso por outro aplicativo neste computador, então o servidor OPC UA ficou parado. Escolha outra porta de escuta e inicie o servidor de novo." O cartão oferece dois botões.

| Comando | O que ele faz | Esmaecido quando (situação) | Não aparece quando (papel) |
| --- | --- | --- | --- |
| Usar a porta N | Guarda N como porta de escuta e inicia o servidor nela, como uma operação de engenharia só. N é a primeira porta acima da recusada que o campo Porta de escuta aceitaria: livre nesta máquina agora, e que não é a porta do servidor web, nem a do acesso do agente, nem a do servidor Modbus. Depois o cartão diz onde o servidor escuta, porque é nessa porta que os clientes OPC UA se conectam daqui em diante: "O servidor OPC UA agora escuta na porta 4841. Os clientes OPC UA se conectam em `<endpoint>`." Se N também estava tomada quando o servidor partiu, o mesmo cartão volta oferecendo a próxima porta. | Enquanto uma unidade está em execução, enquanto o runtime está parado, e enquanto a configuração guardada não pôde ser lida. | Para um papel sem **Configurar Connector**. |
| Abrir o Connector | Abre o Connector na linha do servidor OPC UA, cujo cartão Configuração define a porta de escuta. | Nunca. | Para um papel sem **Ver Connector**. |

A porta só muda quando alguém aperta "Usar a porta 4841" ou um botão igual: o servidor nunca passa sozinho para outra porta. Uma falha que não é da porta deixa Abrir o Connector sozinho no cartão, sob o motivo que a partida deu. Quando a estação parte escondida na bandeja, uma notificação do Windows repete o título e o motivo do cartão; ela não tem botões, e o cartão espera na janela.

## A senha e onde ela mora {#the-password-and-where-it-lives}

A senha é guardada como texto cifrado por DPAPI por usuário, como todo segredo de dispositivo. Um [backup](settings-backups) de configuração aberto em outra máquina ou em outra conta do Windows chega sem ela: o servidor então inicia com Usuário e senha ligado e sem senha a conferir, recusa toda entrada, e registra no diário por quê ("A autenticação por usuário e senha está ligada, mas nenhuma senha do servidor OPC UA pode ser lida nesta conta do Windows … Digite-a de novo na Configuração do servidor OPC UA, no Connector."). Digite-a de novo aqui. A senha guardada nunca faz o caminho de volta: o campo abre vazio e só o rótulo dele diz se existe uma, então a página que um navegador remoto recebe não carrega credencial nenhuma. Por uma conexão remota em HTTP simples, o usuário e a senha digitados nesta página cruzam a rede em texto claro; veja [Acesso remoto](remote-access).

## O que esta seção não faz {#what-this-section-does-not-do}

A confiança no certificado é uma conferência separada, decidida no [Acesso de clientes](connector-opcua-client-access): um aplicativo confiável ainda precisa entrar do jeito escolhido aqui, e um usuário não autentica ninguém cujo certificado não foi confiado. Existe um usuário e uma senha, não uma relação, e não há direitos por cliente; o caminho de endereço `/UA/GanterLab` e as políticas de segurança não são configuráveis; e o Nome de rede guarda um nome, não uma lista, então o endpoint anuncia aquele nome, com `localhost` ao lado, e nada mais. O espaço de endereços da Logic mostra os pontos do servidor em modo somente leitura, e o botão "Abrir o Connector" dele cai na linha do servidor.