Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Página 1
Versión 1.2
15 de mayo de 2020
https://translate.googleusercontent.com/translate_f#9 1/22
14/5/2021 Guía del SDK de SigCaptureWeb
Página 2
Tabla de contenido
https://translate.googleusercontent.com/translate_f#9 2/22
14/5/2021 Guía del SDK de SigCaptureWeb
Página 3
1.0 Introducción
El ePadLink SigCaptureWeb SDK ofrece un mecanismo y una plataforma para desarrolladores y
integradores para capturar firmas manuscritas de forma segura para aplicaciones web que se ejecutan en el
Navegadores Google Chrome, Mozilla Firefox, Opera y Microsoft Edge (Chromium). El SDK
proporciona capacidades para capturar firmas manuscritas biométricas seguras utilizando
blocs de firmas de ePadLink.
El SDK exporta las imágenes de las firmas capturadas, así como la firma biométrica sin procesar.
datos en diferentes formatos. Las imágenes se pueden utilizar en cualquier aplicación que requiera firma.
imágenes. Los datos de la firma biométrica para la firma capturada se obtienen de forma cifrada
y se puede guardar en cualquier base de datos para uso futuro.
https://translate.googleusercontent.com/translate_f#9 3/22
14/5/2021 Guía del SDK de SigCaptureWeb
Página 4
El siguiente diagrama muestra la descripción general de alto nivel de la solución con componentes críticos.
involucrado.
Navegador
(Chrome / Firefox / Opera / Edge (Chromium))
ePadLink
Almohadilla
4
https://translate.googleusercontent.com/translate_f#9 4/22
14/5/2021 Guía del SDK de SigCaptureWeb
Página 5
El ePadLink SigCaptureWeb SDK se ha desarrollado como una aplicación C # .Net estándar. Eso
tiene un mecanismo incorporado para capturar firmas usando dispositivos de captura de firmas ePadLink y
también para exponer los datos de la firma biométrica sin procesar en formato ENC o SIG y la firma como un
imagen (JPG, PNG, etc.). Tiene todas las interfaces de entrada y salida implementadas como estándar
Flujos de entrada y salida según lo requiera la extensión del navegador Chrome y Firefox
marcos. El SDK procesa los mensajes de texto de entrada de los navegadores y ejecuta el
solicitudes de forma asincrónica, y cuando una tarea se completa envía de vuelta el estado o los datos de salida como
un mensaje de texto de salida. Alojará todas las funciones de la interfaz de usuario para la captura y visualización de
firmas de dispositivos.
Los navegadores ejecutan este SDK en un proceso separado, lo inician a través de las API de Google Connect o
API de extensión web y envía una notificación a la extensión cuando la aplicación está
finalizado por el usuario.
Las extensiones de Chrome y Firefox son módulos de código basados en HTML, JavaScript y CSS que son
iniciado durante el inicio del navegador o iniciado bajo demanda desde la página web JavaScript.
Ambas extensiones utilizan API de mensajería nativa de Chrome basadas en JavaScript para iniciar y
comunicarse con ePadLink SigCaptureWeb SDK para la captura de firmas y otros
características. La extensión escucha los mensajes de salida de SigCaptureWeb y procesa
ellos en consecuencia. La mensajería nativa de Chrome tiene una API de conexión para iniciar las aplicaciones
(que puede procesar los mensajes de entrada y salida estándar) y un evento Disconnect para permitir que el
página web conozca la terminación de la aplicación de host nativa. Usando Connect y
Desconecte, se puede controlar el ciclo de vida de la aplicación de host nativa. Además, Chrome Native
Las API de mensajería tienen mecanismos para enviar mensajes de entrada al SDK de SigCaptureWeb y
recibir mensajes de salida de aplicaciones.
Los navegadores Opera y Edge también admiten la instalación y el uso de extensiones de Chrome.
ePadLink SigCaptureWeb SDK aprovecha esto para capturar firmas dentro de Opera y Edge
navegadores.
https://translate.googleusercontent.com/translate_f#9 5/22
14/5/2021 Guía del SDK de SigCaptureWeb
Página 6
https://translate.googleusercontent.com/translate_f#9 6/22
14/5/2021 Guía del SDK de SigCaptureWeb
Página 7
Las muestras se han probado en la última versión de Chrome, Firefox, Opera y Edge.
(Chromium) navegadores. Por lo tanto, se recomienda que instale la última versión del
Navegadores Google Chrome, Mozilla Firefox, Opera y Microsoft Edge (Chromium).
Nota : NET Framework 3.5 o superior debería estar disponible en la computadora Windows de los usuarios finales.
Página 8
https://translate.googleusercontent.com/translate_f#9 7/22
14/5/2021 Guía del SDK de SigCaptureWeb
Página 9
https://translate.googleusercontent.com/translate_f#9 8/22
14/5/2021 Guía del SDK de SigCaptureWeb
Nota : En caso de que hacer clic en la URL no funcione, intente copiar y pegar la URL en el
Navegador Chrome.
Página 10
https://translate.googleusercontent.com/translate_f#9 9/22
14/5/2021 Guía del SDK de SigCaptureWeb
Guía del SDK de SigCaptureWeb
3. Haga clic en el botón "AÑADIR A CROMO" que se muestra en la parte superior derecha de la página que
mostrado (vea la captura de pantalla a continuación).
4. Haga clic en el botón "Agregar extensión" en el cuadro de diálogo de confirmación que se muestra.
10
Página 11
https://translate.googleusercontent.com/translate_f#9 10/22
14/5/2021 Guía del SDK de SigCaptureWeb
Para instalar las extensiones de ePadLink SigCaptureWeb SDK en el navegador Firefox, comuníquese con
Soporte ePadLink en support@epadlink.com.
6.2.3 - Opera
2. Vaya a la página de complementos de Opera e instale el complemento "Instalar extensiones de Chrome" por
navegando a la siguiente URL:
https://addons.opera.com/en/extensions/details/download-chrome-extension-
9 /? Display = en.
3. Haga clic en el botón "+ Agregar a Opera" que se muestra en la parte superior derecha de la página (consulte el
captura de pantalla a continuación). Para ver la extensión instalada, escriba Ctrl + Shift + E.
4. Vaya a la página de extensión del SDK de ePadLink SigCaptureWeb en la tienda web de Chrome:
https://chrome.google.com/webstore/detail/epadlink-sigcaptureweb-
sd / idldbjenlmipmpigmfamdlfifkkeaplc
Nota : En caso de que hacer clic en la URL no funcione, intente copiar y pegar la URL en Opera.
navegador.
11
Pagina 12
https://translate.googleusercontent.com/translate_f#9 11/22
14/5/2021 Guía del SDK de SigCaptureWeb
5. Haga clic en el botón "Agregar a Opera" que se muestra en la parte superior derecha de la página que está
mostrado (vea la captura de pantalla a continuación).
6. Haga clic en Aceptar en el cuadro de diálogo "Instalar extensiones de Chrome" que se muestra.
7. Haga clic en el botón "Instalar" en la parte superior derecha de la página que se muestra para instalar y habilitar
la extensión (vea la captura de pantalla a continuación).
8. Por último, haga clic en el botón "Sí, instalar" en el cuadro de diálogo de confirmación que se muestra (consulte
la captura de pantalla a continuación).
12
Página 13
https://translate.googleusercontent.com/translate_f#9 12/22
14/5/2021 Guía del SDK de SigCaptureWeb
Microsoft Edge ha adoptado el proyecto de código abierto Chromium. Ahora admite la instalación de
Extensiones de Chrome y ePadLink SigCaptureWeb aprovecha la extensión de Chrome para
capturar firmas en el navegador Microsoft Edge. Siga los siguientes pasos para instalar el
Extensión de Chrome en el navegador Microsoft Edge.
Nota : En caso de que hacer clic en la URL no funcione, intente copiar y pegar la URL en Edge
navegador.
3. Una ventana que muestra la extensión de Chrome similar a la de La sección 6.2.1 será
desplegado. Haga clic en el botón "Agregar a Chrome" que se muestra en la parte superior derecha de la página (consulte
la captura de pantalla a continuación).
4. Haga clic en el botón "Agregar extensión" en el cuadro de diálogo de confirmación que se muestra.
Después de asegurarse de que el software ePadLink SigCaptureWeb SDK esté instalado (consulte Sección 6.1)
y el panel de firmas está conectado a la PC, abra esta página en su navegador preferido:
http://www.epadsupport.com/sign_chrome_ff_sigcapturewebsdk/sign_chrome_ff_sigcapturewe
bsdk.html .
Haga clic en el botón "Firmar" para mostrar la ventana de captura de firma. El usuario de la ventana de firma
La interfaz se explica en detalle en la siguiente sección.
13
Página 14
14
Página 15
https://translate.googleusercontent.com/translate_f#9 14/22
14/5/2021 Guía del SDK de SigCaptureWeb
Para controlar la interfaz de la ventana de captura de firmas, siga los pasos que se indican a continuación.
1. Vaya a la ubicación donde está instalado el SDK:
< add key = " uitype " value = " 1 " />
5. Para mostrar la ventana de captura de firma "Moderna", el valor debe establecerse en "1". Para el
En la ventana de captura de firmas "Clásica", el valor debe establecerse en "2". Por defecto, el
Se mostrará la ventana de firma "Moderna".
15
Página 16
https://translate.googleusercontent.com/translate_f#9 15/22
14/5/2021 Guía del SDK de SigCaptureWeb
Las extensiones SigCaptureWeb SDK se basan en eventos HTML personalizados para la comunicación entre
la página web y las extensiones y viceversa.
Las extensiones de Chrome, Firefox, Opera y Edge (Chromium) se cargan durante el inicio del navegador.
y registre un evento HTML personalizado llamado "SigCaptureWeb_SignStartEvent". páginas web
que desee capturar la firma utilizando SigCaptureWeb SDK en Chrome y Firefox
Los navegadores deben generar el evento HTML personalizado "SigCaptureWeb_SignStartEvent" y enviar un
mensaje de entrada al SDK como un atributo de evento.
Una vez que se completa la tarea de captura de firmas, las extensiones SigCaptureWeb generan una
Evento HTML llamado "SigCaptureWeb_SignResponse" y pasa el mensaje de salida como un
atributo de evento. Las páginas web deben registrar e implementar la
Evento “SigCaptureWeb_SignResponse” para procesar la salida de la extensión.
dieciséis
Página 17
https://translate.googleusercontent.com/translate_f#9 16/22
14/5/2021 Guía del SDK de SigCaptureWeb
var message = { "firstName" : "" , "lastName" : "" , "eMail" : "" , "location" : "" ,
document.documentElement.appendChild (elemento);
element.dispatchEvent (evt);
17
Página 18
La carga útil del mensaje de salida contendrá el estado de firma firmada, los datos de la imagen (en el
formato especificado), los datos de la firma sin procesar en formato base 64, el teclado de firma conectado
https://translate.googleusercontent.com/translate_f#9 17/22
14/5/2021 Guía del SDK de SigCaptureWeb
información y un parámetro para llevar el mensaje de error en caso de que falle la firma.
La API de mensajería nativa de Google Chrome (a través de la cual la Extensión envía y recibe
datos al SDK) exige que los datos de texto estén en formato JSON, de ahí la entrada y salida
los mensajes deben estar en formato JSON y, por conveniencia, se sigue el mismo formato JSON
para Firefox también. El formato del mensaje JSON es
18
Página 19
Aquí hay una cadena JSON de muestra que contiene todas las ENTRADAS admitidas.
https://translate.googleusercontent.com/translate_f#9 18/22
14/5/2021 Guía del SDK de SigCaptureWeb
PARÁMETRO DESCRIPCIÓN
primer nombre Nombre del detalle de la firma como cadena.
apellido Detalle de la firma Apellido como cadena.
Email Correo electrónico de detalle de firma como cadena.
La ubicación de la firma como String, podría ser una ubicación física o
localización
longitud y latitud.
Formato de la imagen de la firma a exportar después de la firma
formato de imagen
capturar. Envíe 1 para JPG y 2 para PNG. El formato predeterminado es PNG.
imageX Ancho físico de la imagen de la firma a exportar en píxeles.
imageY Altura física de la imagen a exportar en píxeles.
imageTransparency Transparencia de fondo de la imagen de la firma como booleano.
imageScaling Ya sea para escalar la imagen o no como booleano.
maxUpScalePercent Porcentaje máximo de escala superior permitido como flotante (0 a 100).
Los datos sin procesar se pueden exportar después de la captura de la firma como una cadena. Usar
rawDataFormat ENC como valor para este campo para exportar datos sin procesar de firmas en eSign
Formato Emcee y SIG para exportarlo en formato Topaz .Sig.
Número mínimo de puntos necesarios para calificar el garabato del firmante como
minSigPoints
una firma válida como número.
Una vez formateado el mensaje de entrada JSON requerido, debe pasarlo a Chrome o
Extensión de Firefox. Debe establecerse como un atributo para el evento html personalizado.
SigCaptureWeb_SignStartEvent provocado por una página web.
19
Página 20
La siguiente interfaz aparece para la captura de firmas de forma predeterminada. Si la conexión con el
dispositivo de bloc de firmas es correcto, verá el mensaje "Bloc de notas inicializado, empezar a firmar" en
la barra de estado (en la parte inferior) de la ventana.
https://translate.googleusercontent.com/translate_f#9 19/22
14/5/2021 Guía del SDK de SigCaptureWeb
La barra de herramientas tendrá opciones para borrar la firma, aceptar la firma y cancelar la
firma.
Si el valor del parámetro de configuración "uitype" se establece en "2" (ver Sección 7.0), la siguiente
Aparecerá la interfaz "Clásica" para la captura de firmas. Si la conexión con el dispositivo de bloc de firmas
tiene éxito, verá el “dispositivo ePad inicializado correctamente. Empezar a firmar ... "mensaje en
la ventana de captura de firmas.
La ventana de captura de firma tendrá opciones para borrar la firma, aceptar la firma
("Aceptar") y Cancelar la firma.
20
Página 21
1. No se pudo inicializar el cuadro de diálogo de captura de firma debido a datos de entrada incorrectos o cualquier otro
fallas relacionadas con el dispositivo / controlador.
2. El usuario canceló la firma.
3. El usuario aceptó una firma.
4. Firma no capturada / aceptada.
El mensaje de salida tiene un parámetro booleano de 'estado' que indica si la captura de firma
tiene éxito o no. Las aplicaciones pueden confiar en este parámetro para identificar si una firma es
https://translate.googleusercontent.com/translate_f#9 20/22
14/5/2021 Guía del SDK de SigCaptureWeb
capturado o no.
El siguiente es un mensaje de salida de muestra:
{ "isSigned" : true , "imgData" : "Datos de imagen con formato Base64" , "rawSigData" : "Base64
datos de firma sin procesar formateados en formato eSign Emcee o .Sig encriptados " ," padInfo ":
“Información de la tableta de firmas conectada”};
PARÁMETRO DESCRIPCIÓN
está firmado El valor del parámetro especifica si una firma se captura o no como
Booleano. Devuelve verdadero si el usuario aceptó una firma y firma
la captura es exitosa. Un resultado positivo tiene imagen de éxito y
cargas útiles de datos de firma sin procesar en el mensaje; de lo contrario, serán
cadenas vacías.
imgData Imagen de firma como base de datos de 64 cadenas. El formato será
JPG o PNG como se especifica en el mensaje de entrada. Contiene el vacio
cadena si no se captura la firma.
rawSigData Datos de firma sin procesar como eSign Emcee Encrypted Base 64 String o
como. Cadena con formato sig. Contiene una cadena vacía si la firma es
No capturado.
padInfo Contiene la información sobre el bloc de firmas utilizado para la firma.
capturar.
errorMsg En caso de cualquier falla o firma cancelada por el usuario, este campo contiene
el mensaje de error. Las aplicaciones cliente pueden usar esta información para resolver
los errores.
21
Página 22
https://translate.googleusercontent.com/translate_f#9 21/22
14/5/2021 Guía del SDK de SigCaptureWeb
22
https://translate.googleusercontent.com/translate_f#9 22/22