使用 IronSecureDoc 的 Stirling PDF Docker Compose 替代方案

由於IronSecureDoc採用基於 Docker 的部署方式，因此設定起來非常簡單。 這使得開發人員能夠快速整合其安全功能，而無需處理複雜的安裝過程。

步驟 1：拉取 IronSecureDoc Docker 映像

首先，拉取最新的IronSecureDoc Docker 映像：

docker pull ironsoftwareofficial/ironsecuredoc:latest

docker pull ironsoftwareofficial/ironsecuredoc:latest

步驟 2：運行 IronSecureDoc 容器

鏡像下載完成後，使用必要的環境變數執行容器：

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

代替<IRONSECUREDOC_LICENSE_KEY>使用您的有效許可證金鑰。 這樣可以確保服務以全部功能運作。

步驟 3：存取 API 端點

容器啟動並運行後，您可以使用 Swagger 來探索 API 端點：

• Swagger UI（連接埠 8080）：
  http://localhost:8080/swagger/index.html

透過此設置，您可以開始將IronSecureDoc 的高級安全功能整合到您的應用程式中。

StirlingPDF 是一款開源PDF 處理工具，可使用 Docker 快速部署。 設定過程很簡單，設定完成後即可立即使用其安全性和文件處理功能。

步驟 1：拉取 StirlingPDF Docker 映像

首先，執行以下命令下載最新的 StirlingPDF Docker 映像：

docker pull casjaysdevdocker/stirlingpdf:latest

docker pull casjaysdevdocker/stirlingpdf:latest

或在 Docker Desktop 中搜尋：

步驟 2：運行 StirlingPDF 容器

鏡像準備就緒後，即可啟動新的容器。 在 Docker 介面中，按如下方式配置設定：

-容器名稱：StirlingPDF 主機連接埠：8090

或者，您也可以透過命令列介面 (CLI) 來運行它：

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

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

步驟 3：存取 API

容器運行後，請造訪 StirlingPDF Swagger UI 以瀏覽可用的 API 端點：

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

透過此設置，您可以開始使用 StirlingPDF 的文件安全功能。

編輯文字

在處理機密資訊時，最重要的安全功能之一是編輯，即能夠永久地從 PDF 文件中刪除敏感內容。 IronSecureDoc 在這方面表現出色，它提供了一個用戶友好且高效的 API 端點，可以快速編輯特定的單字或短語。

-靈活的文字編輯：使用者可以指定要編輯的確切字詞或短語。 此 API 支援部分匹配和全詞匹配，可透過查詢參數進行配置。

-區分大小寫控制：允許切換區分大小寫的匹配，從而精確控制編輯行為。

-視覺遮蔽：選定的文字可以用明顯的黑色方框在視覺上遮蔽，清楚地表明 PDF 中的已遮蔽區域。

為了說明這一點，請考慮一個包含短語"Dummy"的 PDF 文件：

利用 IronSecureDoc 簡單易用的 API，開發人員可以輕鬆發出命令來編輯敏感文字。

以下是一個使用 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'

命令成功執行後，您將收到類似如下的回應：

產生的 PDF 檔案展示了 IronSecureDoc 的有效資訊編輯功能。 敏感內容將永久隱藏，確保機密資訊的安全：

IronSecureDoc 也支援進階編輯方法，例如使用正規表示式或 PDF 中的特定區域編輯內容：

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

這項簡單而強大的功能可確保文件的隱私性並符合嚴格的資料保護標準。

文件認證

文件認證可以確保PDF文件的真實性和完整性。 IronSecureDoc 透過專用 API 簡化了這個過程。 以下是如何使用 Swagger UI 對 PDF 文件進行認證的方法：

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'

當呼叫此 API 時，PDF 將使用數位憑證進行簽名，從而鎖定其內容並證明其合法性。 certificate_permissions 參數決定了接收者在認證後可以對文件執行哪些操作，例如列印或填寫表格。

伺服器回應包含一個可下載的認證檔案。這提供了一種無縫的方式來自動化認證流程，並確保您的 PDF 文件安全、可驗證且合規。

簽署PDF文檔

除了認證功能外，IronSecureDoc 還提供另一項關鍵功能——對 PDF 文件進行數位簽署。 與鎖定整個文件的認證不同，數位簽章增加了驗證功能，但不一定限制編輯。

使用 Swagger UI 中的/v1/document-services/pdfs/sign端點，您可以將可見的簽章影像放置在文件的特定頁面上。 您甚至可以透過調整 signature_image_x、signature_image_y、signature_image_w 和 signature_image_h 參數來自訂其位置和尺寸。

除了簽章位置外，您還可以提供使用者或擁有者密碼，套用憑證以增強信任，並可選擇將文件轉換為 PDF/A 或 PDF/UA 格式以符合規定。

簽署文件：

1. 上傳您要簽署的PDF文件。
2. 上傳有效的數位憑證檔案（.p12 格式）。
3. 上傳簽名圖片檔（PNG 或 JPEG）。
4. 設定簽名位置座標和大小。
5. 點選執行。

完成後，伺服器將返回一個帶有數位簽名的 PDF 文件，可供分發。 此功能非常適合自動化審批工作流程、確認作者身份或為官方文件添加品牌標識——所有這些都可以在保持文件完整性的同時完成。

PDF檔案加密

PDF 安全性的最重要支柱之一是加密。 透過 IronSecureDoc，開發人員可以使用強用戶密碼和擁有者密碼對文件進行加密，同時還可以微調文件使用的權限設定。 若要使用 Swagger UI 執行此操作，請導覽至/v1/document-services/pdfs/encrypt端點並配置所需的欄位：

您可以限制多種文件功能，例如：

• 內容擷取
• 表格填寫
• 註釋
• 印刷
• 修改

如果您想要一個完全鎖定的文檔，只需將所有這些選項設為 false 即可。 以下是對應的 CURL 指令，供您參考：

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'

執行後，輸出結果將會是一個完全加密的 PDF 文件，開啟時會提示使用者輸入密碼。

此功能對於保護敏感記錄、限制存取以及確保即使在分發後也能控製文件至關重要。 無論是內部備忘錄、法律文件或客戶報告，IronSecureDoc 都能輕鬆實現文件安全，而不會中斷您的開發流程。

從PDF中提取文本

需要從 PDF 文件中提取內容？ IronSecureDoc 提供了一種快速且準確的方法來使用/v1/document-services/pdfs/extract端點提取文字。 當您想要自動從發票、報表或大型文件中檢索內容而無需手動複製和貼上時，此功能尤其方便。 要提取文本，請前往 Swagger UI 並使用提供的表單上傳您的檔案：

這些參數可讓您輸入密碼（如果 PDF 受保護），如果您只需要選定頁面的內容，甚至可以指定頁碼。 或者，您可以使用以下 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'

執行完畢後，API 會將擷取的文字作為純文字回應體傳回：

然後可以根據需要解析、儲存或分析此輸出結果。 它簡單、快速，無需任何特殊插件或人工審核。 無論您是在建立文件處理流程，還是想要快速存取文件內容，此功能都能滿足您的需求。

驗證文檔密碼

在處理任何受保護的 PDF 檔案之前，最好先檢查一下您的密碼是否有效。 IronSecureDoc 提供了一種快速可靠的方法來驗證使用者和擁有者密碼，它使用/v1/document-services/pdfs/verify-password端點。 在自動化涉及第三方文件或存檔文件的工作流程時，這一點尤其有用，因為在採取進一步行動之前必須確認密碼的準確性。

在 Swagger UI 中，上傳受保護的 PDF 文件，然後根據您的存取等級填寫相關的 user_password 或 owner_password 欄位：

提交後，如果密碼有效，API 將傳回成功（200 OK）；如果密碼無效，則傳回錯誤。 這種輕量級的驗證步驟可以節省時間，防止不必要的失敗，並有助於簡化自動化 PDF 處理流程。

驗證數位簽名

驗證數位簽章是確保 PDF 文件自簽章以來未被竄改以及簽章有效的關鍵步驟。 IronSecureDoc 透過/v1/document-services/pdfs/verify-signatures端點提供此功能。 當從外部來源接收文件或合規性和信任至關重要時，此端點尤其有用。

在 Swagger UI 中，您只需上傳已簽署的 PDF 文件，如有必要，輸入使用者密碼或所有者密碼即可存取該文件：

您也可以使用 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'

請求執行完畢後，API 會以 JSON 格式傳回詳細的驗證結果。 如果簽名完整且真實，則傳回 true。 如果被篡改或無效，您將看到詳細的故障指示。

此功能可確保 PDF 工作流程中的每個簽名都可驗證且安全性—這是處理法律、財務和合規性敏感文件的重要步驟。

編輯 PDF

StirlingPDF 提供了一種簡單且靈活的方式來使用其/api/v1/security/auto-redact端點從 PDF 文件中刪除內容。 對於希望從 PDF 中刪除敏感詞語或圖案而無需高級設定的開發人員來說，此功能非常理想。

在 Swagger UI 中，您可以輕鬆配置編輯參數。 您上傳一個 PDF 文件，輸入要編輯的文字清單（例如"佔位符"），並調整以下選項：

• useRegex – 基於正規表示式進行編輯
• wholeWordSearch – 僅符合整個單字
• redactColor – 自訂編輯顏色（例如，黑色 #000000）
• customPadding – 在已編輯區域周圍新增間距
• convertPDFToImage – 將輸出轉換為影像，以增強保護。

點擊"執行"後，StirlingPDF 將處理該文件，並根據您的配置刪除所有符合的內容。

驗證簽名

使用/api/v1/security/validate-signature端點，您可以快速檢查嵌入在 PDF 檔案中的數位簽章的真實性。此端點支援預設證書驗證和自訂證書驗證。 您只需提交一個包含 fileInput（您的 base64 編碼的 PDF 檔案或檔案字串）的請求正文，如果您想使用特定憑證進行驗證，您也可以選擇提供 certFile。

該 API 會傳回一個 JSON 結構，其中概述了驗證狀態。

使用數位證書簽署 PDF 文件

StirlingPDF 讓您可以使用憑證透過 /api/v1/security/cert-sign 端點對 PDF 檔案進行數位簽署。 透過 Swagger UI，您可以上傳 PDF 檔案並配置數位簽章選項。 你需要準備以下物品：

• fileInput – 您要簽署的 PDF 文件
• certType – 您使用的憑證類型
• privateKeyFile 、 certFile 、 p12File或jksFile – 取決於憑證類型
• password – 用於金鑰庫或私鑰

您也可以透過以下方式提升簽名體驗：

• showSignature – 在 PDF 中以視覺方式顯示簽名
• reason 、 location 、 name – 簽署的元數據
• pageNumber – 簽名所在的頁碼
• showLogo – 是否在簽名時顯示徽標

點擊"執行"後，StirlingPDF 會處理輸入並傳回一個經過數位簽署的 PDF 檔案。

新增密碼保護

StirlingPDF 讓您可以使用/api/v1/security/add-password端點為文件新增密碼保護。 此功能可讓您定義使用者密碼和擁有者密碼，以及進行精細的權限設定。

使用 Swagger UI，以下是設定方法：

• fileInput – 上傳您想要保護的 PDF 文件
• password – 需要使用者密碼才能開啟文檔
• ownerPassword – 控製檔案內的編輯權限
• keyLength – 選擇加密強度（例如，256 位元）

除此之外，您還可以切換文件限制，例如：

• canPrint 、 canModify 、 canFillInForm
• canExtractContent ， canExtractForAccessibility
• canModifyAnnotations ， canAssembleDocument

點擊"執行"後，輸出結果將會是一個受密碼保護的 PDF 文件，其權限與設定完全一致。

IronSecureDoc 提供企業級授權選項，可滿足各種不同的組織需求。 客戶可以選擇獨立的 IronSecureDoc 企業版許可證，或包含 IronSecureDoc 以及其他產品的綜合性 Iron Suite 企業版授權。

IronSecureDoc 企業許可證

-價格：14,999 美元 -特徵：

• 企業級 PDF 伺服器，無需編寫任何程式碼或使用任何程式語言，可部署在本地或雲端
• 無限制的 PDF 文件編輯、簽名和加密功能，確保您的文件安全。
• 支援離線隔離環境 提供折扣支援和更新套餐

Iron Suite 無限企業版許可證

-價格：19,995 美元 -特徵：

• 包括所有 Iron Software 產品：IronPDF、IronOCR、IronXL、IronWord、IronBarcode 等。
• 無限的開發者、地點和項目，包括 OEM 再分銷
• 客製化的永久企業許可證
• 支援離線隔離環境
• 提供僅限企業用戶的選項
• 支援和更新訂閱涵蓋 Suite 和 IronSecureDoc

支援與更新

Iron Software 提供多種支援和產品更新選項，以確保服務不間斷： -年度訂閱：每年 7,500 美元（每年續訂，可隨時取消） -一年套餐：10,000 美元（一次性購買） -五年套餐：30,000 美元（一次性購買）

這些套餐提供持續的產品更新、安全功能升級以及 Iron Software 工程團隊的支援。

評估選項

對於有興趣在購買前評估 IronSecureDoc 的組織，我們提供免費試用。 本次試用提供全部功能，允許在真實環境中進行全面評估，而無需立即投入資金。

透過選擇合適的授權選項，企業可以確保獲得滿足其特定需求的強大文件安全保障。

StirlingPDF 提供了一個簡單、開源的模型：

免費套餐

核心功能以 AGPL v3 授權發布，可免費使用並自行託管。適合開發者或小型內部使用。

企業許可證

對於需要非AGPL合規性或額外支援的企業，可提供商業許可。 價格根據具體情況而定，需要聯絡他們的團隊。

IronSecureDoc 提供一套全面的文件和支援資源，旨在促進您組織內部的無縫整合和操作。

詳盡的文檔

IronSecureDoc 提供詳細的文檔，內容包括： -快速入門指南：逐步指導如何在各種環境（包括本地伺服器和雲端平台）中啟動和運行 IronSecureDoc。

• API 參考：全面的 RESTful API 文檔，詳細介紹了 PDF 編輯、加密和數位簽章等任務的端點。 -教程和操作指南：演示不同程式語言和框架的整合技術的實用指南，增強開發人員的體驗。

專屬支持

IronSecureDoc 透過以下方式提供強大的支援： -直接工程協助：可透過線上聊天、電子郵件或螢幕分享聯繫專門的工程師團隊，及時、專業地解答技術問題。 -持續改進：致力於根據用戶回饋不斷改進產品，確保 IronSecureDoc 滿足用戶不斷變化的需求。

這種結構化的文件和支援方法凸顯了 IronSecureDoc 致力於提供以使用者為中心的體驗，從而促進在企業環境中的高效實施和持續利用。

說明文件

StirlingPDF 提供全面的文檔，涵蓋各種平台的安裝指南、高級配置選項和豐富的功能清單。

支援。

作為開源項目，StirlingPDF 依靠社區驅動的支援。 使用者可以透過 GitHub 和 Discord 等平台尋求協助，在這些平台上，他們可以報告問題、請求功能，並與其他使用者和貢獻者合作。