Last modified: 2023-09-07

Introducción a los SDK

Las siguientes secciones pueden ayudarlo a empezar a trabajar con los SDL de OneSpan Sign:

Comunicación SSL

La integración con OneSpan Sign está asegurada mediante un certificado SSL emitido por GlobalSign. Por lo tanto, el certificado intermedio de GlobalSign debe instalarse en su entorno de integración.

Si bien puede agregar cualquiera de los certificados en la cadena de certificados, el certificado de Root-CA debería funcionar para la mayoría de los entornos.

Entorno de integración

A la luz de la vulnerabilidad de seguridad de Logjam, OneSpan Sign ha aumentado su clave DH SSL de 1024 bits a 2048 bits.

Las versiones anteriores de Java y .NET ya no podrán conectarse a OneSpan Sign, ya que no admiten la clave de cifrado más grande.

Detalles del certificado

Certificate serial#: 04 00 00 00 00 01 21 58 53 08 a2
Thumbprint: d6 9b 56 11 48 f0 1c 77 c5 45 78 c1 09 26 df 5b 85 69 76 ad

Vínculo de descarga: https://secure.globalsign.net/cacert/Root-R3.crt

OneSpan Sign SDK de Java

Nuestros SDK de Java permiten la integración con cualquier aplicación escrita en el lenguaje de programación Java.

De forma predeterminada, los SDK .NET y Java no son seguros para subprocesos. Si está ejecutando este código en una aplicación de varios subprocesos, es posible que encuentre condiciones de carrera y bloqueos. Por ello, recomendamos que cada subproceso tenga su propia instancia del SDK.

Requisitos mínimos

Su JVM debe utilizar Java 1.7.0_21 o superior.

Para identificar la versión de Java instalada en el sistema, ejecute el siguiente comando:

java -version

Si desea trabajar con un OneSpan Sign Java SDK, descargue la versión 11.

Para ver la documentación Javadoc de un OneSpan Sign Java SDK, utilice el siguiente procedimiento:

  1. Acceda a nuestro repositorio de MVN OneSpan Sign, que se encuentra aquí: https://mvnrepository.com/artifact/com.silanis.esl/sdk

  2. Seleccione la versión de SDK de la que desea ver la documentación. Por ejemplo, 11.45.

  3. En la fila Archivos, haga clic en Ver todo.

  4. Descargue y descomprima el siguiente archivo: sdk-<version number>-javadoc.jar

Los OneSpan Sign Java SDKs admiten Java 1.7_21 y versiones posteriores.

Para obtener información adicional, consulte los ejemplos de GitHub a continuación.

Descarga de la última versión del SDK 11

  • Para descargar el SDK de .JAVA de OneSpan Sign, haga clic aquí. 

Para ver la documentación Javadoc de una versión de OneSpan Sign Java SDK, utilice el siguiente procedimiento:

  1. Acceda a nuestro repositorio de MVN OneSpan Sign, que se encuentra aquí: https://mvnrepository.com/artifact/com.silanis.esl/sdk

  2. Seleccione la versión de SDK para la que desea ver la documentación. Por ejemplo, 11.45.

  3. En la fila Archivos, haga clic en Ver todo.

  4. Descargue y descomprima el siguiente archivo: sdk-<version number>-javadoc.jar

Instalación

Para ver si este certificado ya está instalado en su entorno, ejecute el siguiente comando:

keytool -list -keystore <JAVA_HOME/lib/security/cacerts> | grep -i d6:9b:56:11:48:f0:1c:77:c5:45:78:c1:09:26:df:5b:85:69:76:ad

Si el certificado no está instalado, instálelo ejecutando el siguiente comando:

keytool -importcert -alias GlobalSignRootCAR3 -keystore <JAVA_HOME/lib/security/cacerts> -file Root-R3.crt

Ejemplo de código Java

Usuarios de Maven

Si utiliza Maven, agregue a su archivo pom la dependencia adecuada de entre las siguientes.

Para SDK 11:

<dependency>
            <groupId>com.silanis.esl</groupId>
            <artifactId>sdk</artifactId>
            <version>11.xx</version>
            <classifier>jar-with-dependencies</classifier>
        </dependency>

Si desea la versión del SDK que incluye todas las dependencias, agregue <classifier>jar-with-dependencies</classifier> a la dependencia.

OneSpan Sign SDK de .NET

Nuestros SDK de .NET permiten la integración con cualquier aplicación escrita en el lenguaje de programación C#.

Si desea trabajar con un OneSpan Sign .NET SDK, descargue la versión 11 y realice la configuración adicional que se describe a continuación. Para obtener información adicional, consulte los ejemplos de GitHub a continuación.

De forma predeterminada, los SDK .NET y Java no son seguros para subprocesos. Si está ejecutando este código en una aplicación de varios subprocesos, es posible que encuentre condiciones de carrera y bloqueos. Por ello, recomendamos que cada subproceso tenga su propia instancia del SDK.

Requisitos mínimos

.NET

Ahora admitimos .NET Standard 2.0 y .NET Framework 4.5 o superior. Esto significa que .NET Core también es compatible, y que también se pueden utilizar máquinas Linux.

Para identificar el marco de .NET instalado en el sistema, siga las instrucciones de este vínculo: https://msdn.microsoft.com/en-us/library/hh925568

SDK 11

  • Para descargar el SDK de .NET de OneSpan Sign, haga clic aquí. 

Instalación

Para instalar el certificado, haga doble clic en el archivo Root-R3.crt y, a continuación, seleccione Instalar certificado.

Ejemplos de código de .NET

OneSpan Sign SDK de APEX

Escrito en APEX, el OneSpan Sign APEX SDK for Salesforce permite a los desarrolladores integrar la funcionalidad de firma electrónica en sus aplicaciones personalizadas en Salesforce o en la plataforma Force.com.

X