Autenticar firmantes

Para descargar la muestra de código completa, consulte nuestro sitio Code Share.

Para agregar una capa adicional de seguridad a sus transacciones en línea, OneSpan Sign ofrece opciones de autenticación de destinatarios sólidas y flexibles. Específicamente, puede seleccionar varias formas de verificar la identidad del destinatario de una invitación a una transacción antes de que se le permita acceder a los documentos de la transacción.

General Authentication se refiere a las herramientas integradas en OneSpan Sign que le permiten autenticar la identidad del destinatario mediante SMS, correo electrónico o un formato personalizado de Cuestionario.

La autenticación basada en conocimiento La autenticación basada en el conocimiento (KBA) le permite presentar preguntas de desafío a su destinatario. Si el destinatario proporciona las respuestas correctas, se verifica que es el destinatario correcto de la transacción. (KBA) depende de un proveedor de KBA externo para realizar la autenticación. Dicho proveedor es Equifax US o Equifax Canada.

Las preguntas de la autenticación basada en conocimiento se generan dinámicamente, basándose en la información del informe crediticio personal del firmante.

La autenticación basada en conocimiento puede utilizarse junto con cualquiera de los métodos de autenticación generales mencionados anteriormente.

Para activar la autenticación basada en el conocimiento, comuníquese con nuestro Equipo de asistencia.

Uso de la autenticación general

El siguiente código ilustra cómo editar el bloque de firmante para cada método de autenticación general. Si necesita una comparación con la creación básica de objetos de documento o si es la primera vez que crea un paquete con el SDK de Java, consulte Crear una transacción.

 .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]")   .WithFirstName("First")   .WithLastName("Signer")   .ChallengedWithQuestions(ChallengeBuilder.FirstQuestion("What's your favorite sport?")   .Answer("golf")   .SecondQuestion("What music instrument do you play?")   .Answer("drums")))   .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]")   .WithFirstName("Second")   .WithLastName("Signer")   .WithSMSSentTo("1234567890")) 

Enviar manualmente un código SMS

Cada vez que un firmante hace clic en el vínculo de correo electrónico, se genera y envía un nuevo código SMS. Si por alguna razón necesita enviar manualmente un nuevo código SMS, puede hacerlo usando PackageService y entregando como parámetros los objetos PackageId y Signer. El siguiente código hará lo siguiente:

 eslClient.PackageService.SendSmsToSigner(packageId, retrievedPackage.GetSigner(email1)); 

Usar KBA

También puede autenticar un firmante con KBA. También puede editar el bloque de firmante para implementar KBA. El campo withTimeAtAddress se puede dejar vacío. El siguiente código hará lo siguiente:

 .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]")   .WithFirstName("John")   .WithLastName("Smith")   .ChallengedWithKnowledgeBasedAuthentication(   SignerInformationForEquifaxUSABuilder.NewSignerInformationForEquifaxUSA()   .WithFirstName("John")   .WithLastName("Doe")   .WithStreetAddress("2020 Broadway Street")   .WithCity("New York")   .WithState("NY")   .WithZip("12345")   .WithSocialSecurityNumber("123456789")   .WithHomePhoneNumber("1234567890")   .WithDateOfBirth(new DateTime(2002, 2, 2))   .WithDriversLicenseNumber("1234567890")   .WithTimeAtAddress(32) 

Resultados

Después de ejecutar su código, si se envía una transacción con la autenticación del firmante activada, se pedirá a sus firmantes que validen su identidad utilizando el método especificado en la transacción.

Con la autenticación basada en el conocimiento, la identidad del firmante se verifica haciéndole una serie de preguntas acerca de su informe crediticio personal.

Para descargar la muestra de código completa, consulte nuestro sitio Code Share.

Para agregar una capa adicional de seguridad a sus transacciones en línea, OneSpan Sign ofrece opciones de autenticación de destinatarios sólidas y flexibles. Específicamente, puede seleccionar varias formas de verificar la identidad del destinatario de una invitación a una transacción antes de que se le permita acceder a los documentos de la transacción.

General Authentication se refiere a las herramientas integradas en OneSpan Sign que le permiten autenticar la identidad del destinatario mediante SMS, correo electrónico o un formato personalizado de Cuestionario.

La autenticación basada en conocimiento La autenticación basada en el conocimiento (KBA) le permite presentar preguntas de desafío a su destinatario. Si el destinatario proporciona las respuestas correctas, se verifica que es el destinatario correcto de la transacción. (KBA) depende de un proveedor de KBA externo para realizar la autenticación. Dicho proveedor es Equifax US o Equifax Canada.

Las preguntas de la autenticación basada en conocimiento se generan dinámicamente, basándose en la información del informe crediticio personal del firmante.

La autenticación basada en conocimiento puede utilizarse junto con cualquiera de los métodos de autenticación generales mencionados anteriormente.

Para activar la autenticación basada en el conocimiento, comuníquese con nuestro Equipo de asistencia.

Uso de la autenticación general

El siguiente código ilustra cómo editar el objeto de autenticación para cada método de autenticación. Si necesita una comparación con la creación básica de objetos de documento o si es la primera vez que crea un paquete con el SDK de Java, consulte Crear una transacción.

Solicitud HTTP

Encabezados HTTP

Accept: application/json
Content-Type: application/jsonAuthorization: 
Basic api_key

Carga útil de solicitud

 {   "roles": [   {   "type": "SIGNER",   "index": 0,   "signers": [   {   "auth": {   "scheme": "CHALLENGE",   "challenges": [   {   "answer": "golf",   "question": "What's your favorite sport?",   "maskInput": false   }   ]   },   "email": "[email protected]",   "firstName": "Patty",   "lastName": "Galant"   }   ],   "name": "Signer1"   },   {   "type": "SIGNER",   "index": 0,   "signers": [   {   "auth": {   "scheme": "SMS",   "challenges": [   {   "answer": null,   "question": "+15515584587",   "maskInput": false   }   ]   },   "email": "[email protected]",   "firstName": "John",   "lastName": "Smith"   }   ],   "name": "Signer2"   }   ],   "status": "DRAFT",   "type": "PACKAGE",   "name": "Signer Authentication Example"   } 

Para obtener una descripción completa de cada campo, consulte la sección Carga útil de solicitud siguiente.

Carga útil de respuesta

 {   "id": "9sKhW-h-qS9m6Ho3zRv3n2a-rkI="   } 

Enviar manualmente un código SMS

Cada vez que un firmante hace clic en el vínculo de correo electrónico, se genera y envía un nuevo código SMS. Si por alguna razón necesita enviar manualmente un nuevo código SMS, el siguiente código hará esto:

Solicitud HTTP

Encabezados HTTP

Accept: application/json
Content-Type: application/json
Authorization: Basic api_key

Usar KBA

También puede autenticar un firmante con KBA. La siguiente cadena JSON de ejemplo muestra cómo editar el objeto del firmante con KBA. El campo withTimeAtAddress se puede dejar vacío. El siguiente código hará lo siguiente:

 {   "signers":[   {   "delivery":{   "email":false   },   "email":"[email protected]",   "firstName":"John",   "lastName":"Doe",   "auth":{   "scheme":"NONE",   "challenges":[   ]   },   "knowledgeBasedAuthentication":{   "signerInformationForEquifaxUSA":{   "firstName":"John",   "lastName":"Doe",   "streetAddress":"2020 Broadway Street",   "city":"New York",   "zip":"12345",   "state":"NY",   "timeAtAddress":5,   "driversLicenseNumber":"1234567890",   "dateOfBirth":"1969-12-09T00:00:00Z",   "socialSecurityNumber":"123456789",   "homePhoneNumber":"1234567890"   }   }   }   ],   "reassign":false,   "emailMessage":{   "content":""   },   "attachmentRequirements":[   ]   } 

Resultados

Después de ejecutar su código, si se envía una transacción con la autenticación del firmante activada, se pedirá a sus firmantes que validen su identidad utilizando el método especificado en la transacción.

Con la autenticación basada en el conocimiento, la identidad del firmante se verifica haciéndole una serie de preguntas acerca de su informe crediticio personal.

Tabla de carga útil de solicitud

Para descargar la muestra de código completa, consulte nuestro sitio Code Share.

Para agregar una capa adicional de seguridad a sus transacciones en línea, OneSpan Sign ofrece opciones de autenticación de destinatarios sólidas y flexibles. Específicamente, puede seleccionar varias formas de verificar la identidad del destinatario de una invitación a una transacción antes de que se le permita acceder a los documentos de la transacción.

General Authentication se refiere a las herramientas integradas en OneSpan Sign que le permiten autenticar la identidad del destinatario mediante SMS, correo electrónico o un formato personalizado de Cuestionario.

La autenticación basada en conocimiento La autenticación basada en el conocimiento (KBA) le permite presentar preguntas de desafío a su destinatario. Si el destinatario proporciona las respuestas correctas, se verifica que es el destinatario correcto de la transacción. (KBA) depende de un proveedor de KBA externo para realizar la autenticación. Dicho proveedor es Equifax US o Equifax Canada.

Las preguntas de la autenticación basada en conocimiento se generan dinámicamente, basándose en la información del informe crediticio personal del firmante.

La autenticación basada en conocimiento puede utilizarse junto con cualquiera de los métodos de autenticación generales mencionados anteriormente.

Para activar la autenticación basada en el conocimiento, comuníquese con nuestro Equipo de asistencia.

Uso de la autenticación general

El siguiente código muestra cómo crear un objeto de rol para cada método de autenticación de firmante. Si necesita una comparación con la creación básica de objetos de documento o si es la primera vez que crea un paquete con el SDK de Apex, consulte esta guía.

 ESignLiveAPIObjects.Role role = new ESignLiveAPIObjects.Role(); 

 ESignLiveAPIObjects.AuthChallenge firstChallenge = new ESignLiveAPIObjects.AuthChallenge(firstQuestionAnswer, false, firstQuestion);     //Question & Answer     ESignLiveAPIObjects.AuthChallenge secondChallenge = new ESignLiveAPIObjects.AuthChallenge(secondQuestionAnswer, false, secondQuestion);     //Question & Answer     ESignLiveAPIObjects.AuthChallenge smsAuthentication = new ESignLiveAPIObjects.AuthChallenge(null, false, phoneNumber);     //SMS   

Enviar manualmente un código SMS

Cada vez que un firmante hace clic en el vínculo de correo electrónico, se genera y envía un nuevo código SMS. Si, por alguna razón, necesita enviar manualmente un nuevo código SMS, puede hacerlo utilizando la siguiente función encapsulada de Code Share:

 public void sendSmsToSigner(String packageId, String roleId) 

Usar KBA

También puede autenticar un firmante con KBA. Puede usar las dos funciones encapsuladas mostradas a continuación para crear un rol y agregarlo a una transacción existente. Las dos funciones se utilizan por separado para Equifax USA y Equifax CA:

 public void createRoleWithKBA_EquifaxUSA(String packageId, String roleId, String firstName, String lastName, String email, String streetAddress, String city, String zip, String state, Integer timeAtAddress, String driversLicenseNumber, String dateOfBirth, String socialSecurityNumber, String homePhoneNumber)   public void createRoleWithKBA_EquifaxCA(String packageId, String roleId, String firstName, String lastName, String email, String streetAddress, String city, String zip, String state, Integer timeAtAddress, String driversLicenseNumber, String dateOfBirth, String socialSecurityNumber, String homePhoneNumber) 

Resultados

Después de ejecutar su código, si se envía una transacción con la autenticación del firmante activada, se pedirá a sus firmantes que validen su identidad utilizando el método especificado en la transacción.

Con la autenticación basada en el conocimiento, la identidad del firmante se verifica haciéndole una serie de preguntas acerca de su informe crediticio personal.