How to use IronSecureDoc from C# in .NET

This article was translated from English: Does it need improvement?
Translated
View the article in English

Sua porta de entrada para segurança documental aprimorada

IronSoftware.SecureDoc.Client é uma biblioteca robusta do lado do cliente projetada para interagir perfeitamente com a API IronSecureDoc, uma solução abrangente de segurança de documentos hospedada em um contêiner Docker.

Esta biblioteca cliente facilita a integração com seus aplicativos .NET existentes, permitindo que você aproveite os poderosos recursos do IronSecureDoc, incluindo criptografia de PDF, redação e assinatura digital, tudo por meio de chamadas simples à API REST.

Com IronSoftware.SecureDoc.Client, os desenvolvedores podem garantir a segurança e a integridade dos documentos dentro de suas aplicações, mantendo todas as operações no local para maior proteção de dados. Se você precisar redigir informações sensíveis, certificar documentos com assinaturas digitais ou aplicar criptografia a documentos, IronSoftware.SecureDoc.Client fornece as ferramentas necessárias para realizar essas tarefas de forma eficiente e segura.

Características

Principais características:

  • Fácil integração com a API REST do IronSecureDoc.
  • Suporte para criptografia, redação e assinatura digital de documentos.
  • Facilita o processamento seguro de documentos em ambientes auto-hospedados.
  • Aprimora a proteção de dados, mantendo as operações de segurança de documentos no local.
  • Compatível com aplicações .NET , oferecendo uma abordagem simples para a gestão segura de documentos.

Instalação

Vamos começar instalando o pacote NuGet a partir do gerenciador de pacotes:

Opção 1: Baixar do NuGet

O pacote NuGet está listado aqui no site oficial do NuGet : https://www.nuget.org/packages/IronSoftware.SecureDoc.Client

Opção 2: Comando de instalação PM

Install-Package IronSoftware.SecureDoc.Client

Exemplo de código

using IronSecureDoc;
using System.IO;
using System.Threading.Tasks;

// Example illustrating how to use the IronSecureDocClient
class SecureDocExample
{
    static async Task Main(string[] args)
    {
        // Replace with your IRONSECUREDOC URL
        var client = new IronSecureDocClient("http://localhost:5185");

        // Replace with your PDF or CERT paths
        string PDF_PATH = "path/to/your.pdf";
        string CERT_PATH = "path/to/your.p12";

        // Attempt to connect to the IronSecureDoc API
        if (await client.TryConnectAsync())
        {
            // Redact Text
            File.WriteAllBytes(
                "redact_text_example.pdf",
                await client.RedactTextAsync(PDF_PATH, new[] { "Dummy" })
            );

            // Redact Region
            File.WriteAllBytes(
                "redact_region_example.pdf",
                await client.RedactRegionAsync(PDF_PATH, 50, 50, 200, 100)
            );

            // Certify
            File.WriteAllBytes(
                "certify_example.pdf",
                await client.CertifyAsync(PDF_PATH, CERT_PATH, "123456", CertifyPermissions.FormFillingAllowed)
            );

            // Encrypt
            File.WriteAllBytes(
                "encrypt_example.pdf",
                await client.EncryptAsync(PDF_PATH, "iron")
            );
        }
    }
}
using IronSecureDoc;
using System.IO;
using System.Threading.Tasks;

// Example illustrating how to use the IronSecureDocClient
class SecureDocExample
{
    static async Task Main(string[] args)
    {
        // Replace with your IRONSECUREDOC URL
        var client = new IronSecureDocClient("http://localhost:5185");

        // Replace with your PDF or CERT paths
        string PDF_PATH = "path/to/your.pdf";
        string CERT_PATH = "path/to/your.p12";

        // Attempt to connect to the IronSecureDoc API
        if (await client.TryConnectAsync())
        {
            // Redact Text
            File.WriteAllBytes(
                "redact_text_example.pdf",
                await client.RedactTextAsync(PDF_PATH, new[] { "Dummy" })
            );

            // Redact Region
            File.WriteAllBytes(
                "redact_region_example.pdf",
                await client.RedactRegionAsync(PDF_PATH, 50, 50, 200, 100)
            );

            // Certify
            File.WriteAllBytes(
                "certify_example.pdf",
                await client.CertifyAsync(PDF_PATH, CERT_PATH, "123456", CertifyPermissions.FormFillingAllowed)
            );

            // Encrypt
            File.WriteAllBytes(
                "encrypt_example.pdf",
                await client.EncryptAsync(PDF_PATH, "iron")
            );
        }
    }
}
$vbLabelText   $csharpLabel

Explicação

  • Inicialização do IronSecureDocClient: Inicialize o IronSecureDocClient com a URL para o seu servidor IRONSECUREDOC.
  • Conectando: Use TryConnectAsync() para verificar a conexão com o servidor.
  • Redigir Texto: Defina palavras/frases sensíveis para redigir usando RedactTextAsync.
  • Redigir Região: Redija regiões específicas especificando coordenadas com RedactRegionAsync.
  • Certificar: Adicione uma certificação digital com CertifyAsync. Forneça o caminho para o arquivo de certificação e uma senha.
  • Criptografar: Proteja o documento criptografando-o usando EncryptAsync.

Apoiar

Para obter suporte, entre em contato conosco: support@ironsoftware.com

Perguntas frequentes

Como posso integrar recursos de segurança de documentos em meu aplicativo .NET?

Você pode integrar recursos de segurança de documentos usando a biblioteca IronSoftware.SecureDoc.Client. Isso permite realizar operações como criptografia de PDF, redação e assinatura digital por meio de chamadas à API REST.

Quais são os passos envolvidos na instalação do cliente IronSecureDoc em um projeto C#?

Para instalar o cliente IronSecureDoc em um projeto C#, você pode baixar o pacote IronSoftware.SecureDoc.Client do NuGet ou usar o comando do Gerenciador de Pacotes: Install-Package IronSoftware.SecureDoc.Client .

Posso realizar a redação de texto em documentos PDF com esta solução?

Sim, é possível redigir texto em documentos PDF usando o método RedactTextAsync , que permite especificar as palavras ou frases que você deseja ocultar.

Como posso garantir que minhas operações com documentos permaneçam seguras e no local?

O uso do IronSecureDoc mantém as operações de documentos seguras e no local, integrando-se à API do IronSecureDoc, uma solução hospedada em Docker, garantindo que todos os processos de segurança sejam tratados localmente.

Quais são as funcionalidades que a API IronSecureDoc oferece para gerenciamento de documentos?

A API IronSecureDoc oferece funcionalidades como criptografia de documentos, redação, assinatura digital e facilita o processamento seguro de documentos em ambientes auto-hospedados.

Como faço para certificar um documento PDF com uma assinatura digital?

Para certificar um documento PDF com uma assinatura digital, utilize o método CertifyAsync , fornecendo o caminho para o arquivo de certificação e a senha necessária.

Como posso criptografar um documento PDF em minha aplicação C#?

Você pode criptografar um documento PDF em sua aplicação C# usando o método EncryptAsync , que protege o documento com uma senha especificada.

É possível ocultar regiões específicas em um documento PDF?

Sim, é possível ocultar regiões específicas em um documento PDF usando o método RedactRegionAsync , que exige que você especifique as coordenadas da área que deseja ocultar.

O que devo fazer se encontrar problemas ao usar o cliente IronSecureDoc?

Caso encontre problemas ao usar o cliente IronSecureDoc, entre em contato com a equipe de suporte da IronSoftware por e-mail, no endereço support@ironsoftware.com, para obter assistência.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Versão: 2024.10 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas?
executar um exemplo Veja seu PDF ser criptografado.