> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/connect-v3.1/administradores/windows_configuracion_servicios.md).

# Servicios y variables de entorno en Windows

En instalaciones sobre entornos Windows, Editran Connect utiliza una serie de servicios del sistema y variables de entorno para su correcta ejecución y configuración. Esta sección describe los servicios involucrados, el orden de arranque recomendado y las variables del sistema necesarias para el funcionamiento del entorno.

> ⚠️ *Importante:* Todos los servicios y variables deben ejecutarse inicialmente bajo el contexto del usuario `LocalSystem`.

***

## Servicios de Windows

![servicios windows](https://3624397791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzO0mk2eo5LONjICfqrP8%2Fuploads%2Fgit-blob-01f2e1dce3cdaa95092ef137cd09df387b67ce9a%2F01_servicios_windows.png?alt=media)

Los siguientes servicios forman parte de la arquitectura de Editran Connect. Es fundamental respetar el orden de arranque para garantizar que los módulos dependientes encuentren disponibles sus recursos:

| Orden | Nombre del servicio           | Descripción                                    | Estado inicial |
| ----- | ----------------------------- | ---------------------------------------------- | -------------- |
| 1     | **Editran Servicio Licencia** | Atiende las peticiones del API de Licencia V2  | En ejecución   |
| 2     | **Editran Servicio Base**     | Protocolo EDITRAN para transmisión de ficheros | En ejecución   |
| 3     | **Editran Connect Data**      | Servicio de base de datos para Editran Connect | En ejecución   |
| 4     | **Editran Connect Base**      | Servicios base de Editran Connect              | En ejecución   |
| 5     | **Editran Connect Sign**      | Servicios de firma para Editran Connect        | En ejecución   |
| 6     | **Editran Connect Server**    | Servidor web para Editran Connect              | En ejecución   |

> ℹ️ *Nota:* Si alguno de los servicios no arranca, revise que las variables de entorno estén correctamente configuradas y que no haya conflictos de puertos.

***

## Variables de entorno del sistema

A continuación se detallan las variables de entorno necesarias, visibles en el registro de Windows bajo la ruta:\
`HKEY_USERS\.DEFAULT\Environment`

| Nombre de variable                   | Valor                 | Descripción                                                         |
| ------------------------------------ | --------------------- | ------------------------------------------------------------------- |
| `EDITRAN_DDBB_HOST`                  | `localhost`           | Dirección del host de base de datos                                 |
| `EDITRAN_DDBB_PORT`                  | `5432`                | Puerto de conexión a la base de datos                               |
| `EDITRAN_DDBB_PWD`                   | `password_base_datos` | Contraseña del usuario de base de datos                             |
| `EDITRAN_DDBB_USER`                  | `usuario_base_datos`  | Usuario de conexión a la base de datos                              |
| `EDITRAN_LOG_LEVEL`                  | `INFO`                | Nivel de log general del sistema                                    |
| `EDITRAN_PORT_CONNECT`               | `8081`                | Puerto del servicio Connect principal                               |
| `EDITRAN_PORT_SIGN`                  | `8085`                | Puerto del servicio de firma electrónica                            |
| `EDITRAN_TASK_CONTROLLER_SIZE_QUEUE` | `500`                 | Tamaño de la cola de procesamiento del planificador                 |
| `EDITRAN_TASK_CONTROLLER_THREADS`    | `1`                   | Número de hilos asignados al controlador de tareas del planificador |

> 🔒 *Seguridad:* La contraseña de base de datos debe mantenerse protegida. Se recomienda utilizar herramientas de cifrado o resguardo en archivos seguros si se externaliza la configuración.

***

## Cambio de propietario de los servicios y variables de entorno

Por defecto, los servicios de Editran Connect se instalan bajo la cuenta del sistema `LocalSystem`. No obstante, en entornos productivos o cuando se requiere acceso a recursos de red, es recomendable ejecutar los servicios con una cuenta de usuario específica.

### ¿Por qué cambiar el propietario?

Ejecutar los servicios con un usuario diferente a `LocalSystem` permite:

* Acceder a recursos compartidos en red (por ejemplo, carpetas compartidas o bases de datos remotas).
* Mejorar la trazabilidad de accesos y logs.
* Controlar permisos más finamente mediante directivas de seguridad.

> ⚠️ *Importante:* Si se cambia el propietario de los servicios, también se deben configurar las **variables de entorno** en el mismo usuario para que Editran Connect funcione correctamente.

***

### Pasos para cambiar el propietario de los servicios

1. Abrir el panel de servicios:\
   `services.msc`
2. Localizar cada servicio de Editran Connect (ver tabla de servicios).
3. Hacer clic derecho sobre el servicio y seleccionar:\
   `Propiedades`.
4. Ir a la pestaña **Iniciar sesión**.
5. Seleccionar la opción:\
   `Esta cuenta`, e introducir el usuario deseado (por ejemplo: `DOMINIO\usuario_editran`).
6. Introducir y confirmar la contraseña del usuario.
7. Repetir el proceso para todos los servicios de Editran.
8. Reiniciar los servicios una vez aplicados los cambios.

***

### Variables de entorno del nuevo usuario

Una vez definido el usuario propietario de los servicios, las variables de entorno deben trasladarse o definirse en su contexto:

* Acceder al editor del registro (`regedit`) o al entorno gráfico de variables:
  * `HKEY_USERS\[SID_DEL_USUARIO]\Environment`\
    o
  * `Panel de control > Sistema > Configuración avanzada del sistema > Variables de entorno`
* Crear (o copiar) las variables necesarias según la tabla de configuración.

> 🛠️ *Consejo técnico:* Utiliza un script PowerShell o `.reg` si necesitas replicar las variables de entorno en múltiples entornos o servidores.

***

> ℹ️ *Nota:* Si los servicios siguen fallando tras cambiar de usuario, asegúrate de que:
>
> * El nuevo usuario tiene permisos de lectura/escritura donde sea necesario.
> * No hay conflictos de puertos.
> * Se reinició correctamente el servicio después del cambio.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.editran.onesait.com/documentacion-editran/connect-v3.1/administradores/windows_configuracion_servicios.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.