Muitos desenvolvedores começam procurando bibliotecas de componentes de UI quando precisam exibir documentos em uma aplicação web. Doconut Visualizador é um SDK .NET para adicionar visualização no navegador sem plugins ao ASP.NET Core, MVC ou projetos clássicos WebForms. A segurança ainda depende da arquitetura completa da aplicação: autenticação, autorização, transporte, armazenamento, validação, limpeza, correções e monitoramento.
1. Instale o SDK Doconut App e Prepare Seu Projeto .NET para Múltiplos Formatos de Arquivo
1.1 Adicione o pacote suportado
Use o pacote atual e as instruções de configuração da página oficial de download do Doconut: página de download do Doconut. Registre a versão escolhida e verifique se ela suporta o runtime .NET de destino.
1.2 Verifique a referência do pacote
Após a instalação, confirme a referência do pacote e a versão resolvida no arquivo de projeto. Manter as versões explícitas ajuda a tornar as compilações e implantações reproduzíveis.
1.3 Habilite HTTPS
Sirva a aplicação via HTTPS para que os documentos enviados não circulem em texto claro na sua rede. Para um aplicativo hospedado no Kestrel, adicione uma configuração de endpoint em appsettings.json:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
Se você hospedar no IIS, vincule um certificado HTTPS ao site. Com HTTPS habilitado, o arquivo viaja por um canal seguro até o seu próprio servidor, que é onde o SDK o renderiza.
De onde vem a segurança. O SDK roda dentro da sua aplicação, na sua infraestrutura: ele não faz chamadas para servidores Doconut, portanto os documentos nunca deixam sua rede. Essa é a propriedade que vale a pena projetar. Não se trata de um certificado de conformidade — o SDK não inclui ISO 27001, SOC 2 ou atestado HIPAA próprio, e não pode conceder um à sua aplicação. O que ele faz é manter o arquivo dentro de um limite que você já controla e já audita.
2. Configure Uploads de Arquivo Seguros e Armazenamento para Gerenciamento de Documentos
Esta é a parte que cabe a você, não ao SDK, e vale a pena dizer claramente: segurança de transporte, criptografia em repouso, retenção e limpeza são decisões que sua aplicação toma. O SDK renderiza documentos; ele não é uma camada de armazenamento e não criptografa seu disco por você.
2.1 Registre os serviços
Em Startup.cs (ou Program.cs nas versões modernas do .NET), registre os serviços Doconut no contêiner de injeção de dependência seguindo a documentação da versão que você instalou. Onde o SDK precisar de uma pasta de trabalho para saída temporária de renderização, aponte para um local que você controla e faça a limpeza dessa pasta sua responsabilidade — um job agendado ou um tempo de vida gerenciado pela aplicação, não uma suposição.
2.2 Crie o endpoint de upload
Implemente uma ação de controlador que receba um arquivo enviado, grave-o no armazenamento que sua aplicação já utiliza e retorne um token de uso único. O token é o que o visualizador do lado cliente usará para buscar e renderizar o documento. Observe que o armazenamento é sua responsabilidade: você fornece ao SDK os bytes ou o caminho quando chega a hora de renderizar, e ele devolve as páginas.
2.3 Proteja o endpoint
Como o endpoint de upload lida com dados sensíveis, proteja-o com autenticação e autorização baseada em papéis (por exemplo, apenas usuários com a função DocumentViewer podem fazer upload). Valide a extensão e o tamanho no servidor, bem como no navegador, e trate os bytes enviados como entrada não confiável.
Não ignore isso assumindo que o SDK cobre isso. Criptografia em repouso, gerenciamento de chaves e limpeza de arquivos órfãos são tarefas da sua aplicação. Se precisar que os documentos sejam criptografados no disco, use as facilidades da plataforma que já confia para isso — o visualizador não é o local adequado para isso.
3. Incorporar o Componente Viewer no ASP.NET Core, MVC ou WebForms
Com o backend pronto, inicialize o viewer usando os recursos e a API documentados para a versão instalada do Doconut.
3.1 Adicionar o pacote JavaScript
No seu layout compartilhado, inclua apenas os recursos do viewer descritos na documentação que correspondem ao SDK instalado. Não presuma nomes ou locais de pacotes fixos entre versões.
3.2 Criar uma view Razor para Core/MVC
Adicione uma view (por exemplo, Views/Document/View.cshtml) que contenha um campo de arquivo, um elemento contêiner para o viewer e um pequeno script que faça o upload do arquivo selecionado, receba o token seguro e inicialize o widget Doconut Viewer.
O script deve:
- Capturar o arquivo selecionado do elemento
<input type="file">. - Enviar o arquivo para o endpoint de upload usando
fetchouXMLHttpRequest. - Quando a resposta autorizada chegar, inicializar o viewer usando a API suportada para a versão instalada.
3.3 Equivalente WebForms
Em uma página WebForms (por exemplo, DocumentViewer.aspx), coloque um controle asp:FileUpload, um botão para disparar o upload e um <div> que hospedará o viewer. No code‑behind, chame o serviço Doconut para armazenar o arquivo enviado, obtenha o token e registre um script de inicialização que chame uma função JavaScript (initViewer(token)) para criar a instância do viewer.
O motivo para fazer desta forma: um caminho de renderização que atende a três modelos de UI .NET, sem nada instalado na máquina do usuário final.
4. Personalizar o Viewer para Gerenciamento de Documentos
O viewer é renderizado dentro de um contêiner na sua própria página, portanto a aplicação ao redor já é sua. Além disso, use os nomes das opções e os valores padrão da documentação da versão que você instalou, e não de nenhum tutorial, inclusive este — a superfície de configuração muda entre lançamentos e um nome de opção codificado é o que mais provavelmente quebrará na atualização.
As decisões importantes a serem tomadas antecipadamente:
4.1 Quais controles o usuário recebe
Decida se seus usuários devem poder baixar o arquivo original ou apenas ler as páginas renderizadas. A impressão controlada faz parte do viewer, não de uma compra separada, portanto as regras de impressão são uma questão de configuração, não de licenciamento.
4.2 Quais plugins você realmente precisa
Quatro são licenciados separadamente, e a lista é curta o suficiente para valer a pena memorizar: Annotation, Converter, DICOM e Search. Conversão — DOC para PDF e o resto — é o plugin Converter. Busca de texto é o plugin Search. Se você não precisar de nenhum deles, não compre nenhum.
4.3 Localização
Se sua aplicação for multilíngue, verifique o que a versão instalada oferece em termos de strings da UI do viewer antes de projetar em torno delas.
Por que isso importa: o viewer deve parecer parte do seu produto. O que ele não deve fazer é prometer silenciosamente aos seus usuários recursos que a licença que você comprou não inclui.
5. Testar a Integração em Todos os Formatos Suportados
Antes de entrar em produção, execute uma rápida verificação de sanidade para cada tipo de arquivo que você espera que seus usuários visualizem. Usando o viewer do Doconut App, abra um arquivo de exemplo de cada formato e verifique se a renderização, navegação e quaisquer ferramentas especializadas funcionam conforme descrito.
| Formato | Cenário de Teste | Resultado Esperado |
|---|---|---|
| Relatório grande, multipágina com imagens incorporadas | Rolagem suave, zoom e renderização de cores precisa | |
| DOCX | Documento Word com tabelas e notas de rodapé | Todo texto, tabelas e notas de rodapé visíveis; sem deslocamento de layout |
| XLSX | Planilha com gráficos | Gráficos são renderizados como vetores; o zoom mantém a clareza |
| PPTX | Apresentação com construções animadas | Cada construção em um slide é renderizada empilhada em um quadro — isso é esperado, não um erro |
| DWG | Desenho técnico com camadas e referências externas | Camadas podem ser alternadas, medições de distância e área funcionam; xrefs e fontes SHX estão ausentes porque nunca estavam no arquivo |
| PSD | Arquivo Photoshop com camadas | O composto salvo é renderizado, com camadas ocultas permanecendo ocultas; as cores mantêm‑se no zoom |
| SVG | Gráfico vetorial com gradientes | Gradientes são renderizados suavemente; o zoom permanece nítido |
| TIFF | Digitalização de alta resolução | Imagem carrega rapidamente; o zoom revela detalhes |
Teste com arquivos reais dos seus usuários, não com amostras limpas. Os formatos que surpreendem as pessoas são aqueles cujas peculiaridades estão no próprio formato — um DWG que referencia quatro outros desenhos, uma planilha cujos valores armazenados nunca foram recalculados, uma apresentação cujas fontes não foram incorporadas. O viewer gratuito em Doconut.app usa o mesmo motor, portanto é uma maneira rápida de ver como um arquivo específico e problemático será exibido antes de escrever qualquer código.
Conclusão
Incorporar um visualizador de documentos sem plugins se resume a quatro coisas: instalar o SDK, proteger seu próprio caminho de upload, renderizar em um contêiner na sua página e configurar apenas o que a versão instalada documenta. A contribuição do visualizador para a segurança é estreita e real — ele roda nos seus servidores e não envia nada para fora. Todo o resto dessa lista é da sua aplicação, e nenhum SDK pode assumir isso por você.
Pronto para avaliá-lo? Comece com a página oficial de download e documentação do Doconut, então teste o SDK dentro da mesma revisão de segurança aplicada ao restante da sua aplicação ASP.NET baseada em Windows.