> 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-v2.1/firma/firmadeficheros/detallefichero/firmar.md).

# Firmar

Esta opción se encuentra disponible solo para los usuarios de rol firmante que tengan permiso de firma en el *grupo de ficheros* al que el sistema ha asignado el documento.

Para poder firmar los ficheros, es imprescindible que el equipo desde el que se realiza la solicitud disponga del certificado de clave privada correspondiente, debidamente instalado o accesible (certificado en nube), dentro del almacén de certificados del sistema. El certificado de clave privada con el que se va a firmar será el correspondiente a uno de los certificados de clave pública que el firmante tiene configurados en su perfil de Connect.

Por otro lado, para que la firma se considere segura, esta debe realizarse en el equipo donde se encuentra el certificado de clave privada. La aplicación de escritorio **Editranff-Firma**, que también deberá encontrarse instalada en el equipo en el momento de la firma, es la que lleva a cabo este cometido.

## Instalación de la aplicación de escritorio en los puestos firmantes

El instalable de la aplicación se puede descargar haciendo clic sobre el link **descárgala desde aquí** de la primera ventana que se muestra en cada solicitud de firma. De esta forma, quedará en el directorio de descargas del navegador.

![Descargar aplicación de escritorio](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-d4c8f34fbc6265c9bec4948cb9e08ce044acf7c7%2F01_descarga_aplicacion_escritorio.png?alt=media)

Alternativamente, el administrador del sistema puede obtener el instalable de la aplicación del directorio `[Directorio de instalación de Connect]\EditranConnect\signs\app` de la instalación de Connect en el servidor para instalarlo en cada puesto firmante.

Una vez que el instalable de la aplicación se encuentre en el equipo firmante (ya sea porque se ha descargado o porque se ha llevado de forma manual), se procederá como a continuación se explica.

La instalación requiere disponer de privilegios de administrador en el equipo. Cuando se ejecuta el instalable, se muestra una pantalla de bienvenida en la que se debe pulsar el botón **Siguiente**.

![Instalación de la aplicación de escritorio](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-a4d0c68fa8f00014119747f6afe9d82130634529%2F02_instalacion_aplicacion_escritorio.png?alt=media)

A continuación, se elige el directorio de instalación:

![Directorio de instalación de la aplicación de escritorio](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-1a167ff3f5033bc6c288e344f062f78c4b8302a2%2F03_dir_instalacion_aplicacion_escritorio.png?alt=media)

Y por último se indica el servidor (ip/hostname, sin https\://) y el puerto de escucha del servicio **Editran Connect Sign** de la máquina donde se encuentra desplegado Connect.

![IP y puerto del servicio Editran Connect Sign](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-03d42b23d7140d0443fe26ae32660ddc49d11613%2F04_ip_puerto_instalacion_aplicacion_escritorio.png?alt=media)

Pulsado el botón **Siguiente**, la aplicación se instalará.

![Instalación de la aplicación de escritorio finalizada](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-cbdd9ddb85b22bd61cf04d1bbec60873d803d1f4%2F05_terminada_instalacion_aplicacion_escritorio.png?alt=media)

## Proceso de firma

Una vez que el firmante accede al detalle del fichero y, si procede según formato y permisos lo ha visualizado, pulsará el botón **Firmar** para comenzar el proceso.

![Botón Firmar](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-cf6589f2cd6f252f9fbc81dde4b1ec4f03eb7940%2F06_boton_firmar.png?alt=media)

En cada solicitud de firma, una ventana emergente recordará la necesidad de disponer de la aplicación de escritorio para firmar y facilitará el link de descarga. Esta ventana puede tener dos aspectos:

Si en la configuración de la participación del firmante en el grupo de ficheros se indicó que puede actuar con cualquiera de sus certificados (no se seleccionó ninguno en concreto), la ventana ofrece al firmante el conjunto de certificados asociados a su perfil del usuario en Connect. Será el propio firmante quien elija en este momento cuál va a emplear para firmar.

![Firma con cualquier certificado](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-5a0836381e9931eec0f3f7f8d3374626cb92868b%2F07_firmar_con_cualquier_certificado.png?alt=media)

![Selección del certificado](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-6bdfa0adf615067dea5b0add817fefc8ffc9b2ad%2F08_selector_certificado.png?alt=media)

Por el contrario, si en la configuración de la participación del firmante en el grupo de ficheros se indicó que debe actuar con un certificado concreto, esta ventana no ofrece la lista de certificados. En este caso, el firmante puede conocer con qué certificado debe actuar consultando el dato en la propia vista **Detalle del fichero**.

![Sin selector de certificado](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-1f695624ac6d2a313a1edf11ee5806efbd371e16%2F09_sin_selector_certificado.png?alt=media)

En cualquiera de los casos, una vez pulsado el botón **Firmar** de la ventana, una nueva ventana notifica que la aplicación de escritorio Editranff-Firma se va a utilizar. Se pulsará **Abrir**.

![Aviso de uso de la aplicación de escritorio](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-19fcb419ccb6f8cc387e3e2c20c2a4b30c05938a%2F10_aviso_uso_aplicacion_escritorio.png?alt=media)

Aparece una nueva ventana que va informando de los procesos que se están llevando a cabo y, dependiendo del nivel de protección con el que se instaló el certificado, se abrirá aún otra más informando que se va a utilizar el certificado (nivel medio) o solicitando además la introducción de su contraseña (nivel alto, nivel recomendado).

![Pantalla que informa de los procesos de firma](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-c1334f645c86e02854121863eb03e5770a892700%2F11_pantalla_informa_procesos_firma.png?alt=media)

![Pantalla introducción de contraseña del certificado en el proceso de firma](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-76aaaae423931dcd184c64cf5c6be695c3709e25%2F12_pantalla_introduce_contrase%C3%B1a_certificado.png?alt=media)

Aceptada esa ventana, la firma se realizará y una última ventana informará del éxito o del fracaso de la operación.

![Pantalla proceso de firma finalizado](https://1241944019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdpBggYaSLH9X3nOAiMG%2Fuploads%2Fgit-blob-51c977c19b304b786b3400bd141c839dd4e80981%2F13_pantalla_proceso_firma_finalizado.png?alt=media)

El usuario es devuelto a la lista de ficheros filtrada por el estado `Pendientes de firmar por mí`, por lo que el fichero que se acaba de firmar ya no se mostrará. Sin embargo, si el usuario desmarca dicho filtro, puede consultar el fichero recién firmado y sus estados global y particular respecto a cada firmante, si así lo desea.

Desde la lista de ficheros, el firmante puede repetir el proceso descrito con el resto de ficheros que aún estén pendientes de su actuación.


---

# 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-v2.1/firma/firmadeficheros/detallefichero/firmar.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.
