
O Projeto Wycheproof testa bibliotecas criptográficas contra ataques conhecidos.
O Project Wycheproof é um repositório gerido pela comunidade de vetores de teste que podem ser usados por programadores de bibliotecas de criptografia para testar contra ataques conhecidos, inconsistências de especificação e outros vários bugs de implementação.
Os vetores de teste são mantidos como dados de vetores de teste JSON, com ficheiros esquema JSON acompanhantes que documentam a estrutura dos dados dos vetores de teste.
Pode achar útil examinar como outros projetos como pyca/cryptography integraram os vetores de teste do Wycheproof.
O Project Wycheproof tem vetores de teste para os algoritmos criptográficos mais populares, incluindo
Os vetores de teste detetam se uma biblioteca é vulnerável a muitos ataques, incluindo
Acolhemos com agrado contribuições de novos dados de vetores de teste e algoritmos.
Se quiser contribuir, leia CONTRIBUTING e envie-nos pull requests. Também pode reportar bugs ou solicitar novos testes como GitHub issues.
Estamos no processo de revitalizar o desenvolvimento e manutenção do Project Wycheproof como um projeto C2SP com um foco renovado nos dados dos vetores de teste.
A nossa prioridade imediata é adicionar cobertura adicional de algoritmos e casos de teste aos dados dos vetores de teste.
O Project Wycheproof tem o nome do Monte Wycheproof, a montanha mais pequena do mundo. A principal motivação para o projeto na altura da sua criação era ter um objetivo que fosse alcançável. Quanto mais pequena a montanha, mais provável é conseguir escalá-la.
Os vetores de teste do Wycheproof são usados de alguma forma por vários importantes projetos e bibliotecas de criptografia. Sem qualquer ordem particular, estes incluem:
Se o seu projeto usa vetores de teste do Wycheproof, sinta-se à vontade para abrir um PR para adicioná-lo à lista acima!
Consulte doc/bugs.md para alguns bugs históricos notáveis encontrados usando os harnesses de teste do Wycheproof, ou os dados de vetores de teste.
testvectors/?Recentemente, combinamos os diretórios testvectors/ e testvectors_v1/ em
um único diretório unificado com uma abordagem consistente para esquemas.
Usuários que precisam dos dados originais de vetores de teste ("v0") podem clonar este repositório a partir
da tag wycheproof-v0-vectors, mas são incentivados a considerar a atualização para
usar testvectors_v1/ para se beneficiar de atualizações futuras. Se houver recursos/cobertura de teste
de testvectors/ ausentes em testvectors_v1/, ou se houver outro
problema bloqueando sua atualização, abra uma issue descrevendo suas necessidades.
Alguma documentação legada para arquivos, formatos e tipos está disponível, mas não necessariamente sincronizada com o estado atual dos vetores de teste.
Em geral, prefira consultar os arquivos de esquema, pois estes são testados na CI para garantir que o conteúdo dos arquivos de vetores corresponda ao esquema anunciado.
Historicamente, o Wycheproof também incluía harnesses de teste (por exemplo, para implementações
de criptografia Java e Javascript) que testavam uma variedade de ataques
diretamente contra as implementações. Desde a transição para o suporte comunitário,
esses harnesses [foram removidos][harness-rm] (mas ainda existem no histórico do git
para os interessados em [cd27d64]). Nosso foco atual está em
vetores de teste agnósticos de implementação.