Como criptografar/adicionar senha e permissões a arquivos PDF in C#

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

Proteger arquivos PDF com senhas e permissões específicas é fundamental para proteger documentos confidenciais contra acesso e manipulação não autorizados. A API [POST] Criptografar/Adicionar Senha e Permissões do IronSecure Doc oferece uma maneira eficiente de criptografar arquivos PDF com senhas de usuário e proprietário, além de configurar permissões para impressão, preenchimento de formulários, anotações e muito mais. Esta API garante que o PDF esteja totalmente protegido e o acesso seja controlado, tornando-a ideal para 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] Criptografar/Adicionar Senha e Permissões

A API [POST] Criptografar/Adicionar Senha e Permissões permite adicionar camadas de segurança a documentos PDF, criptografando-os com senhas e definindo permissões específicas para diversas operações. Seja para conceder acesso de leitura, permitir o preenchimento de formulários ou desativar a impressão, esta API oferece controle sobre como seus arquivos PDF são acessados ​​e modificados.

Arrogância

O Swagger oferece uma interface amigável para testar essa API de forma interativa. Você pode usá-lo para enviar solicitações de teste e receber respostas sem escrever código, o que o torna uma ótima ferramenta para desenvolvedores.

Passos para Redigir Texto com Swagger

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

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

Swagger docs

  1. Localize a API:

Encontre a API [POST] /v1/document-services/pdfs/encrypt, que corresponde a Criptografar/Adicionar Senha & Permissões.

Redigir texto

  1. Parâmetros de entrada:

Forneça os parâmetros necessários para a API. Você pode carregar um arquivo PDF de exemplo e especificar as permissões desejadas.

  1. Carregar arquivo PDF:

No corpo da solicitação, faça o upload de um arquivo PDF como pdf_file e defina as permissões necessárias, como permitir ou recordair impressão, preenchimento de formulários e extração de conteúdo.

  1. Execute a solicitação:

Após configurar todos os parâmetros, clique em "Executar" para enviar a solicitação. A resposta retornará o PDF criptografado com as configurações de segurança especificadas.

  1. Verifique o PDF gerado:

Digite 'senha' para visualizar o conteúdo do PDF.


Compreendendo os parâmetros de entrada

A API requer parâmetros específicos para criptografar o PDF e atribuir permissões. A seguir, apresentamos uma descrição detalhada dos parâmetros obrigatórios e opcionais:

Parâmetros obrigatórios

Nome Tipo de dados Descrição
`pdf_file` aplicação/pdf O arquivo PDF que você deseja criptografar.
`allow_extracting_content` booleano Indique se a extração de conteúdo é permitida.
`allow_form_filling` booleano Indique se o preenchimento do formulário é permitido.
`allow_annotations` booleano Indique se as anotações são permitidas.
`allow_printing` booleano Indique se a impressão é permitida.
`allow_modifications` booleano Indique se são permitidas modificações.
`new_owner_password` corda A nova senha do proprietário do PDF, que concede acesso total e a capacidade de alterar as permissões.

Parâmetros opcionais

Nome Tipo de dados Descrição
`user_password` corda A senha do usuário atual, necessária caso o PDF possua uma senha de usuário para conceder acesso de leitura.
`owner_password` corda A senha do proprietário atual, necessária caso o PDF possua uma senha de proprietário para conceder acesso total.
`new_user_password` corda A nova senha de usuário para acesso de leitura.
`save_as_pdfa` booleano Salve o PDF em formato compatível com PDF/A-3.
`save_as_pdfua` booleano Salve o PDF em um formato compatível com PDF/UA.
`author` corda Defina a propriedade Autor dos metadados do PDF.
`title` corda Defina a propriedade Título dos metadados do PDF.
`subject` corda Defina a propriedade Assunto dos metadados do PDF.

Integração de API: Exemplo em Python

Depois de se familiarizar com os parâmetros de entrada, você pode chamar a API usando Python ou qualquer outra linguagem de sua preferência. Abaixo, segue um exemplo de como integrar essa API usando Python.

import requests

# Endpoint URL
url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'

# Headers with metadata information
headers = {
    'accept': '*/*',
    'author': 'Iron Software',
    'title': 'ENCRYPTION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

# Files to be sent in the request
files = {
    'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'aplicação/pdf')
}

# Parameters for encryption and permissions
data = {
    'allow_extracting_content': 'true',
    'allow_form_filling': 'true',
    'allow_annotations': 'false',
    'allow_printing': 'false',
    'allow_modifications': 'true',
    'new_owner_password': 'password',
    'new_user_password': 'password',
    'save_as_pdfa': 'false',
    'save_as_pdfua': 'false'
}

# Send POST request with parameters
response = requests.post(url, headers=headers, files=files, data=data)

# Save the encrypted PDF to file system
with open('sample_encrypted.pdf', 'wb') as f:
    f.write(response.content)

print('PDF encrypted successfully.')
import requests

# Endpoint URL
url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'

# Headers with metadata information
headers = {
    'accept': '*/*',
    'author': 'Iron Software',
    'title': 'ENCRYPTION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

# Files to be sent in the request
files = {
    'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'aplicação/pdf')
}

# Parameters for encryption and permissions
data = {
    'allow_extracting_content': 'true',
    'allow_form_filling': 'true',
    'allow_annotations': 'false',
    'allow_printing': 'false',
    'allow_modifications': 'true',
    'new_owner_password': 'password',
    'new_user_password': 'password',
    'save_as_pdfa': 'false',
    'save_as_pdfua': 'false'
}

# Send POST request with parameters
response = requests.post(url, headers=headers, files=files, data=data)

# Save the encrypted PDF to file system
with open('sample_encrypted.pdf', 'wb') as f:
    f.write(response.content)

print('PDF encrypted successfully.')
PYTHON

Passos explicados:

  • Carregar o PDF : O arquivo PDF a ser criptografado é carregado do sistema de arquivos local.
  • Definir parâmetros de criptografia : Defina permissões como permitir impressão, preenchimento de formulários e extração de conteúdo, além de definir novas senhas.
  • Chamar a API : A API [POST] Criptografar/Adicionar Senha e Permissões é chamada, passando os parâmetros necessários.
  • Salvar o resultado : O PDF criptografado é salvo como um novo arquivo.

O arquivo PDF está criptografado conforme mostrado abaixo. Digite 'senha' para visualizar o conteúdo do PDF.

Perguntas frequentes

Como criptografar um arquivo PDF para proteger informações confidenciais?

Para criptografar um arquivo PDF, você pode usar a API IronSecureDoc, que permite definir senhas tanto para o usuário quanto para o proprietário. Essas senhas ajudam a controlar o acesso e as permissões, como impressão e preenchimento de formulários, garantindo a segurança do documento.

Quais são os passos envolvidos na utilização da API IronSecureDoc para criptografia de PDFs?

Primeiro, baixe a imagem Docker do IronSecureDoc e configure-a de acordo com seu ambiente de hospedagem. Em seguida, use a API para especificar os parâmetros de criptografia, como senhas e permissões, e execute a chamada da API para gerar um PDF seguro.

Como posso testar a API IronSecureDoc sem escrever código?

Você pode testar a API IronSecureDoc usando o Swagger. Acesse a interface do Swagger, encontre o endpoint da API relevante, insira os parâmetros necessários e execute a solicitação para ver a resposta e garantir que a API esteja funcionando corretamente.

O que são senhas de usuário e proprietário na segurança de PDFs?

Na segurança de PDFs, a senha do usuário permite a leitura do documento, enquanto a senha do proprietário concede acesso total, incluindo a alteração de permissões. Com o IronSecureDoc, você pode definir ambos os tipos de senha para aumentar a segurança do documento.

Posso configurar um PDF para ser compatível com PDF/A usando o IronSecureDoc?

Sim, a API IronSecureDoc inclui parâmetros que permitem salvar o PDF criptografado em formato PDF/A-3, que é um padrão para preservação de longo prazo de documentos eletrônicos.

Quais permissões podem ser controladas com a API IronSecureDoc?

Utilizando a API IronSecureDoc, você pode controlar permissões como impressão, preenchimento de formulários, extração de conteúdo, anotações e modificações, garantindo que os PDFs sejam usados de maneira consistente com suas políticas de segurança.

Como posso integrar a API IronSecureDoc com um aplicativo Python?

Para integrar a API IronSecureDoc com Python, utilize a biblioteca requests para enviar uma requisição POST ao endpoint da API. Inclua os cabeçalhos, parâmetros e dados de arquivo necessários na sua requisição para criptografar e gerenciar seus arquivos PDF.

Quais parâmetros são essenciais para criptografar um PDF usando o IronSecureDoc?

Os parâmetros essenciais incluem o arquivo PDF a ser criptografado, as senhas do usuário e do proprietário e as permissões para ações como impressão e edição. Esses parâmetros garantem a segurança do documento e o controle sobre seu uso.

É possível modificar os metadados de um PDF durante a criptografia com o IronSecureDoc?

Sim, você pode modificar os metadados do PDF, como autor, título e assunto, usando os parâmetros opcionais da API IronSecureDoc, o que permite personalizar as informações do documento durante o processo de criptografia.

Quais são os requisitos de hospedagem para executar o IronSecureDoc localmente?

O IronSecureDoc pode ser hospedado localmente em sistemas Windows, Mac ou Linux. Siga os tutoriais de configuração específicos para o seu sistema operacional para garantir a instalação e o funcionamento corretos do serviç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.