Instalación Componente Cliente Manual de usuario Referencia: Autor: Fecha de creación: 02/07/2015 Última actualización: 03/07/2015 Versión: 1.10 AST-EFIRMA- InstalacionComponenteCliente.doc Aragonesa de Servicios Telemáticos Clasificación: Uso Público
Contenido 1. COMPONENTE CLIENTE... 3 1.1. REQUISITOS... 3 1.1.1. Lector criptográfico... 3 1.1.2. Tarjetas Criptográficas... 3 1.1.3. Certificados Raíz... 6 1.1.4. Java Runtime Environment (JRE)... 9 1.1.5. Navegador... 9 1.1.6. Sistemas Operativos 64 bits... 10 2. PROCESO INSTALACIÓN... 11 2.1. INSTALACIÓN PASO A PASO... 11 3. PROCESO DESINSTALACIÓN... 13 3.1. BORRADO DE ARCHIVOS... 13 3.2. BORRADO DE LA CACHE DE JAVA... 13 4. PROBLEMAS Y SOLUCIONES... 17 4.1. VENTANAS EMERGENTES DESACTIVADAS... 17 4.2. NO HAY PERMISOS DE EJECUCIÓN DE JAVASCRIPT... 19 4.3. NO ESTÁ INSTALADA LA MÁQUINA VIRTUAL JAVA... 20 4.4. PROBLEMA AL ACTUALIZAR LA MÁQUINA VIRTUAL JAVA... 21 4.5. NAVEGADOR IEXPLORER. ERROR AL FIRMAR UN FICHERO ALOJADO EN EL EQUIPO DEL USUARIO... 22 4.6. ADVERTENCIAS DE SEGURIDAD... 24 4.6.1. Conexión no verificada... 24 4.6.2. Java Update Necesario... 25 4.6.3. Conexión al sitio web no es de confianza... 25 4.6.4. Bloqueo de la ejecución de componente inseguros... 27 4.7. CONFIGURACIÓN DE SEGURIDAD JAVA... 28 4.7.1. Comportamiento Java 1.7.0.21... 29 a) Seguridad Alta... 29 b) Seguridad Media... 30 4.7.1.2. Comportamiento Java 1.7.0.25... 32 a) Seguridad Alta... 32 b) Seguridad Media... 34 4.7.1.3. Comportamiento Java 1.7.0.51... 35 a) Seguridad Alta... 35 b) Seguridad Media... 36 4.8. UNA VEZ ACEPTADO TODO NO SUCEDE NADA... 38 4.9. ERRORES INVOCATIONTARGETEXCEPTION... 40 4.10. INSTALACIÓN CON JRE 1.6. (JAVA 1.6.0_45 CON WIN7)... 44 4.11. INSTALACIÓN CON JRE 1.8.... 45 Versión: 1.10 Pág. 2 de 50
1. Componente Cliente El componente cliente de la Plataforma de Firma de Gobierno de Aragón permite a un usuario la firma y el cifrado de documentos electrónicos desde una aplicación web, pudiendo acceder a los almacenes locales de certificados de su ordenador. 1.1. Requisitos Para la correcta utilización del componente cliente y de sus funcionalidades es necesario tener en cuenta cierto número de requisitos previos. 1.1.1. Lector criptográfico Es necesario tener correctamente instalado el teclado con lector criptográfico y sus drivers. Administrador de dispositivos de MS Windows XP 1.1.2. Tarjetas Criptográficas Disponer de una tarjeta criptográfica y haber instalado sus drivers, que son distintos para cada tipo de tarjeta (CERES, DNI Electrónico ). Estos drivers deben instalarse tanto para el MS Versión: 1.10 Pág. 3 de 50
Certificate Store como para los diversos clientes que no usen el MS Certificate Store y que puedan hacer uso de las tarjetas (Firefox, Thunderbird ). Tarjetas mas comunes DNI Electrónico Tarjeta CERES URL de descarga de sus drivers http://www.dnielectronico.es http://www.cert.fnmt.es Los drivers de estas tarjetas son independientes de los certificados y claves privadas que contengan, ya que las tarjetas son solamente un contenedor. En el caso del DNI Electrónico, éste solamente contendrá los certificados y claves de firma y autenticación emitidos por la Dirección General de la Policía, mientras que en las tarjetas CERES, al poder escribirse en ellas, podrán contener todo tipo de certificados y claves, como las emitidas por FNMT, Camerfirma, Firmaprofesional, Ancert Para comprobar que sus correspondientes drivers han sido instalados correctamente, basta con observar si podemos ver los certificados alojados en las tarjetas desde los distintos almacenes de navegadores. En Internet Explorer (MS Certificate Store): Herramientas Opciones de Internet Pestaña Contenido Certificados Certificados del DNI Electrónico en MS Certificate Store Versión: 1.10 Pág. 4 de 50
En Mozilla Firefox: Herramientas Opciones Avanzado Pestaña Cifrado Ver certificados Certificados del DNI Electrónico en Firefox Estas tarjetas tienen funcionamientos diferentes respecto a su PIN. Mientras que la tarjeta CERES solo pide el PIN cuando se accede a una clave privada y éste se cachea temporalmente, el DNI Electrónico pide el PIN cada vez que tiene que acceder al propio chip criptográfico, ya sea solamente para acceder al certificado público o para usar la clave privada, adicionalmente cuando se vaya a hacer uso de la clave privada de firma, aparecerá un aviso para indicar que esta apunto de realizarse una firma electrónica reconocida (Ley 59/2003). Petición del PIN del DNI Electrónico Versión: 1.10 Pág. 5 de 50
Aviso del DNI Electrónico de creación de firma electrónica reconocida 1.1.3. Certificados Raíz Los certificados raíz de las Autoridades de Certificación emisoras de los certificados con los que vamos a trabajar, deben estar instalados tanto en el MS Certificate Store como en los almacenes de los diversos clientes que no usen el MS Certificate Store (Firefox, Thunderbird ). Almacén de certificados de Firefox Versión: 1.10 Pág. 6 de 50
Almacén de certificados MS Certificate Store En el MS Certificate Store el certificado raíz de la FNMT debe estar habilitado para soportar todos los propósitos. Para ello hacer doble clic en el certificado FNMT Clase 2 donde aparecerá la siguiente ventana: Versión: 1.10 Pág. 7 de 50
En el botón de Modificar propiedades de la pestaña Detalles de las propiedades de un certificado, deben habilitarse todos los propósitos para este certificado. Versión: 1.10 Pág. 8 de 50
Deben estar habilitados todos los propósitos para este certificado. 1.1.4. Java Runtime Environment (JRE) Para la utilización del componente cliente, será necesario tener instalada la máquina virtual de Java en sus versiones: JRE 1.6 (desde 1.6.0_1 hasta 1.6.0_45) JRE 1.7 (desde 1.7.0_01 hasta 1.7.0_76) JRE 1.8 (desde 1.8.0_01 hasta 1.8.0_31). 1.1.5. Navegador Con la actual versión del componente cliente se soportan los siguientes navegadores: MS Internet Explorer (desde 7 hasta 11) Versión: 1.10 Pág. 9 de 50
Mozilla Firefox (desde 3.6 hasta 35) Chrome (desde 11 hasta 40) Opera (11.51) Safari (5,6) 1.1.6. Sistemas Operativos 64 bits En Sistemas Operativos de 64 bits se debe tener en cuenta que para el correcto funcionamiento del componente es necesario instalar un entorno de ejecución Java (tanto del navegador como de la máquina virtual de Java) en 32 bits, y no una variante de 64 bits. Versión: 1.10 Pág. 10 de 50
2. Proceso Instalación Para la instalación de del componente cliente se deben cumplir unos requisitos básicos: Navegador compatible Máquina Virtual Java (JRE) compatible El navegador debe tener habilitada la funcionalidad para ejecutar JavaScript El navegador debe tener las ventanas Emergentes activadas para el sitio que se está integrando con el componente cliente. Cuando se accede al sitio que requiera el uso del componente cliente, si este no está instalado todavía, se procede a su instalación online automática antes de su ejecución. Durante la instalación pueden darse algunos errores. Para ver la solución a posibles errores de instalación ver la sección Problemas y Soluciones. El componente cliente se descarga y se instala automáticamente en la máquina local del usuario, ahorrando así las constantes descargas de librerías en cada ejecución del Applet Java. El proceso de instalación creará una carpeta WebSigner que alojará las diferentes versiones del componente instalado donde almacenará: SystemLibs: librerías del sistema (DLLs) que se copian a este directorio para tener un control exacto de la carga de las mismas sin depender de posibles versiones obsoletas instaladas en la máquina. Logs: Trazas de las ejecuciones del componente. Lib: librerías Java del propio componente. 2.1. Instalación Paso a Paso Para la instalación/actualización de una nueva versión del componente cliente, es necesario acceder vía web y con permisos de administrador a la página https://firmaelectronica.aragon.es En caso de tener instaladas versiones anteriores le aparecerá la siguiente pantalla preguntándole si desea actualizar la versión: Versión: 1.10 Pág. 11 de 50
Si no dispone de ninguna versión instalada en su entorno, o una vez aceptada la instalación en caso de tener otras versiones del componente instaladas, se lanzaría el proceso de instalación: Y finalmente si todo ha ido bien, se le pediría reiniciar el navegador: Una vez realizado este proceso el usuario podrá ejecutar el navegador de manera normal para usar el componente cliente de firma. Versión: 1.10 Pág. 12 de 50
3. Proceso Desinstalación 3.1. Borrado de archivos Para la desinstalación se debe eliminar la carpeta WebSigner situada en la carpeta del usuario. Entornos Windows: C:\Documents and Settings\USUARIO\WebSigner Entornos Unix: \home\usuario\websigner 3.2. Borrado de la cache de JAVA En caso de tener la cache de Java activada, será necesario borrar los datos correspondientes para evitar así que se ocasionen problemas en futuras ejecuciones La forma de desinstalar el componente cliente es borrando la cache de Java desde el panel de control de Java, dicho panel puede aparecer en el panel de control del sistema operativo con el nombre de Java. En Windows XP se encontraría en Inicio->Panel de Control->Java Versión: 1.10 Pág. 13 de 50
Si en el Panel de Control no aparece el panel de control de Java (depende de cómo se haya realizado la instalación), se puede arrancar directamente de su ejecutable alojado en: DirectorioJRE\bin\javacpl.exe Ir a la pestaña General y pulsar sobre el botón Configuración : Versión: 1.10 Pág. 14 de 50
Pulsar sobre el botón Borrar archivos : Marcar la check Aplicaciones y applets y pulsar sobre el botón Aceptar. Si la check Aplicaciones y applets aparece deshabilitada es porque la check Conservar los archivos Versión: 1.10 Pág. 15 de 50
temporales en mi equipo. que se puede ver en la captura del paso 2 esta sin marcar por lo que no hay nada que borrar. Versión: 1.10 Pág. 16 de 50
4. Problemas y Soluciones El Servicio de Firma Electrónica de Gobierno de Aragón pone a disposición la página web https://firmaelectronica.aragon.es/efirmatest para poder realizar un primer chequeo de requerimientos del ordenador del usuario donde comprobar si cumple con los requisitos básicos de versiones. Un ejemplo de que su equipo cumple con los requisitos mínimos, salvo el visor de PDF se obtendría el siguiente resultado: A continuación se muestran los problemas o situaciones más comunes a la hora de realizar el proceso de instalación o ejecución del componente. 4.1. Ventanas emergentes desactivadas En algunos casos es posible que el componente necesite tener las ventanas emergentes activadas para el sitio que se está integrando con el componente cliente. Según versiones del navegador muestra avisos diferentes desde que se está intentando mostrar una pantalla a mostrar un icono en la barra de estado. Para navegador Firefox habrá que desactivar la opción Bloquear ventanas emergentes, o bien añadir una excepción al sitio desde el cual se accede al componente cliente en el botón Excepciones situado a la derecha de Bloquear ventanas emergentes. Versión: 1.10 Pág. 17 de 50
En Herramientas Opciones Contenido En las últimas versiones de IExplorer podemos desactivar la opción de Activar el bloqueador de elementos emergentes en Herramientas Opciones de Internet Privacidad. También podemos dejar esta opción habilitada y poner una excepción en el menú de Configuración. Versión: 1.10 Pág. 18 de 50
4.2. No hay permisos de ejecución de JavaScript Hay que permitir ejecutar JavaScript para que funcione correctamente. Mozilla Firefox En Herramientas->Opciones->Contenido Versión: 1.10 Pág. 19 de 50
NOTA: Mozilla Firefox no mostrara ningún mensaje avisando de este hecho. 4.3. No está instalada la Máquina Virtual Java Se requiere tener instalada la Máquina Virtual Java en alguna de las versiones compatibles indicadas en este documento. Se dispone de dos procesos: Instalación de cero: En caso de no disponer de ninguna versión de plugin instalada deberá descargase la JRE (http://www.java.com/es/). Una vez descargada simplemente se debe ejecutar el archivo descargado. Actualización: En caso de disponer de una versión de java actualmente instalada se puede realizar el proceso anterior o en su lugar llevar a cabo una actualización, para ello se deben seguir los siguientes pasos: 1. Acceso al panel de Java disponible en el panel de control de Windows. 2. Accedemos a la pestaña Actualización y pulsamos la opción Actualizar ahora. Versión: 1.10 Pág. 20 de 50
NOTA: Esta ventana puede cambiar según las diferentes versiones de JRE instaladas. 4.4. Problema al actualizar la Máquina Virtual Java Cuando se actualiza la JRE en el equipo del usuario se corre el riesgo que se actualice una versión Java que no es compatible con el componente cliente. En entornos en los que los usuarios trabajen con cuentas limitadas, recomendamos que en la instalación de la JRE se desmarque la opción de actualización para evitar estos problemas. Versión: 1.10 Pág. 21 de 50
NOTA: Esta ventana puede cambiar según las diferentes versiones de JRE instaladas. 4.5. Navegador IExplorer. Error al firmar un fichero alojado en el equipo del usuario Durante el proceso de firma se obtiene el siguiente mensaje: El problema se debe a una restricción de seguridad que tiene el navegador IExplorer en versiones posteriores a la 7 (el navegador ofusca la ruta del fichero a firmar por lo que el componente cliente de firma no tiene acceso al documento que tiene que firmar, motivo por el cual se produce el error). La solución al problema sería abrir desde el menú de Herramientas Opciones de Internet, ir a la pestaña de Seguridad : Versión: 1.10 Pág. 22 de 50
Clickear en el icono de Sitios de confianza y posteriormente al botón sitios : Y en la ventana agregar las rutas en los sitios de confianza del usuario http://*.aragon.es y https://*.aragon.es Versión: 1.10 Pág. 23 de 50
4.6. Advertencias de seguridad 4.6.1. Conexión no verificada Al acceder vía https la primera vez tenemos que confiar en el dominio aragon.es al que entramos, veremos una imagen como esta: Debemos pulsar en Entiendo los riesgos y se nos abrirá hacia abajo un menú donde deberemos añadir la excepción Al añadir la excepción nos abrirá la ventana para confirmar y así confiar en dicho certificado Versión: 1.10 Pág. 24 de 50
4.6.2. Java Update Necesario Una vez pasado este punto si no tenemos la última versión Java instalada nos mostrara un mensaje similar a este donde indica que su versión Java no es segura, podemos pulsar en más tarde y marcar el check de abajo para que no nos vuelva a mostrar el mensaje No es necesario tener la última versión de Java para trabajar con el componente. Ver Punto 1.1.4 4.6.3. Conexión al sitio web no es de confianza La siguiente advertencia de seguridad que puede aparecer seria como el siguiente: Versión: 1.10 Pág. 25 de 50
Esto indica que debemos confiar en estos sitios web. Para eliminar estas advertencias podemos configurar desde nuestro navegador los sitios web de Gobierno de Aragón (aragon.es) como sitios de confianza desde Herramientas Seguridad Sitios de Confianza y al pulsar en sitios deberíamos ver algo similar a: Versión: 1.10 Pág. 26 de 50
4.6.4. Bloqueo de la ejecución de componente inseguros Por ultimo podría mostrar un mensaje como este al que deberemos de pulsar que NO deseamos bloquear la ejecución del componente En función de la versión se Java Instalada, el mensaje puede variar, por ejemplo con Java 1.7 Versión: 1.10 Pág. 27 de 50
4.7. Configuración de Seguridad Java En función de la configuración de seguridad (Media, Alta o Muy Alta) que tengamos en Java pueden salir diferentes alertas de seguridad. Para conocer el nivel de seguridad que hay configurado se tiene que acceder a: Versión: 1.10 Pág. 28 de 50
4.7.1. Comportamiento Java 1.7.0.21 a) Seguridad Alta Versión: 1.10 Pág. 29 de 50
Habría que indicar, para que la seguridad no bloquee la instalación de WebSigner. b) Seguridad Media Se indica para continuar con la instalación con esta configuración. Versión: 1.10 Pág. 30 de 50
Versión: 1.10 Pág. 31 de 50
Al darle al botón Ejecutar se muestra un nuevo mensaje: Es necesario indicar, para que la seguridad no bloquee la ejecución de WebSigner. 4.7.1.2. Comportamiento Java 1.7.0.25 El comportamiento de la versión de Java v1.7.0_25 es similar a la v1.7.0_21. La instalación de WebSigner depende del nivel de seguridad de Java a) Seguridad Alta Se indica para continuar con la instalación con esta configuración. Versión: 1.10 Pág. 32 de 50
Al, se queda bloqueado, indicando el siguiente error en la consola de java: security: LiveConnect (JavaScript) blocked due to security settings. Este error se soluciona a partir de la versión v1.7.0_51 de Java. Versión: 1.10 Pág. 33 de 50
b) Seguridad Media Al darle al botón Ejecutar se muestra un nuevo mensaje. Versión: 1.10 Pág. 34 de 50
Habría que indicar para que la seguridad no bloquee la instalación de WebSigner. 4.7.1.3. Comportamiento Java 1.7.0.51 A partir de la versión v1.7.0_51, se solucionan los problemas de bloqueo identificados en la versión anterior. a) Seguridad Alta Versión: 1.10 Pág. 35 de 50
Al darle al botón Ejecutar se instala WebSigner. Si se marca la check, se incluye en Java el certificado de confianza y no se vuelve a mostrar el mensaje. b) Seguridad Media Versión: 1.10 Pág. 36 de 50
Al darle al botón Ejecutar se instala WebSigner. Si se marca la check, se incluye en Java el certificado de confianza y no se vuelve a mostrar el mensaje. Versión: 1.10 Pág. 37 de 50
4.8. Una vez aceptado todo no sucede nada Hay que recargar como mínimo la página web para que lance de nuevo la ejecución del plug-in Java. Según versión del navegador también puede ser necesario reiniciar todo el navegador. Si continúan los errores en la ejecución, para navegadores Firefox se han detectado errores en algunas casuísticas en función de la configuración del panel de control de Java. En estos casos es recomendable activar la opción Java Plug-In en la misma pestaña Avanzado indicada en la opción anterior como se indica en la figura Versión: 1.10 Pág. 38 de 50
En determinados navegadores con algunas configuraciones hay que permitir de firma expresa la ejecución de los plug-in. Con Internet Explorer 8 Con Internet Explorer 9 Versión: 1.10 Pág. 39 de 50
Con Firefox 4.9. Errores InvocationTargetException Se ha detectado errores del tipo InvocationTargetException al instalar WebSigner y al cargar Certificados con distintas versiones de Java 1.7 Para solucionar este problema será preciso deshabilitar la caché de Java. Para ello: En Panel de Control Java, pestaña General, pulsar Botón Configuración. Versión: 1.10 Pág. 40 de 50
Eliminar los archivos temporales. Versión: 1.10 Pág. 41 de 50
Desmarcar la check de Conservar los archivos temporales y Aceptar. Aplicar y Aceptar. Versión: 1.10 Pág. 42 de 50
Si los errores persisten, en el panel Avanzado, se marcan las checks seguridad de Java. indicadas de la Versión: 1.10 Pág. 43 de 50
4.10. Instalación con JRE 1.6. (Java 1.6.0_45 con Win7) Versión: 1.10 Pág. 44 de 50
4.11. Instalación con JRE 1.8. Con la instalación por defecto de Java, y seguridad de Java Alta : Versión: 1.10 Pág. 45 de 50
Se da la siguiente excepción durante la fase de instalación: Versión: 1.10 Pág. 46 de 50
Marcando la opción indicada de Java: Permite la instatación de WebSigner y la carga de certificados, mostrando los siguientes mensajes: Versión: 1.10 Pág. 47 de 50
Versión: 1.10 Pág. 48 de 50
Con la Seguridad de Java como Muy Alta los mensajes mostrados son los siguientes: Versión: 1.10 Pág. 49 de 50
Versión: 1.10 Pág. 50 de 50