> 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/editranff-6-windows/administrador-de-onesait-ecosystems-editran-ff/alta-de-perfiles/alta-de-aplicaciones-de-editran-ff.md). # Alta de Aplicaciones de Editran/FF Para dar de alta una nueva aplicación de Editran/FF, se debe seleccionar en el árbol la rama “*Aplicaciones*” y a continuación acceder al menú “*Operaciones -> Nuevo*” (también desde menú contextual del botón derecho del ratón) o bien pulsar el botón ![](https://1175462395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs4uOQXH4gXp9MdTLmUaj%2Fuploads%2Fgit-blob-6bc8cc680d419d619a28893a2c05cad6b6f6e8ac%2Fimage1.png?alt=media) de la barra de herramientas. Se describen a continuación los parámetros que el sistema requiere para dar de alta una nueva aplicación. * **Nombre:** identificador de la aplicación que se va a dar de alta. Para el primer carácter se permiten los caracteres: A...Z@#$. Para los siguientes son posibles: A...Z0...9@#$-{ * **Propósito:** las aplicaciones pueden ser o bien para firmar o bien para verificar firmas. Si se selecciona la opción *“Nuevo*” desde las ramas “*De firma de ficheros*” o “*De verificación de firmas*”, este campo se rellena de forma automática. ![](https://1175462395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs4uOQXH4gXp9MdTLmUaj%2Fuploads%2Fgit-blob-eaed8ae74faa13f2c1af6feef658f384d1353582%2Fimage2.png?alt=media) **--- Firmas ---** * **Modo de firma:** indica el formato de las firmas que se van a realizar desde la aplicación. Los modos implementados se engloban en dos tipos: PKCS#7 (el fichero de firma tiene formato PKCS#7 y extensión *.p7b*) y XAdES (el fichero de firma tiene formato XML y extensión .*xsig*). Dentro de cada uno de estos formatos de firma existen a su vez varias modalidades, se describen brevemente a continuación: * **PKCS#7 detached:** el fichero de firma no incluye el fichero original. **Requiere el envío del fichero de datos y del de la firma al extremo receptor/validador.** * **PKCS#7 attached:** el fichero de firma incluye el fichero de datos. * **XAdES Detached Interna Implícita:** el fichero de firma incluye el fichero de datos. En este modo los nodos del fichero de datos y los de las firmas realizadas sobre el fichero se disponen al mismo nivel bajo el nodo raíz. Si el fichero de datos que se firma no tiene formato XML, se incorpora en base64. * **XAdES Detached Interna Explícita:** disposición igual que la descrita en el modo implícito, pero en este caso no se incluye el fichero de datos propiamente sino su hash. Este formato es adecuado para ficheros muy grandes. **Requiere el envío del fichero de datos y del de firma al extremo receptor/validador.** * **XAdES Detached Interno Explícito Un Fichero:** es una variación del modo anterior propietaria de Iberpay en la que se concatena el fichero de datos a continuación del de firma, quedando ambos en un mismo fichero físico. Esta modalidad **sólo admite ficheros XML y una única firma.** * **XAdES Detached Externa:** el fichero de firma no incluye el fichero de datos. Es una variación de los modos internos en los que en lugar del fichero de datos lo que se incluye es una dirección URI donde se localiza el fichero de datos físicamente. * **XAdES Enveloped:** el fichero de firma incluye el fichero de datos. En este caso los nodos de firma son hijos del nodo del fichero de datos. Con este modo **sólo se pueden firmar ficheros de formato XML.** * **XAdES Enveloping Implícito:** el fichero de firma incluye el fichero de datos. En este caso el nodo del fichero de datos es hijo del nodo de la firma. Si el fichero firmado no es XML, se incorpora en base 64. Este formato **sólo admite una firma.** * **XAdES Enveloping Explicito:** disposición igual que la descrita para el modo implícito, pero en este caso no se incluye el fichero de datos propiamente sino su hash. Este formato es adecuado para ficheros muy grandes. **Requiere el envío del fichero de datos y del de firma al extremo receptor/validador**. Este formato **sólo admite una firma.** Bajo el combo con los modos de firma, se puede visualizar un campo cuyo literal va cambiando según se selecciona uno u otro modo. Este campo es informativo, se marca o desmarca automáticamente en función del modo de firma escogido, no es posible configurarlo por parte del Administrador. La información que aporta es relevante a la hora de escoger el tipo de ficheros que se van a marcar en la pestaña *Envío* de este diálogo que se verá más adelante. **La utilización de cualquiera de los modos de firma XAdES requiere disponer de una instalación de Java 8 o superior de 32 bits en la máquina. Además, dicha instalación deberá incluir necesariamente la extensión Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files** (a partir de la Release 1.8.0\_151 está incluida por defecto). La funcionalidad para los modos de firmas XAdES se realiza por medio del servicio *Editran Signature* *Services*, que deberá estar correctamente arrancado (desde *UserFF* se ejecuta automáticamente si start\_xades.bat está configurado de manera adecuada), véase **7.12.** * **Validación de firmas necesarias:** Editran/FF ofrece dos formas para establecer los diferentes conjuntos de usuarios que deben firmar los ficheros. Atendiendo a las necesidades de cada entidad, las firmas requeridas para cada fichero (tanto el número de firmas como los firmantes concretos que pueden hacerlo) pueden definirse por medio de Usuarios/Grupos o de Reglas Mancomunadas: * **Usuarios/grupos** * Un usuario puede formar parte de un grupo o estar fuera de todos, pero no puede participar de ambas formas simultáneamente. * Un usuario no puede formar parte de más de un grupo o conjunto de usuarios. * Para poder considerar cada fichero suficientemente firmado, todos los conjuntos de usuarios deben cumplirse: los usuarios que estén fuera de grupo deben firmar siempre (es el caso de los usuarios automáticos) y en cada grupo debe alcanzarse el número mínimo de firmas (firmas obligatorias) y no puede superarse el número máximo (firmas permitidas). * El importe máximo de los ficheros que cada usuario puede firmar en la aplicación es constante y no depende de la actuación o no de otros firmantes. El alta de grupos se explica de forma detallada en la sección **4.2.4.** * **Habilitar orden de los firmantes:** se marcará esta opción cuando las firmas de los usuarios asociados a la aplicación deban realizarse en una secuencia determinada. Si el orden en el que tienen que firmar los usuarios es indiferente, este parámetro no deberá activarse. En el perfil del usuario en la aplicación se establecerá el nivel de cada uno. * **Reglas mancomunadas:** * Cada usuario puede formar parte de tantas condiciones como resulten necesarias. * Se considera un fichero suficientemente firmado cuando se cumple una de las condiciones. * Los usuarios que no forman parte de ninguna condición, no podrán firmar. A excepción de los usuarios automáticos que no pueden participar en ninguna de las reglas y sin embargo siempre tienen que firmar. * El importe máximo de los ficheros que el usuario puede firmar en la aplicación no es constante, puede variar en función de en compañía de quien los firme, es decir, en función de las condiciones mancomunadas en las que participe. Los usuarios sólo podrán firmar los ficheros cuyo importe no supere ninguno de los límites establecidos en las diferentes condiciones en las que esté relacionado. * No es posible establecer el orden en el que se realizan las firmas. El alta de condiciones mancomunadas se explica de forma detallada en la sección **4.2.6.** **--- Ficheros ---** * **Directorios:** seleccionando las pestañas de la tabla, se podrán configuran los directorios asociados a la aplicación. Son los siguientes: * **Ficheros a firmar/Ficheros recibidos:** cuando el propósito de la **aplicación** es “***Firmar”***, se escribirá la **ruta de los ficheros de datos**. Esta ruta admite caracteres comodín (‘\*’, ‘?’). Cuando el propósito de la **aplicación** es “*V**erificar”*** firmas, se escribirá aquí una **ruta de directorio**, aquel donde quedarán los ficheros de datos extraídos de las firmas (o que acompañan a estas en los modos que no los incluyen). * **Firmas:** recoge la ubicación de las firmas de los ficheros: las que se generan en las aplicaciones para firmar y las que se reciben en las aplicaciones para verificar. Puede coincidir con el directorio de los ficheros de datos. En este caso se recomienda utilizar expresiones regulares en la pestaña “Ficheros a firmar” para evitar que las firmas sean consideradas ficheros a firmar. * **Envío:** solo para aplicaciones cuyo propósito es “*Firmar*” y que se quieran configurar para el envío con Editran. Para hacer uso de esta funcionalidad, se deberá haber completado en primer lugar *Directorio envíos Editran* en el menú *Administrador -> Configuraciones generales -> Pestaña “Varios”,* véase **4.1.1.1,.** La pestaña *Envío* muestra tres seleccionables, *Datos, Firmas* y *Habilitación* y, siempre que se haya marcado uno de ellos, además un directorio. * Los seleccionables se refieren al tipo de ficheros que se van a enviar por Editran (versión 5.2.1 y siguientes) al otro extremo. *Habilitación* solo se puede seleccionar en aplicaciones configuradas con *Habilitación -> Sí* y siempre que previamente se haya marcado *Firmas*, en caso contrario aparecerá deshabilitado. **Si lo que se le va a enviar al otro extremo son las firmas, consulte el texto bajo el modo de firma para decidir si es necesario enviar además los ficheros de datos.** * El directorio es aquel donde Editran buscará los ficheros que hay que enviar. Es un subdirectorio bajo el que se indicó en las *Configuraciones generales* y cuyo nombre es el de la aplicación. Esta ruta se compone automáticamente y no es modificable. Los ficheros se moverán a este directorio inmediatamente y de manera automática: * En aplicaciones configuradas con *Habilitación -> Sí*, cuando se habilita la aplicación. * En aplicaciones configuradas con *Habilitación -> No*, cuando todos los ficheros de la aplicación alcancen el número de firmas necesarias (de acuerdo a los perfiles) y todas ellas sean correctas. El directorio de envío debe ser accesible desde los puestos firmantes (igual que los directorios de datos y de firmas) puesto que el movimiento se desencadenará desde el de uno de ellos (el del que habilita, en el primer caso, o el del que realiza la última firma necesaria sobre el último de los ficheros de la aplicación, en el segundo caso). Una vez que los ficheros se encuentran en el directorio de envío, la validación del estado de la aplicación se realiza sobre este directorio. El proceso de firma para nuevos ficheros de la aplicación queda detenido (ningún usuario ve nuevos ficheros pendientes de firma) mientras existan ficheros en este directorio. Cuando los ficheros de la aplicación se encuentran en este directorio, Editran/FF validará una última vez las firmas de la aplicación y Editran, versión 5.2.1 y siguientes, enviará únicamente los ficheros de los tipos que se hayan seleccionado (Datos, Firmas y/o Habilitación), de acuerdo al siguiente criterio: * En aplicaciones configuradas con *Habilitación -> Sí*, si en la verificación previa al envío se encuentra que todo es correcto, se realiza el envío de los ficheros correspondientes a los tipos seleccionados. Si todo es correcto pero además hay ficheros ajenos a esa habilitación, estos se retiran a un subdirectorio llamado *RetiradosEditran* y se realiza el envío de los ficheros correspondientes a los tipos seleccionados. Sin embargo, si la verificación previa al envío finaliza con algún error porque se detecta que alguna de las firmas mencionadas en el fichero de habilitación no es correcta, o falta algún fichero de datos, de firmas o el de habilitación, no se envía nada. Es decir, en este tipo de aplicaciones, si no es correcta toda la información recogida en el fichero de habilitación, no se envía nada, ni siquiera los ficheros de la aplicación que sí tengan las firmas necesarias y correctas. *Por ejemplo, si la aplicación APLICACION consta de FICHERO1, FIRMAFICHERO1, FICHERO2,* *FIRMAFICHERO2 y APLICACIÓN.p7b y se ha configurado enviar Firmas:* * *Si la verificación previa al envío concluye que todo es correcto, se envía* *FIRMAFICHERO1 y FIRMAFICHERO2.* * *Si la verificación previa al envío concluye que FIRMAFICHERO1 es correcta pero que* *FIRMAFICHERO2 es incorrecta, no se envía nada.* * *Si la verificación previa al envío concluye que todo es correcto pero en el directorio* *de envío se encuentra además NUEVOFICHERODESCONOCIDO, se retira* *NUEVOFICHERODESCONOCIDO y se envía FIRMAFICHERO1 y FIRMAFICHERO2.* * En aplicaciones configuradas con *Habilitación -> No*, se verifica que cada fichero cuenta con las firmas necesarias y que todas ellas son correctas. Si la verificación es correcta, se envía el tipo de fichero correspondiente, pero si no lo es, se mueven tanto ese fichero como sus firmas a *RetiradosEditran*. Es decir, en este tipo de aplicaciones, se envían los tipos de ficheros correspondientes a los ficheros que sí cuentan con las firmas necesarias y correctas y se retira el resto. *Por ejemplo, si la aplicación APLICACION consta de FICHERO1, FIRMAFICHERO1, FICHERO2* *y FIRMAFICHERO2 y se ha indicado enviar Firmas:* * *Si la verificación previa al envío concluye que FIRMAFICHERO1 es correcta y* *FIRMAFICHERO2 es incorrecta, se mueven FICHERO2 y FIRMAFICHERO2 a* *RetiradosEditran y se envía FIRMAFICHERO1.* * *Si la verificación previa al envío concluye que FIRMAFICHERO1 y FIRMAFICHERO2* *son correctas pero en el directorio se encuentra además* *NUEVOFICHERODESCONOCIDO, se retira NUEVOFICHERODESCONOCIDO y se envía* *FIRMAFICHERO1 y FIRMAFICHERO2.* En todos los casos, se crea en el directorio de envío un informe llamado *\[Nombre Aplicación].editran* que recoge los ficheros que se han enviado y los asociados que no se han enviado. Si se ha configurado el envío de correos SMTP en el menú *Configuraciones generales* y en la aplicación se ha configurado una dirección de correo electrónico, el producto enviará correos informativos y de incidencias relativas a esta funcionalidad. Una vez finalizado el envío con Editran, los ficheros y el informe se mueven a un subdirectorio bajo este llamado *EnviadosEditran*. En este momento podrá reanudarse el proceso de firma con los nuevos ficheros que existan en el directorio de ficheros a firmar. **Para hacer uso de esta funcionalidad con Editran** versión 5.2.1 y siguientes, **deberán estar arrancados los servicios necesarios (EditranFF y/o Editran Signature Services, si las firmas son de modos XAdES).** Si la versión en uso de Editran es anterior a la 5.2.1, en EditranFF se deberá configurar en esta pestaña todo como se ha descrito para que se produzca el movimiento de los ficheros a este directorio. En Editran, se actualizará el directorio de donde hay que recoger los ficheros con el directorio que recoge esta pestaña y para el envío se procederá como se venía haciendo hasta ahora. * **Mover/Rechazar:** es el directorio por defecto al que se moverán los ficheros de datos que se rechacen, es decir, que se saquen del circuito de firmas por parte de los usuarios asociados a la aplicación que tengan permiso para ello. Si este campo se deja en blanco, los usuarios a los que se otorgue dicho permiso podrán mover los ficheros a cualquier directorio visible desde su equipo para el que dispongan de permiso de escritura. * **Plantilla (en aplicaciones para “*****Firmar*****”) / Política XAdES (en aplicaciones para “*****Verificar”):*** cuando se haya seleccionado uno cualquiera de los modos de firma XAdES, se deberá definir aquí la localización de la **plantilla** a utilizar, **si la aplicación es para “*****Firmar”***, o de la **política, si la aplicación es para “*****Verificar*****” y el nivel de protección utilizado en las firmas es EPES.** Las plantillas son documentos XML, según esquema propietario de Editran/FF y entregado en la distribución (en *XAdES/rsc*), que reúnen un conjunto de características que son configurables para el modo de firma elegida, tales como nivel de protección (BES o EPES), versión de SHA para obtener el hash del documento, versión SHA de algoritmo RSA con el que se firma, etiquetas obligatorias, etc. Con el producto se distribuyen diferentes plantillas para cada modo de firma con las configuraciones más utilizadas, se encuentran en el directorio *XAdES/plantillas* de la instalación. El fichero de política es otro fichero XML, esta vez según un esquema propietario de XAdES, que recoge las características exigidas para considerar correctas las firmas recibidas. En el directorio XAdES/politicas de la instalación se encuentra el fichero de la política de la Agencia General del Estado (AGE). Relación de modos de firma y plantillas/política correspondientes: | **Modo de firma** | **Plantilla (aplicaciones para firmar)** | **Política (aplicaciones para verificar firmas)** | | ----------------------------------------------- | ---------------------------------------- | ------------------------------------------------- | | **XAdES Detached Interna Implícita** | pln-di-i-BES.xml | Sin política | | | pln-di-i-EPES-AGE-v1.9.xml | plt-firma-AGE-v1-9.xml | | **XAdES Detached Interna Explícita** | pln-di-e-BES.xml | Sin política | | **XAdES Detached Interno Explícito Un Fichero** | pln-di-e-unfich-BES.xml | Sin política | | **XAdES Enveloped** | pln-envped-BES.xml | Sin política | | | pln-envped-EPES-AGE-v1.9.xml | plt-firma-AGE-v1-9.xml | | **XAdES Enveloping Implícito** | pln-envping-i-BES.xml | Sin política | | **XAdES Enveloping Explícito** | pln-envping-e-BES.xml | Sin política | Si ninguna plantilla de la instalación se adaptara a las necesidades requeridas, se podrá escribir otra, siempre cumpliendo el esquema indicado, y aludirla en este campo. Cuando el nivel de protección que se quiera utilizar en las firmas intercambiadas sea EPES, en este campo el extremo que firma colocará una plantilla con EPES y el extremo que valida colocará el fichero de política. El uso en el extremo firmante de aquellas plantillas del directorio XAdES/plantillas con “EPES-AGE” en el nombre garantiza el cumplimiento de la política AGE en el extremo receptor y validador de dichas firmas. Por el contrario, si el extremo validador va a utilizar como nivel de protección BES, dejará este campo en blanco y el extremo firmante indicará una plantilla para nivel de protección BES (en las de la distribución son todas aquellas con “BES” en el nombre). Cuando se da de alta una nueva aplicación y este campo está en blanco, la selección de cada modo de firma en el combo escribe automáticamente en este campo la plantilla correspondiente entre las incluidas en el producto. En los modos para los que hay plantilla BES y plantilla EPES, por defecto se asigna la primera, pero el valor es modificable. * **Visualizador/Validador:** se indicará por medio de este parámetro el formato de los ficheros que se van a validar, visualizar y firmar en esta aplicación. Si no se desea la visualización del contenido antes de la firma (opción no recomendada) o se quieren mezclar en el directorio “*Ficheros a firmar*” ficheros de diferentes formatos, se debe seleccionar \ en el combo. El combo muestra todos los módulos visualizadores y validadores incluidos en el producto, véase apartado **6.1. Cuando el visualizador que se va a utilizar es de la norma de Transferencias (tanto en formato plano como en formato XML) únicamente se podrá escoger aquí el programa Resumen (solo muestra la cabecera y los totales del fichero). Después, en el perfil Usuario – Aplicación de aquellos usuarios que deban visualizar el contenido completo del fichero (las transferencias individuales) se seleccionará el módulo RRHH, quedando para el resto el módulo Resumen, que es el que aparecerá por defecto.** * **Importe total máximo permitido en los ficheros (€):** este parámetro permite limitar el importe máximo de los ficheros que se pueden firmar. **--- Certificados ---** ***Verificar cadena de certificación:*** su selección desencadena la validación (en cuanto a estructura, contenido, uso y fecha de caducidad) de todos los certificados de autoridad (raíz e intermedios) de la cadena de certificación del que se ha utilizado para firmar. Este proceso es obligatorio para los modos de firma XAdES, por lo que esté parámetro quedará marcado automáticamente cuando se seleccione uno de esos modos. **Verificar estado de revocación:** su selección desencadena la validación del estado de revocación del certificado elegido para firmar, es decir, conocer si la autoridad que lo emitió lo sigue considerando válido o no. El lugar donde se debe verificar esta información forma parte de la información contenida en los certificados. Si la ubicación es una dirección https, la máquina desde la que se realiza la validación deberá tener salida a internet y tener correctamente configurados los parámetros que se escriben con XAdES/bin/configuración\_xades.cfg. **--- Habilitación ---** * **Sí / No:** el fichero de habilitación es un fichero resumen con formato propietario de EditranFF. Recoge el nombre de cada fichero de la aplicación que se encuentre en el directorio de datos, los DN de los certificados con los que se ha firmado, el nombre del fichero de firma resultante y, cuando procede, un comentario informando de que faltan firmas. Este fichero se creará en las aplicaciones en las que se marque la opción “*Sí*” y no se creará en caso contrario. La presencia de firmas incorrectas o inválidas en la aplicación es incompatible con la generación de este fichero. Puede ser creado de manera manual o automática y sólo por parte de los usuarios que tengan permiso para ello. El fichero de habilitación, con el contenido arriba descrito, queda firmado por el usuario que lo genera, se almacena en el directorio de firmas de la aplicación con el mismo nombre que esta y la extensión .*p7b*. Si la aplicación es para verificar firmas, el parámetro indica si se va a recibir o no el fichero de habilitación. * **Habilitación automática:** cuando se haya seleccionado la opción “*Sí*”, se podrá marcar además esta opción para que la generación del fichero de habilitación se desencadene a continuación de la última firma necesaria para los ficheros de una aplicación, siempre que el usuario que haya realizado esa última firma tenga permiso para habilitar. Aunque el proceso en este caso se desencadena automáticamente, el usuario podrá cancelar su generación si así lo desea. Si no se marca esta opción, la aplicación permanecerá sin el fichero de habilitación hasta que un usuario de la aplicación, con el permiso oportuno, proceda a su generación de manera manual. * **Proceso posterior a la habilitación:** en este parámetro se puede indicar el nombre de un programa o fichero *batch* que ejecute cierta tarea que se quiera lanzar tras la habilitación, si la aplicación es para firmar, o tras la aceptación si es para verificar firmas. * **E-Mail Notificaciones:** siempre que se haya configurado el envío de e-mails (véase **4.1.1.1**) en esta dirección se recibirán diversas notificaciones genéricas de EditranFF, por ejemplo cuando se habilite la aplicación, cuando se rechace un fichero, etc. **Los campos “*****Compresión*****” y “*****Cifrado*****” en la pestaña “*****Ficheros a firmar*****”, las pestañas “*****Envío”, “Mover/Rechazar*****” y *****“Certificado para cifrar*****” de la tabla “*****Directorios*****” y campo “*****Habilitación automática*****” son propios de las aplicaciones para firmar y quedan por tanto deshabilitados cuando se define una aplicación cuyo propósito sea verificar firmas.** Una vez completado el formulario se procederá a “*Guardar*”, quedando así la nueva aplicación almacenada con estos parámetros en “*aplicFF.cfg*” y se añadirá en el árbol a una de las subramas “*De firma de ficheros*” o “*De verificación de* *firmas*”, según el propósito que tenga, en la lista de la derecha. --- # 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/editranff-6-windows/administrador-de-onesait-ecosystems-editran-ff/alta-de-perfiles/alta-de-aplicaciones-de-editran-ff.md?ask=&goal= ``` `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.