Transmisión de secuencia de bytes confiablemente (Transission Control Protocol, TCP)
tramites.cancilleria.gov.co · Web viewRealiza la conversión de un archivo Word a pdf. El...
48
MANUAL TÉCNICO SERVICIOS WEB BUS DE SERVICIOS WINHOUSE SOFTWARE Versión 2.0 1
Transcript of tramites.cancilleria.gov.co · Web viewRealiza la conversión de un archivo Word a pdf. El...
MANUAL TÉCNICO SERVICIOS WEB
BUS DE SERVICIOS WINHOUSE SOFTWARE
Versión 2.0
1
ContenidoAviso de confidencialidad.......................................................................................................................4
Objetivo..................................................................................................................................................5
Definición de servicios............................................................................................................................6
1. Validación PDF/A............................................................................................................................6
PdfaBase64.........................................................................................................................................6
Método AnalyzePdfA......................................................................................................................6
PdfaBinary..........................................................................................................................................7
Método AnalizePdfA.......................................................................................................................7
2. Conversión Word a PDF..................................................................................................................8
Conversion.........................................................................................................................................8
Método ConvertToPdfBase64........................................................................................................8
Método ConvertToPdfByte............................................................................................................9
Método ConvertToPdfPath............................................................................................................9
3. Conversión PDF a PDF/A...............................................................................................................10
PdfaBase64.......................................................................................................................................10
Método ConvertToPdfA...............................................................................................................10
PdfaBinary........................................................................................................................................11
Método ConvertToPdfA...............................................................................................................12
4. Firma digital PDF..........................................................................................................................12
ServerSign........................................................................................................................................13
Método SignServerBase64...........................................................................................................13
Método SignServerBinary.............................................................................................................14
Método SignServerPath...............................................................................................................15
TimeStamp.......................................................................................................................................16
Método TimeStampingBase64.....................................................................................................17
Método TimeStampingBinary.......................................................................................................18
Método TimeStampingPath.........................................................................................................18
ClientSign.........................................................................................................................................19
Método PrepareDocumentSignature...........................................................................................20
Método FinalizeDocumetSignature..............................................................................................23
5. Compresión..................................................................................................................................26
Compression....................................................................................................................................26
2
Método LayeredPdf......................................................................................................................27
Método PdfCompression..............................................................................................................27
6. EForm...........................................................................................................................................28
Método GenerateForm................................................................................................................28
7. Registraduría................................................................................................................................30
PersonIdentityValidator...................................................................................................................30
Método ValidatePersonIdentity...................................................................................................30
Autenticación.......................................................................................................................................32
Instalación del sitio web.......................................................................................................................32
Requisitos mínimos..........................................................................................................................32
Procedimiento de instalación...........................................................................................................32
Configuraciones del Servicio:...........................................................................................................35
Anexo 1 Objeto Firma..........................................................................................................................36
Anexo 2 Formatos de archivos soportados para la compresión...........................................................38
Anexo 3 Estructura inicial de archivo XMP...........................................................................................39
Anexo 4 Posición-Numeración de los dedos........................................................................................40
3
Aviso de confidencialidad
Este documento y cualquier documento anexo contienen información propietaria, confidencial o privilegiada que pertenecen a Winhouse S.A. Se advierte que cualquier divulgación, distribución, copia o acción relacionada al contenido del mismo, sin la autorización escrita de Winhouse S.A está totalmente prohibida.
4
Objetivo
Este documento contiene las especificaciones y requerimientos técnicos para el uso del bus de servicios web de firma, validación y conversión de documentos. Se indica el procedimiento de instalación del sitio web y las configuraciones para el funcionamiento.
5
Definición de servicios1. Validación PDF/A
PdfaBase64Este servicio realiza la validación del nivel de cumplimiento del estándar PDF/A
Nota de implementación: El tamaño máximo de los archivos se encuentra limitado de acuerdo al perfil del usuario autenticado. Para mayor información del proceso de autenticación por favor remítase a la sección “Proceso de autenticación”
Ubicación del endpoint
http://rutasitioweb/Pdfa/PdfaBase64.svc
Ubicación wsdl
http:// rutasitioweb/Pdfa/PdfaBase64.svc?wsdl
http:// rutasitioweb/Pdfa/PdfaBase64.svc?singleWsdl
Método AnalyzePdfAValida el cumplimiento del estándar PDF/A de acuerdo al nivel de conformidad indicado de un archivo PDF. En caso de inconsistencia con el estándar se genera un reporte de errores detallado.
Parámetros de entradaNombre Tipo Descripción
document string Documento PDF a validar en formato string base 64compliancyLevel1 string Nivel de conformidad. La lista de valores permitidos son
3b, 3u, 3a, 2b, 2u, 2a, 1b, 1a
Parámetros de salidaNombre Tipo Descripción
Result string Resumen del proceso de validaciónReport Byte[] Reporte detallado en formato html con el resultado del
proceso de validación.
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:AnalyzePdfA xmlns:ns1='http://winhouse.com/IPdfaBase64/v1'> <ns1:document>?XXX?</ns1:document> <ns1:compliancyLevel>?XXX?</ns1:compliancyLevel> </ns1:AnalyzePdfA>
1 Vea la sección de términos para obtener una breve descripción de cada uno de los niveles de conformidad
6
</s12:Body></s12:Envelope>
PdfaBinaryEste servicio realiza la validación del nivel de cumplimiento del estándar PDF/A. El archivo PDF debe ser pasado al servicio en formato binario. Se recomienda preferir el uso de este servicio sobre el PdfaBase64 ya que proporciona un uso más eficiente de los recursos de ancho de banda y procesamiento; use el servicio PdfaBase64 por razones de compatibilidad.
Nota de implementación: El tamaño máximo de los archivos se encuentra limitado de acuerdo al perfil de usuario autenticado. Para mayor información del proceso de autenticación por favor remítase a la sección “Proceso de autenticación”
Ubicación del endpoint
https://rutasitioweb/Pdfa/PdfaBinary.svc
Ubicación wsdl
http://rutasitioweb/Pdfa/PdfaBinary.svc?wsdl
http://rutasitioweb/Pdfa/PdfaBinary.svc?singleWsdl
Método AnalizePdfAValida el cumplimiento del estándar PDF/A de acuerdo al nivel de conformidad indicado de un archivo PDF. En caso de inconsistencia con el estándar se genera un reporte de errores detallado.
Parámetros de entradaNombre Tipo Descripción
document string Documento PDF a validar en formato binariocompliancyLevel2 string Nivel de conformidad. La lista de valores permitidos son 3b,
3u, 3a, 2b, 2u, 2a, 1b, 1a
Parámetros de salidaNombre Tipo Descripción
Result string Resumen del proceso de validaciónReport Byte[] Reporte detallado en formato html con el resultado del
proceso de validación.
Request Template<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:AnalyzePdfA xmlns:ns1='http://winhouse.com/IPdfaBinary/v1'> <ns1:document>???</ns1:document>
2 Vea la sección de términos para obtener una breve descripción de cada uno de los niveles de conformidad
7
<ns1:compliancyLevel>?XXX?</ns1:compliancyLevel> </ns1:AnalyzePdfA> </s12:Body></s12:Envelope>
2. Conversión Word a PDF
ConversionEste servicio realiza la conversión de un archivo Word a formato pdf
Ubicación del endpoints
https://rutasitioweb/Conversion/Conversion.svc/basic
https://rutasitioweb/Conversion/Conversion.svc/binary
Ubicación wsdl
http://rutasitioweb/Conversion/Conversion?wsdl
http://rutasitioweb/ws/Conversion/Conversion.svc?singleWsdl
Método ConvertToPdfBase64Realiza la conversión de un archivo Word a pdf. El archivo de entrada y de respuesta es recibido y enviado en formato string base 64
Parámetros de entradaNombre Tipo Descripción
document string Documento Word a convertir en formato string base 64extensión string Extensión del archivo: doc, docx, oct
Parámetros de salidaNombre Tipo Descripción
document string Documento pdf resultado de la conversión en formato string base 64
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:ConvertToPdfBase64 xmlns:ns1='http://winhouse.com/IConversion/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:document>?XXX?</ns1:document><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. -->
8
<ns1:extension>?XXX?</ns1:extension> </ns1:ConvertToPdfBase64> </s12:Body></s12:Envelope>
Método ConvertToPdfByteRealiza la conversión de un archivo Word a pdf. El archivo de entrada y de respuesta es recibido y enviado como una rreglo de bytes
Parámetros de entradaNombre Tipo Descripción
documentByte Byte[] Documento Word a convertir extensión string Extensión del archivo: doc, docx, oct
Parámetros de salidaNombre Tipo Descripción
document Byte[] Documento pdf resultado de la conversión
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:ConvertToPdfByte xmlns:ns1='http://winhouse.com/IConversion/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:documentByte>???</ns1:documentByte><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:extension>?XXX?</ns1:extension> </ns1:ConvertToPdfByte> </s12:Body></s12:Envelope>
Método ConvertToPdfPathRealiza la conversión de un archivo Word a pdf. El archivo de entrada y de respuesta debe encontrarse en una ubicación accesible por el servidor
Parámetros de entradaNombre Tipo Descripción
inputPath string Ruta del documento Word a convertir outputPath string Ruta del documento resultado de la conversión
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'><s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'>
9
<s12:Body> <ns1:ConvertToPdfPath xmlns:ns1='http://winhouse.com/IConversion/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:inputPath>?XXX?</ns1:inputPath><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:outputPath>?XXX?</ns1:outputPath> </ns1:ConvertToPdfPath> </s12:Body></s12:Envelope>
3. Conversión PDF a PDF/A
PdfaBase64Este servicio permite la conversión de archivos PDF al estándar PDF/A; el archivo PDF y XMP (en el proceso de conversión) deben ser pasados al servicio en formato string base 64.
Nota de implementación: El tamaño máximo de los archivos se encuentra limitado de acuerdo al perfil de usuario autenticado. Para mayor información del proceso de autenticación por favor remítase a la sección “Proceso de autenticación”
Ubicación del endpoint
http://rutasitioweb/PdfaBase64.svc
Ubicación wsdl
http://rutasitioweb/Pdfa/PdfaBase64.svc?wsdl
http://rutasitioweb/Pdfa/PdfaBase64.svc?singleWsdl
Método ConvertToPdfARealiza la conversión de un archivo PDF o Word a PDF/A según el nivel de conformidad indicado.
Parámetros de entradaNombre Tipo Descripción
document string Documento PDF o Word a convertir en formato string base 64
compliancyLevel string Nivel de conformidad. La lista de valores permitidos son 3b, 3u, 3a, 2b, 2u, 2a, 1b, 1a
ppi int Resolución de la imagen en píxeles por pulgada empleada para procesar el contenido cuando se debe forzar una conversión a PDF/A que por algún motivo no fue exitosa. Las páginas con problemas se convierten a imágenes, y el texto se transforma en
10
texto invisible ubicado en la posición correcta a fin de mantenerlo disponible para copiar y marcar.
xmp3 string Archivo XMP en formato string base 64extension string Extensión del archivo a convertir. Las extensiones
permitas son: .pdf , .docx
Parámetros de salidaNombre Tipo Descripción
Result string Resumen del proceso de validaciónConvertedFile Byte[] Documento PDF/A resultado del proceso de
conversión.
Request Template<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:ConvertToPdfA xmlns:ns1='http://winhouse.com/IPdfaBase64/v1'> <ns1:document>?XXX?</ns1:document> <ns1:compliancyLevel>?XXX?</ns1:compliancyLevel> <ns1:ppi>?999?</ns1:ppi> <ns1:xmp>?XXX?</ns1:xmp> <ns1:extension>?XXX?</ns1:extension> </ns1:ConvertToPdfA> </s12:Body></s12:Envelope>
PdfaBinaryEste servicio permite la conversión de archivos PDF al estándar PDF/A; el archivo PDF y XMP (en el proceso de conversión) deben ser pasados al servicio en formato binario. Se recomienda preferir el uso de este servicio sobre el PdfaBase64 ya que proporciona un uso más eficiente de los recursos de ancho de banda y procesamiento; use el servicio PdfaBase64 por razones de compatibilidad.
Nota de implementación: El tamaño máximo de los archivos se encuentra limitado de acuerdo al perfil de usuario autenticado. Para mayor información del proceso de autenticación por favor remítase a la sección “Proceso de autenticación”
Ubicación del endpoint
https://rutasitioweb/Pdfa/PdfaBinary.svc
Ubicación wsdl
http://rutasitioweb/Pdfa/PdfaBinary.svc?wsdl
http://rutasitioweb/Pdfa/PdfaBinary.svc?singleWsdl
3 Siglas de Extensible Metadata Platform
11
Método ConvertToPdfARealiza la conversión de un archivo PDF o Word a PDF/A según el nivel de conformidad indicado.
Parámetros de entradaNombre Tipo Descripción
document Byte[] Documento PDF o Word a convertir en formato binariocompliancyLevel string Nivel de conformidad. La lista de valores permitidos son 3b,
3u, 3a, 2b, 2u, 2a, 1b, 1ªppi int Resolución de la imagen en píxeles por pulgada empleada para
procesar el contenido cuando se debe forzar una conversión a PDF/A que por algún motivo no fue exitosa. Las páginas con problemas se convierten a imágenes, y el texto se transforma en texto invisible ubicado en la posición correcta a fin de mantenerlo disponible para copiar y marcar.
xmp4 Byte[] Archivo XMP en formato binarioextension string Extensión del archivo a convertir. Las extensiones permitas
son: .pdf , .docx
Parámetros de salidaNombre Tipo Descripción
Result string Resumen del proceso de validaciónConvertedFile Byte[] Documento PDF/A resultado del proceso de conversión.
Request Template<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:ConvertToPdfA xmlns:ns1='http://winhouse.com/IPdfaBinary/v1'> <ns1:document>???</ns1:document> <ns1:compliancyLevel>?XXX?</ns1:compliancyLevel> <ns1:ppi>?999?</ns1:ppi> <ns1:xmp>???</ns1:xmp> <ns1:extension>?XXX?</ns1:extension> </ns1:ConvertToPdfA> </s12:Body></s12:Envelope>
4. Firma digital PDF
ServerSignEste servicio realiza el firmado invisible sobre un documento PDF con un certificado que se encuentre instalado en el servidor (Llave pública y privada).
4 Siglas de Extensible Metadata Platform
12
Ubicación del endpoint
https://rutasitioweb/Sign/ServerSign.svc/basic
https://rutasitioweb/Sign/ServerSign.svc/binary
Ubicación wsdl
http://rutasitioweb/Sign/ServerSign.svc?wsdl
http://rutasitioweb/Sign/ServerSign.svc?singleWsdl
Método SignServerBase64Firma un archivo pdf con certificado de servidor y configuración invisible. El archivo de entrada y de respuesta así como la información no estándar están en formato string base 64.
Parámetros de entradaNombre Tipo Descripción
Document* string Documento pdf a firmar en formato string base 64customInfo string Campo para almacenar información no estándar de la
firma. Por ejemplo información biométrica. Formato string base 64
certificateSerial* string Número de serie del certificado que se encuentra instalado en el servidor y que se usará para firmar5
tsaUrl String Url del servidor de estampado de tiempotsaUsername String Si el servidor de estampado requiere autenticación,
usuario para acceder al serviciotsaPassword String Si el servidor de estampado requiere autenticación,
contraseña para acceder al servicio
Parámetros de salidaNombre Tipo Descripción
document string Documento pdf firmado en formato base 64
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'><s12:Body> <ns1:SignServerBase64 xmlns:ns1='http://winhouse.com/IServerSign/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:document>?XXX?</ns1:document><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:customInfo>?XXX?</ns1:customInfo><!-- optional -->
5 Esto dado que el servidor podría tener varios certificados válidos instalados en el almacén de certificados “Personal”
13
<!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:certificateSerial>?XXX?</ns1:certificateSerial><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUrl>?XXX?</ns1:tsaUrl><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUsername>?XXX?</ns1:tsaUsername><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaPassword>?XXX?</ns1:tsaPassword> </ns1:SignServerBase64> </s12:Body></s12:Envelope>
Método SignServerBinaryFirma un archivo pdf con certificado de servidor y configuración invisible. El archivo de entrada y de respuesta así como la información no estándar se deben enviar como arreglos de bytes
Parámetros de entradaNombre Tipo Descripción
Document* Byte[] Documento pdf a firmar customInfo Byte[] Campo para almacenar información no estándar de la
firma. Por ejemplo información biométrica. certificateSerial* string Número de serie del certificado que se encuentra
instalado en el servidor y que se usará para firmartsaUrl String Url del servidor de estampado de tiempotsaUsername String Si el servidor de estampado requiere autenticación,
usuario para acceder al serviciotsaPassword String Si el servidor de estampado requiere autenticación,
contraseña para acceder al servicio
Parámetros de salidaNombre Tipo Descripción
document Byte[] Documento pdf firmado en formato base 64
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:SignServerBinary xmlns:ns1='http://winhouse.com/IServerSign/v1'><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:document>???</ns1:document><!-- optional -->
14
<!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:customInfo>???</ns1:customInfo><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:certificateSerial>?XXX?</ns1:certificateSerial><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUrl>?XXX?</ns1:tsaUrl><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUsername>?XXX?</ns1:tsaUsername><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaPassword>?XXX?</ns1:tsaPassword> </ns1:SignServerBinary> </s12:Body></s12:Envelope>
Método SignServerPathFirma un archivo pdf con certificado de servidor y configuración invisible. La ruta del archivo de entrada y salida deben ser accesibles desde el servidor. La identidad del pool de aplicaciones que ejecuta el servicio debe tener permisos para lectura, escritura y modificación
Parámetros de entradaNombre Tipo Descripción
inputPath* string Ruta del documento pdf a firmar outputPath* string Ruta (directorio y nombre del archivo) en dónde se
creará el documento pdf firmadocustomInfo string Campo para almacenar información no estándar de la
firma. Por ejemplo información biométrica. Formato string base 64
certificateSerial* string Número de serie del certificado que se encuentra instalado en el servidor y que se usará para firmar
tsaUrl String Url del servidor de estampado de tiempotsaUsername String Si el servidor de estampado requiere autenticación,
usuario para acceder al serviciotsaPassword String Si el servidor de estampado requiere autenticación,
contraseña para acceder al servicio
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:SignServerPath xmlns:ns1='http://winhouse.com/IServerSign/v1'>
15
<!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:inputPath>?XXX?</ns1:inputPath><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:outputPath>?XXX?</ns1:outputPath><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:customInfo>?XXX?</ns1:customInfo><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:certificateSerial>?XXX?</ns1:certificateSerial><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUrl>?XXX?</ns1:tsaUrl><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUsername>?XXX?</ns1:tsaUsername><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaPassword>?XXX?</ns1:tsaPassword> </ns1:SignServerPath> </s12:Body></s12:Envelope>
TimeStampEste servicio realiza el firmado de estampa de tiempo sobre un documento PDF
Ubicación del endpoint
https://rutasitioweb/Sign/TimeStamp.svc/basic
https://rutasitioweb/Sign/TimeStamp.svc/binary
Ubicación wsdl
http://rutasitioweb/Sign/TimeStamp.svc?wsdl
http://rutasitioweb/Sign/TimeStamp.svc?singleWsdl
Método TimeStampingBase64Coloca la firma de estampa de tiempo en un archivo pdf. Los archivos de entrada y de salida están formato string base 64
Parámetros de entradaNombre Tipo Descripción
16
Document* string Documento pdf a firmar en formato string base 64tsaUrl* String Url del servidor de estampado de tiempotsaUsername String Si el servidor de estampado requiere autenticación,
usuario para acceder al servicio. Obligatorio si el servidor de estampado lo requiere
tsaPassword String Si el servidor de estampado requiere autenticación, contraseña para acceder al servicio. Obligatorio si el servidor de estampado lo requiere
Parámetros de salidaNombre Tipo Descripción
document string Documento pdf firmado en formato base 64
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:TimeStampingBase64 xmlns:ns1='http://winhouse.com/ITimeStamp/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:document>?XXX?</ns1:document><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUrl>?XXX?</ns1:tsaUrl><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUsername>?XXX?</ns1:tsaUsername><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaPassword>?XXX?</ns1:tsaPassword> </ns1:TimeStampingBase64> </s12:Body></s12:Envelope>
Método TimeStampingBinaryColoca la firma de estampa de tiempo en un archivo pdf. El formato de transmisión de los archivos de entrada y de salida es como arreglo de bytes
Parámetros de entradaNombre Tipo Descripción
Document* Byte[] Documento pdf a firmar tsaUrl* String Url del servidor de estampado de tiempotsaUsername String Si el servidor de estampado requiere autenticación,
usuario para acceder al servicio. Obligatorio si el
17
servidor de estampado lo requieretsaPassword String Si el servidor de estampado requiere autenticación,
contraseña para acceder al servicio. Obligatorio si el servidor de estampado lo requiere
Parámetros de salidaNombre Tipo Descripción
document Byte[] Documento pdf firmado en formato base 64
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:TimeStampingBinary xmlns:ns1='http://winhouse.com/ITimeStamp/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:document>???</ns1:document><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUrl>?XXX?</ns1:tsaUrl><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUsername>?XXX?</ns1:tsaUsername><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaPassword>?XXX?</ns1:tsaPassword> </ns1:TimeStampingBinary> </s12:Body></s12:Envelope>
Método TimeStampingPathColoca la firma de estampa de tiempo en un archivo pdf Las rutas del archivo de entrada y salida deben ser accesibles desde el servidor, se deben verificar los permisos de lectura, escritura y modificación
Parámetros de entrada
Nombre Tipo DescripcióninputPath* string Ruta del documento pdf a firmar outputPath* string Ruta del documento pdf firmadotsaUrl* String Url del servidor de estampado de tiempotsaUsername String Si el servidor de estampado requiere autenticación,
usuario para acceder al servicio. Obligatorio si el servidor de estampado lo requiere
tsaPassword String Si el servidor de estampado requiere autenticación,
18
contraseña para acceder al servicio. Obligatorio si el servidor de estampado lo requiere
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:TimeStampingPath xmlns:ns1='http://winhouse.com/ITimeStamp/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:inputPath>?XXX?</ns1:inputPath><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:outputPath>?XXX?</ns1:outputPath><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUrl>?XXX?</ns1:tsaUrl><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUsername>?XXX?</ns1:tsaUsername><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaPassword>?XXX?</ns1:tsaPassword> </ns1:TimeStampingPath> </s12:Body></s12:Envelope>
ClientSignEste servicio realiza el firmado de un documento PDF con un certificado instalado en la máquina del cliente, evitando brechas de seguridad al transmitir credenciales o tener en custodia certificados digitales. Este servicio es especialmente útil cuando los documentos a firmar son generados o descargados desde el servidor dado el eficiente uso de recursos en el proceso de transmisión de datos
Ubicación del endpoint
https://rutasitioweb/ws/Sign/ClientSign.svc
Ubicación wsdl
http://rutasitioweb/ws/Sign/ClientSign.svc?wsdl
http://rutasitioweb/ws/Sign/ClientSign.svc?singleWsdl
19
Método PrepareDocumentSignaturePrepara el documento para la firma en el cliente, retorna los datos a firmar más un identificador de proceso que se usará posteriormente para finalizar el firmado
Parámetros de entradaNombre Tipo Descripción
Document* string Documento pdf a firmar en formato string base 64almacenCertificado* String Almacén de certificados con la llave pública del
certificado del cliente en formato string base 64. El almacén puede ser generado con la funcionalidad del control ActiveX para el cliente a partir de llamados con Javascript
tsaUrl String Url del servidor de estampado de tiempotsaUsername String Si el servidor de estampado requiere autenticación,
usuario para acceder al serviciotsaPassword String Si el servidor de estampado requiere autenticación,
contraseña para acceder al servicioFirmaConfig FirmaConfig Objeto tipo firma con todas las propiedades requeridas
para la firma del documento. Ver anexo 1 Objeto FirmaConfig para obtener una lista completa de las propiedades de este objeto y sus descripciones
Parámetros de salidaNombre Tipo Descripción
data string Información para la firmadocumentIdentifier string Identificador único del proceso, se debe tener en cuenta
para el llamado al servicio de finalización de firma
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:PrepareDocumentSignature xmlns:ns1='http://winhouse.com/IClientSign/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:document>?XXX?</ns1:document><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:almacenCertificado>?XXX?</ns1:almacenCertificado><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:firmaConfig><!-- optional --><!-- possible value: CERTIFICADA, possible value: DE_APROBACION -->
20
<ns2:ClaseFirma xmlns:ns2='http://schemas.datacontract.org/2004/07/PdfSign'>???</ns2:ClaseFirma><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:FirmaVisible xmlns:ns2='http://schemas.datacontract.org/2004/07/PdfSign'><!-- optional --> <ns2:AltoImagen>?999?</ns2:AltoImagen><!-- optional --> <ns2:AnchoImagen>?999?</ns2:AnchoImagen><!-- optional --> <ns2:AutoStretchImagen>?true?</ns2:AutoStretchImagen><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:EncabezadoFirma>?XXX?</ns2:EncabezadoFirma><!-- optional --><!-- possible value: HELVETICA, possible value: HELVETICA_BOLD, possible value: HELVETICA_OBLIQUE, possible value: HELVETICA_BOLD_OBLIQUE, possible value: TIMES_ROMAN, possible value: TIMES_BOLD, possible value: TIMES_ITALIC, possible value: TIMES_BOLD_ITALIC, possible value: COURIER, possible value: COURIER_BOLD, possible value: COURIER_OBLIQUE, possible value: COURIER_BOLD_OBLIQUE --> <ns2:FuenteFirma>???</ns2:FuenteFirma><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:ImagenFirma>???</ns2:ImagenFirma><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:Localizacion>?XXX?</ns2:Localizacion><!-- optional --> <ns2:MostrarEstampaTiempo>?true?</ns2:MostrarEstampaTiempo><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:NombreCampoFirma>?XXX?</ns2:NombreCampoFirma><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:NombreFirmador>?XXX?</ns2:NombreFirmador><!-- optional --> <ns2:PaginaFirma>?999?</ns2:PaginaFirma><!-- optional --> <ns2:PosXFirma>?999?</ns2:PosXFirma>
21
<!-- optional --> <ns2:PosYFirma>?999?</ns2:PosYFirma><!-- optional --> <ns2:PosicionAutomaticaFirma>?true?</ns2:PosicionAutomaticaFirma><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:RazonFirma>?XXX?</ns2:RazonFirma><!-- optional --> <ns2:TamanioAutomaticoFirma>?true?</ns2:TamanioAutomaticoFirma><!-- optional --> <ns2:TamanoFuenteAutomatico>?true?</ns2:TamanoFuenteAutomatico><!-- optional --> <ns2:TamanoFuenteDescripcion>?999.99?</ns2:TamanoFuenteDescripcion><!-- optional --> <ns2:TamanoFuenteTiempo>?999.99?</ns2:TamanoFuenteTiempo><!-- optional --> <ns2:TamanoFuenteTitulo1>?999.99?</ns2:TamanoFuenteTitulo1><!-- optional --> <ns2:TamanoFuenteTitulo2>?999.99?</ns2:TamanoFuenteTitulo2><!-- optional --> <ns2:TextoAutomaticoFirma>?true?</ns2:TextoAutomaticoFirma><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:TextoDescripcion11>?XXX?</ns2:TextoDescripcion11><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:TextoDescripcion12>?XXX?</ns2:TextoDescripcion12><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:TextoDescripcion13>?XXX?</ns2:TextoDescripcion13><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:TextoDescripcion14>?XXX?</ns2:TextoDescripcion14><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:TextoDescripcion2>?XXX?</ns2:TextoDescripcion2><!-- optional --><!-- possible value: FONDO_POR_DEFECTO, possible value: SIN_FONDO, possible value: IMAGEN --> <ns2:TipoImagenFirma>???</ns2:TipoImagenFirma><!-- optional -->
22
<!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:Titulo1Firma>?XXX?</ns2:Titulo1Firma><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:Titulo2Firma>?XXX?</ns2:Titulo2Firma><!-- optional --> <ns2:TitulosFirma>?true?</ns2:TitulosFirma> </ns2:FirmaVisible><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns2:InformacionPersonalizada xmlns:ns2='http://schemas.datacontract.org/2004/07/PdfSign'>???</ns2:InformacionPersonalizada><!-- optional --> <ns2:PermitirAnotaciones xmlns:ns2='http://schemas.datacontract.org/2004/07/PdfSign'>?true?</ns2:PermitirAnotaciones><!-- optional --> <ns2:PermitirRellenarCampos xmlns:ns2='http://schemas.datacontract.org/2004/07/PdfSign'>?true?</ns2:PermitirRellenarCampos><!-- optional --><!-- possible value: VISIBLE, possible value: INVISIBLE --> <ns2:TipoFirma xmlns:ns2='http://schemas.datacontract.org/2004/07/PdfSign'>???</ns2:TipoFirma> </ns1:firmaConfig><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUrl>?XXX?</ns1:tsaUrl><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUsername>?XXX?</ns1:tsaUsername><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaPassword>?XXX?</ns1:tsaPassword> </ns1:PrepareDocumentSignature> </s12:Body></s12:Envelope>
23
Método FinalizeDocumetSignatureFinaliza el proceso de firmado que se efectúa en el cliente
Parámetros de entradaNombre Tipo Descripción
signedData string Documento pdf a firmar en formato string base 64documentIdentifier String Identificador único del procesotsaUrl String Url del servidor de estampado de tiempotsaUsername String Si el servidor de estampado requiere autenticación,
usuario para acceder al serviciotsaPassword String Si el servidor de estampado requiere autenticación,
contraseña para acceder al servicio
Parámetros de salidaNombre Tipo Descripción
signedDocument string Documento firmado en formato string base 64
Request Template:<s12:Envelope xmlns:s12='http://www.w3.org/2003/05/soap-envelope'> <s12:Body> <ns1:FinalizeDocumetSignature xmlns:ns1='http://winhouse.com/IClientSign/v1'><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:signedData>?XXX?</ns1:signedData><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:documentIdentifier>?XXX?</ns1:documentIdentifier><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUrl>?XXX?</ns1:tsaUrl><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaUsername>?XXX?</ns1:tsaUsername><!-- optional --><!-- This element may be left empty if xsi:nil='true' is set. --> <ns1:tsaPassword>?XXX?</ns1:tsaPassword> </ns1:FinalizeDocumetSignature> </s12:Body></s12:Envelope>
24
Control ActiveX para firmaPara el uso del control ActiveX usted deberá haber instalado previamente el control ActiveX en la máquina del cliente. El llamado del control ActiveX se realiza mediante la creación de un objeto JavaScript:
var objetoAXFirma = new ActiveXObject("AX_Firma.FirmadorCliente");
El cliente ActiveX expone los siguientes métodos para llevar a cabo la firma en documentos PDF con certificado digital:
1. ObtenerListaCertificadosAlmacenWin: Contiene la lista de certificados que pueden ser usados para firmar que se encuentran actualmente instalados en la máquina dentro del almacén de certificados personal o MY
Valores de retorno: Devuelve una cadena de texto con los siguientes datos por cada certificado: NAME,ISSUER,FROM,TO,INDEX,SERIAL_NUMBER, cada propiedad/valor va separada por una salto de línea y cada certificado se encuentra separado por un doble pipe ||
2. ObtenerAlmacenamientoTemporalCertificado: Crea un objeto "almacén de certificados" con el certificado que se encuentra en el índice especificado.
Parámetros de entrada:
indiceCertificado: índice del certificado dentro del almacén de certificados
Valores de retorno: Devuelve el objeto almacén de certificado el cual contiene el certificado indicado en el índice pasado como parámetro
3. ProcesarDatos: Firma el listado de datos base 64 pasados como parámetro con el certificado ubicado en el almacén de certificados de windows de acuerdo al índice pasado como parámetro.
Parámetros de entrada:
datosBase64: lista de datos a firmar, para indicar más de uno separar por pipe |. La estructura general debe coincidir con identificador|datos
indCertAlmacenWin: índice del certificado empleado para firmar dentro del almacén de certificados de Windows personal o 'MY'
Valores de retorno: Devuelve los datos firmados codificados en base 64
Para realizar el llamado a cualquiera de los métodos del ActiveX basta con hacer el llamado al método desde la instancia del ActiveX creado:
var certsString = objetoAXFirma.ObtenerListaCertificadosAlmacenWin();
El siguiente es un ejemplo de una función en JavaScript para cargar la lista de certificados del equipo en un arreglo:
25
var consultarCertificadosAlmacen = function () { var x = new ActiveXObject("AX_Firma.FirmadorCliente"); var certsString = x.ObtenerListaCertificadosAlmacenWin(); var certs = certsString.split("||"); var certificados = []; angular.forEach(certs, function (value) { if (value.trim() !== '') { var cert = {}; //cargar propiedades individuales de los certificados var properties = value.split('\n'); angular.forEach(properties, function (prop) { var nombre = prop.match(/^([A-Za-z]*):/gm); var valor = prop.match(/:(.*)/gm); if (nombre != null && valor != null) { nombre = (nombre + '').replace(':', ''); valor = (valor + '').replace(':', ''); cert[nombre] = valor; } }); console.log(cert); certificados.push(cert); } }); }
Proceso de firmado en clienteA continuación se describen los pasos para completar un firmado de datos desde un cliente
1. Llamado al servicio web PrepareDocumentSignature: Prepara los datos para firma, para la invocación de este servicio se requiere el almacén de certificados con la llave pública del certificado usado para la firma.
2. Llamado a ProcesarDatos (ActiveX): Firma los datos en el cliente y retorna los datos firmados codificados en base64
3. Llamado al servicio FinalizeDocumetSignature: Realiza la reconstrucción del pdf y lo devuleve codificado como string base64
5. Compresión
CompressionEste servicio realiza la compresión de imágenes provenientes de diferentes fuentes (pdfs, archivos de imagen) en un solo archivo de salida en formato pdf
Ubicación del endpoint
http://rutasitioweb/Compression/Compression.svc
Ubicación wsdl
http://rutasitioweb/Compression/Compression?wsdl
26
http://rutasitioweb/Compression/Compression?singleWsdl
Método LayeredPdfRealiza la compresión en capas de los archivos de imagen y pdfs que se encuentren en la raíz del directorio de imágenes especificado en los parámetros de entrada. La lista de formatos de archivo soportada para la compresión se indica en el Anexo 2 Formatos de archivos soportados para la compresión. Los archivos no soportados así como el contenido en subdirectorios no son procesados por el servicio.
Parámetros de entradaNombre Tipo Descripción
imagesDirectory string Ruta del directorio de imágenes/pdfs a las que se les realizará el proceso de compresión
outputFilePath string Ruta del archivo (Directorio y nombre completo del archivo) pdf de salida que será creado como resultado del proceso de compresión
Parámetros de salidaNombre Tipo Descripción
Result bool Indica si el proceso de compresión fue o no exitoso
Request Template<s11:Envelope xmlns:s11='http://schemas.xmlsoap.org/soap/envelope/'><s11:Body> <ns1:LayeredPdf xmlns:ns1='http://winhouse.com/ICompression/v1'> <ns1:imagesDirectory>?XXX?</ns1:imagesDirectory> <ns1:outputFilePath>?XXX?</ns1:outputFilePath> </ns1:LayeredPdf> </s11:Body></s11:Envelope>
Método PdfCompressionRealiza la compresión más óptima de los archivos de imagen y pdfs que se encuentren en la raíz del directorio de imágenes especificado en los parámetros de entrada. La lista de formatos de archivo soportada para la compresión se indica en el Anexo 2 Formatos de archivos soportados para la compresión. Los archivos no soportados así como el contenido en subdirectorios no son procesados por el servicio.
Parámetros de entradaNombre Tipo Descripción
imagesDirectory string Ruta del directorio de imágenes/pdfs a las que se les realizará el proceso de compresión
outputFilePath string Ruta del archivo (Directorio y nombre completo del archivo) pdf de salida que será creado como resultado
27
del proceso de compresión
Parámetros de salidaNombre Tipo Descripción
Result bool Indica si el proceso de compresión fue o no exitoso
Request Template<s11:Envelope xmlns:s11='http://schemas.xmlsoap.org/soap/envelope/'> <s11:Body> <ns1:PdfCompression xmlns:ns1='http://winhouse.com/ICompression/v1'> <ns1:imagesDirectory>?XXX?</ns1:imagesDirectory> <ns1:outputFilePath>?XXX?</ns1:outputFilePath> </ns1:PdfCompression> </s11:Body></s11:Envelope>
6. EForm
EFormEste servicio permite la generación de PDFs a partir de plantillas generadas dinámicamente
Ubicación del endpoint
http://rutasitioweb/Forms/EForm.svc
Ubicación wsdl
http://rutasitioweb/Forms/EForm?wsdl
http://rutasitioweb/Forms/EForm?singleWsdl
Método GenerateFormGenera un archivo PDF a partir de una plantilla que contiene la estructura del archivo y un listado de parámetros
Parámetros de entradaNombre Tipo Descripción
template string Ubicación de la plantilla (archivo excel) que va a ser usada para la generación del PDF
parameters string Duplas de parámetros con la estructura: “nombre variable | valor”. Cada dupla debe estar separada por un salto de línea
imageModeProcesing string Cadena de tres dígitos así: 999 valor para el proceso de imágenes donde cada
28
digito corresponde a: 1 para procesar imagen de foto que viene en el
campo photo que forma parte de los parámetros, 0 de lo contrario.
1 para procesar imagen de firma que viene en el campo signature que forma parte de los parámetros, 0 de lo contrario.
1 para procesar imagen de huella que viene en el campo fingerPrint que forma parte de los parámetros, 0 de lo contrario.
photo string Contenido de la Foto en formato JPG y Hexadecimal. Puede venir hasta 12 imágenes separada por |*| Ej.: /hexfoto1|*||*|/hexfoto3|*| Si solo viene una imagen no se requiere hacer uso de |*| , en caso de múltiples imágenes puede o no incluir al final el separador |*|
signature string Contenido de la Firma en formato JPG y Hexadecimal. Puede venir hasta 12 imágenes separada por |*| Ej.: /hexfirma1|*||*|/hexfirma3|*| Si solo viene una imagen no se requiere hacer uso de |*|, en caso de múltiples imágenes puede o no incluir al final el separador |*|
signatureType Int 1 JPG, 2 TIFFfingerPrint string Contenido de la Huella en formato JPG y Hexadecimal.
Puede venir hasta 12 imágenes separada por |*| Ej.: /hexHuella1|*||*|/hexHuella3|*| Si solo viene una imagen no se requiere hacer uso de |*|, en caso de múltiples imágenes puede o no incluir al final el separador |*|
xmlDoc Contenido del archivo de autodocumentación para anexar, el cual permite personalizar adicionalmente los metadatos del documento. Este archivo deberá tener la estructura XML definida por el Ministerio, en el Anexo 3 se describe estructura XML inicial.
outputFilePath string Ruta del archivo (Directorio y nombre completo del archivo) pdf de salida que será creado como resultado del proceso de generación a partir de plantillas
Parámetros de salidaNombre Tipo Descripción
Result bool Indica si el proceso de generación fue o no exitoso
Request Template<s11:Envelope xmlns:s11='http://schemas.xmlsoap.org/soap/envelope/'> <s11:Body>
29
<ns1:GenerateForm xmlns:ns1='http://winhouse.com/IForm/v1'> <ns1:template>?XXX?</ns1:template> <ns1:parameters>?XXX?</ns1:parameters> <ns1:imageModeProcesing>?XXX?</ns1:imageModeProcesing> <ns1:photo>?XXX?</ns1:photo> <ns1:signature>?XXX?</ns1:signature> <ns1:signatureType>?999?</ns1:signatureType> <ns1:fingerPrint>?XXX?</ns1:fingerPrint> <ns1:xmlDoc>?XXX?</ns1:xmlDoc> <ns1:outputFilePath>?XXX?</ns1:outputFilePath> </ns1:GenerateForm> </s11:Body></s11:Envelope>
7. Registraduría
PersonIdentityValidator Permite consultar y validar la identidad de un ciudadano frente a Registraduría.
Ubicación del endpoint
http://rutasitioweb/Registraduria/PersonIdentityValidator.svc
Ubicación wsdl
http://rutasitioweb/Registraduria/PersonIdentityValidator.svc ?wsdl
http://rutasitioweb/Registraduria/PersonIdentityValidator.svc?singleWsdl
Método ValidatePersonIdentityRealiza la consulta y validación de un ciudadano frente a la Registraduría Nacional; el servicio requiere el número de identificación (NUIP) y dos huellas diferentes del ciudadano (de cualquiera de las dos manos), si al menos una de las huellas del ciudadano coincide con la respuesta de la Registraduría se retornan los datos biográficos del ciudadano expuestos en la respuesta del servicio web de la Registraduría, en caso de que las huellas no coincidan o no se encuentre registro de ciudadano con el NUIP indicado se retornará el respectivo mensaje de error, el resultado de la validación será “falso” y no se enviarán datos biográficos.
El proceso se ilustra en el siguiente diagrama de secuencia:
30
Ilustración 1 Diagrama de secuencia validación de ciudadano Registraduría
Parámetros de entradaNombre Tipo Descripción
Nuip string Número único de identificación del ciudadanofingerPrintOne string ID del dedo asociado a la huella y huella en formato
string base 64 separados por pipe |. Los valores permitidos para el ID del dedo deberán estar entre 1 y 10 – Ver anexo 3.
fingerPrintTwo string ID del dedo asociado a la huella y huella en formato string base 64 separados por pipe |. Los valores permitidos para el ID del dedo deberán estar entre 1 y 10 – Ver anexo 3.
Parámetros de salidaNombre Tipo Descripción
RegistraduriaResponse Objeto Resulta de la consulta y validación de los datos frente a la Registraduría.
RegistraduriaResponse.valido Bool Si se encontró coincidencia entre las huellas y la identificación del ciudadano, este campo es verdadero(true) y el valor del campo
31
RegistraduriaResponse.QueryResponse se diligencia con los datos biográficos obtenidos de la Registraduría, en caso contrario el valor de este campo es falso(false) y el valor del campo RegistraduriaResponse.QueryResponse es nulo(null)
RegistraduriaResponse. QueryResponse
Objeto Objeto que contiene los datos biográficos del ciudadano y otros relativos a la consulta obtenidos de la Registraduría
RegistraduriaResponse. QueryResponse.NUIP
String NUIP/NIP
RegistraduriaResponse. QueryResponse.Nombre1
String Nombre 1.
RegistraduriaResponse. QueryResponse.Nombre2
String Nombre 2
RegistraduriaResponse. QueryResponse.Apellido1
String Apellido 1
RegistraduriaResponse. QueryResponse.Apellido2
String Apellido 2
RegistraduriaResponse. QueryResponse.Particula
String Partícula (Código + Descripción).
RegistraduriaResponse. QueryResponse.LugarExpedicion
String Lugar de Expedición del Documento de Identificación
RegistraduriaResponse. QueryResponse.FechaExpedicion
String Fecha de Expedición del Documento de Identificación
RegistraduriaResponse. QueryResponse.MinuciaPrimeraHuella
String Minucias, si existe, de la primera huella (PKM, ISO-FMR o ANSI-FMR).
RegistraduriaResponse. QueryResponse.MinuciaSegundaHuella
String Minucias, si existe, de la segunda huella (PKM, ISO-FMR o ANSI-FMR).
RegistraduriaResponse. QueryResponse.VigenciaDocumento
String Vigencia del Documento de Identificación (Código + Descripción).
RegistraduriaResponse. QueryResponse.NUT
String NUT
RegistraduriaResponse. QueryResponse.IdLog
Int ID del LOG asociado a la solicitud búsqueda.
AutenticaciónEl tipo de seguridad empleada es TransportWithMessageCredential; mediante el cual el proceso de autenticación se realiza a través de un usuario y contraseña los cuales deben ser pasados al servicio en el payload del mensaje. Para el caso de la contraseña el valor a transmitir en el servicio es el SHA512 de la misma.
32
Instalación del sitio webRequisitos mínimos:
1. .NET Framework 4.5, si no se encuentra instalado puede descargar una copia de http://www.microsoft.com/es-co/download/details.aspx?id=30653
2. Sistema operativo Windows Server 2008 R2 SP1 (x64), Windows Server 2008 SP2 (x86 y x64) o versiones superiores
3. Procesador a 1 GHz o más rápido4. 512 MB de RAM5. IIS v.7 o superior6. Certificado SSL instalado en el IIS (puede ser un certificado selfsigned)7. OpenOffice Writter (Para los servicios de conversión de Word a pdf)8. Visual Fox Pro 9 Runtime (Para los servicios de huella y validación con registraduría)6
9. Librería Eform (Para la generación de pdfs a partir de plantillas)7
Procedimiento de instalación 1. Cree una nueva carpeta y copie los archivos del sitio
Ilustración 2 Creación de carpeta
Ilustración 3 Archivos de instalación
2. En Internet Information Services Manager cree un nuevo Pool de aplicaciones con la siguiente configuración:
6 Para instalar Visual Fox Pro 9 Runtime ejecute eVFP9SP1RT.exe que se incluye dentro de los archivos de instalación7 Para instalar la librería EForm ejecute Instalador_wvEform.exe que se incluye como parte de los archivos de intalación
33
Ilustración 4 Creación de pool de aplicaciones
Ilustración 5 Configuración básica del pool de aplicaciones
3. En IIS Manager cree un nuevo sitio o una aplicación de sitio
Ilustración 6 Creación de aplicación
4. Cree un alias o nombre para la aplicación y asigné el pool de aplicaciones creado en el paso 2; de la misma forma asocie la carpeta en donde se encuentran copiados los archivos del sitio
Ilustración 7 Asignación del Pool de aplicaciones
34
Ilustración 8 Creación de aplicación en IIS
5. Configure el sitio para permitir únicamente conexiones a través del protocolo https. Si el sitio aún no tiene creado el Binding, cree el Binding de tipo https y seleccione el certificado SSL de la lista, en este punto el certificado ya debe estar instalado en el servidor
Ilustración 9 Configuración https Binding
6. Seleccione el ítem “SSL Settings” de la pantalla de configuraciones del sitio y marque el check “Require SSL”. Guarde los cambios
Ilustración 10 SSL Settings
35
Ilustración 11 Configuración SSL para el sitio/app
7. Finalmente efectué las configuraciones del sitio como se indican en la siguiente sección.
Configuraciones del Servicio:
Ubique el archivo web.config en la carpeta del sitio. En la sección appSettings deberá realizar la configuración de las siguientes claves:
CliFolder: Corresponde a la carpeta de instalación/ubicación del utilitario para el manejo de documentos PDF/A. Este utilitario se encuentra ubicado junto con los archivos copiados en el sitio, reemplace esta ruta por la ruta respectiva: “ruta carpeta ubicación sitio/bin/cli/” (Nota:no olvide colocar el slash al fina)
CacheFolder: Corresponde a la carpeta de procesamiento temporal de los archivos. Reemplace esta ruta por la correspondiente en el equipo de instalación. Tenga en cuenta que el usuario del pool de aplicaciones deberá tener permisos de modificación, lectura y escritura sobre esta carpeta.
OpenOffice: El usuario debe tener permisos para ejecutar el servicio de openoffice writer. Ingrese a Component Services y cambie el OpenOffice.org Service Manager para que use "Interactive User" como Identity
36
Anexo 1 Objeto FirmaEste objeto define todas las propiedades de configuración de la firma incluyendo los parámetros para la visualización de la misma, el tipo de firma (visible, invisible), la clase de firma (certificada, aprobación) además de otras características
PropiedadesNombre Descripción
ClaseFirma Indica si la firma es certificada o de aprobación. Las firmas certificadas solamente se pueden aplicar sobre firmas visibles. El documento solo puede tener una firma certificada. Si el documento ya tiene firma certificada se realiza una firma de aprobación
FirmaVisible Si la firma es visible, este campo permite especificar las características de presentación: ubicación, textos, imágenes y fuentes
InformacionPersonalizada Este campo permite agregar información personalizada a la firma
PermitirAnotaciones Indica si se pueden agregar comentarios al documento
PermitirRellenarCampos Indica si se pueden llenar formularios en el documento
TipoFirma Indica si la firma es visible o invisible
Propiedades FirmaVisible
37
Nombre Descripción
38
AltoFirma Alto de la firma en pulgadas
AltoImagen Alto en pulgadas de la imagen si es una imagen personalizada
AnchoFirma Ancho de la firma en pulgadas
AnchoImagen Ancho en pulgadas de la imagen si es una imagen personalizada
AutoStretchImagen Indica si la firma se debe auto ajustar al ancho y alto especificado
EncabezadoFirma Texto del encabezado de la firma
FuenteFirma Fuente para los textos incluidos en la firma
ImagenFirma Imagen cuando el tipo de imagen de firma es personalizada
Localizacion Ubicación geográfica firmante
MostrarEstampaTiempo Si TitulosFirma es verdadero este campo permite especificar si se va a mostrar la estampa de tiempo
NombreCampoFirma Nombre del campo de la firma
NombreFirmador Nombre de la entidad que firma
PaginaFirma índice de la página en dónde se colocará la firma visible, si no se estipula se asume la última página del documento
PosXFirma Ubicación desde el borde derecho de la hoja de la esquina superior derecha del campo de la firma visible
PosYFirma Ubicación desde el borde inferior de la hoja de la esquina superior derecha del campo de la firma visible
PosicionAutomaticaFirma
RazonFirma Texto que indica la razón de firma
TamanioAutomaticoFirma Indica si se debe asignar tamaño automático a la firma
TamanoFuenteAutomatico Indica si el tamaño de la fuente para los títulos de la firma es automático o no
TamanoFuenteDescripcion Tamaño de la fuente en puntos del texto de descripción de la firma
TamanoFuenteTiempo Tamaño de la fuente en puntos del texto de estampa de tiempo de la firma
TamanoFuenteTitulo1 Tamaño de la fuente en puntos del primer título
TamanoFuenteTitulo2 Tamaño de la fuente del segundo título de la firma
TextoAutomaticoFirma Indica si usa o no el texto por defecto de la firma
TextoDescripcion11 Texto de descripción personalizado ubicado en la primera línea de texto debajo del primer título
39
TextoDescripcion12 Texto de descripción personalizado ubicado en la segunda línea de texto debajo del primer título
TextoDescripcion13 Texto de descripción personalizado ubicado en la tercera línea de texto debajo del primer título
TextoDescripcion14 Texto de descripción personalizado ubicado en la cuarta línea de texto debajo del primer título
TextoDescripcion2 Texto de descripción personalizado ubicado en la primera línea de texto debajo del segundo título
TipoImagenFirma Si la firma tiene imagen especifica el tipo de imagen: defecto, sin fondo, imagen personalizada
Titulo1Firma Texto personalizado para el primer título de la firma
Titulo2Firma Texto de descripción personalizado del segundo título
TitulosFirma Indica si se deben incluir o no otros campos en la firma
Anexo 2 Formatos de archivos soportados para la compresión
La siguiente es la lista de formatos de archivo soportados por el proceso de compresión:
1. BMP2. GIF 3. JBIG2 4. JPEG5. PDF6. PCX7. PNG8. TIFF,TIFF multipágina
Anexo 3 Estructura inicial de archivo XMP<?xml version="1.0"?><SistemaGestionDocumental> <Entidad>Ministerio de Relaciones Exteriores de Colombia</Entidad> <Dependencia>Oficina de Pasapostes Calle 100</Dependencia> <Pais>Colombia</Pais> <Departamento-Estado>Cundinamarca</Departamento-Estado> <Ciudad-Municipio>Bogotá D.C.</Ciudad-Municipio> <TipoDocumento>Pasaporte Ordinario</TipoDocumento> <SolicitadoPor>
<PersonaNatural> <NombrePersonaNatural>Orlando Rodríguez</NombrePersonaNatural> <TipoDocumentoIdentidad>Cédula de Ciudadania</TipoDocumentoIdentidad>
40
<NumeroDocumentoIdentidad>Cédula de Ciudadania</NumeroDocumentoIdentidad></ PersonaNatural >
</SolicitadoPor> <ElaboradoPor> <FechaHoraElaboradoPor>2012-06-25 11:15:15 AM</FechaHoraElaboradoPor> <Funcionario> <NombreFuncionario>Martha Lucia Jimenez Medina</NombreFuncionario>
<DependenciaFuncionario>Dirección de Gestión de Informática y Tecnología</DependenciaFuncionario>
<CargoFuncionario>Directora</CargoFuncionario><CorreoElectronicoFuncionario>[email protected] </CorreoElectronicoFuncionario>
</Funcionario> </ElaboradoPor>
<AprobadoPor><FechaHoraAprobadoPor>2012-06-25 11:15:15 AM</FechaHoraAprobadoPor><Funcionario> <NombreFuncionario>Dora Stella Amado Hernandez</NombreFuncionario> <DependenciaFuncionario>Dirección de Gestión de Informática y Tecnología</DependenciaFuncionario>
<CargoFuncionario>Asesor</CargoFuncionario> <CorreoElectronicoFuncionario> [email protected]
</CorreoElectronicoFuncionario> </Funcionario> </AprobadoPor> <EmitidoaNombreDe> <PersonaNatural> <NombrePersonaNatural>Orlando Rodríguez</NombrePersonaNatural> <TipoDocumentoIdentidad>Cédula de Ciudadania</TipoDocumentoIdentidad>
<NumeroDocumentoIdentidad>Cédula de Ciudadania </NumeroDocumentoIdentidad>
</ PersonaNatural > </EmitidoaNombreDe> <FechaHoraDocumento>2012-06-25 11:15:15 AM</FechaHoraDocumento> <Asunto>Pasaporte Ordinario</Asunto> <TituloDocumento>Pasaporte Orlando Rodriguez CC 79151938</TituloDocumento> <PalabrasClaves></PalabrasClaves> <SistemaDeInformacion>SISTEMA DE TRAMITES VIRTUALES</SistemaDeInformacion> <ExpedientesElectronico> <CodigoExpediente>MINRELEX-99999999</CodigoExpediente>
<DescripcionExpediente>PASAPORTES</DescripcionExpediente></ExpedientesElectronico><MesesVigenciaDocumentoSegunNaturaleza>120</MesesVigenciaDocumentoSegunNaturaleza><TablaDeRetencionDocumental>
<CodigoTRD>0070.0123.0000</CodigoTRD><DescripcionTRD>PASAPORTES</DescripcionTRD><MesesVigenciaDocumentoArchivoGestion>120</MesesVigenciaDocumentoArchivoGestion><AñosVigenciaDocumentoArchivoCentral>10</AñosVigenciaDocumentoArchivoCentral>
</TablaDeRetencionDocumental>
41
</SistemaGestionDocumental>
Anexo 4 Posición-Numeración de los dedos1. Pulgar derecho2. Índice derecho3. Medio derecho4. Anular derecho5. Meñique derecho6. Pulgar izquierdo7. Índice izquierdo8. Medio izquierdo9. Anular izquierdo10. Meñique izquierdo
42
![michaelfp14toros.files.wordpress.com · Web view// Creamos el array de bytes para leer los datos del archivo byte[] buffer = new byte[ tam ]; // Obtenemos el archivo mediante la lectura](https://static.fdocuments.es/doc/165x107/5f89237294ba885ad702c46f/web-view-creamos-el-array-de-bytes-para-leer-los-datos-del-archivo-byte-buffer.jpg)
