Pular para o conteúdo principal

Atributos de Segurança - Web PKI

Webpki Model

  • A instalação dos componentes do plugin WebPKI é realizada unicamente e de forma centralizada no (https://get.webpkiplugin.com) servido com HTTPS estrito e com avaliação "A" na SSL Labs.

  • Os componentes "Web Extension" são submetidos para as lojas oficiais de cada navegador suportado, e em seguida revisados e assinados digitalmente pelas lojas abaixo:

    • Chrome webstore;
    • Firefox ADD-NOS;
    • Edge Add-nos;
    • Safari App Store;
  • Os componentes “Web Extension” possui seu código-fonte principal em JavaScript na forma original, não-ofuscado e não-minificado, de forma que todas as operações podem ser avaliadas ou auditadas por terceiros.

  • O desenvolvimento do ecossistema do plugin WebPKI é realizado seguindo as melhores práticas de programação estando em conformidade com o que é exigido das plataformas oficiais da Microsoft e Apple.

  • Os componentes "Native App" que são instalados na máquina do usuário, são baixados através do domínio centralizado e são assinados digitalmente com CodeSign EV e com carimbo de tempo DigiCert com validade de 10 anos. De modo que a instalação é realizada de forma confiável e autenticada pelos sistemas operacionais sem nenhum alerta de segurança.

  • Os componentes "Native App" não necessitam de privilégios de administrador para sua execução.

  • Os componentes "Native App" dão preferência para comunicação com os certificados e chaves do usuário via API/Repositório padrão do sistema operacional, de forma que PINs ou senhas de autenticação não são trafegadas pelo "Native App", são gerenciadas diretamente entre os "Crypto Devices" e o sistema operacional.

Permissões da extensão​

Os componentes "Web Extension" pedem o menor conjunto de permissões de navegador que permite ao Web PKI funcionar. Todas as permissões abaixo são declaradas no manifesto da extensão, que acompanha o pacote publicado em cada loja e pode ser inspecionado por qualquer pessoa.

Permissões de execução​

PermissãoPor que o Web PKI precisa dela
nativeMessagingComunicar-se com o "Native App", o componente que acessa o repositório de certificados do sistema operacional para listar certificados e produzir assinaturas. Sem ela a extensão não tem acesso algum aos certificados.
storageGuardar as preferências e configurações do usuário, incluindo os sites já autorizados a acessar certificados e os módulos PKCS#11 que o usuário configurou.
downloadsBaixar o instalador do "Native App" pelo popup da extensão e abri-lo direto dali, para que o usuário não precise procurar o arquivo.
tabsUsada apenas durante a instalação da extensão e do "Native App": a extensão procura a página de instalação já aberta no navegador, para recarregá-la assim que a instalação termina.
content_scripts.matches (http://*/*, https://*/*, com all_frames)Executar o content script nas páginas dos clientes que usam o Web PKI. É por esse script que a página fala com a extensão, e o padrão não pode ser restringido porque cada cliente serve o Web PKI a partir do seu próprio domínio. As lojas dos navegadores classificam esse padrão como permissão de host.
observação

No Safari a extensão não pede downloads: ela é distribuída como aplicativo para macOS na App Store, que instala os componentes "Web Extension" e "Native App" juntos.

Autorização de acesso aos certificados​

Antes que uma página possa listar os certificados do usuário ou ler um certificado (listCertificates, readCertificate), a extensão pede autorização ao usuário, por site, em um diálogo com as opções Permitir, Sempre permitir e Negar. A resposta Sempre permitir fica guardada para aquele domínio, de modo que o usuário não é perguntado novamente para aquele site. Veja a entrada Extensão web 2.18.0 do changelog.

Coleta de dados declarada no Firefox​

A Mozilla exige que a extensão declare no manifesto as categorias de dados do usuário que ela manipula, e o Firefox mostra essa declaração ao usuário no momento da instalação. A extensão do Web PKI declara como obrigatórias as quatro categorias abaixo, em browser_specific_settings.gecko.data_collection_permissions:

CategoriaO que abrange
browsingActivityO hostname da página que faz a solicitação. Ele vai para o "Native App" junto com a licença, para que a licença seja conferida contra o domínio da página, e é o que identifica o site na autorização de acesso aos certificados.
personallyIdentifyingInfoO conteúdo do certificado digital entregue à página depois que o usuário autoriza aquele site: nome do titular, endereço de e-mail e identificadores fiscais (CPF, CNPJ, codice fiscale).
locationInfoOs campos de localidade do titular do certificado -- país, estado e cidade -- devolvidos junto com o certificado, depois que o usuário autoriza aquele site.
websiteContentOs dados ou o hash que a página fornece para serem assinados, cifrados ou enviados: documentos, hashes pré-calculados e as próprias solicitações.

O que a extensão não faz​

Os componentes "Web Extension" não fazem tracking, profiling nem analytics, não pedem acesso a histórico de navegação, cookies, favoritos ou área de transferência, e não interceptam requisições de rede. Também não carregam código remoto: todo script executado é o que vem no pacote revisado e assinado pela loja.

Ver em Markdown