comoinstalarquipux
TRANSCRIPT
-
7/21/2019 ComoInstalarQuipux
1/23
ComoInstalarQuipux
Contenido
[ocultar]
1 Introduccin 2 Instalacin del Sistema Quipux 3 Configuracin Sevidor Web 4 Instalacin del servidor de Base de Datos 5 Instalacin del servidor de PDFs 6 Configuracin Servidor Firma Digital
IntroduccinEste manual trata de ser lo ms sencillo y lo ms estndar posible, funciona igual endistribuciones como Debian, Centos, Ubuntuy en teora cualquier GNU Linux. Por elmomento, el sistema Quipux NO HA SIDO PROBADO CON SERVIDORESWINDOWS.
Este manual se desarroll basado en Ubuntu, la instalacin es la misma sin importar sudistribucin, claro, teniendo en cuenta que la paquetera se instala diferente en cadasistema; por ejemplo para instalar apache:
en Debian o Ubuntu ejecutamos
aptitude install apache2
mientras en Centos
yum install httpd
y algunos archivos estn ubicados en sitios diferentes.
La configuracin que veremos es muy bsica y permitir instalar y configurar una mquinade pruebas, para configurar un servidor real es bsicamente lo mismo, pero se necesitaponer todas las seguridades para evitar ataques, se debern modificar las contraseas ypublicar los nombres de los servidores.
Nota: Dependiendo de sus necesidades y de los recursos con que cuenten, se puede instalartodo el sistema en un solo equipo o en varios servidores, en un ambiente real, se sugierecontar con tres equipos: uno para servidor web, uno para generar PDFsy uno para la base
http://toggletoc%28%29/http://toggletoc%28%29/http://toggletoc%28%29/http://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Introducci.C3.B3nhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Introducci.C3.B3nhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_Sistema_Quipuxhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_Sistema_Quipuxhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Configuraci.C3.B3n_Sevidor_Webhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Configuraci.C3.B3n_Sevidor_Webhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_servidor_de_Base_de_Datoshttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_servidor_de_Base_de_Datoshttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_servidor_de_PDFshttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_servidor_de_PDFshttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Configuraci.C3.B3n_Servidor_Firma_Digitalhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Configuraci.C3.B3n_Servidor_Firma_Digitalhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Configuraci.C3.B3n_Servidor_Firma_Digitalhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_servidor_de_PDFshttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_servidor_de_Base_de_Datoshttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Configuraci.C3.B3n_Sevidor_Webhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Instalaci.C3.B3n_del_Sistema_Quipuxhttp://wiki.quipux.org.ec/index.php/ComoInstalarQuipux#Introducci.C3.B3nhttp://toggletoc%28%29/ -
7/21/2019 ComoInstalarQuipux
2/23
de datos(este debe ser bastante robusto dependiendo de la carga se maneje, los otros noconsumen muchos recursos).
El sistema Quipux es un sistema de Gestin Documental que est siendo utilizado por elGobierno Ecuatoriano, hasta el momento en que se elabor este manual, se tenan
registrados cerca de 25.000 funcionarios pblicos y 65.000 ciudadanos; se han creado en elsistema algo ms de 2 millones de documentos; se conectan diariamente cerca de 7000usuarios, los que generan al rededor de 20.000 documentospor da entre originales ycopias.
Est desarrollado completamente con software librey liberado con licencia AGPL. Porotro lado fue desarrollado y est siendo mantenido por el Estado Ecuatoriano, por lo que elsistema es actualizado todo el tiempo y peridicamente se liberan nuevas actualizacionespara lacomunidad.
Instalacin del Sistema Quipux
Se va a dividir la instalacin en lo siguiente :
Obtener el Cdigo fuente de Quipux Configuracin Sevidor Web Configuracin Servidor de Base de Datos Configuracin Servidor para generar PDFs Configuracin Servidor Firma Digital
Glad I've fanilly found something I agree with!
Configuracin Sevidor Web
1.Instalamos el sistema operativo
2.Instalamos los siguientes paquetes:
apache2php-pearphp5php5-gd
php5-pgsqlphp-soapsubversionsendmail
3.Editamos el archivo php.ini(/etc/php5/apache2/php.ini en Ubuntu) y modificamos lossiguientes valores de las variables de configuracin.
http://www.quipux.org/http://www.quipux.org/http://www.quipux.org/http://www.quipux.org/ -
7/21/2019 ComoInstalarQuipux
3/23
register_globals = On #Para instalar Quipux necesita estar activada, Esrecomendable ponerla en off.display_errors = On #(nicamente mientras configuran el sistema, porrazones de seguridad luego se sugiere regresarla a off').short_open_tag = On register_long_arrays = Onmemory_limit = 32 #Mnimo 32, se sugiere 64 o 128
4.Reiniciamos el servidor apache:
/etc/init.d/apache2 restart
Para comprobar que Apacheest ejecutndose y acepta scripts PHP, se hace lo siguiente:
En /var/wwwcree un archivo llamado phpinfo.php, el cual debe contener las siguientesinstrucciones:
Abra su navegador Web y en la direccin URL coloque:
http://IP_SERVIDOR/phpinfo.php
Esto deber mostrarle una pgina con informacin de la configuracin de PHP.
http://ip_servidor/phpinfo.phphttp://ip_servidor/phpinfo.php -
7/21/2019 ComoInstalarQuipux
4/23
Si todo va bien hasta aqu, se borra el archivo creado phpinfo.php.
5.En nuestro webroot (/var/www en Ubuntu) creamos una carpeta llamada quipux
http://wiki.quipux.org.ec/index.php/Archivo:PhpInfo_0.png -
7/21/2019 ComoInstalarQuipux
5/23
mkdir /var/www/quipux
6.Utilizando Subversin, se descarga la ltima versin del sistema Quipux en la carpetaque acabamos de crear con el siguiente comando:
svn checkouthttp://svn.quipux.org/quipux/var/www/quipux
Nota: Si se descarga Quipux en formato tar.gzuse el siguiente comando paradescomprimir el contenido:
tar xfz instaladorQuipux.tar.gz -C /var/www/quipux
7.Creamos el archivo de configuracin del sistema Quipux:
cp /var/www/quipux/config2.php /var/www/quipux/config.php
8.Creamos el repositorio de archivos:
mkdir /var/www/quipux/bodegamkdir /var/www/quipux/bodega/logos mkdir/var/www/quipux/bodega/plantillas mkdir /var/www/quipux/bodega/tmpmkdir /var/www/quipux/bodega/2010 (o el ao actual)
9.Editamos el archivo /var/www/quipux/config.phpy completamos la siguienteinformacin en base a nuestros parmetros:
//Email del Super Administrador del Sistema QUIPUX$amd_email = "[email protected]";
//email de la cuenta de soporte$cuenta_mail_soporte = "[email protected]";// email de la cuenta desde la que se enviarn los recordatorios a losusuarios$cuenta_mail_envio = "[email protected]";// Nombre de nuestro servidor; por ejemplo:http://quipux.dominio.com// ohttp://127.0.0.1/quipuxohttp://192.168.0.5/quipux$nombre_servidor="http://nombre_servidor_quipux";
10.Cambiamos los permisos y el propietario de las carpetas y archivos:
chown -R apache:apache /var/www/quipux cd /var/www/quipuxfind . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
Por seguridad se sugiere dar permisos 755 a todos los directorios y 644 a todos losarchivos.
11.Por ltimo accedemos a la aplicacin desde nuestro navegador
http://svn.quipux.org/quipuxhttp://svn.quipux.org/quipuxhttp://quipux.dominio.com/http://quipux.dominio.com/http://127.0.0.1/quipuxhttp://127.0.0.1/quipuxhttp://192.168.0.5/quipuxhttp://192.168.0.5/quipuxhttp://nombre_servidor_quipux/http://nombre_servidor_quipux/http://nombre_servidor_quipux/http://192.168.0.5/quipuxhttp://127.0.0.1/quipuxhttp://quipux.dominio.com/http://svn.quipux.org/quipux -
7/21/2019 ComoInstalarQuipux
6/23
http://IP_SERVIDOR/Debe mostrarse esta pantalla:
Instalacin del servidor de Base de Datos
1.Instalamos el sistema operativo 2.Instalamos el servidor de base de Datos Postgresql 8.2.Lamentablemente el sistema no funciona con versiones superiores de Postgres estaanunciada una nuevaversinde Quipux, en la que ya funciona versiones de Postgresmayores a la 8.2.
3.Modificamos los archivos de configuracin de postgres.Ingresamos al directorio
/etc/postgresql/8.2/main
y configuramos los archivos postgresql.confy pg_hba.conf
Editamos el archivo
/etc/postgresql/8.2/main/postgresql.conf:
Cambiamos la lnea:
listen_addresses = '*'
A continuacin editamos el archivo
/etc/postgresql/8.2/main/pg_hba.conf
y aumentamos el Nmero IPde la mquina
# IPv4 local connections:
http://ip_servidor/http://ip_servidor/http://www.quipux.org/?q=node/71http://www.quipux.org/?q=node/71http://www.quipux.org/?q=node/71http://wiki.quipux.org.ec/index.php/Archivo:Ingreso.pnghttp://www.quipux.org/?q=node/71http://ip_servidor/ -
7/21/2019 ComoInstalarQuipux
7/23
host all all 127.0.0.1/32 md5host all all 192.168.0.22/32 md5#suponiendo que el IP de la mquina sea 192.168.0.22
Por seguridad se recomienda poner nicamente el nmero IPdel servidor web pero si sedesea que cualquier usuario de la red tenga acceso al servidor de base de datos se puede
incluir la siguiente lnea:
host all all 192.168.0.0/24 md5 (suponiendo que el nmero de la subredsea 192.168.0.0)
4.Reiniciamos el servidor de base de datos PostgreSQL
sudo /etc/init.d/postgresql-8.2 restart
5.Cambiamos la clave del usuario postgres
sudo passwd postgres
6.Nos cambiamos de usuario al usuario postgres
su postgres
7.Ingresamos al servidor de base de datos PostgreSQLcon el comando
psql
8.Cambiamos la contrasea del usuario postgresde la base de datos y salimos de psql
ALTER USER postgres WITH PASSWORD 'nuevo_password';\q
9.Para mayor facilidad en la administracin de la base de datos vamos a utilizar el paquetepgAdmin III, lo podemos instalar en otra mquina y con este nos conectamos a nuestroservidor de base de datos.
Para instalarlo ejecute sudo aptitude install pgadmin3
10.Una vez instalado, creamos una nueva conexin al servidor de BDD(hacemos click
sobre el cono ) y nos aparecer el siguiente wizard que nos ayudar a configurar laconexin:
http://wiki.quipux.org.ec/index.php/Archivo:Icono.jpg -
7/21/2019 ComoInstalarQuipux
8/23
11.A continuacin creamos una nueva base de datoscon los siguientes parmetros:
name: quipux
owner: postgresencoding: UTF-8Tablespace: pg_default
http://wiki.quipux.org.ec/index.php/Archivo:Postgres.png -
7/21/2019 ComoInstalarQuipux
9/23
12.Abrimos el editor SQL y ejecutamos los scriptspara la creacin de tablas y los insertsbsicos para que funcione el sistema (los scriptsse encuentran en el directorio
/var/www/quipux/bdd
13.Caso contrario podemos restaurar desde el backupque se encuentra en el mismodirectorio. Para esto damos un click derecho sobre la base de datosy seleccionamos laopcin Restaurary nos aparecer un wizard que nos ayudar a restaurar la base de datos.
nicamente marcamos la opcin No ownery verificamos que no existan errores en elproceso.
14.Luego configuramos la conexin del sistema Quipuxcon la base de datos. Editamos elarchivo
/var/www/quipux/config.php
(en el servidor Quipux) y cambiamos las siguientes variables:
http://wiki.quipux.org.ec/index.php/Archivo:Postgres2.png -
7/21/2019 ComoInstalarQuipux
10/23
$usuario = "Usuario de la base de datos";$contrasena = "Contrasea de la base de datos";$servidor = Servidor de BDD:puerto; //ejm: "192.168.0.22:5432";$db = "nombre de la BDD";
15.Por ltimo ingresamos a la aplicacin:
17.En el campo cdula ponemos ADMINISTRADORy la contrasea es 123e ingresamosal administrador.png sistema.
http://wiki.quipux.org.ec/index.php/Archivo:Ingreso.png -
7/21/2019 ComoInstalarQuipux
11/23
Nota: Si existe algn problema para ingresar y no se muestra esta pantalla, se sugiereejecutar el archivo test_config.php, este archivo verifica que varios de los puntos de laconfiguracin estn correctos y da sugerencias para solucionar los inconvenientes. Ingresadesde desde tu navegador Web
http://IP_SERVIDOR/quipux/test_config.php
Instalacin del servidor de PDFs
1.Instalamos el sistema operativo
2.Instalamos los siguientes paquetes:
Apache2php-pearphp5php5-gdphp-soapsubversionghostscripthtml2ps
3.En nuestro webroot( /var/wwwen Ubuntu) creamos una carpeta llamada html_a_pdf
http://ip_servidor/quipux/test_config.phphttp://wiki.quipux.org.ec/index.php/Archivo:Administrador.pnghttp://ip_servidor/quipux/test_config.php -
7/21/2019 ComoInstalarQuipux
12/23
mkdir /var/www/html_a_pdf
4.Utilizando Subversin, descargamos la ltima versin del mdulo para generacin dePDFs en la carpeta que acabamos de crear con el siguiente comando:
svn checkouthttp://svn.quipux.org/html_a_pdf/var/www/html_a_pdf
Nota: Si se descarga Quipux en formato tar.gzuse el siguiente comando paradescomprimir el contenido:
tar xfz instaladorQuipux.tar.gz -C /var/www/html_a_pdf
5.Creamos los archivos de configuracin:
cp /var/www/html_a_pdf/config2.php /var/www/html_a_pdf/config.phpcp /var/www/html_a_pdf/html_a_pdf2.wsdl/var/www/html_a_pdf/html_a_pdf.wsdl
6.Modificamos el archivo config.phpen base a los datos de nuestro servidor:
$nombre_servidor= 'http://IP_SERVIDOR/html_a_pdf'
Nota: no es necesario que este servidor est publicado, basta con que el servidor Quipuxpueda acceder a el.
7.Editamos el archivo html_a_pdf.wsdly al final del archivo cambiamos la variable soap:address location:
Este archivo es fundamental para la comunicacin entre el servidor Quipux y el Servidor dePDFs. Para probar la conexin ingresamos desde nuestro navegador web la siguientedireccin y debe mostrarse la siguiente pantalla:
http://svn.quipux.org/html_a_pdfhttp://svn.quipux.org/html_a_pdfhttp://ip_servidor/html_a_pdf%27http://ip_servidor/html_a_pdf%27http://ip_servidor/html_a_pdf/html_a_pdf.phphttp://ip_servidor/html_a_pdf/html_a_pdf.phphttp://ip_servidor/html_a_pdf/html_a_pdf.phphttp://ip_servidor/html_a_pdf%27http://svn.quipux.org/html_a_pdf -
7/21/2019 ComoInstalarQuipux
13/23
http://IP_SERVIDOR/html_a_pdf/html_a_pdf.php?wsdl
8.Por ltimo le indicamos a nuestro servidor Quipux la direccin de nuestro servidor dePDFs.
Editamos el archivo /var/www/quipux/config.php(en el servidor Quipux) y cambiamos lasiguiente variable:
$servidor_pdf = 'http://IP_SERVIDOR/html_a_pdf';
http://ip_servidor/html_a_pdf/html_a_pdf.php?wsdlhttp://ip_servidor/html_a_pdf%27http://ip_servidor/html_a_pdf%27http://wiki.quipux.org.ec/index.php/Archivo:WebServices_0.pnghttp://ip_servidor/html_a_pdf%27http://ip_servidor/html_a_pdf/html_a_pdf.php?wsdl -
7/21/2019 ComoInstalarQuipux
14/23
Nota 1: Las plantillas son archivos PDF de tamao A4 en la que se tiene un margen de 4cmen la parte superior para el encabezado y 3cm en la parte inferior para el pi de pgina. Sepuede poner las imgenes que se desen.
Nota 2: Hay veces que las plantillas no funcionan, es por el programa en que se las genera,
se puedes utilizar Open Officeo descargarse gratis programas como elpdfcreatoro elpdf995(recomendado). NO FUNCIONAN LAS PLANTILLAS GENERADAS CONMICROSOFT OFFICE 2007 .
Nota 3: Por ltimo, cuando se configuren las instituciones, por favor crear una nuevainstitucin, NO utilizar la institucin creada por defecto.
http://sourceforge.net/projects/pdfcreator/http://sourceforge.net/projects/pdfcreator/http://sourceforge.net/projects/pdfcreator/http://www.pdf995.com/download.htmlhttp://www.pdf995.com/download.htmlhttp://www.pdf995.com/download.htmlhttp://sourceforge.net/projects/pdfcreator/ -
7/21/2019 ComoInstalarQuipux
15/23
Configuracin Servidor Firma Digital
Como funciona Firma Electrnica Quipux
Contenido
[ocultar]
1 Esquema General de la Firma Electrnica en Quipux 2 Diagrama de la Firma No 1. Relacin con los servicios Web utilizados 3 Diagrama No 2. Relacin de la Firma en Quipux con las interfaces de Usuario 4 Requisitos para que funcione la firma electrnica en Quipux 5 Configurando el Servidor Apache en Linux 6 Configuracin de la Base de Datos para Firma
7 Configurando el Servidor Apache Tomcat en Linux
Esquema General de la Firma Electrnica en Quipux
http://toggletoc%28%29/http://toggletoc%28%29/http://toggletoc%28%29/http://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Esquema_General_de_la_Firma_Electr.C3.B3nica_en_Quipuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Esquema_General_de_la_Firma_Electr.C3.B3nica_en_Quipuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Diagrama_de_la_Firma_No_1._Relaci.C3.B3n_con_los_servicios_Web_utilizadoshttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Diagrama_de_la_Firma_No_1._Relaci.C3.B3n_con_los_servicios_Web_utilizadoshttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Diagrama_No_2._Relaci.C3.B3n_de_la_Firma_en_Quipux_con_las_interfaces_de_Usuariohttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Diagrama_No_2._Relaci.C3.B3n_de_la_Firma_en_Quipux_con_las_interfaces_de_Usuariohttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Requisitos_para_que_funcione_la_firma_electr.C3.B3nica_en_Quipuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Requisitos_para_que_funcione_la_firma_electr.C3.B3nica_en_Quipuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_Tomcat_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_Tomcat_en_Linuxhttp://wiki.quipux.org.ec/index.php/Archivo:EsquemaFirma.pnghttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_Tomcat_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Requisitos_para_que_funcione_la_firma_electr.C3.B3nica_en_Quipuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Diagrama_No_2._Relaci.C3.B3n_de_la_Firma_en_Quipux_con_las_interfaces_de_Usuariohttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Diagrama_de_la_Firma_No_1._Relaci.C3.B3n_con_los_servicios_Web_utilizadoshttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Esquema_General_de_la_Firma_Electr.C3.B3nica_en_Quipuxhttp://toggletoc%28%29/ -
7/21/2019 ComoInstalarQuipux
16/23
En la figura anterior se puede observar los elementos que deben configurarse para quefuncione la firma electrnica en Quipux. En esta gua explica la configuracin de losmismos.
Diagrama de la Firma No 1. Relacin con los servicios
Web utilizados
Este es el esquema de firma digital que utiliza el Quipux en estos momentos. Por un lado enla parte izquierda esta el Quipux (Servidor Institucin) y en la parte derecha el Servicio deFirma. Se muestran tambin los servicios web que participan en el proceso de firma.
Diagrama No 2. Relacin de la Firma en Quipux con las
interfaces de Usuario
http://wiki.quipux.org.ec/index.php/Archivo:FirmaQuipuxNivel1.png -
7/21/2019 ComoInstalarQuipux
17/23
En este diagrama se observan las interfaces de usuario y su relacin con los sistemas queintervienen en la firma. Cuando el usuario presiona aceptar en Envo de documentosElectrnicos, se dispara el applet por un lado (applet.php) esto dentro del sistema de firma.
Y por el otro se invoca al servicio web wsFirma.php.
Cuando el usuario presiona firmar dentro del applet se llama a un servicio web en tomcatwsappletfirmadigital64(responsable de traer los archivos para que el usuario los firme).
Cuando termina de firmar se llama a la pantalla confirmar.php dentro del servicio de firmay al cerrar esta pantalla se llama al servicio ws_firma_digital.php, para enviar los archivosfirmados al Quipux.
En el caso de la verificacin cuando se presiona verificar un documento, se llamanuevamente al servicio wsappletfirmadigital64, quien recibe como parmetro un
documento y verifica si se encuentra vlido y fue correctamente firmado.
En resumen estos son los servicios web que participan en la firma : wsFirma.php (phpdentro del servidor firma) wsAppletFirmaDigital64 (para uso del applet) ws_firma_digital(Dentro del Quipux)
Requisitos para que funcione la firma electrnica en
Quipux
Apache ( Desde la versin 2 en adelante ) BD de datos en Postgres ( Desde la versin 8.2 en Adelante ) Apache Tomcat ( Pueden usarse versiones desde la 6 en adelante) Servidor NTP Java ( Desde la 1.6 en Adelante. )
http://wiki.quipux.org.ec/index.php/Archivo:FirmaQuipux2.png -
7/21/2019 ComoInstalarQuipux
18/23
Se puede obtener el cdigo fuente de la firma electrnica en Quipux de 2 formas,descargndolo[1]en formato tar.gz[2], o via subversin dentro del repositorio de Quipux[3](si utiliza esta opcin y necesita ayuda, mire en los foros[4]de la Comunidad Quipux )
Dentro de la carpeta de firmase encuentran los siguientes archivos:/firma/bdd/firma/instalacion/firma/instalacion/bdd/firma/instalacion/bdd/BDD_certificados.backup Este archivo ya no esnecesario/firma/instalacion/bdd/BDD_firma.backup/firma/instalacion/tomcat/firma/instalacion/tomcat/postgresql-8.3-603.jdbc3.jar/firma/instalacion/tomcat/WsAppletFirmaDigital64.war/firma/instalacion/tomcat/wsFirmaDigitalQuipux_1_3.war/firma/lib/firma/propiedades/firma/verificar_firma/firma/applet.php/firma/config2.php/firma/confirmar.php/firma/firma2.wsdl/firma/funciones.php/firma/logo.png/firma/proyFirma_2.jar/firma/spinner.gif/firma/spinner_16.gif/firma/ws_cliente_firma.php/firma/wsFirma.php
Configurando el Servidor Apache en Linux
En esta gua suponemos que se va ha instalar el cdigo fuente de Quipux, conjuntamentecon el de firma, dentro del mismo servidor Apache. Si ese es el caso, copiar el contenido delos archivos de firmaal directorio apache donde esta instalado quipux
Dentro del Cdigo de Quipuxbuscamos el archivo config.phpy editamos la linea donde seencuentra declarada la variable $servidor_firmadebemos agregar la direccin web donde
esta ejecutndose el cdigo firma. Por ejemplo, si la direccin URL donde esta nuestro sitioweb funcionando y donde esta copiado el cdigo que ejecuta el applet de firma eshttp://quipux.info/firmaes la que debemos poner, en la siguiente lnea
Ubicamos la linea dentro del archivo config.php
$servidor_firma = "http://nombre_del_servidor_de_firma";
http://www.quipux.org/?q=descargashttp://www.quipux.org/?q=descargashttp://www.quipux.org/?q=descargashttp://www.informatica.gob.ec/instaladoresQuipux.tar.gzhttp://www.informatica.gob.ec/instaladoresQuipux.tar.gzhttp://www.informatica.gob.ec/instaladoresQuipux.tar.gzhttp://svn.quipux.org/http://svn.quipux.org/http://www.quipux.org/?q=node/6#comment-11http://www.quipux.org/?q=node/6#comment-11http://www.quipux.org/?q=node/6#comment-11http://quipux.info/firmahttp://quipux.info/firmahttp://nombre_del_servidor_de_firma/http://nombre_del_servidor_de_firma/http://nombre_del_servidor_de_firma/http://quipux.info/firmahttp://www.quipux.org/?q=node/6#comment-11http://svn.quipux.org/http://www.informatica.gob.ec/instaladoresQuipux.tar.gzhttp://www.quipux.org/?q=descargas -
7/21/2019 ComoInstalarQuipux
19/23
Modificamos de modo que esta variable apunte al servidor de firma
$servidor_firma = "http://quipux.info/firma";
Nos ubicamos dentro del cdigo de firma, y ejecutamos lo siguiente:
cp config2.php config.php
Modificamos el archivo config.php.
Nos ubicamos dentro del cdigo de firma, y ejecutamos lo siguiente:
cp firma2.wsdl firma.wsdl
Modificar el archivo firma.wsdlal final buscar la referencia a location
http://quipux.info/firmahttp://quipux.info/firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://nombre_del_servidor_de_firma/http://nombre_del_servidor_de_firma/http://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_Tomcat_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_Tomcat_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_Tomcat_en_Linuxhttp://servidor_tomcat_firma/wsFirmaDigitalQuipux_1_3http://servidor_tomcat_firma/wsFirmaDigitalQuipux_1_3http://servidor_tomcat_firma/wsFirmaDigitalQuipux_1_3http://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_Tomcat_en_Linuxhttp://nombre_del_servidor_de_firma/http://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://quipux.info/firma -
7/21/2019 ComoInstalarQuipux
20/23
Cambiar la informacin, debe tener el mismo nombre que se puso en la variable$servidor_nombredel archivo config.php del codigo de firma. Esta es la direccin alWebServiceque se encarga de procesar las peticiones de verificacin y enviar los archivosfirmados a la base de datos de firma.
Ejemplo
Configuracin de la Base de Datos para Firma
Crear en postgres la base de datos firma
CREATE DATABASE firma with owner=postgres encoding='UTF8';
Restaurar el backup( este archivo se encuentra dentro del directorio de firma/firma/instalacion/bdd/BDD_firma.backup ) en la base nueva
pg_restore -i -h localhost -p 5432 -U postgres -d firma -vBDD_firma.backup
Cuando se configura el tomcat y el directorio apache firma, debe tener en cuenta el usuarioy la clave de la base de datos. Si usa postgres como usuario de la base de datos, la siguientelnea es til para asignar una clave al usuario postgres
passwd postgres
En la tabla sistemade la Base de Datos de firmadebe llenarse el campo nombreydir_firma. En el campo nombredebe ingresar la direccin URL del servidor Quipux. El
nombre que ingrese en este campo esta relacionado con la variable $nombre_servidordelarchivo config.phpdentro delCdigo de Quipux.En el campo dir_firmadebe ingresar lainformacin de la ruta del Web Service de Interconexin( Dentro del Cdigo de Quipuxse encuentra un directorio llamado interconexion. Este Web Servicese encarga de enviarel archivo firmado a la base de datos ).
Ejemplos nombre http://DIRECCION_URL_QUIPUXdir_firma
http://DIRECCION_URL_QUIPUX/interconexion/ws_firma_digital.php?wsdl
Configurando el Servidor Apache Tomcat en Linux
Se descarga tomcat[5]y se lo descomprime ( es necesario tener instalado java (Se haprobado con xito con la versin para linux de java sun-java6-jdk) instalado previamente).Una vez hecho esto se observan algunos directorios como los siguientes
http://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linuxhttp://direccion_url_quipux/http://direccion_url_quipux/interconexion/ws_firma_digital.php?wsdlhttp://apache.opensourceresources.org/tomcat/tomcat-6/v6.0.29/bin/apache-tomcat-6.0.29.tar.gzhttp://apache.opensourceresources.org/tomcat/tomcat-6/v6.0.29/bin/apache-tomcat-6.0.29.tar.gzhttp://apache.opensourceresources.org/tomcat/tomcat-6/v6.0.29/bin/apache-tomcat-6.0.29.tar.gzhttp://apache.opensourceresources.org/tomcat/tomcat-6/v6.0.29/bin/apache-tomcat-6.0.29.tar.gzhttp://direccion_url_quipux/interconexion/ws_firma_digital.php?wsdlhttp://direccion_url_quipux/http://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configurando_el_Servidor_Apache_en_Linux -
7/21/2019 ComoInstalarQuipux
21/23
-bin-conf-lib-logs-temp-webapps
Dentro del directorio binse encuentra el archivo catalina.sh. Agregar las siguientes lineasal comienzo del archivo. Se necesitan para indicarle a tomcat donde esta la maquina virtualde java, parmetros de memoria y donde esta instalado el tomcat.
JAVA_HOME=/usr/java/jdk1.6.0_06/CATALINA_OPTS="-Xms256m -Xmx512m"CATALINA_HOME=/DIRECTORIO_INSTALACION_TOMCAT6/apache-tomcat-6.0.16.5/
Dentro del cdigo fuente de Quipux[6],se encuentra el archivo firma.zip (en la versintar.gz[7])o dentro del repositorio svn Quipux-Firma-Digital[8]
Dentro del directoriofirmabuscamos los subdirectorios instalacion\tomcat, all debenencontrarse los siguientes archivos:
postgresql-8.3-603.jdbc3.jarWsAppletFirmaDigital64.warwsFirmaDigitalQuipux_1_3.war
El archivo postgresql-8.3-603.jdbc3.jardebe copiarse/DIRECTORIO_INSTALACION_TOMCAT6/apache-tomcat-6.0.16.8/lib/
Los siguientes cambios se necesitan hacerlos en los archivos .war. Es necesario editarlos .Descomprima el archivo WsAppletFirmaDigital64.war. Ejecute los siguientes comandos.
mkdir directorioWarcp WsAppletFirmaDigital64.war directorioWarcd directorioWarjar -xvf WsAppletFirmaDigital64.war (dentro de directorioWar ejecuteel comando)
Dentro de directorioWarse crean una lista de directorios y archivos es necesario editar lossiguientes:
META-INF/context.xmlWEB-INF/propiedades/parametros.properties
En archivo parametros.propertieseditar la informacin
bd=firma #El nombre de la Base de Datos que se creo anteriormentebd_cert=NOMBRE_BDD_CERTIFICADOS #Este linea no es necesariaservidor_tiempo=192.168.20.1 #Ponga aqu la direccin del servidorNTP que este usandodireccionLDAP=ldap://ldap.bce.ec/o=BCE,c=EC #Conexin con el BancoCentral para verificar revocados (Esta lnea ya no es til )
http://www.quipux.org/?q=descargashttp://www.quipux.org/?q=descargashttp://www.quipux.org/?q=descargashttp://www.informatica.gob.ec/instaladoresQuipux.tar.gzhttp://www.informatica.gob.ec/instaladoresQuipux.tar.gzhttp://www.informatica.gob.ec/instaladoresQuipux.tar.gzhttp://svn.quipux.org/http://svn.quipux.org/http://svn.quipux.org/http://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Requisitos_para_que_funcione_la_firma_electr.C3.B3nica_en_Quipuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Requisitos_para_que_funcione_la_firma_electr.C3.B3nica_en_Quipuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Requisitos_para_que_funcione_la_firma_electr.C3.B3nica_en_Quipuxhttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Requisitos_para_que_funcione_la_firma_electr.C3.B3nica_en_Quipuxhttp://svn.quipux.org/http://www.informatica.gob.ec/instaladoresQuipux.tar.gzhttp://www.quipux.org/?q=descargas -
7/21/2019 ComoInstalarQuipux
22/23
En el archivo context.xmledite la informacin referente a la Base de Datos firmaconfigurada en la seccinanterior.
Ejemplo jdbc:postgresql://IP_SERVIDOR_BD:5432/firmaLa siguiente informacin sobre BDD_CERTIFICADOSya no es util ( no es
necesario editar )
Una vez editados los cambios volver a comprimir el archivo war.
cd directorioWarrm WsAppletFirmaDigital64.warjar -cvf WsAppletFirmaDigital64.war *
Luego vuelva a copiar los archivos editados .war en la siguiente ubicacin:/DIRECTORIO_INSTALACION_TOMCAT6/apache-tomcat-6.0.16.8/webapps, siesta configurado tomcat automaticamente se desplegaran. Cuando se despliegan losarchivos war ( mirar dentro del directorio webapps) se observan una serie de directorios,con los nombres de los archivos enunciados arriba.
No es necesario modificar el archivo wsFirmaDigitalQuipux_1_3.war, se debe copiarlo ala siguiente ubicacin: /DIRECTORIO_INSTALACION_TOMCAT6/apache-tomcat-6.0.16.8/webapps
Si necesita administracin web del tomcat es necesario agregar al archivo tomcat-users.xml( dentro del directorio/DIRECTORIO_INSTALACION_TOMCAT6/apache-tomcat-6.0.16.8/conf/) losiguiente:
http://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firmahttp://wiki.quipux.org.ec/index.php/Como_funciona_Firma_Electr%C3%B3nica_Quipux#Configuraci.C3.B3n_de_la_Base_de_Datos_para_Firma -
7/21/2019 ComoInstalarQuipux
23/23