如何在 Docker 中使用 C# 確保 PDF API 的安全

Docker功能

• 可攜性：容器可以在任何平台上運行，無需修改，從開發機器到生產環境。
• 隔離性：每個容器獨立運行，防止應用程式及其依賴項之間的干擾。
• 效率：共用主機系統的核心，相較虛擬機器，容器是極輕量的。
• 輕鬆部署：Docker加速了應用程式的部署，需最小的設置，促進持續整合和交付（CI/CD）。

Docker的組件

• Docker引擎：Docker的骨幹，負責容器的構建、運行和管理。
• Docker映像：只讀模板，用於建立容器，包括應用程式程式碼、運行環境和依賴項。
• Docker容器：Docker映像的運行實例。
• Docker Hub：用於分享和發佈Docker映像的雲端儲存。

Docker在現代DevOps流程中扮演著關鍵角色，確保應用程式部署的可預測性和速度。

T>## 什麼是IronSecureDoc？

IronSecureDoc是一個先進的文件管理和安全工具，提供強大的加密、數位簽署和PDF操作功能。 針對企業和開發者，它確保文件的保密性和完整性，同時簡化PDF處理。 作為一個多功能的PDF API，允許開發者以程式方式生成、上傳、操作和保護PDF。

IronSecureDoc可以從多種資料輸入建立PDF，新增和編輯文字、圖像及元資料。 它可以合併、拆分、並註釋PDF，使用評論、重點突出或水印。 其安全功能包括密碼保護、AES加密和基於證書的存取控制，保護敏感資訊安全。 數位簽署確保文件真實性，在如金融、醫療和法律等行業至關重要。 稽核跟蹤功能可以跟蹤文件活動以確保合規性和責任追究。

IronSecureDoc作為PDF API

IronSecureDoc提供以下PDF API功能：

• PDF建立：從原始資料、文字或其他文件格式建立PDF。
• PDF加密：使用強大的加密算法（如AES）保護PDF。
• PDF解密：使用授權憑據解密加密的PDF。
• 文件簽署：數位簽署PDF，以確保真實性和完整性。
• PDF編輯：修改處理過的PDF中的文字、圖像或元資料。
• 文件分享：安全地分享PDF，使用存取控件。

IronSecureDoc 的特點

高級加密：

• 使用業界標準的加密算法如AES-256來保護文件。
• 設置文件打開（使用者）和擁有者密碼。

數位簽名：

• 對PDF應用數位簽名以驗證真實性。
• 確保不可否認性和防篡改的PDF。

存取控制：

• 用於使用者或群組的資料存取權限設置。
• 控制PDF的查看、編輯、列印和複製權限。

稽核線索：

• 監控所有文件操作，獲取詳細歷史以確保合規。

PDF操作：

• 合併多個PDF或分割大文件。
• 用評論、重點或水印註釋。
• 使用文字提取能力提取資料。

跨平台支持：

• 與.NET、Java等平台整合。
• 作為Docker容器使用於各平台。

可擴展性和性能：

• 在企業環境中優化高文件量。
• 提供快速的複雜操作處理。

API整合：

• 詳細記錄的API供自訂應用程式整合使用。
• RESTful API適用於基於網路的實施。

安裝和運行 IronSecureDoc

使用以下命令從GitHub儲存庫中拉取IronSecureDoc Docker映像。

# Pull the IronSecureDoc Docker image
docker pull ironsoftwareofficial/ironsecuredoc

# Pull the IronSecureDoc Docker image
docker pull ironsoftwareofficial/ironsecuredoc

拉取Docker映像後，使用該命令啟動IronSecureDoc：

# Run IronSecureDoc in a Docker container with specified environment variables
docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

# Run IronSecureDoc in a Docker container with specified environment variables
docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

為PDF文件新增密碼

IronSecureDoc的REST API是現代化的基於網頁的介面，讓開發者能夠安全地與軟體的文件管理和PDF處理功能交互。 利用RESTful原則，這個API提供了一種簡單的方法來將IronSecureDoc功能整合到應用程式中，不論技術堆棧如何。

為PDF文件進行密碼加密，您可以向IronSecureDoc API發出如下請求：

# Use curl to encrypt a PDF document with a user password
curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

# Use curl to encrypt a PDF document with a user password
curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

該命令會加密並安全地儲存PDF文件。

簽署PDF文件

這是一個使用證書簽署PDF的範例程式碼：

# Use curl to digitally certify a PDF document
curl -X POST 'http://localhost:8080/v1/document-services/pdfs/certify' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@Demo.pdf;type=application/pdf' \
  -F 'certificate_file=@DemoSign.pfx;type=application/x-pkcs12' \
  -F 'certificate_password="p4ssw0rd"' \
  -F 'certificate_permissions=1'

# Use curl to digitally certify a PDF document
curl -X POST 'http://localhost:8080/v1/document-services/pdfs/certify' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@Demo.pdf;type=application/pdf' \
  -F 'certificate_file=@DemoSign.pfx;type=application/x-pkcs12' \
  -F 'certificate_password="p4ssw0rd"' \
  -F 'certificate_permissions=1'

該命令處理PDF，使用證書簽署它，並保存輸出為certify.pdf。