Alternativas ao Docker Compose para PDF usando IronSecureDoc

Configurar o IronSecureDoc é simples, graças ao seu desdobramento baseado em Docker. Isso permite que os desenvolvedores integrem rapidamente seus recursos de segurança sem lidar com instalações complexas.

Passo 1: Obter a Imagem Docker do IronSecureDoc

Para começar, obtenha a imagem Docker mais recente do IronSecureDoc:

docker pull ironsoftwareofficial/ironsecuredoc:latest

docker pull ironsoftwareofficial/ironsecuredoc:latest

Passo 2: Execute o Container IronSecureDoc

Uma vez que a imagem seja baixada, execute o container com as variáveis de ambiente necessárias:

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
-e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
-e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

Substitua <IRONSECUREDOC_LICENSE_KEY> com sua chave de licença válida. Isso garante que o serviço funcione com plena funcionalidade.

Passo 3: Acesse os Endpoints da API

Uma vez que o container esteja em funcionamento, você pode explorar os endpoints da API usando o Swagger:

• Swagger UI (Porta 8080): http://localhost:8080/swagger/index.html

Com essa configuração, você pode começar a integrar os recursos avançados de segurança do IronSecureDoc em sua aplicação.

O StirlingPDF é uma ferramenta de processamento de PDF de código aberto que pode ser rapidamente desdobrada usando o Docker. Configurar é simples e permite que você aproveite seus recursos de segurança e manipulação de documentos imediatamente.

Passo 1: Obter a Imagem Docker do StirlingPDF

Primeiro, baixe a imagem Docker mais recente do StirlingPDF executando:

docker pull casjaysdevdocker/stirlingpdf:latest

docker pull casjaysdevdocker/stirlingpdf:latest

Ou procure por ele no Docker Desktop:

Passo 2: Execute o Container StirlingPDF

Depois que a imagem estiver disponível, você pode iniciar um novo container. Na interface do Docker, configure as configurações da seguinte forma:

• Nome do Container: StirlingPDF
• Porta do Host: 8090

Alternativamente, você pode executá-lo via CLI:

docker run --rm -p 8090:8080 casjaysdevdocker/stirlingpdf:latest

docker run --rm -p 8090:8080 casjaysdevdocker/stirlingpdf:latest

Passo 3: Acesse a API

Uma vez que o container esteja em execução, acesse o StirlingPDF Swagger UI para explorar os endpoints de API disponíveis:

http://localhost:8090/swagger-ui/index.html#/

Com essa configuração, você pode começar a usar os recursos de segurança de documentos do StirlingPDF.

Redação de Texto

Quando se trata de lidar com informações confidenciais, um dos recursos de segurança mais importantes é a redação, a capacidade de remover conteúdo sensível de documentos PDF permanentemente. O IronSecureDoc se destaca nesta tarefa, fornecendo um endpoint de API amigável e eficiente para rapidamente redigir palavras ou frases específicas.

• Redação Flexível de Texto: Os usuários podem especificar palavras ou frases exatas para redação. A API suporta correspondência de palavras completas e parciais, configurável por meio de parâmetros de consulta.

• Controle de Sensibilidade de Maiúsculas: Permite alternar a correspondência sensível a maiúsculas, oferecendo controle preciso sobre o comportamento de redação.

• Redação Visual: O texto selecionado pode ser obscurecido visualmente com uma caixa preta distinta, sinalizando claramente as áreas redigidas dentro do PDF.

Para ilustrar isso, considere um documento PDF contendo a frase "Dummy":

Usando a API simples do IronSecureDoc, os desenvolvedores podem facilmente emitir um comando para redigir o texto sensível.

Aqui está um exemplo prático usando Curl:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/redact-text?draw_black_box=true&match_whole_word=false&words_to_redact=Dummy&match_case=false&save_as_pdfa=false&save_as_pdfua=false' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/redact-text?draw_black_box=true&match_whole_word=false&words_to_redact=Dummy&match_case=false&save_as_pdfa=false&save_as_pdfua=false' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

Uma vez que o comando seja executado com sucesso, você receberá uma resposta similar à seguinte:

O PDF resultante demonstra a capacidade efetiva de redação do IronSecureDoc. O conteúdo sensível é obscurecido permanentemente, garantindo que as informações confidenciais permaneçam seguras:

IronSecureDoc também suporta métodos avançados de redação, como redigir conteúdo usando expressões regulares ou regiões específicas dentro de um PDF:

• /v1/document-services/pdfs/redact-regular-expression
• /v1/document-services/pdfs/redact-region

Este recurso simples, mas poderoso, garante que os documentos mantenham a privacidade e cumpram os rigorosos padrões de proteção de dados.

Certificar Documentos

Certificar documentos garante a autenticidade e integridade dos arquivos PDF. IronSecureDoc simplifica esse processo usando uma API dedicada. Veja como certificar um documento PDF usando o Swagger UI:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/certify?certificate_password=P%40ssw0rd123&certificate_permissions=3' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf' \
  -F 'certificate_file=@certificate.p12;type=application/x-pkcs12'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/certify?certificate_password=P%40ssw0rd123&certificate_permissions=3' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf' \
  -F 'certificate_file=@certificate.p12;type=application/x-pkcs12'

Quando essa API é chamada, o PDF é assinado com um certificado digital, que bloqueia seu conteúdo e prova sua legitimidade. O parâmetro certificate_permissions determina o que os destinatários podem fazer com o documento após a certificação, como imprimir ou preencher formulários.

A resposta do servidor inclui um arquivo certificado que pode ser baixado. Isso fornece uma maneira perfeita de automatizar o processo de certificação e garantir que seus PDFs sejam seguros, verificáveis e conformes.

Assinar Documentos PDF

Além da certificação, o IronSecureDoc fornece outra capacidade crucial—assinar documentos PDF digitalmente. Diferente da certificação, que bloqueia o documento inteiro, uma assinatura digital adiciona verificação sem necessariamente restringir edições.

Usando o endpoint /v1/document-services/pdfs/sign no Swagger UI, você pode colocar uma imagem de assinatura visível em uma página específica do documento. Você pode até personalizar sua localização e dimensões ajustando os parâmetros signature_image_x, signature_image_y, signature_image_w, e signature_image_h.

Além do posicionamento da assinatura, você pode fornecer uma senha de usuário ou proprietário, aplicar um certificado para maior confiança, e opcionalmente converter o documento para os formatos PDF/A ou PDF/UA para conformidade.

Para assinar um documento:

1. Carregue o PDF que deseja assinar.
2. Carregue um arquivo de certificado digital válido (formato .p12).
3. Carregue um arquivo de imagem da assinatura (PNG ou JPEG).
4. Defina as coordenadas e tamanho de colocação da assinatura.
5. Clique em Executar.

Quando concluído, o servidor retornará um PDF assinado digitalmente pronto para distribuição. Este recurso é ótimo para automatizar fluxos de trabalho de aprovação, confirmar autoria ou adicionar branding a documentos oficiais—tudo isso enquanto mantém a integridade do documento.

Criptografia de arquivos PDF

Um dos pilares mais importantes da segurança de PDF é a criptografia. Com IronSecureDoc, os desenvolvedores podem criptografar documentos usando senhas fortes de usuário e proprietário enquanto também ajustam finamente as configurações de permissão para uso do documento. Para executar esta ação usando o Swagger UI, navegue até o endpoint /v1/document-services/pdfs/encrypt e configure os campos necessários:

Você pode restringir uma variedade de recursos do documento, como:

• Extração de conteúdo
• Preenchimento de formulários
• Anotações
• Impressão
• Modificações

Basta configurar todas essas opções para false se quiser um documento completamente bloqueado. Aqui está o comando CURL equivalente para referência:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?allow_extracting_content=false&allow_form_filling=false&allow_annotations=false&allow_printing=false&allow_modifications=false&new_user_password=123&new_owner_password=123' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?allow_extracting_content=false&allow_form_filling=false&allow_annotations=false&allow_printing=false&allow_modifications=false&new_user_password=123&new_owner_password=123' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

Uma vez executado, a saída será um arquivo PDF totalmente criptografado que solicita ao usuário que insira uma senha ao abrir.

Esta funcionalidade é essencial para proteger registros sensíveis, limitar o acesso e garantir o controle do documento, mesmo após a distribuição. Seja para memorandos internos, documentos legais ou relatórios de clientes, o IronSecureDoc facilita a aplicação da segurança do documento sem interromper seu fluxo de desenvolvimento.

Extrair Texto de PDFs

Precisa extrair conteúdo de um arquivo PDF? O IronSecureDoc oferece uma maneira rápida e precisa de extrair texto usando o endpoint /v1/document-services/pdfs/extract. Este recurso é especialmente útil quando você deseja automatizar a recuperação de conteúdo de faturas, relatórios ou documentos grandes sem a necessidade de copiar e colar manualmente. Para extrair texto, acesse o Swagger UI e carregue seu arquivo usando o formulário fornecido:

Os parâmetros permitem que você insira senhas (se o PDF estiver protegido) e até especifique números de páginas se você só precisar de conteúdo de páginas selecionadas. Alternativamente, você pode usar o seguinte comando CURL:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/extract' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@long_text_test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/extract' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@long_text_test.pdf;type=application/pdf'

Depois de executado, a API retorna o texto extraído como um corpo de resposta simples:

Esta saída pode então ser analisada, armazenada ou analisada conforme necessário. É simples, rápido, e não requer nenhum plugin especial ou revisão manual. Seja construindo um pipeline de processamento de documentos ou desejando acesso rápido ao conteúdo de um arquivo, este recurso faz o trabalho.

Verificar Senha do Documento

Antes de processar qualquer PDF protegido, é uma boa ideia verificar se sua senha é válida. IronSecureDoc fornece uma forma rápida e confiável de verificar tanto senhas de usuário quanto de proprietário usando o endpoint /v1/document-services/pdfs/verify-password. Isso é especialmente útil ao automatizar fluxos de trabalho que envolvem documentos de terceiros ou arquivos arquivados, onde a precisão da senha deve ser confirmada antes de qualquer ação adicional.

Na interface do Swagger UI, faça upload do PDF protegido e então preencha o campo relevante de user_password ou owner_password, dependendo do seu nível de acesso:

Uma vez submetido, a API retornará um sucesso (200 OK) se a senha for válida ou um erro se não for. Esta etapa de validação leve pode economizar tempo, prevenir falhas desnecessárias e ajudar a simplificar o manuseio automático de PDFs.

Verificar Assinaturas Digitais

Verificar uma assinatura digital é um passo crucial para garantir que um documento PDF não foi alterado desde que foi assinado e que a assinatura é válida. IronSecureDoc fornece esta funcionalidade através do endpoint /v1/document-services/pdfs/verify-signatures. Este endpoint é especialmente útil quando documentos são recebidos de fontes externas ou quando conformidade e confiança são essenciais.

Na interface do Swagger UI, tudo que você precisa fazer é fazer upload do arquivo PDF assinado e, se necessário, inserir user_password ou owner_password para acessar o arquivo:

Você também pode executar esse processo usando uma solicitação CURL:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/verify-signatures' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test_Signed.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/verify-signatures' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test_Signed.pdf;type=application/pdf'

Após executar a solicitação, a API retorna resultados de verificação detalhados em formato JSON. Se a assinatura estiver intacta e autêntica, retornará verdadeiro. Se tiver sido alterada ou for inválida, você verá indicadores detalhados de falha.

Esse recurso garante que cada assinatura em seu fluxo de trabalho de PDF seja verificável e segura—um passo essencial para documentos legais, financeiros e de conformidade.

Redigir PDF

StirlingPDF oferece uma forma simples e flexível de redigir conteúdo de documentos PDF usando seu endpoint /api/v1/security/auto-redact. Este recurso é ideal para desenvolvedores que desejam remover palavras ou padrões sensíveis de PDFs sem precisar de configuração avançada.

Na interface do Swagger UI, você pode facilmente configurar parâmetros de redação. Você faz upload de um PDF, insere a lista de texto a ser redigido (como "Dummy") e ajusta opções como:

• useRegex – Redação baseada em expressões regulares
• wholeWordSearch – Correspondência apenas de palavras inteiras
• redactColor – Personalizar a cor da redação (por exemplo, preto #000000)
• customPadding – Adicionar espaçamento ao redor das áreas redigidas
• convertPDFToImage – Converter a saída para uma imagem para proteção extra

Uma vez que você clica em Executar, StirlingPDF processa o arquivo e remove todo o conteúdo correspondente com base na sua configuração.

Validar Assinaturas

Usando o endpoint /api/v1/security/validate-signature, você pode rapidamente verificar a autenticidade de assinaturas digitais embutidas em um arquivo PDF. O endpoint suporta tanto a validação de certificados padrão quanto personalizados. Tudo que você precisa fazer é submeter um corpo de solicitação contendo o fileInput (seu PDF em base64 ou string de arquivo) e, opcionalmente, fornecer um certFile se quiser validar contra um certificado específico.

Esta API responde com uma estrutura JSON detalhando o status da verificação.

Assinar Arquivos PDF com um Certificado Digital

StirlingPDF permite que você assine digitalmente arquivos PDF usando seus certificados com o endpoint /api/v1/security/cert-sign. Através da interface do Swagger UI, você pode fazer upload do seu PDF e configurar as opções de assinatura digital. Aqui está o que você precisará:

• fileInput – O arquivo PDF que você deseja assinar
• certType – O tipo de certificado que você está usando
• privateKeyFile, certFile, p12File, ou jksFile – Dependendo do tipo de certificado
• password – Para o keystore ou chave privada

Você também pode melhorar a experiência de assinatura com:

• showSignature – Exibir visualmente a assinatura no PDF
• reason, location, name – Metadados para a assinatura
• pageNumber – A página onde a assinatura deve aparecer
• showLogo – Se deve mostrar um logotipo junto com a assinatura

Uma vez que você clica em Executar, StirlingPDF processa a entrada e retorna um PDF assinado digitalmente.

Adicionar Proteção por Senha

StirlingPDF permite que você bloqueie documentos com proteção por senha usando o endpoint /api/v1/security/add-password. Este recurso permite que você defina senhas de usuário e proprietário, juntamente com configurações de permissão ajustadas.

Usando o Swagger UI, veja como configurá-lo:

• fileInput – Carregar o PDF que você deseja proteger
• password – A senha do usuário é necessária para abrir o documento
• ownerPassword – Controlar permissões de edição dentro do arquivo
• keyLength – Escolher a força da criptografia (por exemplo, 256 bits)

Além disso, você pode alternar restrições de documentos, como:

• canPrint, canModify, canFillInForm
• canExtractContent, canExtractForAccessibility
• canModifyAnnotations, canAssembleDocument

Quando você clicar em Executar, a saída será um PDF protegido por senha com permissões exatamente como configuradas.

IronSecureDoc oferece opções de licenciamento de nível empresarial adaptadas para atender a diversos requisitos organizacionais. Os clientes podem escolher entre uma Licença Empresarial IronSecureDoc autônoma ou a abrangente Licença Empresarial Iron Suite, que inclui o IronSecureDoc junto com outros produtos.

Licença Empresarial IronSecureDoc

• Preço: USD 14,999
• Recursos:
  • Servidor PDF Empresarial suportando sem código ou qualquer linguagem de programação, hospedado localmente ou na nuvem
  • Remoção ilimitada de PDF, assinatura e criptografia para proteger seus documentos
  • Suporta ambientes offline isolados
  • Pacotes de suporte e atualização com desconto estão disponíveis

Licença Empresarial Ilimitada Iron Suite

• Preço: USD 19,995
• Recursos:
  • Inclui todos os produtos da Iron Software: IronPDF, IronOCR, IronXL, IronWord, IronBarcode, e mais
  • Desenvolvedores ilimitados, locais e projetos, incluindo redistribuição OEM
  • Licença empresarial perpétua sob medida
  • Suporta ambientes offline isolados
  • Opções disponíveis somente para empresas
  • Assinatura de suporte e atualizações cobre a Suite e o IronSecureDoc

Suporte e Atualizações

A Iron Software fornece várias opções de suporte e atualização de produtos para garantir serviço ininterrupto:

• Assinatura Anual: $7,500 por ano (renova a cada ano, pode ser cancelada a qualquer momento)
• Pacote de 1 Ano: $10,000 (compra única)
• Pacote de 5 Anos: $30,000 (compra única)

Esses pacotes oferecem acesso a atualizações contínuas de produtos, melhorias de recursos de segurança e suporte da equipe de engenharia da Iron Software.

Opções de Avaliação

Para organizações interessadas em avaliar o IronSecureDoc antes de comprar, uma versão de teste gratuita está disponível. Este teste oferece funcionalidade total, permitindo uma avaliação abrangente em um ambiente ao vivo sem compromisso financeiro imediato.

Ao escolher a opção de licenciamento apropriada, as empresas podem garantir segurança robusta de documentos adaptada às suas necessidades específicas.

O StirlingPDF oferece um modelo simples e de código aberto:

Plano Gratuito

Disponível sob a licença AGPL v3, os recursos principais são gratuitos para usar e auto-hospedar. Adequado para desenvolvedores ou uso interno pequeno.

Licença Empresarial

Uma licença comercial está disponível para empresas que exigem conformidade não-AGPL ou suporte adicional. Os preços são personalizados e requerem contato com a equipe deles.

O IronSecureDoc oferece um conjunto abrangente de documentações e recursos de suporte projetados para facilitar a integração e operação perfeita dentro de sua organização.

Documentação Extensa

O IronSecureDoc fornece documentação detalhada que abrange:

• Guias de Início Rápido: Instruções passo a passo para colocar o IronSecureDoc em funcionamento em vários ambientes, incluindo servidores locais e plataformas em nuvem.
• Referências de API: Documentação abrangente de API RESTful, detalhando endpoints para tarefas como redação, criptografia e assinatura digital de PDFs.
• Tutoriais e How-Tos: Guias práticos demonstrando técnicas de integração com diferentes linguagens de programação e frameworks, melhorando a experiência do desenvolvedor.

Suporte Dedicado

O IronSecureDoc garante suporte robusto através de:

• Assistência de Engenharia Direta: Acesso a uma equipe de engenheiros dedicados via chat ao vivo, e-mail ou compartilhamento de tela, fornecendo respostas oportunas e conhecedoras a consultas técnicas.
• Melhoria Contínua: Um compromisso com a evolução do produto com base no feedback dos usuários, garantindo que o IronSecureDoc atenda às necessidades dinâmicas de seus usuários.

Essa abordagem estruturada para documentação e suporte destaca a dedicação do IronSecureDoc em oferecer uma experiência centrada no usuário, facilitando a implementação eficiente e a utilização contínua em ambientes empresariais.

Documentação

O StirlingPDF fornece documentação abrangente cobrindo guias de instalação para várias plataformas, opções avançadas de configuração e uma lista extensa de recursos.

Apoiar

Como um projeto de código aberto, o StirlingPDF depende de suporte impulsionado pela comunidade. Os usuários podem buscar assistência através de plataformas como GitHub e Discord, onde podem relatar problemas, solicitar recursos e colaborar com outros usuários e contribuidores.