Como criptografar/adicionar senha e permissões a arquivos PDF in C
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.
Como criptografar/adicionar senha e permissões a arquivos PDF
- Baixe e inicie a imagem Docker do IronSecureDoc.
- Teste a API usando o Swagger.
- Especifique os parâmetros para senha e permissões.
- Execute a chamada da API para aplicar as alterações.
- Exporte o documento PDF criptografado.
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
- 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.

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

- 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.
- 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.
- 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.
- 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.')
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.

