Changes between Version 15 and Version 16 of actividades_2018_pruebas

Timestamp:

May 31, 2018, 8:36:44 AM (6 years ago)

Author:

pbuitrago

Comment:

--

actividades_2018_pruebas

@@ -13 +13 @@
 * ''' Subir documento pdf: ''' En este paso se carga al sistema Murachí el archivo usando el recurso “:/Murachi/0.1/archivos/” y se obtiene como respuesta el identificador único del archivo pdf (:identificador_unico_de_archivo_pdf). 
 
-* '''Preparar firma del archivo:''' En este caso se envía el certificado firmante al sistema Murachí junto con otros parámetros necesarios para la firma electrónica. En esta ocasión se utiliza biblioteca de JavaScript Forge y crytpto. Con esta librería podemos gestionar los archivos .p12 o .pfx  
-
-* '''Completar la firma del archivo:''' En este paso se va a enviar al sistema Murachí el hash cifrado utilizando el recurso :Murachi/0.1/archivos/pdfs/resenas, para completar la firma electrónica. Aquí se utiliza de nuevo la librería JavaScript Forge y Crytpto para acceder al archivo y firmar el hash que se obtuvo en la sección anterior, usando el recurso :firmar_hash(sign). Obtenemos del sistema Murachí el identificador único del archivo firmado. 
+* '''Preparar firma del archivo:''' En este caso se envía el certificado firmante al sistema Murachí junto con otros parámetros necesarios para la firma electrónica. En esta ocasión se utiliza biblioteca de JavaScript Forge y crytpto. Con esta librería podemos gestionar los archivos ''.p12'' o ''.pfx''  
+
+* '''Completar la firma del archivo:''' En este paso se va a enviar al sistema Murachí el hash cifrado utilizando el recurso '':Murachi/0.1/archivos/pdfs/resenas'', para completar la firma electrónica. Aquí se utiliza de nuevo la librería ''JavaScript Forge y Crytpto'' para acceder al archivo y firmar el ''hash'' que se obtuvo en la sección anterior, usando el recurso :firmar_hash(sign). Obtenemos del sistema Murachí el identificador único del archivo firmado. 
 Como el servicio de firma electrónica se realiza en varios pasos vamos a dividir el ejercicio en secciones.
 
@@ -22 +22 @@
 == Sección 1: Subir documento pdf ==
 
-En la primera sección se envía al sistema Murachí el archivo pdf que se va a firmar. Entonces para esta sección se requiere de un formulario que permita tomar del sistema de archivo documentos pdf y luego enviarlo con el método ''$.ajax usando el recurso /Murachi/0.1/archivos/''
+En la primera sección se envía al sistema Murachí el archivo ''pdf'' que se va a firmar. Entonces para esta sección se requiere de un formulario que permita tomar del sistema de archivo documentos pdf y luego enviarlo con el método ''$.ajax'' usando el recurso ''/Murachi/0.1/archivos/''
 
 '''Característica del formulario HTML''' 
@@ -69 +69 @@
 Los elementos <div> del formulario con id = "sección1", “sección2” y “sección3” se utiliza para mostrar los resultados correspondientes a los 3 procesos descritos para la firma electrónica (consumo del servicio a Murachí).
 
-Como se va a utilizar certificado con soporte a software se requiere tener en la pagina una sección que me permita cargar a la pagina el archivo .p12 o .pxf 
+Como se va a utilizar certificado con soporte a software se requiere tener en la pagina una sección que me permita cargar a la pagina el archivo ''.p12'' o ''.pxf'' 
 
 [[br]]
@@ -181 +181 @@
 Con esta función obtenemos la clave privada almacenada en la variable ''privateKey'' y el certificado almacenado en la variable ''certBytesHex''. 
 
-La clave privada es un conjunto de bytes que debemos convertir a string, para esto se tiene la siguiente función 
+La clave privada es un conjunto de bytes que debemos convertir a ''string'', para esto se tiene la siguiente función 
 
 [[BR]]
@@ -212 +212 @@
 
 '''Opciones de configuración de la petición $.ajax:'''
-'''ulr:''' Establece la URL en donde se realiza la petición, para esta sección es ''"https://murachi.cenditel.gob.ve/Murachi/0.1/archivos"''.
-'''type:''' Establece el tipo de petición, para esta actividad vamos a utilizar ''"POST"''. 
-'''dataType:''' Establece el formato de la respuesta que es permitido, si el servidor devuelve información con un formato diferente al especificado el código fallará. Para este proceso se establece “json”.
-'''data:''' Establece la información que se enviará al servidor. Para este proceso se envía el archivo almacenado en una variable de tipo ''FormaData''. 
-'''contentType:''' Establece el tipo de codificación que se va a utilizar, para esta actividad es ''"application/json"''.
-'''processData:''' Establece si la información que se envía al servidor debe ser procesada a una cadena de caracteres. Para evitar esto se debe utilizar el valor ''“false”''. En esta sección sólo se quiere enviar el archivo sin ser procesado.
-'''xhrFields:''' {withCredentials: true} esta característica puede usarse para establecer la propiedad de '''withCredentials'''. Si se establece ''TRUE'' permite que se pase los ''cookies'' al servidor y permitir solicitudes de dominios cruzados. 
-'''headers:''' {"Authorization":"Basic YWRtaW46YWRtaW4="} autenticación básica HTTP
+ * '''ulr:''' Establece la URL en donde se realiza la petición, para esta sección es ''"https://murachi.cenditel.gob.ve/Murachi/0.1/archivos"''.
+ * '''type:''' Establece el tipo de petición, para esta actividad vamos a utilizar ''"POST"''. 
+ * '''dataType:''' Establece el formato de la respuesta que es permitido, si el servidor devuelve información con un formato diferente al especificado el código fallará. Para este proceso se establece “json”.
+ * '''data:''' Establece la información que se enviará al servidor. Para este proceso se envía el archivo almacenado en una variable de tipo ''FormaData''. 
+ * '''contentType:''' Establece el tipo de codificación que se va a utilizar, para esta actividad es ''"application/json"''.
+ * '''processData:''' Establece si la información que se envía al servidor debe ser procesada a una cadena de caracteres. Para evitar esto se debe utilizar el valor ''“false”''. En esta sección sólo se quiere enviar el archivo sin ser procesado.
+ * '''xhrFields:''' {withCredentials: true} esta característica puede usarse para establecer la propiedad de '''withCredentials'''. Si se establece ''TRUE'' permite que se pase los ''cookies'' al servidor y permitir solicitudes de dominios cruzados. 
+ * '''headers:''' {"Authorization":"Basic YWRtaW46YWRtaW4="} autenticación básica HTTP
 
 [[BR]]
@@ -398 +398 @@
 En esta sección se va a calcular el valor del hash del documento que se envió en la sección 1, en tal sentido antes del cálculo del hash se debe enviar al servidor Murachí toda la información que se agregará al documento tales como el certificado del firmante como información adicional necesaria para la firma electrónica: 
 
-'''fileId:''' corresponde al identificador del archivo que se encuentra en el servidor y se desea firmar (identificador único del archivo pdf). 
-'''certificate:''' corresponde al certificado del firmante en formato hexadecimal. 
-'''reason:''' corresponde a la razón de la firma (cadena descriptiva del por qué de la firma). 
-'''location:''' corresponde a la ubicación donde se realiza la firma. 
-'''contact:''' corresponde a información de contacto del firmante. 
-'''signatureVisible:''' true para mostrar un indicador visible de firma en la primera página del documento pdf y false para no mostrar un indicador visible de firma en la primera página del documento pdf. 
+ * '''fileId:''' corresponde al identificador del archivo que se encuentra en el servidor y se desea firmar (identificador único del archivo pdf). 
+ * '''certificate:''' corresponde al certificado del firmante en formato hexadecimal. 
+ * '''reason:''' corresponde a la razón de la firma (cadena descriptiva del por qué de la firma). 
+ * '''location:''' corresponde a la ubicación donde se realiza la firma. 
+ * '''contact:''' corresponde a información de contacto del firmante. 
+ * '''signatureVisible:''' true para mostrar un indicador visible de firma en la primera página del documento pdf y false para no mostrar un indicador visible de firma en la primera página del documento pdf. 
 
 El certificado lo obtuvimos en la sección anterior, en la función ''getCertificate()''. Luego enviarlo al sistema Murachí con el metodo ''$.ajax'' usando el recurso '':Murachi/0.1/archivos/pdfs''