Orientação gerada a partir de informações públicas. Apenas para referência.
O pacote webcrypto fornece uma implementação multiplataforma da API de Criptografia da Web para o Flutter, permitindo operações criptográficas seguras como geração de chaves, criptografia, descriptografia e assinaturas digitais em Android, iOS, Web, macOS, Windows e Linux. Oferece uma interface consistente que reflete as APIs Web Crypto baseadas em navegadores, facilitando a implementação de manipulação segura de dados em aplicativos Flutter. O pacote é especialmente útil para aplicativos que exigem recursos de segurança robustos sem código específico de plataforma. É mantido pelo Google e aberto no GitHub.
Casos de uso
Criptografia de dados segura
verificação de assinatura digital
Gerenciamento de chaves
Criptografia multiplataforma
Manipulação segura de token
Principais recursos
Compatibilidade multiplataforma
Corresponde à especificação da API Web Crypto
Suporta criptografia simétrica e assimétrica
Open-source e mantido pela Google
Nenhum código nativo necessário
Indicado para
Aplicativos que precisam de armazenamento seguro de dados
Sistemas de autenticação
Protocolos de comunicação seguros
Aplicativos focados na privacidade
Desenvolvedores familiarizados com as APIs de Cripto da Web
Considerações
Requer entendimento de conceitos criptográficos
Não adequado para cargas de trabalho cripto-intensivas de alto desempenho
Depende do modelo assíncrono do Dart
Limitado a algoritmos padrão de Web Crypto
Pode exigir validação adicional para uso em produção
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
Cross-Platform Web Cryptography Implementation
This package provides a cross-platform implementation of the
Web Cryptography API.
Disclaimer: This is not an officially supported Google product.
This packages provides an implementation of the
Web Cryptography API across multiple platforms. Outside the
browser, this package features a native implementation embedding
BoringSSL using dart:ffi. When used inside a
web browser this package wraps the window.crypto APIs and
providing the same Dart API as the native implementation.
This way, package:webcrypto provides the same crypto API on Android, iOS, Web, Windows, Linux and Mac.
BoringSSL, Chrome and Firefox implementations pass the same test cases.
Missing:
Exceptions and errors thrown for invalid input is not tested yet.
The native implementation executes on the main-thread, however, all expensive
APIs are asynchronous, so they can be offloaded in the future.
For a discussion of the API design of this package,
see doc/design-rationale-md.
System dependencies
When you have a dependency on package:webcrypto, it will use
hooks to build BoringSSL. Thus, your system
must have:
cmake, and,
a C compiler (like gcc or clang)
Limitations
This package has a few limitations compared to the
Web Cryptography API. For a discussion of parity with
Web Cryptography APIs see doc/webcrypto-parity.md.
deriveKey is not supported, however, keys can always be created from
derivedBits which is supported.
wrapKey is not supported, however, keys can be exported and encrypted.
unwrapKey is not supported, however, keys can be decrypted and imported.
AES-KW is not supported because it does not support encrypt/decrypt.
Compatibility notes
This package has many tests cases to asses compatibility across the native
implementation using BoringSSL and various browser implementations of the
Web Cryptography APIs.
At the moment compatibility testing is limited to native implementation,
Chrome, Firefox and Safari.
Known Issues:
Chrome and BoringSSL does not support valid ECDH spki-formatted keys exported
by Firefox prior to version 72.
Firefox does not support PKCS8 import/export for ECDSA and ECDH keys.
Firefox does not handle counter wrap around for AES-CTR.
Safari does not support P-521 for ECDSA and ECDH.
The browser implementation of streaming methods for encryption,
decryption, signing and verification buffers the entire input, because
window.crypto does not expose a streaming API. However, the native
implementation using BoringSSL does support streaming.
In browsers, operations backed by window.crypto.subtle require a secure
context. When loaded from an insecure context, package:webcrypto throws
UnsupportedError for those operations with guidance to use HTTPS or a
trustworthy local origin such as localhost. fillRandomBytes() continues
to work because it uses window.crypto.getRandomValues(), which browsers
expose outside secure contexts.