Академический Документы
Профессиональный Документы
Культура Документы
Autofirma
Manual de instalacin
Versin: v02r02
Fecha: 21/06/2016
Autofirma
Manual de instalacin
HOJA DE CONTROL
Ttulo
Manual de instalacin
Entregable
20160621-Autofirma_Manual de Instalacin_V02R02
Autor
DGPD
Versin/Edicin
v02r02
Aprobado por
Fecha Versin
21/06/2016
Fecha Aprobacin
N Total Pginas
25
REGISTRO DE CAMBIOS
Versin
Fecha
Cambio
del
v01r00
DGPD
SCAE
16/05/2016
v01r01
DGPD
SCAE
17/05/2016
v02r00
UTE
UTE
31/05/2016
V02r01
DGPD
SCAE
10/06/2016
V02R02
DGPD
SCAE
21/06/2016
Autofirma
Manual de instalacin
NDICE
1 Introduccin......................................................................................................................................................4
2 Novedades en la nueva versin de Autofirma 1.4.2.JAv02................................................................................5
3 Requisitos mnimos...........................................................................................................................................6
4 Enlaces de descarga.........................................................................................................................................7
5 Instalacin de Autofirma...................................................................................................................................8
5.1 Instalacin en Windows..............................................................................................................................8
5.2 Instalacin en Linux.................................................................................................................................11
5.3 Instalacin en Mac OS X..........................................................................................................................13
6 Desinstalacin de Autofirma............................................................................................................................17
6.1 Desinstalacin en Windows......................................................................................................................17
6.2 Desinstalacin en Linux...........................................................................................................................19
6.3 Desinstalacin en Mac OS X....................................................................................................................20
7 Problemas conocidos......................................................................................................................................23
7.1 No se puede instalar autofirma................................................................................................................23
7.2 Al instalar AutoFirma se muestra el error: Error abriendo archivo para escritura...................................23
7.3 Al instalar AutoFirma se muestra el error: Error abriendo archivo para escritura...................................23
7.4 El usuario utilizado para la instalacin de AutoFirma no es el mismo que el usuario final de Autofirma....24
7.5 Comprobacin de acceso a las libreras NSS de Firefox usando Autofirma de Mac OS X..........................24
7.6 Autofirma mediante SocketSSL en Mac OS X...........................................................................................25
Autofirma
Manual de instalacin
1 Introduccin
AutoFirma es una aplicacin de escritorio con interfaz grfica que permite la ejecucin de operaciones de firma
electrnica en ordenadores personales. Actualmente es compatible con los Sistemas Operativos ms utilizados,
Windows (XP o superior), Linux (Ubuntu y Guadalinex) y Mac OS X. Puede ser utilizado para la firma de ficheros
locales o a travs de aplicaciones de Administracin Electrnica que requieran de una operacin de firma
electrnica.
El presente documento constituye una gua de instalacin de la aplicacin AutoFirma dirigida al usuario final.
La aplicacin Autofirma hace uso de los certificados digitales X.509 v3 y de las claves privadas asociadas a estos
que estn instalados en el repositorio o almacn de claves y certificados (KeyStore) del Sistema Operativo o del
navegador Web (Internet Explorer, Mozilla Firefox, etc.) en caso de realizarse la operacin desde un trmite web.
Tambin permite el uso de dispositivos externos (tarjetas inteligentes, dispositivos USB) configurados en estos
almacenes de claves (como por ejemplo, el DNI Electrnico o DNIe).
El cliente AutoFirma hace uso de las claves privadas asociadas a los certificados del usuario y no permite que
estos salgan en ningn momento del almacn (tarjeta, dispositivo USB o navegador) ubicado en su PC.
AutoFirma no almacena ningn tipo de informacin personal del usuario, ni hace uso de cookies ni ningn otro
mecanismo para la gestin de datos de sesin.
Puede obtener la ltima versin de a aplicacin Autofirma desde la siguiente direccin web:
https://ws024.juntadeandalucia.es/clienteafirma/autofirma/autofirma.html
Autofirma
Manual de instalacin
Permite la instalacin en Sistemas Operativos basados en Ubuntu (14.04+), Guadalinex (v9+) y Mac OS
X (10.11 El Capitn)
Corrige el certificado utilizado para el SocketSSL, de forma que ahora si se utiliza un certificado con los
atributos necesarios para ser admitido como Autoridad en los navegadores Firefox.
Autofirma
Manual de instalacin
3 Requisitos mnimos
Windows
La propia instalacin de la aplicacin contiene la mquina virtual de Java (JRE 1.8.0_60), por lo que no
es necesario realizar ninguna accin extra para poder ejecutar esta aplicacin Java.
Linux
En el caso de que la distribucin de Linux instalada no tenga preinstalada la mquina virtual de Java
ser necesario instalarla previamente para poder ejecutar la instalacin y posteriormente la aplicacin.
(Posteriormente en este documento se describe como podemos instalar la mquina virtual de Java 8 en
un Sistema Operativo Ubuntu).
Mac OS X
La propia instalacin de la aplicacin contiene la mquina virtual de Java (JRE 1.8.0_60), por lo que no
es necesario realizar ninguna accin extra para poder ejecutar esta aplicacin Java.
Autofirma
Manual de instalacin
4 Enlaces de descarga
Puede descargar la ltima versin disponible de AutoFirma desde la siguiente pgina web:
https://ws024.juntadeandalucia.es/clienteafirma/autofirma/autofirma.html
Con cada nueva versin que sea publicada en los repositorios de la Junta de Andaluca, la aplicacin informar
de que hay una actualizacin disponible durante el arranque de la misma.
Deber seleccionar su sistema operativo para descargar el fichero de instalacin adecuado. Adicionalmente,
tambin disponemos en esta pgina del enlace para descargar este manual.
AutoFirma 1.4.2.JAv02 Segunda versin publicada por la Junta de Andaluca. (Compatible con Windows,
Linux y Mac OS X)
Autofirma
Manual de instalacin
5 Instalacin de Autofirma
La instalacin de AutoFirma requiere permisos de administracin en el equipo donde se instala,
por tanto, el usuario final que ejecuta el instalador debe tener permisos de administracin para
una correcta instalacin.
Al pulsar sobre el botn Siguiente > seremos redirigidos a la pantalla de licencia de la aplicacin.
En esta pantalla, el usuario puede leer el texto de licencia de AutoFirma. Para continuar con el proceso de
instalacin es necesario pulsar el botn Acepto.
Autofirma
Manual de instalacin
En la siguiente pantalla, podr seleccionar la ruta de instalacin de la aplicacin. Puede dejar la ruta que se le
muestra por defecto (recomendado) o seleccionar cualquier otra ubicacin. En caso de modificar el directorio por
defecto, asegrese de instalar AutoFirma en un directorio propio y no en uno compartido con ms aplicaciones o
documentos. A continuacin, pulse el botn Instalar.
El proceso de instalacin extrae y copia los ficheros necesarios. Una vez que llegue al 100%, ejecutar la
aplicacin que configurar los certificados del SocketSSL.
Autofirma
Manual de instalacin
Una vez hecho esto se tratar de instalar el certificado de confianza generado en su almacn local de Windows,
necesario para poder utilizar de forma segura la aplicacin Autofirma desde sitios web. Se le pedir confirmacin
mediante una ventana como la siguiente:
Una vez finalizado el proceso, el usuario podr pulsar el botn Siguiente para conocer el resultado de la
instalacin.
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 10 de 25
Autofirma
Manual de instalacin
Cuando el asistente termina, la instalacin habr finalizado. Tenga en cuenta que si se deneg el permiso para
la instalacin de certificados, es posible que la aplicacin le indique que la instalacin ha finalizado
correctamente. Esto le permitir utilizar AutoFirma como aplicacin local de firma, pero no podr utilizarlo en
procesos de firma de trmites web mediante SocketSSL. Para finalizar, pulse el botn Terminar.
Si el usuario administrador utilizado para la instalacin no es el mismo que el usuario final, el
administrador deber proveer a dicho usuario el certificado generado para que pueda instalarlo
en el almacn local de sus navegadores. En el apartado 7.4 se explica donde encontrar el
certificado generado por parte del administrador y como importarlo correctamente en los
diferentes navegadores del usuario final.
Tenga en cuenta que para que se instalen correctamente los certificados de confianza necesarios
para la comunicacin SocketSSL entre Autofirma y los navegadores, estos deben estar instalados
previamente. Si se ejecuta el instalador de Autofirma antes de instalar alguno de los navegadores
soportados, deber desinstalar e instalar de nuevo la aplicacin para poder usar Autofirma con
los navegadores instalados posteriormente, o instalar manualmente en los nuevos navegadores el
certificado de confianza generado durante la instalacin original de la aplicacin (ver apartado
7.4).
5.2
Instalacin en Linux
Para simplificar la instalacin de Linux en sus diferentes distribuciones usaremos el la instalacin de paquetes
debian (.deb) mediante comandos, pero se podr utilizar cualquier asistente de Linux para la instalacin de este
tipo de paquetes, como gdebi o el Centro de Software de Ubuntu.
5.2.1
Lo primero es asegurarse de que el Sistema Operativo tiene instalada la mquina virtual de Java 8. Podemos
comprobarlo ejecutando el siguiente comando.
$ java -version
java version "1.8.0_91"
Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)
Si su distribucin de Ubuntu no dispone de la versin 8 de java, deber instalarla siguiendo los siguientes pasos:
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 11 de 25
Autofirma
Manual de instalacin
Y una vez listo, procedemos a realizar la instalacin del paquete oracle-java8-installer, qu instalar
automticamente la ltima actualizacin de Java 8.
Una vez terminada la instalacin, podremos comprobar que se ha aplicado como la JVM del sistema, la
cual permite la instalacin y ejecucin de Autofirma.
$ java -version
java version "1.8.0_91"
Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
Java HotSpot(TM) Client VM (build 25.91-b14, mixed mode)
Nos movemos al directorio del usuario (con permisos de administracin) que contiene el paquete
debian de Autofirma.
$ cd <PATH_AUTOFIRMA_DEBIAN>
$ ls
AutoFirma-1.4.2.JAv02.deb
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 12 de 25
Autofirma
Manual de instalacin
Tenga en cuenta que para que se instalen correctamente los certificados de confianza necesarios
para la comunicacin SocketSSL entre Autofirma y los navegadores, estos deben estar instalados
previamente. Si se ejecuta el instalador de Autofirma antes de instalar alguno de los navegadores
soportados, deber desinstalar e instalar de nuevo la aplicacin para poder usar Autofirma con
los navegadores instalados posteriormente, o instalar manualmente en los nuevos navegadores el
certificado de confianza generado durante la instalacin original de la aplicacin (ver apartado
7.4).
Si el navegador web utilizado no encuentra la aplicacin y le pide definir la ubicacin de la
misma, deber seleccionarse manualmente desde /usr/bin/AutoFirma
5.3
Instalacin en Mac OS X
El proceso de instalacin le guiar a travs de unos sencillos pasos, y a continuacin se muestran las imgenes
correspondientes a la ltima versin publicada, qu en este caso es Autofirma 1.4.2.JAv02. Es posible que las
pantallas varen de una versin a otra, pero en cualquier caso las variaciones sern mnimas.
Ejecutamos el instalador AutoFirma1.4.2.JAv02.pkg
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 13 de 25
Autofirma
Manual de instalacin
Tras seleccionar el destino local donde vamos a instalar Autofirma (Macintosh HD), iremos a la pantalla con el
resumen de la instalacin. Nos informa del tamao de ocupar la instalacin 386,9MB y nos permitir cambiar
de nuevo el destino o continuar con la instalacin.
Si pulsamos el botn Instalar nos pedir la contrasea de administrador para permitir hacer cambios en el
equipo.
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 14 de 25
Autofirma
Manual de instalacin
Una vez introducida la contrasea de nuestro usuario con permisos de administracin comenzar
automticamente la instalacin de Autofirma y esperaremos a que finalice este proceso, donde veremos en
ltima instancia como se realiza el proceso de generacin e instalacin del certificado de confianza generado por
Autofirma en los navegadores (Llaveros de Mac y NSS de Firefox).
Una vez finalizado el proceso de instalacin veremos la siguiente pantalla, qu podemos cerrar para finalizar la
instalacin de Autofirma.
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 15 de 25
Autofirma
Manual de instalacin
Hay que tener en cuenta que para un correcto funcionamiento de Autofirma en modo SocketSSL,
debera haberse instalado correctamente el certificado generado por Autofirma en los Llaveros de
Mac (Safari y Chrome) y en el almacn NSS de Firefox.
Adicionalmente, para el acceso a los almacenes NSS de Firefox, el instalador debera haber
creado dos enlaces simblicos en la ruta /usr/local/lib de nuestro equipo. En el apartado 7.5 se
explica como realizar las acciones necesarias para comprobar esto y corregirlo en el caso de no
haber terminado correctamente.
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 16 de 25
Autofirma
Manual de instalacin
6 Desinstalacin de Autofirma
Este apartado explica detalladamente el proceso de desinstalacin de la aplicacin Autofirma en Windows, Linux
y Mac OS X.
6.1
Desinstalacin en Windows
La desinstalacin de Autofirma puede realizarse desde la opcin Desinstalar AutoFirma que aparece en el
men inicio de Windows bajo el grupo AutoFirma.
O bien desde el ejecutable para desinstalacin que podemos encontrar en la carpeta de instalacin de la
aplicacin.
{RUTA_INSTALACION_AUTOFIRMA}\AutoFirma\unistall.exe
Una vez lanzado, el desinstalador presenta un sencillo asistente:
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 17 de 25
Autofirma
Manual de instalacin
Como parte del proceso de desinstalacin, se le pedir permiso para la eliminacin del certificado de confianza
del almacn de certificados de Windows.
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 18 de 25
Autofirma
Manual de instalacin
6.2
Desinstalacin en Linux
Para desinstalar la aplicacin Autofirma de un Sistema Operativo Linux, ejecutamos los siguientes comandos.
Purgamos la instalacin del paquete Autofirma para eliminar cualquier rastro de la aplicacin
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 19 de 25
6.3
Autofirma
Manual de instalacin
Desinstalacin en Mac OS X
Autofirma para Mac OS X no provee desinstalador, de forma que simplemente seleccionamos AutoFirma.app
desde la ventana de Aplicaciones del Finder para enviarla a la papelera y vaciarla posteriormente.
Una vez que enviamos Autofirma.app a la papelera y la vaciamos, la aplicacin est desinstalada, pero los
certificados de confianza instalados en el Llavero del sistema y el almacn de Autoridades de Firefox siguen
estando presentes, de forma que procedemos a su eliminacin para completar la desinstalacin.
6.3.1 Eliminacin del certificado de confianza de Autofirma del Llavero del sistema
Abrimos los Llaveros del sistema de Mac OS X y seleccionamos Eliminar AutoFirma ROOT.
Primero nos pedir la contrasea de administrador para confirmar que se van a hacer cambios en el Llavero.
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 20 de 25
Autofirma
Manual de instalacin
Despus confirmamos la eliminacin del certificado, y nos pedir de nuevo la contrasea del administrador para
eliminarlo definitivamente.
En la pestaa Autoridades, buscamos el certificado AutoFirma ROOT. Una vez seleccionado pulsamos en
Eliminar o dejar de confiar...
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 21 de 25
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 22 de 25
Autofirma
Manual de instalacin
Autofirma
Manual de instalacin
7 Problemas conocidos
7.1
AutoFirma requiere permisos de administrador para ser instalado y para insertar el certificado de confianza para
el funcionamiento de la firma en los trmites online. Si no puede instalar AutoFirma o el certificado de confianza,
solicite al administrador de su sistema que realice la instalacin de la aplicacin.
7.2
Si ya tena instalado AutoFirma, compruebe que este no se est ejecutando, en cuyo caso el instalador no podr
sobrescribir los ficheros de instalacin. Cierre AutoFirma y pulse el botn reintentar.
Si AutoFirma no se est ejecutando, es posible que el archivo en cuestin se encuentre bloqueado por una
ejecucin o intento de instalacin previo. Reinicie su equipo y pruebe a instalar nuevamente la aplicacin.
7.3
7.4
Si instal el software con un usuario administrador diferente al usuario final, es probable que no funcione
Autofirma en modo SocketSSL. Esto es debido a que el certificado generado durante la instalacin se instala
automticamente en los almacenes locales del usuario que realiza la instalacin.
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 23 de 25
Autofirma
Manual de instalacin
Si ste es el caso, el usuario final deber instalar manualmente el certificado en los almacenes de certificados de
los navegadores que vaya a utilizar.
Administrador
El certificado a importar debe proporcionarlo el administrador que realiz la instalacin y se encuentra dentro de
la carpeta donde se instal Autofirma:
{RUTA_INSTALACION_AUTOFIRMA}\AutoFirma\autofirma.cer
Usuario final
El usuario final que usar la aplicacin Autofirma deber instalar el certificado proporcionado por el
administrador de su equipo en los siguientes almacenes en funcin del navegador:
7.5
Firefox. Deber incorporarse en el almacn "Autoridades" (No es posible con la versin de Autofirma
1.4.2JAv01).
Chrome/Chromium.
Windows (Chrome e Internet Explorer). En este caso, Chrome comparte el almacn del
sistema, de forma que sera en el almacn "Entidades de certificacin raz de
confianza".
Mac OS X (Chrome y Safari). En este caso, Chrome comparte el almacn del sistema, de
forma que aadimos el certificado en el Llavero del sistema.
Para un correcto acceso a los almacenes NSS de Firefox, el instalador deber haber creado los enlaces
simblicos hacia las libreras que permiten el acceso a los mismos. Para comprobarlo listamos el contenido de la
ruta /usr/local/lib.
Si no se han creado los enlaces durante la instalacin podemos crearlos manualmente con los siguientes
comandos, ejecutados con permisos de administrador desde la ruta /usr/local/lib.
7.6
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 24 de 25
Autofirma
Manual de instalacin
CommonName del certificado generado no coincide con la IP de publicacin del servicio local de
Autofirma 127.0.0.1. El error que se muestra al intentar conectar es el siguiente:
Failed to load resource: El certificado de servidor no es vlido. Es posible que el servidor al que
intenta conectarse simule ser 127.0.0.1, lo que podra poner en peligro su informacin
confidencial.
Este problema solo afecta a Safari y se podr utilizar Chrome con Autofirma en modo SocketSSL
sin problemas.
20160621-Autofirma_Manual de Instalacin_V02R02Pgina 25 de 25