Version 5 (modified by aaraujo, 8 years ago) (diff) |
---|
Tabla de Contenido
- Bienvenido a la wiki del Proyecto Murachí
- Metodología de Desarrollo de Software Libre (MDSL) Versión 2.0
- Análisis del Dominio
- Propuesta de Desarrollo del Proyecto
- Plan del Proyecto
- Estándares de Desarrollo del Proyecto
- Especificación de Requerimientos (Funcionalidades)
- 1. Casos de Uso General
- 1.1 Casos de Uso firmar electrónicamente un documento
- 1.2 Casos de Uso verificar la firma electrónica de un documento
- 1.3 Casos de Uso Descargar contenedor
- 1.4 Casos de Uso Descargar documento firmado electrónicamente
- Flujograma de actividades
- Diagrama de secuencia de proceso de firma
- Codificación
- Análisis y Diseño
- Pruebas
- Liberación
Liberación
Manual de Usuario
[En esta plantilla se coloca el manual de usuarios de la aplicación de software.]
El servicio web Murachí es un programa que sirve para construir otras programas con soporte para firma electrónica y verificación. Por la naturaleza de este proyecto, no se tiene un manual de usuario final; en lugar de ello se cuenta con una documentación de la Interfaz de Programación de Aplicaciones (API) REST del servicio. En la documentación del API se detalla cada uno de los recursos disponibles del servicio en varias categorías:
- Información general: recursos para obtener información general del servicio como versión y estadísticas básicas.
- Gestión de archivos: recursos para cargar y descargar archivos al y desde el servicio, así como para verificar electrónicamente un archivo firmado.
- Gestión de firma electrónica en formato BDOC: recursos para aplicar firma electrónica y obtener información sobre documentos firmados electrónicamente en formato BDOC.
- Gestión de firma electrónica en formato PDF: recursos para aplicar firma electrónica y obtener información sobre documentos firmados electrónicamente en formato PDF.
La documentación del API de Murachí está disponible en el siguiente enlace: https://murachi.cenditel.gob.ve/apidoc/index.html.
Configuración para archivos descargables
[En esta sección se coloca la información concerniente a los archivos empaquetados de las diferentes versiones y sistemas operativos.]
El servicio web Murachí está construido siguiendo el estilo arquitectónico REST con la tecnología Java y el marco de trabajo Jersey que brinda soporte para el API JAX-RS y sirve como una implementación de referencia de JAX-RS. Jersey proporciona una biblioteca para implementar servicios web RESTful en un contenedor Servlet de Java.
Para el despliegue del servicio web Murachi se utiliza Apache Tomcat como contenedor de servlet, específicamente la versión 7.
El archivo descargable del servicio web Murachí se encuentra disponible en: https://tibisay.cenditel.gob.ve/murachi/downloads
Para desplegar el servicio web Murachi en Tomcat 7 se debe colocar el archivo Murachi.war en el directorio de aplicaciones web webapps de Tomcat. En el caso de utilizar el sistema operativo Debian GNU/Linux 7.9 el archivo desplegable de Murachi se debe colocar en el directorio /var/lib/tomcat7/webapps.
cenditel09-000a:/var/lib/tomcat7/webapps# ls -l total 26184 drwxr-xr-x 4 tomcat7 tomcat7 35 sep 30 16:22 Murachi -rw-r--r-- 1 root root 25802952 sep 30 16:22 Murachi.war drwxr-xr-x 8 tomcat7 tomcat7 4096 sep 18 13:40 pruebaservicioweb -rw-r--r-- 1 tomcat7 tomcat7 996302 sep 9 10:46 pruebaservicioweb.war drwxr-xr-x 7 tomcat7 tomcat7 4096 sep 22 14:31 ROOT
Una vez que el archivo Murachi.war se encuentra en el directorio webapps se inicia el Tomcat:
#cenditel09-000a:/var/lib/tomcat7/webapps# /etc/init.d/tomcat7 start
De esta manera el servicio web Murachí estaría desplegado en el servidor.
Sobre estadísticas básicas del servicio web
El servicio web Murachí mantiene estadísticas básicas del número de firmas realizadas, número de firmas incompletas y número de verificaciones de firma electrónica. La documentación para activar las estadísticas básicas se encuentra disponible en el siguiente enlace: https://tibisay.cenditel.gob.ve/murachi/wiki/notasVarias#Estad%C3%ADsticasdeusodelservicio.