# Configuración

> El nombre de aplicación, el puerto de escucha, el nombre de red y la autenticación de cliente del servidor OPC UA integrado, y el Aplicar que los guarda y los pone en vigor.

Configuración es la segunda tarjeta del panel del servidor OPC UA en Connector. Sus campos son un borrador: se pueden editar mientras el servidor no escucha (apagado, o encendido y rechazado en su último arranque), y nada cambia hasta que **Aplicar** guarda el borrador. Un servidor apagado lo conserva para la próxima vez que se encienda ("Configuración del servidor OPC UA guardada. El servidor arranca con ella la próxima vez que se active."); con el servidor encendido el botón dice **Aplicar y reiniciar** y regresa el servidor arriba con él. La tarjeta lo dice bajo el botón: "Desactive el servidor para editar su endpoint. Los cambios se aplican en su próximo arranque." Ver Connector lee la tarjeta; Configurar Connector la edita, y apagar el servidor es el Desactivar de la [barra de comandos](connector-opcua-server#the-commands).

## Los campos {#the-fields}

| Campo | Qué es | Valores / predeterminado | Efecto |
| --- | --- | --- | --- |
| Nombre de la aplicación | El nombre con el que el servidor se anuncia a los clientes, y el sujeto de su propio certificado de aplicación. | Cualquier texto; predeterminado **GanterLab OPC UA Server**. Un nombre en blanco se guarda como el predeterminado; los espacios de alrededor se recortan. | Los clientes lo ven como el nombre de aplicación del servidor. No es parte de la dirección del endpoint. Cambiar el nombre reemplaza el certificado del propio servidor, igual que cambiar el nombre de red, así que los clientes confían en el nuevo antes de volver a conectarse; una estación que lee este servidor como equipo deja de leerlo y muestra "Certificado cambiado: `<nombre>`" en su [Acceso a los equipos](driver-opc-ua#equipment-access) hasta que el nuevo se aprueba ahí. |
| Puerto de escucha | El puerto TCP en el que escucha el servidor. | De 1 a 65535; predeterminado **4840**. Un texto que no es un número se ignora mientras usted escribe; un número fuera del rango, tenga las cifras que tenga, se rechaza debajo del campo con "El puerto de escucha tiene que estar entre 1 y 65535." y el campo regresa al puerto en vigor. El puerto de otro servicio de esta estación, o uno que tiene tomado otro programa, se rechaza al presionar Aplicar (vea más abajo). | Cambia las dos direcciones de Direcciones de conexión, en Acceso de clientes, y pide ahí un permiso nuevo de firewall, porque la regla de Windows está atada al puerto. |
| Nombre de red | El nombre que lleva la dirección del endpoint, para que un cliente llegue a la estación por un nombre que sí llega hasta ella: un nombre de DNS por el que se conectan los clientes, o la dirección de una computadora cuyo nombre la red no resuelve. | Vacío de manera predeterminada, y vacío significa el nombre de esta computadora. Si no, un nombre de host: letras, dígitos, guiones, guiones bajos y puntos, o una dirección, sin opc.tcp:// delante, sin puerto y sin ruta. El campo confirma al perder el foco o con Entrar; cualquier otra cosa se rechaza debajo del campo, diciendo que no es un nombre de host, y el campo regresa al nombre en vigor. | Desde el arranque siguiente, la dirección de red de Direcciones de conexión, en Acceso de clientes, lleva ese nombre, y el certificado del propio servidor responde por él junto a `localhost`. Cambiar el nombre reemplaza ese certificado, así que los clientes confían en el nuevo antes de volver a conectarse. |
| Autenticación de cliente | Qué sesiones acepta el servidor una vez que se confía en un certificado. | **Anónima** (predeterminado): acepta sesiones sin credenciales y rechaza las de usuario. **Nombre de usuario y contraseña**: acepta solo el par configurado y rechaza las sesiones anónimas. | Se aplica en el siguiente arranque; el servidor siempre anuncia las dos políticas de token y hace valer la opción cuando una sesión se activa. Para rechazar toda sesión, apague el servidor. |
| Usuario | El único usuario aceptado. | De 1 a 64 caracteres, recortados. Editable solo bajo Nombre de usuario y contraseña. | Junto con la contraseña, la única credencial que inicia sesión. |
| Contraseña | La contraseña que se acepta. El campo es solo de escritura: abre vacío, haya lo que haya guardado, y su etiqueta dice en qué estado está, **Contraseña (guardada)** o **Contraseña (ninguna guardada)**. El conmutador **Mostrar la contraseña** revela solo lo que usted escribe ahí. | De 8 a 128 caracteres, sin quedar en blanco. Dejarlo vacío conserva la contraseña guardada, que es lo que dice la línea bajo el campo en cuanto hay una: "Déjelo vacío para conservar la contraseña guardada." Editable solo bajo Nombre de usuario y contraseña; la regla de longitud también está escrita bajo el campo: "Nombre de usuario: de 1 a 64 caracteres. Contraseña: de 8 a 128 caracteres." | Se guarda cifrada y atada al usuario y a la máquina de Windows (véase más abajo). |

Los botones de opción y los tres campos de texto quedan atenuados mientras el servidor escucha ("Desactive el servidor OPC UA para cambiar su endpoint."), mientras se ejecuta otro comando del servidor, y mientras una unidad está en marcha. El borrador se siembra desde la configuración guardada cuando abre el panel, y se vuelve a sembrar, tirando las ediciones sin guardar, cuando la configuración cambia en otro lado, cuando una unidad toma la estación, y cuando el runtime se detiene. La contraseña es la excepción: se siembra vacía cada vez, porque la guardada nunca se le entrega al navegador.

## Aplicar {#apply}

| Comando | Qué hace | Atenuado cuando (situación) | No se dibuja cuando (rol) |
| --- | --- | --- | --- |
| Aplicar / Aplicar y reiniciar | Valida el borrador y lo guarda como una sola operación de ingeniería. Con el servidor apagado dice **Aplicar**: "Guardando la configuración del servidor OPC UA…" y después "Configuración del servidor OPC UA guardada. El servidor arranca con ella la próxima vez que se active." Con el servidor encendido dice **Aplicar y reiniciar** y vuelve a arrancar el servidor con los valores nuevos: "Reiniciando el servidor OPC UA con la nueva configuración…" y después "Configuración del servidor OPC UA aplicada. Escuchando en `<endpoint>`." Un nombre de aplicación o un nombre de red nuevo cambia el certificado propio de la estación, con el que también lee los equipos el [driver OPC UA](driver-opc-ua), así que reinicia todo Connector, cuyos dispositivos vuelven a leer un momento después, esté el servidor encendido o apagado; cualquier otro cambio toca solo el servidor, y Connector lee todo el tiempo. | Mientras el servidor escucha, mientras se ejecuta otro comando del servidor, mientras una unidad está en marcha, y mientras la configuración guardada no se pudo leer. | Para un rol sin **Configurar Connector**. |

La validación pasa antes de que se guarde nada, en este orden: el puerto ("El puerto de escucha tiene que estar entre 1 y 65535."); un puerto distinto del que está en vigor se rechaza después cuando es el puerto del servidor web, fijado en [Acceso remoto](remote-access) ("El puerto N ya es el del servidor web. Elija otro puerto, o mueva antes el servidor web."), el puerto fijado para el acceso de agente en la página [Agente](agent), con el acceso de agente encendido o apagado ("El puerto N ya es el del acceso de agente. Elija otro puerto, o mueva antes el acceso de agente."), el puerto del [servidor Modbus](connector-modbus-server) en la página Connector, encendido o apagado ("El puerto N ya es el del servidor Modbus. Elija otro puerto, o mueva antes el servidor Modbus."), el puerto del [bróker MQTT](connector-mqtt-broker) en la página Connector, encendido o apagado ("El puerto N ya es el del bróker MQTT. Elija otro puerto, o mueva antes el bróker MQTT."), o un puerto que otra cosa en esta computadora ya retiene ("El puerto N está ocupado en esta computadora. Cierre lo que lo retiene, o elija otro puerto."), cada uno dicho debajo del campo Puerto de escucha, como el rechazo por el rango, con el campo de regreso en el puerto en vigor; luego el nombre de red, dicho debajo del campo Nombre de red, con el campo de regreso en el nombre en vigor; y después, bajo Nombre de usuario y contraseña, el usuario ("El nombre de usuario tiene que tener entre 1 y 64 caracteres."), un campo vacío sin ninguna contraseña guardada que conservar ("Todavía no hay ninguna contraseña guardada, escriba una antes de aplicar."), la longitud de la contraseña ("La contraseña tiene que tener entre 8 y 128 caracteres.") y una contraseña en blanco ("La contraseña no puede quedar en blanco."). Un borrador rechazado no guarda nada. Un reinicio que deja al servidor detenido, típicamente porque otro programa tiene tomado el puerto en vigor, que Aplicar y reiniciar no vuelve a revisar, se informa como "El servidor OPC UA no pudo iniciarse. Puede que no consiga enlazar el puerto N. Revise el diario técnico."; la configuración sí quedó guardada, así que corrija la causa y presione Reiniciar en la barra de comandos. Un arranque que falla con un error en lugar de volver detenido se informa como "Error del servidor OPC UA: …". Pase lo que pase, los campos vuelven a leer después los valores guardados.

## Cuando la configuración guardada no se pudo leer {#when-the-stored-configuration-could-not-be-read}

Si la base de datos de configuración no pudo devolver la fila del servidor al arrancar, la tarjeta abre con el aviso "La configuración guardada del servidor no se pudo leer. Los valores de abajo son los predeterminados de este arranque, y guardar está desactivado para que no sobrescriban la configuración guardada. Revise el diario técnico y reinicie la aplicación." El servidor corre con los valores predeterminados ese arranque, Aplicar queda atenuado, y una pulsación se contesta con esa misma frase en la barra de estado.

## Cuando el servidor no puede abrir su puerto al arrancar {#when-the-server-cannot-open-its-port-at-start}

Cuando la estación arranca y el servidor no puede abrir su puerto de escucha, porque otro programa ya lo ocupa (en una computadora industrial el 4840 suele estar tomado) o porque Windows lo rechaza (un puerto dentro de un rango que reservan Hyper-V, WSL o Docker), solo el servidor queda detenido: Connector lee los dispositivos, y Logic y las grabaciones siguen. Una tarjeta dice por qué: "El servidor no pudo iniciarse", y después "El puerto 4840 ya está en uso por otra aplicación en esta computadora, así que el servidor OPC UA quedó detenido. Elija otro puerto de escucha e inicie el servidor de nuevo." La tarjeta ofrece dos botones.

| Comando | Qué hace | Atenuado cuando (situación) | No se dibuja cuando (rol) |
| --- | --- | --- | --- |
| Usar el puerto N | Guarda N como puerto de escucha y arranca el servidor en él, como una sola operación de ingeniería. N es el primer puerto por encima del rechazado que el campo Puerto de escucha aceptaría: libre en esta máquina ahora mismo, y que no sea el puerto del servidor web, ni el del acceso del agente, ni el del servidor Modbus. Después la tarjeta dice dónde escucha el servidor, porque de ahora en adelante los clientes OPC UA se conectan a ese puerto: "El servidor OPC UA escucha ahora en el puerto 4841. Los clientes OPC UA se conectan a `<endpoint>`." Si N también estaba ocupado cuando el servidor arrancó, regresa la misma tarjeta ofreciendo el puerto siguiente. | Mientras una unidad está en marcha, mientras el runtime está detenido, y mientras la configuración guardada no se pudo leer. | Para un rol sin **Configurar Connector**. |
| Abrir Connector | Abre Connector en la fila del servidor OPC UA, cuya tarjeta Configuración fija el puerto de escucha. | Nunca. | Para un rol sin **Ver Connector**. |

El puerto solo cambia cuando alguien pulsa "Usar el puerto 4841" o uno igual: el servidor nunca se pasa a otro puerto por su cuenta. Una falla que no tiene que ver con el puerto deja Abrir Connector solo en la tarjeta, bajo el motivo que dio el arranque. Cuando la estación arranca oculta en la bandeja, una notificación de Windows repite el título y el motivo de la tarjeta; no tiene botones, y la tarjeta espera en la ventana.

## La contraseña y dónde vive {#the-password-and-where-it-lives}

La contraseña se guarda como texto cifrado con DPAPI por usuario, igual que todo secreto de dispositivo. Una [copia de seguridad](settings-backups) de la configuración abierta en otra máquina o en otra cuenta de Windows llega sin ella: el servidor arranca entonces con Usuario y contraseña encendido y sin contraseña que verificar, rechaza todo inicio de sesión, y registra por qué ("La autenticación con usuario y contraseña está encendida, pero en esta cuenta de Windows no se puede leer ninguna contraseña del servidor OPC UA … Vuelva a ingresarla en la Configuración del servidor OPC UA, en Connector."). Vuelva a ingresarla aquí. La contraseña guardada nunca hace el camino de vuelta: el campo abre vacío y solo su etiqueta dice si hay una, así que la página que recibe un navegador remoto no lleva ninguna credencial. Sobre una conexión remota de HTTP simple, el usuario y la contraseña escritos en esta página cruzan la red en texto claro; véase [Acceso remoto](remote-access).

## Lo que esta sección no hace {#what-this-section-does-not-do}

La confianza en el certificado es una verificación aparte, que se decide en [Acceso de clientes](connector-opcua-client-access): una aplicación de confianza igual tiene que iniciar sesión de la manera elegida aquí, y un usuario no le da entrada a nadie cuyo certificado no se haya confiado. Hay un solo usuario y una sola contraseña, no una lista, y no hay derechos por cliente; la ruta de dirección `/UA/GanterLab` y las políticas de seguridad no son configurables; y el Nombre de red guarda un nombre, no una lista, así que el endpoint anuncia ese nombre, con `localhost` al lado, y nada más. El espacio de direcciones de Logic muestra los puntos del servidor en solo lectura, y su botón "Abrir Connector" aterriza en la fila del servidor.