OneSpan Sign Release 11.33: Personalización de logotipo de autoservicio

Duo Liang, 19 de Marzo de 2020
OneSpan Sign Release 11.33: Self-Serve Logo Customization

OneSpan Sign versión 11.33 se implementó recientemente en el entorno de vista previa y sandbox. En esta nueva versión, permitimos que un firmante elimine una firma que aún no se ha confirmado, mejoramos la validación de los campos condicionales y registramos las acciones de "Lógica de condición" en la pista de auditoría, ampliamos nuestra API y SDK para personalizar el logotipo que se muestra en la nueva ceremonia de firma y se agregaron varias correcciones de errores. Puede encontrar las fechas de implementación para todos nuestros entornos en nuestro Centro de confianza página.
Entre todas estas actualizaciones interesantes, explicaremos cómo cargar un logotipo de ceremonia de firma para la Experiencia New Signer. ¡Empecemos!

Nueva experiencia de firmante: personalización de logotipo de autoservicio

Poder cargar un logotipo personalizado que represente a su organización es una de las opciones más importantes en términos de la ceremonia de firma. Desde la versión 11.33, estamos orgullosos de permitirle cargar el logotipo a través de la API y el SDK. La captura de pantalla a continuación le da una breve idea de cómo se presenta el logotipo en la experiencia de New Signer. 

3-19-1

Nota :

1) Si está utilizando la Ceremonia de firma clásica, los cambios mencionados en este blog no afectarán su integración actual o la experiencia del usuario final.

2) Configurar el logotipo de la interfaz de usuario del remitente pronto estará disponible en una versión futura.

3) En lugar de una configuración de paquete, la personalización del logotipo en New Signer Experience se gestiona en Nivel de cuenta y se especifica por idioma.

4) El logotipo en la Experiencia New Signer estará limitado a 273x43 píxeles. Las imágenes más grandes se reducirán y se adaptarán automáticamente al área.

Personalizar a través de la API

Hay dos API de Restful expuestas para crear, actualizar, eliminar y / o recuperar las personalizaciones de logotipo configuradas. Para agregar nuevas configuraciones de logotipo, la API es:

Solicitud HTTP

POST / api / account / admin / signatureLogos

Encabezados HTTP

Tipo de contenido: application / json 
Autorización: Basic api_key

Solicitar carga útil

[
  {
    "idioma": "en",
    "image": "data: image / jpeg; base64, / 9j / 4AAQSkkvkl8kv // 9k ="
  },
  {
    "idioma": "fr",
    "image": "data: image / jpeg; base64, / 9j / 4AAQSkkvkl8kv // 9k ="
  }
]

Nota :

1) Las teclas de idioma admitidas son: "en", "fr", "it", "ru", "es", "pt", "de", "nl", "da", "el", "zh-CN" , "Zh-TW", "ja", "ko".

2) El atributo "imagen" aceptará una cadena base64 que presenta la imagen. 

Del mismo modo, cuando desee actualizar la configuración existente o agregar nuevas configuraciones para otro idioma, usaría el mismo punto final de API e incluiría todas las configuraciones existentes como carga útil. De lo contrario, se perderán los nodos de idioma que faltan. Esto requiere que siempre realice primero una llamada de recuperación y edite según la respuesta cada vez que desee actualizar:

Solicitud HTTP

GET / api / account / admin / signLogos

Encabezados HTTP

Aceptar: aplicación / json 
Autorización: Basic api_key

Carga útil de respuesta

[
    {
        "dirtyFields": [
            "imagen",
            "idioma"
        ],
        "idioma": "en",
        "image": "data: image / png; base64, / 9j / 4AAQSkkvkl8kv // 9k ="
    },
    {
        "dirtyFields": [
            "imagen",
            "idioma"
        ],
        "idioma": "fr",
        "image": "data: image / png; base64, / 9j / 4AAQSkkvkl8kv // 9k ="
    }
]

Para volver a los valores predeterminados del sistema y eliminar todas las configuraciones existentes, simplemente pase una matriz vacía al actualizar:

Solicitud HTTP

POST / api / account / admin / signatureLogos

Encabezados HTTP

Tipo de contenido: application / json 
Autorización: Basic api_key

Solicitar carga útil

[]

Personalizar a través de los SDK

El código SDK equivalente para crear y recuperar la configuración del logotipo se ve a continuación:

SDK de Java

         List  signatureLogos = new ArrayList  ();
        SigningLogo signatureLogoEn = SigningLogoBuilder.newSigningLogo ()
                .withLanguage (Locale.ENGLISH)
                .withImage ("datos: imagen / png; base64, xxxuQmCC")
                .construir();
        signatureLogos.add (SignatureLogoEn);
        // Crear logotipos de firma
        eslClient.getSigningStyleService (). saveSigningLogos (SignatureLogos);
        Lista  createdSigningLogos = eslClient.getSigningStyleService (). GetSigningLogos ();

.NET SDK

            List  signatureLogos = new List  ();
            SigningLogo signatureLogoEn = SigningLogoBuilder.NewSigningLogo ()
                    .WithLanguage ("en")
                    .WithImage ("datos: imagen / png; base64, iVBORw0KGgoAAUEAALGPC")
                    .Construir ();
            signatureLogos.Add (SignatureLogoEn);
            eslClient.GetSigningStyleService () .SaveSigningLogos (SignatureLogos);
            List  createdSigningLogos = eslClient.GetSigningStyleService () .GetSigningLogos ();

Ahí está. Después de leer el blog de hoy, tiene una mejor idea de cómo cargar un logotipo personalizado en su cuenta y los detalles técnicos necesarios involucrados.

Si tiene alguna pregunta sobre este blog o cualquier otra cosa relacionada con la integración de OneSpan Sign en su aplicación, visite el Foros de la comunidad de desarrolladores . ¡Sus comentarios nos importan!

Comunidad de desarrolladores de OneSpan Sign

¡Únase a la comunidad de desarrolladores de OneSpan Sign! Foros, blogs, documentación, descargas de SDK y más.

Únete hoy