OneSpan Sign Release 11.33: Personalização do logotipo de autoatendimento

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

A versão 11.33 do OneSpan Sign foi implantada recentemente no ambiente de visualização e sandbox. Nesta nova versão, habilitamos um assinante a remover uma assinatura que ainda não foi confirmada, aprimoramos a validação dos campos condicionais e registramos as ações “Condition Logic” na trilha de auditoria, estendemos nossa API e SDKs para personalizar o logotipo que é exibido na nova cerimônia de assinatura e adicionou várias correções de bugs. Você pode encontrar as datas de implantação de todos os nossos ambientes em nosso site. Centro de confiança página.
Entre todas essas atualizações interessantes, explicaremos como fazer upload de um logotipo da cerimônia de assinatura para a Nova Experiência do Signatário. Vamos começar!

Nova experiência do assinante - personalização do logotipo de self-service

Ser capaz de fazer upload de um logotipo personalizado que representa sua organização é uma das opções mais importantes em termos de cerimônia de assinatura. Desde a versão 11.33, temos o orgulho de permitir que você faça upload do logotipo por meio da API e do SDK. A captura de tela abaixo fornece uma breve idéia de como o logotipo é apresentado na Nova experiência do assinante. 

3-19-1

Nota :

1 Se você estiver usando a Cerimônia de assinatura clássica, as alterações mencionadas neste blog não afetarão sua integração ou experiência do usuário final.

2) O logotipo de configuração da interface do usuário do remetente estará disponível em breve em uma versão futura.

3) Em vez de uma configuração de pacote, a personalização do logotipo na Nova Experiência do Signatário é gerenciada no Nível da conta e é especificado por idioma.

4) O logotipo na nova experiência do assinante será limitado a 273 x 43 pixels. Imagens maiores serão reduzidas e ajustadas automaticamente à área.

Personalizar através da API

Existem duas APIs Restful expostas para criar, atualizar, excluir e / ou recuperar as personalizações de logotipo configuradas. Para adicionar novas configurações de logotipo, a API é:

Solicitação HTTP

POST / api / account / admin / signatureLogos

Cabeçalhos HTTP

Tipo de Conteúdo: application / json 
Autorização: básica api_key

Solicitar carga útil

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

Nota :

1 As teclas de idioma suportadas são: "en", "fr", "it", "ru", "es", "pt", "de", "nl", "da", "el" e "zh-CN" , "Zh-TW", "ja", "ko".

2) O atributo "imagem" aceitará uma string base64 que apresente a imagem. 

Da mesma forma, quando você deseja atualizar as configurações existentes ou adicionar novas configurações para outro idioma, usaria o mesmo ponto de extremidade da API e incluiria todas as configurações existentes como carga útil. Caso contrário, os nós de idioma ausentes serão perdidos. Isso exige que você sempre faça uma chamada de recuperação primeiro e edite com base na resposta sempre que desejar atualizar:

Solicitação HTTP

GET / api / account / admin / signatureLogos

Cabeçalhos HTTP

Accept: application / json 
Autorização: básica api_key

Carga útil da resposta

[
    {
        "dirtyFields": [
            "imagem",
            "língua"
        ],
        "language": "en",
        "image": "data: image / png; base64, / 9j / 4AAQSkkvkl8kv // 9k ="
    }
    {
        "dirtyFields": [
            "imagem",
            "língua"
        ],
        "language": "fr",
        "image": "data: image / png; base64, / 9j / 4AAQSkkvkl8kv // 9k ="
    }
]

Para reverter para o padrão do sistema e remover todas as configurações existentes, basta passar uma matriz vazia ao atualizar:

Solicitação HTTP

POST / api / account / admin / signatureLogos

Cabeçalhos HTTP

Tipo de Conteúdo: application / json 
Autorização: básica api_key

Solicitar carga útil

[]

Personalizar através dos SDKs

O código SDK equivalente para criar e recuperar as configurações do logotipo é semelhante a seguir:

Java SDK

         Lista  signatureLogos = new ArrayList  ();
        SigningLogo signatureLogoEn = SigningLogoBuilder.newSigningLogo ()
                .withLanguage (Locale.ENGLISH)
                .withImage ("dados: image / png; base64, xxxuQmCC")
                .Construir();
        signatureLogos.add (signatureLogoEn);
        // Criar logotipos de assinatura
        eslClient.getSigningStyleService (). saveSigningLogos (signatureLogos);
        Lista  createdSigningLogos = eslClient.getSigningStyleService (). GetSigningLogos ();

.NET SDK

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

Aí está. Depois de ler o blog de hoje, você tem uma idéia melhor de como enviar um logotipo personalizado para sua conta e os detalhes técnicos necessários.

Se você tiver alguma dúvida sobre este blog ou qualquer outra coisa relacionada à integração do OneSpan Sign ao seu aplicativo, visite o Fóruns da comunidade de desenvolvedores . Seu feedback é importante para nós!

Comunidade de desenvolvedores OneSpan Sign

Comunidade de desenvolvedores OneSpan Sign

Participe da comunidade de desenvolvedores do OneSpan Sign! Fóruns, blogs, documentação, downloads de SDK e muito mais.

Junte-se hoje