Pular para o conteúdo principal

Assinaturas em dispositivos móveis

Quem assina em um computador pode usar o Web PKI para acessar o certificado digital armazenado no próprio computador, em um token criptográfico ou em um smart card. No celular isso não funciona. Por isso, um recurso de assinatura no celular começa com uma escolha: onde estará a chave privada no momento em que o titular assinar?

Este artigo compara as quatro respostas que os produtos da Lacuna oferecem e indica a documentação, os exemplos e as demos de cada uma:

  1. Um certificado em nuvem armazenado em um PSC, pelo CloudHub
  2. Um certificado dentro do aplicativo do Web PKI
  3. Uma chave armazenada no seu servidor ou em um HSM
  4. Um token em uma estação de trabalho, acionado pelo celular com o TrustBridge

Por que o celular é diferente​

No computador, uma assinatura web usa o Web PKI: uma extensão do navegador e um componente nativo que acessam o repositório de certificados do sistema operacional (onde costuma ficar um certificado A1) e o token ou smart card em que está armazenado um certificado A3. A página pede ao Web PKI que assine, e a chave privada nunca sai da máquina do usuário.

O celular não tem nenhum desses componentes. Os navegadores móveis não executam a extensão do Web PKI, uma página web não tem acesso ao repositório de chaves do próprio celular, e os tokens USB e smart cards que armazenam certificados A3 não são suportados em celulares. Então a chave privada precisa estar em um lugar que o celular consiga acessar de outra forma: em um Prestador de Serviço de Confiança (PSC), dentro de um aplicativo, no seu servidor ou em um computador que continua ligado.

1. Um certificado em nuvem armazenado em um PSC, pelo CloudHub​

Em um certificado em nuvem, a chave privada fica armazenada no HSM de um PSC credenciado pelo ITI na ICP-Brasil. O titular autoriza cada uso no aplicativo do próprio PSC, com um PIN, uma notificação push ou um QR code. Entre os PSCs brasileiros estão o BirdID (Soluti), o SafeID (Safeweb), o VIDaaS (Valid), o RemoteID (Certisign) e o NeoID (Serpro).

O CloudHub integra a sua aplicação a todos eles por uma única API REST: descobre em quais PSCs o CPF do signatário tem certificado, redireciona o usuário ao PSC escolhido para que ele autorize a assinatura e assina o hash calculado pela sua biblioteca de assinatura. O documento não sai do seu servidor, e a chave privada não sai do PSC.

Como fica no celular. A sua página redireciona o navegador ao PSC, o aplicativo do PSC abre, o titular aprova a assinatura nele e o navegador volta para a sua página. O retorno é a única diferença entre os sistemas operacionais:

  • No Android, o aplicativo do PSC consegue devolver o usuário ao navegador automaticamente.
  • No iOS, o aplicativo do PSC não pode devolver o usuário ao navegador automaticamente. Depois de aprovar, o próprio usuário volta ao navegador. Avise isso na sua página antes de redirecioná-lo, por exemplo: "depois de aprovar no aplicativo do seu PSC, volte para esta aba".

A integração é a mesma do computador. As chamadas ao CloudHub, a sessão, a URI de redirecionamento e a assinatura são idênticas; só o aviso do iOS é específico do celular. Siga Como funciona e Assinando um PDF.

Vários documentos, uma autorização. Crie a sessão com o tipo SignatureSession e um tempo de vida suficiente para o lote: o usuário aprova uma vez e o seu servidor assina todos os documentos com a mesma sessão. Veja Tipos de sessão.

O que o usuário precisa ter. Um certificado em nuvem. Um certificado em token ou em arquivo é outro certificado: quem hoje assina com um token A3 precisa emitir um certificado em nuvem em um PSC. A emissão é feita a distância, com a validação da identidade por videoconferência, costuma levar cerca de uma hora e custa em torno de R$ 150, conforme o provedor.

Uma organização que queira operar o seu próprio PSC pode fazê-lo com o Lacuna PSC e o Amplia.

2. Um certificado dentro do aplicativo do Web PKI​

O aplicativo do Web PKI, para Android e iOS, armazena certificados no repositório de chaves do celular e permite que páginas web assinem com eles. Toda assinatura exige uma autenticação biométrica; uma autenticação bem-sucedida vale para as assinaturas seguintes por 2 minutos, só no mesmo site e só enquanto o aplicativo estiver em primeiro plano. O titular importa um certificado A1 (um arquivo .pfx) para o aplicativo lendo um QR code.

O aplicativo pode ser usado de três formas:

  • Assinando no celular, dentro do aplicativo. A sua página de assinatura abre dentro do aplicativo, por um deep link ou por um QR code. O aplicativo exibe a página no próprio navegador interno e responde à biblioteca JavaScript do Web PKI em vez da extensão; assim, uma página que assina com o Web PKI no computador também assina no celular.
  • Assinando dentro do seu próprio aplicativo. Uma organização que tenha um aplicativo próprio para Android, iOS ou Flutter pode incorporar nele o mesmo recurso de assinatura. Fale com o suporte da Lacuna.
  • Aprovando no celular uma assinatura iniciada no computador. O usuário pareia o aplicativo com a extensão do Web PKI em um computador lendo um QR code. A partir daí, quando uma página nesse computador pede uma assinatura com o certificado do celular, o pedido chega ao celular como notificação e o usuário o aprova ali.

O que o usuário precisa ter. O aplicativo, com um certificado A1 importado. Um certificado A3 não pode ser importado: a chave privada dele nunca sai do token ou do smart card.

3. Uma chave armazenada no seu servidor ou em um HSM​

A sua aplicação armazena a chave privada do usuário e assina no servidor quando ele solicita. Um certificado A1 fica armazenado de forma criptografada; uma chave A3 é gerada e armazenada em um HSM, como um HSM de rede ou o Azure Key Vault. O usuário se autentica na sua aplicação com um PIN e, opcionalmente, com outros fatores, como um código de uso único ou biometria, e o servidor assina.

Esta é a melhor experiência no celular: uma página web comum, sem aplicativo para instalar, sem redirecionamento ao PSC e sem diferença entre iOS e Android. Um lote é assinado de uma vez, depois de uma única autenticação.

O preço é a responsabilidade: o seu serviço passa a ter a custódia de chaves privadas que pertencem a pessoas. Proteja-as como um PSC faria: com a chave criptografada ou em um HSM, com um PIN que só o titular conhece e que a sua aplicação nunca armazena, e com um registro de cada autorização.

Para implementar:

4. Um token em uma estação de trabalho, acionado pelo celular com o TrustBridge​

Alguns usuários já assinam com tokens ou smart cards A3 que ficam conectados a um computador Windows sempre ligado, como acontece em hospitais. O TrustBridge permite que eles assinem de qualquer lugar, inclusive do celular, enquanto a chave privada continua no token.

O Workstation Service do TrustBridge roda no computador e se conecta ao Servidor do TrustBridge. A sua aplicação, que o usuário acessa pelo celular, chama a API REST do Servidor com o CPF e o PIN do usuário para abrir uma Sessão de Assinatura e depois envia os PDFs a assinar, um por vez ou até 50 em uma só chamada. O Servidor pede à estação de trabalho em que o token está conectado que assine o hash e usa o Lacuna Signer ou o Rest PKI Core para montar o PDF assinado.

Pontos de atenção:

  • O computador precisa estar ligado, com o token conectado. Peça ao titular que digite o PIN do token no Tray App do TrustBridge ao conectá-lo. Quando o PIN não está em cache naquele computador, o TrustBridge o pede no Tray App, na tela do computador, e quem assina pelo celular não tem como responder.
  • O celular e o computador não precisam estar na mesma rede. As estações de trabalho se conectam ao Servidor por conexões de saída e não abrem nenhuma porta de entrada. Quando o Servidor fica em uma rede privada, os computadores externos a ela o acessam por VPN. Veja Postura de rede.
  • O PIN do usuário nunca é enviado à estação de trabalho. O Servidor valida uma prova que a estação calcula a partir do PIN que o titular digitou nela. Veja Segurança.

Comparando as abordagens​

Certificado em nuvem (CloudHub)Aplicativo do Web PKIChave no seu servidor ou HSMToken em uma estação de trabalho (TrustBridge)
Experiência no celularVai ao aplicativo do PSC, aprova e voltaAssina dentro do aplicativo, com autenticação biométricaUma página web e um PINUma página web e um PIN
Onde a chave privada fica armazenadaNo HSM do PSCNo repositório de chaves do celularNo seu servidor ou HSMNo token, no computador do usuário
O que o usuário precisa terUm certificado em nuvem de um PSCO aplicativo, com um A1 importadoNada além da sua aplicaçãoUm computador ligado, com o token conectado
A1 / A3Certificado em nuvem (nem arquivo A1 nem token A3)Só A1A1 criptografado, A3 em um HSMA3 em token, ou A1 no repositório de certificados do Windows
iOS / AndroidNo iOS, o próprio usuário volta ao navegadorOs doisOs dois, sem diferençaOs dois, sem diferença
Quem tem a custódia da chaveO PSCO usuárioVocêO usuário
ImplementaçãoBaixa: a mesma integração do computador, mais um aviso para o iOSBaixa para uma página com o Web PKI; maior para incorporar ao seu aplicativoMédia: custódia das chaves e autenticação do usuárioMédia: um Servidor do TrustBridge e as estações de trabalho

Como escolher. Se os seus usuários podem emitir um certificado em nuvem, o CloudHub oferece uma assinatura no celular que funciona em qualquer lugar, com pouco código. Se eles precisam continuar com os tokens A3 que já têm, o TrustBridge mantém esses tokens em uso. Se você pode assumir a custódia das chaves, uma chave no servidor ou em um HSM oferece a experiência mais simples. O aplicativo do Web PKI atende a usuários com certificado A1 dispostos a instalar um aplicativo e cobre o caso de uma assinatura iniciada no computador e aprovada no celular.

Uma aplicação pode oferecer mais de uma abordagem: quem tem certificado em nuvem assina pelo CloudHub, e os demais usam uma das outras.

Implemente em duas etapas​

Seja qual for a abordagem, prefira uma assinatura em duas etapas: o servidor prepara a assinatura e calcula o hash a assinar, a chave privada assina só esse hash e o servidor conclui o documento assinado. O documento fica no seu servidor, trafegam só alguns kilobytes e o mesmo código de servidor atende às quatro abordagens:

AbordagemQuem assina o hash
Certificado em nuvemO CloudHub, no PSC
Aplicativo do Web PKIO Web PKI, no aplicativo
Chave no seu servidor ou HSMO seu servidor, com o PKI SDK ou o HSM
TrustBridgeA estação de trabalho, pela Assinatura de hash ou pelos endpoints de PDF

Veja Assinaturas web remotas e Assinaturas em duas etapas com o Rest PKI Core.

Exemplos e demos​

O quadro abaixo lista os exemplos do PKI Suite Samples para cada componente: uma assinatura PAdES em duas etapas com o PKI SDK ou o Rest PKI Core, uma chave armazenada no servidor, um certificado em nuvem pelo CloudHub e um lote de PDFs.

Para experimentar uma assinatura com certificado em nuvem pelo celular, abra Assinar um arquivo (Certificado em nuvem, com CloudHub) no site de demos da Lacuna.

Ver em Markdown