Administrador de Onesait Editran/FF
Se accede a este menú con la opción 2 del menú general.
------------------------------------------------------------------------------
| DD/MM/AA GESTION DE FIRMAS EDITRAN/FF |
| HH:MM:SS ADMINISTRADOR |
------------------------------------------------------------------------------
| |
| |
| |
| |
| |
| 1 ENTORNO LOCAL |
| |
| 2 USUARIOS LOCALES Y REMOTOS |
| |
| 3 APLICACIONES DE FIRMA |
| |
| |
| |
| OPCION : |
| |
| |
| |
| |
| |
------------------------------------------------------------------------------Entorno local
Se accede a esta pantalla con la opción 1 del menú del administrador.
Se dará de alta el Entorno Local (único) donde aparecerá la siguiente pantalla:
El significado de cada uno de los campos es el siguiente.
PREFIJO NOMBRE DE FICHEROS: Máximo 11 bytes. Empleado para la definición de ficheros intermedios y opcionalmente, de ficheros de recepción de aplicación. Debe cumplir las normas del MVS en cuanto a la longitud de los segmentos separados por puntos.
SERVIDOR de FIRMA (ESS): es la dirección del servidor Java que proporciona los servicios de firma y su verificación; se encuentra instalado en el USS.
Puerto: Puerto de escucha del servidor Java.
T/O: indica el tiempo en segundos que el cliente espera para que su petición sea atendida por el servidor. El valor 999 supone una espera indefinida.
Usuarios
Se accede a esta pantalla con la opción 2 del menú del administrador.
Debemos introducir
la opción,
el tipo de usuario (local, para los usuarios propios o remoto para los usuarios de otras entidades),
el código de la entidad a la que pertenece el usuario (código local de Editran para los usuarios locales y código de la entidad remota para los usuarios remotos),
y el nombre con el que identificaremos internamente al usuario.
El nombre del usuario admite cualquier carácter, mayúsculas y minúsculas, o espacios.
Si el usuario es local, el código de entidad que se indica es el código local de Editran. Si se dispusiera de varios códigos locales, subentornos, se podrán dar de alta distintos usuarios para cada uno de los subentornos. Un usuario local sólo puede emplearse en trasmisiones Editran de ese código local. Los nombres de los usuarios locales pueden repetirse en otros códigos locales y se consideran usuarios distintos.
Si el usuario es remoto, el código de entidad se corresponde con el código remoto de la sesión Editran. Los nombres de los usuarios remotos pueden repetirse en otros códigos de entidad.
La baja del usuario no está permitida si se encuentra asociado a alguna regla. La modificación del usuario se arrastra a todas las reglas en las que aparece.
En la opción de alta es obligatorio rellenar todos los datos. En las restantes podemos teclear sólo una parte y utilizar ‘*’ como comodines. Si no se teclean todos los campos, se mostrará una lista de usuarios que podremos seleccionar.
La pantalla es la siguiente.
En la cabecera aparecen los campos que se teclearon en el menú previo.
TIPO (de cabecera): Local o remoto.
ENTIDAD (de cabecera): Código local o remoto.
USUARIO (de cabecera): Nombre de usuario.
En las líneas de la consulta se mostrará
SEL: Campo de selección. Tecleando ‘S’ y pulsando <INTRO> se selecciona el usuario.
TIPO: Local o remoto del usuario.
ENTIDAD: Código local o remoto al que pertenece el usuario.
USUARIO: Nombre del usuario.
ALIAS / DN: Alias del certificado del usuario local o DN (identificación) del certificado del usuario remoto.
Si se teclean todos los datos en la primera pantalla, o se selecciona la sesión de la lista, aparecerá la pantalla de usuario correspondiente al usuario.
LOCAL
El significado de los campos es el siguiente.
ALIAS DEL CERTIFICADO LOCAL: Es el alias del certificado que permite identificarlo dentro del keystore o dentro del anillo de claves. Admite mayúsculas y minúsculas.
Hay dos tipos de certificados a utilizar.
Certificados contenidos en un keystore
PATH DEL KEYSTORE: Para certificados contenidos en un keystore se indicará el path del keystore. El alias del usuario y el path, así como cualquier password asociada, se deberán dar de alta en el servidor EditranSignatureServices mediante la utilidad gestor_claves.sh
Certificados RACF.
USUARIO RACF: Es el propietario del certificado RACF
ANILLO DE CLAVES: Es el anillo (keyring) en el que está incluido el certificado RACF
REMOTO
IDENTIFICACION DEL CERTIFICADO REMOTO:’. Se podrá elegir entre D para DN correspondiente al certificado digital público o P para el path donde se encuentra el archivo certificado digital público.
DN: ‘Distinguished name’. Se corresponde con el DN del certificado digital con el que se firmarán los ficheros. Es una de las dos formas de identificar el certificado. Si no conocemos el DN podemos obtenerlo del fichero ZTBFFSAL
PATH: Se corresponde con la ruta relativa o absoluta donde se encuentra el archivo del certificado público digital con el que se firmarán los ficheros.
Si en la pantalla de usuario pulsamos <PF5>, podremos consultar las reglas a las que está asociado el usuario y los grupos en los que está incluido.
En la cabecera aparecen los campos para los que se realiza la consulta.
USUARIO: Nombre del usuario en curso.
TIPO: Local o remoto, del usuario en curso.
CÓDIGO ENTIDAD: Si el usuario es local aparecerá el código local, si es remoto aparecerá como el código remoto.
En las líneas de la consulta se mostrará
SESION: Aplicación a la que se asoció el usuario.
NORMA: Norma bancaria de la regla en la que está incluido el usuario.
EMPRESA: NIF y sufijo de la regla en la que se incluye el usuario.
GRUPO: Grupo al que pertenece el usuario o espacios si no pertenece a grupo.
F: El usuario puede firmar.
CTF: El usuario contrafirma.
Aplicaciones (sesiones de presentación)
Se accede a esta pantalla con la opción 3 del menú del administrador.
Con la opción 1 daremos de alta las sesiones de presentación.
La pantalla es la siguiente.
Debemos introducir
OPCION : (A)lta, (B)aja, (C)onsulta, (M)odificación o (R) Alta con copia
CODIGO LOCAL
CODIGO REMOTO
APLICACION: aplicación de la sesión Editran que empleará firma de ficheros.
La baja de la sesión supone la eliminación de todos los grupos y usuarios asociados que cuelgan de ella. El alta con copia de sesión copia todos los grupos y usuarios locales a la nueva sesión cuando el código local de la sesión imagen coincide con el de la sesión destino y copia todos los grupos y usuarios remotos cuando coinciden los códigos remotos.
En la opción de alta es obligatorio rellenar todos los datos. En las restantes podemos teclear sólo una parte empleando ‘*’ como comodines.
En la opción de alta con copia, tras rellenar la sesión imagen y pulsar <INTRO>, se nos solicitará la sesión destino.
Si en la pantalla inicial no se tecleó algún campo, se mostrará una lista de sesiones.
En las líneas de la consulta se mostrará
S: Campo para seleccionar. Tecleando ‘S’ y pulsando <INTRO> se selecciona la sesión.
APLICACION: Código local, código remoto y aplicación.
Los siguientes campos se describen en la pantalla de sesión.
EMI REC: Tipo de aplicación, Emisión o Recepción.
VAL CER: Tipo de validación que se hará a los certificados usados.
FIR: Tipo de firma, PKCS#7 o XAdES.
ATT DET: Attached o Detached (modo de firma).
PLANTILLA POLITICA: Plantilla en aplicaciones de emisión y política en recepción.
FTO: Formato de fichero de recepción.
LRECL: Longitud del fichero de recepción.
TRA: Traducir alfabeto.
CC: Quitar saltos de carro.
Para las opciones de alta, alta con copia, baja, consulta y modificación, si se teclean todos los datos en la pantalla inicial, o se selecciona la sesión desde la lista, aparece la siguiente pantalla de sesión.
TIPO DE APLICACION (E/R): Emisión, para realizar la firma de los ficheros a enviar y Recepción para verificar la firma de ficheros recibidos.
VERIFICACION OCSP/CRL (N/O/C/A): Indica el tipo de validación que se desea hacer sobre los certificados, usando la verificación OCSP, CRL, Ninguna, o la que indique el propio certificado, en cuyo caso se pondrá ‘A’.
TIPO DE FIRMA (P/X): Indica si la firma sigue la norma PKCS#7 (Public-Key Cryptography Standards) o la norma XAdES (XML Advanced Electronic Signatures, hasta nivel de protección XAdES - EPES).
MODO FIRMA (A/C/D): Permite elegir si los datos firmados y la firma estarán en un mismo fichero o en ficheros separados. Con formato Attached la firma está contenida en el fichero firmado, con Detached la firma de cada usuario estará contenida en un fichero de firmas. El modo C es el que implementa el formato elegido por Iberpay para el tipo de firma XAdES.
PLANTILLA PARA FIRMA XAdES: sólo para aplicaciones de emisión XAdES, indica que plantilla de firma XAdES se quiere aplicar en las firmas de esta aplicación. Si dicha plantilla especifica una política las firmas generadas serán tipo XAdES –EPES, si la plantilla no indica esa característica o si no se indica plantilla, la firma será tipo XAdES – BES. (*)
POLITICA VERIFICACION FIRMA XAdES: sólo para aplicaciones de recepción XAdES, indica el fichero XML que recoge la política con la que se deben validar las firmas de la aplicación. Si se especifica las firmas serán XAdES - EPES, en caso contrario serán XAdES - BES. (*)
ℹ️(*) Se consigna únicamente el nombre del documento, que debe residir en el directorio “plantillas” / ”políticas” de la instalación en USS. Estos directorios se crearán al instalar el servidor Java y contienen los documentos que permiten crear y verificar firmas según los criterios de la AGE (Administración General del Estado).
Con modo de firma ‘C’ se debe consignar la plantilla: pln-di-e-unfich-BES.xml
Cualquier otra plantilla/política que se quiera utilizar tendrá que ser incluida en estos directorios.
NOMBRE O DIRECTORIO DE LOS FICHEROS DE FIRMA: especifica el nombre del fichero HFS o directorio USS que contendrá las firmas. En caso de que el modo de firma sea Detached, sólo podrá indicarse el nombre de un directorio; el fichero de firmas se llamará (dentro de dicho directorio) igual que el fichero de datos a firmar más la extensión correspondiente al tipo de firma, “.xsig” o “.p7b”. Cuando la firma es Attached se podrá poner un nombre de fichero (que contendrá los datos y las firmas) atendiendo las reglas usadas en Editran (ver apartado Sesión presentación del manual Administración y Operación); en este caso si se consigna un directorio, se procederá como en el modo Detached.
ℹ️Se ha de tener en cuenta que el nombre generado no debe exceder de 44 caracteres para poder ser enviado por la aplicación si la versión del remoto es inferior a 5.2.
Los siguientes parámetros sólo se aplican en la recepción de ficheros.
BORRAR SI EXISTEN (S/N): ‘S’, se borrará el fichero anteriormente recibido en caso de que exista. ‘N’, se acumularán los ficheros recibidos en una presentación siempre que haya proceso de adaptación (ADAPTAR FICHERO FIRMADO: S).
ADAPTAR FICHERO FIRMADO (S/N): Indica que el fichero recibido va a ser formateado tras la verificación de firma. Cuando el proceso de firma XML necesita transformar el fichero de datos para firmarlo, en la recepción se deberá adaptar el fichero a su formato original, esto se hace en un proceso posterior a la verificación de firmas.
NOMBRE: Es el nombre del destino final de los ficheros de aplicación recibidos. El nombre del fichero debe ajustarse al que se incluye en la primera pantalla de sesión de Editran. (opción 1.4 del menú general)
Los siguientes parámetros sólo se aplican cuando se realiza la adaptación de ficheros.
FOMATO FICHERO RECEPCION (F/V/E): El fichero formateado tendrá formato de registro fijo, variable o variable expandido (RECFM=FB, VB o VS).
LONG. REG. RECIBIDO (1-32756): Tamaño del registro del fichero formateado.
TRADUCIR EN RECEPCION (A/E/N): Indica el alfabeto en el que se desea el fichero formateado si se traduce.
TABLA DE CONVERSION RECEPCION: Indica la tabla de conversión de caracteres de Editran que se aplica sobre el fichero una vez traducido.
ELIMINA DELIMITADORES (S/N). DEL. REGISTRO (HEXADECIMAL): Permite quitar los delimitadores que las máquinas ASCII colocan en ficheros de texto. Se indicarán los valores en hexadecimal que se van a eliminar. Para un fichero DOS el delimitador suele ser x’0D0A’ y para un fichero UNIX x’0A’. Los caracteres se eliminarán en cualquier posición del fichero porque el filtro se aplica sobre un fichero sin formato de registro. No se deberá aplicar en ficheros que no sean de texto.
Reglas de firmado de la aplicación
Se accede a esta pantalla con la opción 3.2 del menú del administrador.
Debemos introducir
la opción,
E para emisión R para recepción
el código local, el código remoto y la aplicación de la sesión.
la norma,
la empresa.
En todas las opciones es obligatorio rellenar EMI-REC
En la opción de alta es obligatorio rellenar todos los datos. En las restantes podemos teclear sólo una parte empleando ‘*’ como comodines.
Si no se teclea norma ni empresa se entiende que es una regla genérica. Se puede usar ‘*’ como comodín.
En emisión no podemos teclear norma ni empresa
Si se teclea norma, la regla se aplicará a ficheros pertenecientes a esa norma. Se admiten las normas 19 y 34.
La empresa está compuesta de NIF (9 posiciones) y sufijo (3 posiciones). Estos valores de NIF y Sufijo se obtienen de la Identificación del Presentador del fichero y, en su ausencia, de la Identificación del primer ordenante (norma 34) o de la Identificación del primer acreedor (norma 19). Para definir una empresa que pueda aplicarse a un NIF y todos los sufijos podemos indicar el NIF y sufijo “???”. Si tecleamos empresa es obligatorio incluir norma.
Para una aplicación de recepción pueden definirse múltiples reglas, sin norma, con norma y sin empresa y con norma y empresa.
Las validaciones de las reglas se realizan en el orden de más a menos restrictivas.
Si el fichero tiene norma, se validan solo las reglas de esa norma.
Se aplicará primero la regla con NIF y sufijo coincidentes con los del fichero
Si no la hay se aplicará la que coincida con el NIF y no tenga definido sufijo (“???”)
Si ninguna coincide se aplicará la regla sin NIF ni sufijo
Si el fichero no tiene norma se aplica la regla genérica
Si en la opción de consulta no se teclea norma ni empresa se consultará la regla genérica de forma concreta. Para consultar de forma genérica todas las reglas de una aplicación se tecleará * en norma y empresa.
Pantalla de regla
Si en la pantalla inicial se cumplimenta la opción, EMI-REC y la aplicación, y opcionalmente norma y empresa, aparecerá la pantalla de gestión de la regla.
En la cabecera aparecen los campos de selección.
APLICACION (de cabecera): Código local, código remoto y aplicación.
NORMA (de cabecera): Norma bancaria.
EMPRESA (de cabecera): Empresa compuesta por NIF más sufijo.
EMI-REC (de cabecera): Emisión/Recepción)
NÚMERO TOTAL DE FIRMAS: Número de firmas que se esperan en la regla. Este parámetro sólo se aplica en recepción.
NUMERO DE GRUPOS OBLIGATORIO: Número de grupos de usuarios que se esperan en la regla. Este parámetro sólo se aplica en recepción.
OPCION: Usuario o grupo. En emisión no se permiten grupos
NOMBRE: Nombre del grupo o del usuario. El nombre se puede informar de las siguientes formas:
Dejar en blanco: Saldrá una nueva pantalla con todos los usuarios o grupos (lo que ponga en el parámetro opción)
Informar parcialmente utilizando el comodín ‘*’ al principio o al final del nombre: Saldrá una nueva pantalla con todos los usuarios o grupos (lo que ponga en el parámetro opción), que cumplan la regla
Informando el nombre completo: Saldrá la pantalla del usuario o la pantalla del grupo, dependiendo lo que se ponga en el parámetro opción.
Pantalla scroll de usuarios de recepción.
Si no se cumplimenta usuario o se cumplimente parcialmente, para una norma de recepción, aparecerá la siguiente pantalla
APLICACION (de cabecera): Código local, código remoto y aplicación.
NORMA (de cabecera): Norma bancaria.
EMPRESA (de cabecera): Empresa compuesta por NIF más sufijo.
EMI-REC (de cabecera): Emisión/Recepción
FIRMAS (de cabecera): Número de firmas obligatorias en la regla
GRUPOS (de cabecera): Número de grupos obligatorios en la regla
En las líneas de la consulta se mostrará
S: Seleccionar una línea
GRUPO. Nombre del grupo al que pertenece el usuario dentro de la regla
USUARIO. Nombre del Usuario
CONTRAFIRMANTE. Nombre del contrafirmante
FIR: El usuario firma ficheros
CTF: El usuario es contrafirmante
IMPORTE (P/T): Importe máximo autorizado al usuario por operación (parcial) o por total de fichero.
Si se selecciona un usuario aparecerá la pantalla de usuario cuyo contenido se describe más adelante.
Pantalla scroll de grupos de recepción.
Si no se cumplimenta el grupo o se cumplimente parcialmente, para una norma de recepción, aparecerá la siguiente pantalla
APLICACION (de cabecera): Código local, código remoto y aplicación.
FIRMAS (de cabecera): Número de firmas obligatorias en la regla
GRUPOS(de cabecera): Número de grupos obligatorios en la regla
RECEPCION (de cabecera) : Se trata de una regla de recepción
En las líneas de la consulta se mostrará
S: Seleccionar una línea
NORMA : Norma bancaria.
EMPRESA : Empresa compuesta por NIF más sufijo
GRUPO. Nombre del grupo de la regla
FIRMAS OBLI. : Número de fimas obligatorias para ese grupo
GRUPO OBLI. : Indica si el grupo es o no obligatorio
ℹ️Si se selecciona un grupo aparecerá la pantalla de grupo cuyo contenido se describe más adelante.
Pantalla de usuario de recepción.
Si se cumplimenta usuario, para una norma de recepción o se selecciona un usuario en la pantalla scroll de usuarios de recepción, aparecerá la siguiente pantalla
GRUPO: Si dejamos este campo en blanco el usuario no pertenecerá a ningún grupo. Podemos incluirlo en un grupo tecleando el nombre del grupo.
FIRMA LOS FICHEROS (S/N): El usuario puede firmar ficheros. El usuario firmante no puede contrafirmar.
REQUIERE CONTRAFIRMA (S/N): La firma del usuario debe ser contrafirmada.
USUARIO CONTRAFIRMANTE: Es el nombre del usuario asociado a la regla que debe contrafirmar. El usuario contrafirmante debe tener permiso de contrafirma
IMPORTE TOTAL MAXIMO: Importe máximo autorizado al usuario por el total de operaciones del fichero. Este parámetro sólo se aplica en normas de recepción. Se puede consignar un solo importe, total o parcial, o ninguno. En normas sin regla no se pueden consignar importes.
IMPORTE PARCIAL MAXIMO: Importe máximo autorizado al usuario por operación. Este parámetro sólo se aplica en normas de recepción. Se puede consignar un solo importe, total o parcial, o ninguno. En normas sin regla no se pueden consignar importes.
CONTRAFIRMA FICHERO(S/N): El usuario puede contrafirmar ficheros. El usuario que contrafirma no puede firmar.
IDENTIFICACION DEL CERTIFICADO REMOTO: Es el DN del registro de usuario que se suministró en la opción 2.2 del menú Editran/FF y se muestra aquí como informativo. Su significado se indicó en el epígrafe de Usuarios
Pantalla de usuario de emisión
Si se cumplimenta usuario, para una norma de emisión o se selecciona un usuario en la pantalla scroll de usuarios de emisión, aparecerá la siguiente pantalla
No se consignarán importes en las reglas de emisión
Se podrán cumplimentar campos adicionales
LUGAR DE LA FIRMA: Si se desea se consignarán la CIUDAD, PROVINCIA, CÓDIGO POSTAL Y PAÍS dónde se realiza la firma
Los campos siguientes están seleccionados de la política de la AGE que se suministra con la instalación (plt-firma-AGE-v1-8.xml).
ROL DEL FIRMANTE: Define el rol de la persona en la firma electrónica.
ACCION SOBRE EL DOCUMENTO: Define la acción del firmante sobre el documento firmado.
ALIAS DEL CERTIFICADO LOCAL, PATH DEL KEYSTORE USUARIO RACF y ANILLO DE CLAVES: Son los datos del registro de usuario que se suministraron en la opción 2.2 del menú Editran/FF y se muestran aquí como informativos. Su significado se indicó en el epígrafe de Usuarios
Pantalla de grupo (sólo recepción)
Si se cumplimenta grupo, en una norma de recepción o se selecciona un grupo en la pantalla scroll de grupos de recepción aparecerá la siguiente pantalla. En emisión no están permitidos los grupos.
FIRMAS OBLIGATORIAS EN EL GRUPO: Indica el número mínimo de usuarios que deben firmar para poder cumplir el grupo.
GRUPO OBLIGATORIO (S/N): Indica si es obligatorio que se cumpla el grupo. El grupo se cumple cuando se alcanzan las firmas obligatorias.
IMPORTE TOTAL MAXIMO e IMPORTE PARCIAL MAXIMO, a título informativo, indican el mayor valor de importe por total de fichero o por operación que tiene los usuarios del grupo.
Baja de reglas y usuarios asociados
Si en la pantalla inicial se cumplimenta baja, EMI-REC, la aplicación (se permite utilizar el comodín del asterisco) y opcionalmente se teclea norma o empresa aparecerá la pantalla de baja de reglas y usuarios. En el caso de seleccionar una regla concreta indicando si es EMI-REC, la aplicación concreta, la norma y la empresa concreta se saltará la pantalla de selección de reglas.
Si seleccionamos una de las reglas aparece la siguiente pantalla:
Si se pulsa F2 el sistema dará de baja la regla y todos los usuarios asociados previa confirmación.
Si por el contrario se teclea U en la opción el sistema ira realizando la baja de los usuarios asociados a la regla.
Al seleccionar uno de los usuarios saldrá la pantalla d baja de usuario asociado a una regla
ℹ️Con el INTRO el sistema da de baja el usuario asociado a la regla
Consulta genérica
Si en la pantalla inicial se cumplimenta consulta, EMI-REC, la aplicación, y * en norma y empresa aparecerá la pantalla de consulta de reglas.
En la cabecera aparecen los campos de selección.
APLICACION (de cabecera): Código local, código remoto y aplicación.
NORMA (de cabecera): Norma bancaria.
EMPRESA (de cabecera): Empresa compuesta por NIF más sufijo.
EMI-REC (de cabecera): Emisión/Recepción)
En las líneas de la consulta se mostrará
S: Campo para seleccionar la regla.
APLICACION: Código local, código remoto y aplicación.
NORMA: Norma bancaria.
EMPRESA: Empresa compuesta por NIF más sufijo.
FIRMAS: Número de firmas obligatorias en la regla.
GRUPOS: Número de grupos obligatorios en la regla.
Si se selecciona una regla aparecerán los usuarios asociados.
En la cabecera aparecen los campos de la regla.
APLICACION (de cabecera): Código local, código remoto y aplicación.
NORMA (de cabecera): Norma bancaria.
EMPRESA (de cabecera): Empresa compuesta por NIF más sufijo.
EMISION/RECEPCION (de cabecera).
FIRMAS (de cabecera): Número de firmas obligatorias en la regla.
GRUPOS (de cabecera): Número de grupos obligatorios en la regla.
En las líneas de la consulta se mostrará
S: Campo para seleccionar el usuario.
GRUPO: Nombre del Grupo.
USUARIO: Nombre del usuario.
CONTRAFIRMANTE: Nombre del contrafirmante
FIR: El usuario firma ficheros.
CTF: El usuario contrafirma.
IMPORTE (P/T): Importe máximo autorizado al usuario por operación (parcial) o por total de fichero.
Si se selecciona un usuario aparecerá la pantalla de usuario cuyo contenido se describió en el punto anterior.
Última actualización