> 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/ibm-editran-v5.3-comun-z-os/editran-ff-instalacion-firma-y-verificacion-v7.1.1/instalacion-y-requisitos/instalar-en-uss.md). # Instalar en USS 1. Se recomienda crear un directorio en la partición Unix de z/OS (USS) para instalar el software de verificación de firma, por ejemplo: /u/edisign. 2. Enviar, en modo binario, al USS el paquete EditranSignature-zos.Vn.n-AAAA-MM-DD.tar. Puede usar cualquier utilidad de transferencia de ficheros, como el ftp. 3. Conectarse al USS y descomprimir el fichero dentro del directorio creado (u/edisign>tar -xof EditranSignatureServices-zos.V3.1.0-2024-04-10.tar). Dejará una estructura como en el ejemplo que sigue: ```sh /u/edisign: >ls -l drwxr-xr-x 2 KI10139 KISNCE 8192 May 25 12:19 bin drwxrwxrwx 2 KI10139 KISNCE 8192 May 25 10:18 conf drwxr-xr-x 2 KI10139 KISNCE 8192 May 25 09:55 crl drwxr-xr-x 3 KI10139 KISNCE 8192 May 25 10:18 lib drwxrwxrwx 2 KI10139 KISNCE 8192 May 25 10:28 logs drwxr-xr-x 2 KI10139 KISNCE 8192 May 25 10:18 plantillas drwxr-xr-x 2 KI10139 KISNCE 8192 May 25 10:18 politicas drwxr-xr-x 4 KI10139 KISNCE 8192 Dec 17 2018 rsc ``` Los scripts de configuración del producto están en el directorio bin y debemos de asegurar que tienen permiso de escritura y ejecución. Se han de modificar dichos scripts con el directorio JAVA\_HOME de la instalación y con el directorio creado para instalar el software (punto 1), en la variable DIR\_XADES. También es recomendable que la carpeta de logs tenga permiso de escritura, al menos, para el grupo de usuarios. El servidor utiliza ficheros temporales cuyo lugar de creación se indicará en el script start\_xades.sh modificando la variable DIRTMP=/u/edisign/tmp (Opcionalmente, modificando el parámetro de llamada -Djava.io.tmpdir=”/u/edisign/tmp). 4. Ejecutando */u/edisign/bin/configuracion\_xades.sh* se procederá a la adaptación de la configuración del producto a la instalación propia. El comando nos devuelve: ``` #####Configuracion de EDITRAN/XAdES##### ``` Los valores con contrasena (passProxy y passTrustStore) se guardan codificados y los demas en claro. Si se quisiera se pueden editar los valores en claro con un editor de texto plano, pero no los valores codificados. Valor del archivo conf\xades.properties ``` #Parametros de EDITRAN/XAdES (Obligatorio) ipEditranXades=127.0.0.1 puertoEditranXades=7760 #Tipo de almacen del que se extraen los certificados. Puede ser FICHERO para el sistema clasico de keystores, #HSM para tarjetas criptograficas o RACF para usar este sistema (solo en z/OS). tipoAlmacen=FICHERO #Conexion con EDITRAN/OCSP remoto (Opcional, se rellena si se usa EDITRAN/OCSP remoto) ipEditranOcsp= puertoEditranOcsp= #Conexion con proxy para la conexion a Internet. Es necesario en el caso de querer usar OCSP o CRL para verificar la revocacion #de certificados o para el caso de querer firmar con TimeStamp para lo que se necesita la conexion con un servidor ipProxy= puertoProxy= userProxy= passProxy= #Sistema Operativo donde se instala EDITRAN/XAdES. En el caso de Sistemas Operativos Windows, Unix o AS400, su valor debe ser N(No). #En el caso de Sistemas Operativos z/OS, su valor debe ser S(Si) zOS=S #Propiedades del modo FICHERO #TrustStore de las CAs (Obligatorio) pathTrustStore=rsc/truststore/trustStore.pfx passTrustStore=******** #KeyStore por defecto (Opcional) pathKeyStore=rsc/keystore/keyStore.pfx #Propiedades del modo HSM #Ruta a la libreria nativa del HSM (Obligatorio) pathLibreria= #Token de las CAs (Obligatorio) tokenCA= passTokenCA= #Token de certificados de firma por defecto (Opcional) tokenDefecto= #Propiedades del modo RACF #Nombre de usuario que accede a los anillos por defecto (Opcional) usuarioDefecto= #Nombre del anillo con los certificados de firma por defecto (Opcional) anilloDefecto= Modificar las propiedades del fichero conf\xades.properties? (S/N) ``` Poniendo S irá pidiendo los valores de los parámetros; se tendrán que introducir sólo aquellos que sea necesario modificar. En la opción Tipo Almacén se selecciona el modo de obtención de los certificados necesarios para la firma y de las CAs que aseguran la validez de los certificados, tanto para firmar como para verificar. En el modo Fichero, el modo por defecto, se obtienen los certificados a partir de ficheros (.pfx), que es el sistema que se ha usado en versiones anteriores del producto. En el modo RACF, estos certificados se deben encontrar incluidos en dicho sistema, en anillos accesibles por un usuario. En caso de que los certificados que se usen en las aplicaciones necesiten validación OCSP y ésta se haga de forma remota, se necesita el servidor Editran/OCSP, debiendo configurar la dirección y puerto en el que está instalado. Para poder hacer la verificación OCSP/CRL de los certificados y también para la firma con TimeStamp para conectarse al servidor que selle la hora de firma, normalmente se necesitará un proxy para salir del Host, por lo que en ese caso se tendrá que implementar la dirección y puerto del proxy así como un usuario y password para poder acceder a través de él a Internet. Esta configuración quedará guardada en el fichero xades.properties del directorio conf (en el ejemplo: /u/edisign/conf/xades.properties). Describimos a continuación todas estas propiedades: * Propiedades obligatorias: * IP de Editran/XAdES: IP en la que se arranca el Servidor Java Editran/XAdES. * Puerto de Editran/XAdES: Puerto en el que se arranca el Servidor Java Editran/XAdES. * Tipo Almacén: El modo de obtención de los certificados para la firma y las CAs. En modo Fichero se obtienen de ficheros (.pfx). En el modo RACF, se obtienen de este sistema, guardados en anillos accesibles por usuarios. Las CAs serán aquellas que se encuentras marcadas como de confianza por RACF. * Propiedades obligatorias del modo Fichero: * Path del truststore: Es la ruta del almacén de certificados donde se guarda el certificado de todas las CA en las que debamos confiar. * Password: Password del truststore. * Propiedades opcionales: * Editran/OCSP remoto: Sólo es necesario en el caso de querer usar Editran/OCSP de forma remota, por defecto se usa de forma local en el caso de querer hacer verificación de certificados. * IP Editran/OCSP: Dirección IP de la máquina donde esté instalado y ejecutándose el servidor Editran/OCSP Remoto. * Puerto Editran/OCSP: Puerto del servidor Editran/OCSP para poder conectarse a él. * Proxy: Uso de proxy para la conexión a Internet de Editran/XAdES. Es necesario en el caso de verificación de los certificados tanto por medio de CRL u OCSP, y también para la firma con TimeStamp para conectarse al servidor que selle la hora de firma: * IP Proxy: Puerto del proxy con el que necesita conectarse Editran/XAdES. * Puerto Proxy: Puerto del proxy para la conexión a Internet. * Usuario Proxy: En caso de ser necesario, usuario del proxy para la conexión a Internet. * Password Proxy: Password del usuario del proxy. * Sistema z/OS: Indica si el sistema donde se está ejecutando el programa Java es una máquina z/OS o no. 5. Para arrancar y parar el proceso se utilizarán los scripts: ``` /u/edisign/bin/start_xades.sh /u/edisign/bin//stop_xades.sh ``` --- # 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/ibm-editran-v5.3-comun-z-os/editran-ff-instalacion-firma-y-verificacion-v7.1.1/instalacion-y-requisitos/instalar-en-uss.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.