How to Redact Text in C# PDF with IronSecureDoc

Curtis Chau

Updated: 9 de maio de 2026

Download IronSecureDoc

• DockerHub Download

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # How to Redact Text in C# PDF with IronSecureDoc Neste artigo, discutiremos a redação de texto em um PDF usando o IronSecureDoc. Isso permite que o serviço ou processo redija rapidamente e facilmente informações confidenciais com uma simples solicitação `POST` com o PDF para o servidor IronSecureDoc em execução. Iremos demonstrar isso visualmente através do uso de documentos Swagger. A solicitação `POST` aceita parâmetros obrigatórios e opcionais e é altamente personalizável; A resposta retorna o PDF com o texto ocultado. <div class="hsg-featured-snippet"> <h2>Como ocultar texto em um PDF com o IronSecureDoc</h2> <ol> <li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://hub.docker.com/r/ironsoftwareofficial/ironsecuredoc">Baixe e inicie a imagem Docker do IronSecureDoc.</a></li> <li>Teste a API usando o Swagger.</li> <li>Especifique o texto a ser ocultado.</li> <li>Execute a chamada da API com os detalhes fornecidos.</li> <li>Exporte o documento PDF com as informações ocultadas.</li> </ol> </div> ## Puxe e inicie o IronSecureDoc Se você ainda não tem o IronSecureDoc instalado, siga os links abaixo para configurá-lo: <table class="table"> <tr style="background-color: rgb(241 249 251);"> <th style="text-align: center;">Hospedagem local</th> <th style="text-align: center;">Implantação na nuvem</th> </tr> <tr> <td style="vertical-align: top;"> <ul> <li><a href="/enterprise/securedoc/tutorials/hosting-windows/">Hospedagem no Windows</a></li> <li><a href="/enterprise/securedoc/tutorials/hosting-mac/">Hospedagem no Mac</a></li> <li><a href="/enterprise/securedoc/tutorials/hosting-linux/">Hospedagem em Linux</a></li> </ul> </td> <td style="vertical-align: top;"> <ul> <li><a href="/enterprise/securedoc/tutorials/set-up-azure/">Implantação em contêineres do Azure</a></li> <li><a href="/enterprise/securedoc/tutorials/set-up-aws/">Implantação em contêineres da AWS</a></li> </ul> </td> </tr> </table> ## A API [POST] Redact Text O endpoint da API [POST] Redact Text permite ocultar texto sensível em um documento PDF usando redação. Essa funcionalidade é essencial para aplicações que lidam com documentos confidenciais, como contratos legais, registros médicos ou relatórios financeiros. O uso desta API garante a remoção permanente de textos específicos, proporcionando maior segurança e assegurando a conformidade com os padrões de proteção de dados. [[i:(Uma vez que um texto é redigido, o conteúdo não pode ser recuperado.)]] ## Arrogância 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 Texto com Swagger 1. **Acesse a interface do usuário do Swagger:** Se o servidor da sua API estiver sendo executado localmente, você pode acessar o Swagger navegando para `http://localhost:8080/swagger/index.html` em seu navegador web.  2. **Localize a API [POST] Redact Text:** Dentro da UI do Swagger, encontre o endpoint `POST` `/v1/document-services/pdfs/redact-text`.  3. **Especificar configurações:** Neste exemplo, estou fornecendo tanto o arquivo PDF quanto as palavras a serem redigidas na solicitação `POST`. Vamos redigir a palavra "nós" e sobrepor uma caixa preta sobre ela. Para esta demonstração, usaremos o arquivo ' [sample.pdf](/static-assets/securedoc/how-to/redact-text/sample.pdf) ' com as seguintes configurações: - `draw_black_box`: `true` - `match_whole_word`: `true` - `words_to_redact`: nós 4. **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 é adicionado como **`pdf_file`**. 5. **Execute a solicitação:** Clique em "Executar" para executar a solicitação. A resposta incluirá o PDF com as informações ocultadas. Essa interação com a interface do Swagger permite testar facilmente o processo de redação, fornecendo feedback imediato. <hr /> ## Utilize o comando CURL para solicitar dados através da linha de comando. Alternativamente, podemos usar o Prompt de Comando com uma solicitação `curl` `POST` para alcançar o mesmo resultado. ```shell curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \ -H 'accept: */*' \ -H 'Content-Type: multipart/form-data' \ -F 'pdf_file=@sample.pdf;type=application/pdf' \ -F 'words_to_redact="we"' \ -F 'draw_black_box=true' \ -F 'match_whole_word=true' ``` [[i:( )]] Por padrão, o PowerShell pode interpretar `curl` como um alias para `Invoke-WebRequest`, um cmdlet integrado do PowerShell. Tente usar `curl.exe` em vez de `curl`. ```shell curl.exe --version ``` )&#125;] ### Parâmetros obrigatórios no corpo da requisição <table class="table"> <tr> <th style="text-align: center;">Nome</th> <th style="text-align: center;">Tipo de dados</th> <th style="text-align: center;">Descrição</th> </tr> <tr> <td><code>arquivo_pdf</code></td> <td><code>application/pdf</code></td> <td>O arquivo PDF que você deseja manipular.</td> </tr> <tr> <td><code>palavras_a_redigir</code></td> <td><code>array[string]</code></td> <td>Este parâmetro recebe uma lista de palavras e oculta o texto que corresponde à entrada.</td> </tr> </table> ### Parâmetros opcionais do corpo da requisição <table class="table"> <tr> <th style="text-align: center;">Nome</th> <th style="text-align: center;">Tipo de dados</th> <th style="text-align: center;">Descrição</th> </tr> <tr> <td><code>senha_do_usuário</code></td> <td><code>string</code></td> <td>Isso é necessário se o PDF de entrada tiver uma senha de usuário. A operação falhará se nenhuma senha for fornecida para o PDF protegido por senha.</td> </tr> <tr> <td><code>senha_do_proprietário</code></td> <td><code>string</code></td> <td>Isso é necessário se o PDF de entrada tiver uma senha de proprietário. A operação falhará se nenhuma senha for fornecida para o PDF protegido por senha.</td> </tr> <tr> <td><code>specific_pages</code></td> <td><code>array[int]</code></td> <td>Permite especificar quais páginas redigir texto. Por padrão, o valor é <code>null</code>, significando que a palavra fornecida em todas as páginas será redigida.</td> </tr> <tr> <td><code>draw_black_box</code></td> <td><code>boolean</code></td> <td>Permite especificar se deve desenhar uma caixa preta sobre o texto redigido. Por padrão, este valor é definido como <code>True</code>.</td> </tr> <tr> <td><code>match_whole_word</code></td> <td><code>boolean</code></td> <td>Especifica se correspondências parciais dentro de palavras também devem ser redigidas. Por exemplo, se a palavra fornecida for "são", quaisquer palavras contendo "são", como "petição", terão o "são" redigido também. Por padrão, isso é definido como <code>True</code>.</td> </tr> <tr> <td><code>match_case</code></td> <td><code>boolean</code></td> <td>Especifica se a palavra fornecida deve ser uma correspondência exata em termos de caixa. Por padrão, este valor é <code>null</code>. Nota: Definir isto como <code>True</code> significa que strings em minúsculas e maiúsculas não serão correspondidas. Por exemplo, se a palavra fornecida for "NÓS", a versão em minúsculas "nós" não seria redigida.</td> </tr> <tr> <td><code>overlay_text</code></td> <td><code>string</code></td> <td>Especifica o texto de sobreposição, como palavras ou símbolos, sobre o texto ocultado. Por padrão, essa string está vazia.</td> </tr> <tr> <td><code>salvar_como_pdfa</code></td> <td><code>boolean</code></td> <td>Salva o PDF modificado com conformidade PDF/A-3. Por padrão, isso é definido como <code>False</code>.</td> </tr> <tr> <td><code>salvar_como_pdfua</code></td> <td><code>boolean</code></td> <td>Salva o PDF modificado com conformidade PDF/UA. Por padrão, isso é definido como <code>False</code>.</td> </tr> </table> ### Parâmetros de cabeçalho opcionais <table class="table"> <tr> <th style="text-align: center;">Nome</th> <th style="text-align: center;">Tipo de dados</th> <th style="text-align: center;">Descrição</th> </tr> <tr> <td><code>autor</code></td> <td><code>string</code></td> <td>Útil para identificar você como o autor do documento PDF. Por padrão, este campo está vazio.</td> </tr> <tr> <td><code>título</code></td> <td><code>string</code></td> <td>Exibe o título do documento PDF. Por padrão, este campo está vazio.</td> </tr> <tr> <td><code>assunto</code></td> <td><code>string</code></td> <td>Útil para identificar o conteúdo do documento PDF rapidamente. Por padrão, este campo está vazio.</td> </tr> </table>

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Neste artigo, discutiremos a redação de texto em um PDF usando o IronSecureDoc. Isso permite que o serviço ou processo redija rapidamente e facilmente informações confidenciais com uma simples solicitação POST com o PDF para o servidor IronSecureDoc em execução. Iremos demonstrar isso visualmente através do uso de documentos Swagger. A solicitação POST aceita parâmetros obrigatórios e opcionais e é altamente personalizável; A resposta retorna o PDF com o texto ocultado.

Puxe e inicie o IronSecureDoc

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

A API [POST] Redact Text

O endpoint da API [POST] Redact Text permite ocultar texto sensível em um documento PDF usando redação. Essa funcionalidade é essencial para aplicações que lidam com documentos confidenciais, como contratos legais, registros médicos ou relatórios financeiros. O uso desta API garante a remoção permanente de textos específicos, proporcionando maior segurança e assegurando a conformidade com os padrões de proteção de dados.

Arrogância

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 Texto com Swagger

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

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

2. Localize a API [POST] Redact Text:

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

3. Especificar configurações:

Neste exemplo, estou fornecendo tanto o arquivo PDF quanto as palavras a serem redigidas na solicitação POST. Vamos redigir a palavra "nós" e sobrepor uma caixa preta sobre ela. Para esta demonstração, usaremos o arquivo ' sample.pdf ' com as seguintes configurações:

• draw_black_box: true
• match_whole_word: true
• words_to_redact: nós

4. 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 é adicionado como pdf_file.

5. Execute a solicitação:

   Clique em "Executar" para executar a solicitação. A resposta incluirá o PDF com as informações ocultadas. Essa interação com a interface do Swagger permite testar facilmente o processo de redação, fornecendo feedback imediato.

Utilize o comando CURL para solicitar dados através da linha de comando.

Alternativamente, podemos usar o Prompt de Comando com uma solicitação curl POST para alcançar o mesmo resultado.

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
 -H 'accept: */*' \
 -H 'Content-Type: multipart/form-data' \
 -F 'pdf_file=@sample.pdf;type=application/pdf' \
 -F 'words_to_redact="we"' \
 -F 'draw_black_box=true' \
 -F 'match_whole_word=true'

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
 -H 'accept: */*' \
 -H 'Content-Type: multipart/form-data' \
 -F 'pdf_file=@sample.pdf;type=application/pdf' \
 -F 'words_to_redact="we"' \
 -F 'draw_black_box=true' \
 -F 'match_whole_word=true'

Por padrão, o PowerShell pode interpretar curl como um alias para Invoke-WebRequest, um cmdlet integrado do PowerShell. Tente usar curl.exe em vez de curl.

curl.exe --version

curl.exe --version

)}]

Parâmetros obrigatórios no corpo da requisição

Parâmetros opcionais do corpo da requisição

Parâmetros de cabeçalho opcionais

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

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 bem estruturados e visualmente atraentes.

...

Leia mais