Como ocultar regiões em arquivos PDF with C#

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

A ocultação de informações sensíveis em documentos PDF é crucial para garantir a privacidade e a conformidade com as normas de proteção de dados. A API [POST] Redact Region da IronSecure Doc oferece uma maneira eficiente de ocultar texto e informações confidenciais em regiões específicas de um documento PDF usando redação verdadeira. Esta API garante que os dados ocultados sejam completamente removidos e não possam ser recuperados, tornando-a ideal para lidar com informações confidenciais em documentos jurídicos, financeiros ou pessoais.

Puxe e inicie o IronSecureDoc

Se você ainda não tem o IronSecureDoc instalado, siga os links abaixo para configurá-lo:

Hospedagem local Implantação na nuvem

A API [POST] Redact Region

O endpoint da API [POST] Redact Region permite ocultar informações confidenciais em regiões específicas de um documento PDF usando redação verdadeira. Essa funcionalidade é crucial para aplicativos que gerenciam documentos confidenciais, como contratos legais, registros médicos ou demonstrações financeiras. Ao utilizar esta API, você pode garantir que textos sensíveis em áreas definidas de um PDF sejam removidos permanentemente, oferecendo segurança e conformidade.

ObserveUma vez que uma região é redigida, o conteúdo dentro dessa área não pode ser recuperado.

Testando com estilo

O Swagger é uma ferramenta poderosa que permite aos desenvolvedores interagir com APIs RESTful por meio de uma interface web amigável. Independentemente de você usar linguagens como Python, Java ou outras, o Swagger oferece uma maneira prática de testar e implementar essa API.

Passos para Redigir uma Região com o Swagger

  1. Acesse a interface do usuário do Swagger:

    Se o seu servidor de API estiver sendo executado localmente, você pode acessar o Swagger navegando para http://localhost:8080/swagger/index.html em seu navegador web.

    Documentos Swagger

  2. Localize o endpoint [POST] /v1/document-services/pdfs/redact-region:

    Dentro da interface do Swagger, encontre o endpoint POST /v1/document-services/pdfs/redact-region.

    Redigir regiões

  3. Especifique as coordenadas de redação:

    Neste exemplo, removeremos uma tabela do PDF na página de índice 1 (ou seja, página 2). Utilize as seguintes coordenadas para definir a região de redação:

    • Índice da página (specific_pages): 1
    • Coordenada X (region_to_redact_x): 60
    • Coordenada Y (region_to_redact_y): 270
    • Largura (region_to_redact_w): 470
    • Altura (region_to_redact_h): 200
  4. Defina os parâmetros opcionais:

    Opcionalmente, você pode adicionar uma senha de usuário ou proprietário, especificar páginas específicas ou decidir se deseja desenhar uma caixa preta sobre a área ocultada e salvar o documento em conformidade com PDF/A ou PDF/UA.

    Entrada Swagger

  5. Carregar um PDF de exemplo:

    No corpo da solicitação, faça o upload de um arquivo PDF de exemplo onde você deseja aplicar a redação. Certifique-se de que o arquivo seja adicionado como pdf_file.

  6. Execute a solicitação:

    Clique em "Executar" para executar a solicitação. A resposta incluirá o PDF com as informações ocultadas, com a tabela removida da página 1, conforme especificado.

    Resposta

    Essa interação com a interface do Swagger permite testar facilmente o processo de redação, fornecendo feedback imediato sobre como as coordenadas afetam o conteúdo do PDF.

  7. Verifique o PDF gerado:

    A parte ocultada estará na página 2.


Compreendendo os parâmetros de entrada

Antes de usar esta API, é essencial compreender os parâmetros de entrada obrigatórios e opcionais para redigir uma região no seu PDF. Esses parâmetros ajudam a definir a área específica a ser ocultada.

Parâmetros-chave

  • pdf_file: O documento PDF que você deseja redigir.
  • region_to_redact_x: Coordenada X da região a ser redigida (começando do canto inferior esquerdo da página).
  • region_to_redact_y: Coordenada Y da região a ser redigida (começando do canto inferior esquerdo da página).
  • region_to_redact_w: Largura da região a ser redigida.
  • region_to_redact_h: Altura da região a ser redigida.

Parâmetros opcionais

  • user_password: Se o PDF estiver protegido por senha, forneça a senha de usuário.
  • owner_password: Forneça a senha do proprietário se as modificações estiverem restritas.
  • specific_pages: Especificar quais páginas redigir. Caso não seja fornecida, a redação se aplica a todas as páginas.
  • save_as_pdfa: Salve o PDF com conformidade PDF/A-3.
  • save_as_pdfua: Salve o PDF com conformidade PDF/UA.

Integração de API: Exemplo em Python

Depois de se familiarizar com os parâmetros, você poderá chamar essa API usando sua linguagem de programação preferida. Abaixo, segue um exemplo de como integrar essa API usando Python.

import requests

# Define the API endpoint URL
url = 'http://localhost:8080/v1/document-services/pdfs/redact-region'

# Set the headers for the request (optional relevant metadata)
headers = {
    'accept': '*/*',
    'author': 'Iron Software',
    'title': 'REDACT REGION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

# Open the PDF file to be redacted in binary read mode
files = {
    'pdf_file': ('sample_file.pdf', open('sample_file.pdf', 'rb'), 'application/pdf')
}

# Define the coordinates and page for the redaction region
data = {
    'region_to_redact_x': '60',  # X-coordinate starting at the bottom-left
    'region_to_redact_y': '270', # Y-coordinate starting at the bottom-left
    'region_to_redact_w': '470', # Width of the region to be redacted
    'region_to_redact_h': '200', # Height of the region to be redacted
    'specific_pages': [1]        # Specify the page index to redact
}

# Make the POST request to the API with the provided parameters and file
response = requests.post(url, headers=headers, files=files, data=data)

# Save the redacted PDF response to a new file
with open('redacted_output.pdf', 'wb') as f:
    f.write(response.content)

print('PDF redacted successfully.')
import requests

# Define the API endpoint URL
url = 'http://localhost:8080/v1/document-services/pdfs/redact-region'

# Set the headers for the request (optional relevant metadata)
headers = {
    'accept': '*/*',
    'author': 'Iron Software',
    'title': 'REDACT REGION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

# Open the PDF file to be redacted in binary read mode
files = {
    'pdf_file': ('sample_file.pdf', open('sample_file.pdf', 'rb'), 'application/pdf')
}

# Define the coordinates and page for the redaction region
data = {
    'region_to_redact_x': '60',  # X-coordinate starting at the bottom-left
    'region_to_redact_y': '270', # Y-coordinate starting at the bottom-left
    'region_to_redact_w': '470', # Width of the region to be redacted
    'region_to_redact_h': '200', # Height of the region to be redacted
    'specific_pages': [1]        # Specify the page index to redact
}

# Make the POST request to the API with the provided parameters and file
response = requests.post(url, headers=headers, files=files, data=data)

# Save the redacted PDF response to a new file
with open('redacted_output.pdf', 'wb') as f:
    f.write(response.content)

print('PDF redacted successfully.')
PYTHON

Este código executa os seguintes passos:

  • Carregar o PDF: O arquivo PDF a ser editado é carregado do sistema de arquivos local.
  • Definir parâmetros de redação: especifique as coordenadas (X, Y), largura, altura e página específica a ser redigida.
  • Chamar a API: A API [POST] Redact Region é chamada, passando os parâmetros necessários.
  • Salvar o resultado: O PDF com as informações ocultadas é salvo como um novo arquivo.

A região indicada foi ocultada, conforme mostrado abaixo.

Saída redigida

Perguntas frequentes

Como posso ocultar regiões específicas em um arquivo PDF?

Você pode ocultar regiões específicas em um arquivo PDF usando a API [POST] Redact Region do IronSecureDoc. Ao fornecer as coordenadas e dimensões da área a ser ocultada, a API garante que as informações confidenciais sejam removidas permanentemente do documento.

Quais são os passos envolvidos na configuração da API IronSecureDoc para redação?

Para configurar a API IronSecureDoc para redação, você precisa baixar e iniciar a imagem do Docker, configurar a API usando o Swagger, especificar os parâmetros de redação e executar a chamada da API para redigir regiões em seus documentos PDF.

O IronSecureDoc pode ser usado em plataformas de nuvem?

Sim, o IronSecureDoc pode ser implementado em plataformas de nuvem como Azure e AWS, permitindo soluções de redação escaláveis e flexíveis.

Como faço para especificar quais áreas de um PDF devem ser ocultadas usando o IronSecureDoc?

Para especificar áreas a serem ocultadas usando o IronSecureDoc, você precisa fornecer as coordenadas X e Y, juntamente com a largura e a altura da região a ser ocultada. Esses parâmetros definem a área exata na página do PDF.

Existe alguma forma de testar o processo de redação antes da implementação completa?

Sim, você pode testar o processo de redação localmente executando o servidor da API IronSecureDoc e usando o Swagger para interagir com a API. Isso permite que você experimente parâmetros de redação e verifique a saída antes da implementação em larga escala.

Quais linguagens de programação podem ser usadas para integrar com a API do IronSecureDoc?

A API IronSecureDoc pode ser integrada a qualquer linguagem de programação capaz de fazer requisições HTTP, como Python, Java, C# e outras.

O que é a verdadeira redação em PDFs e por que ela é importante?

A verdadeira redação em PDFs garante que os dados sensíveis não sejam apenas ocultados, mas completamente removidos do documento. Isso é crucial para manter a confidencialidade e cumprir as normas de proteção de dados.

O IronSecureDoc é compatível com os padrões de conformidade de PDF?

Sim, ao salvar um PDF com informações ocultadas usando o IronSecureDoc, você pode optar pela conformidade com padrões como PDF/A-3 ou PDF/UA para atender a requisitos específicos do documento.

O IronSecureDoc consegue lidar com PDFs protegidos por senha para fins de redação?

Sim, o IronSecureDoc consegue lidar com PDFs protegidos por senha, fornecendo as senhas de usuário e proprietário necessárias como parâmetros opcionais durante o processo de redação.

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.