使用 C# 在 Linux 上託管 IronSecureDoc

4. 訪問容器

容器運行後，您可以透過開啟網頁瀏覽器並導航至以下位址來存取 IronSecureDoc：

http://localhost:8080/swagger/index.html

您應該會看到 IronSecureDoc 介面，這表示您的容器正在成功運行。

5. 使用憑證執行 IronSecureDoc 容器

如果您需要使用證書執行容器，請按照以下步驟產生證書並設定本機：

1.生成證書：

   dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

   dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

代替<CREDENTIAL_PLACEHOLDER>使用密碼。

2.運行 Docker 容器：

   docker container run -d -p 8081:8081 -p 8080:8080 \
   -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081 \
   -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
   -e ENVIRONMENT=Production \
   -v $HOME/.aspnet/https:/https:ro \
   -e CERTIFICATE_PATH=$HOME/.aspnet/https/ironsecuredoc.pfx \
   -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> \
   ironsoftwareofficial/ironsecuredoc:latest

   docker container run -d -p 8081:8081 -p 8080:8080 \
   -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081 \
   -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
   -e ENVIRONMENT=Production \
   -v $HOME/.aspnet/https:/https:ro \
   -e CERTIFICATE_PATH=$HOME/.aspnet/https/ironsecuredoc.pfx \
   -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> \
   ironsoftwareofficial/ironsecuredoc:latest

代替<IRONSECUREDOC_LICENSE_KEY>和<CERTIFICATE_PASSWORD>分別使用您的 IronSecureDoc 授權金鑰和憑證密碼。

6. 管理容器

您可以使用 Docker 命令管理正在執行的容器。 以下是一些有用的指令：

-停止容器：

  docker stop <container_id>

  docker stop <container_id>

-啟動容器：

  docker start <container_id>

  docker start <container_id>

-移除容器：

  docker rm -f <container_id>

  docker rm -f <container_id>

代替<container_id>使用實際的容器 ID 或名稱。

環境變數

容器可使用下列環境變數進行設定：

• PDF_MAX_SIZE_MB （預設值：30）：設定 PDF 上傳允許的最大檔案大小（以兆位元組為單位）。
• REQUEST_TIMEOUT_SECONDS （預設值：5）：設定 API 請求的逾時時間（以秒為單位）。 值為 -1 時，請求可以無限期地運行。
• ALLOWED_ORIGINS ：透過指定允許的來源 URL 設定跨網域資源共用 (CORS)。 多個網址之間以逗號分隔。 使用 * 或"all"允許來自任何來源的請求。
• HTTP_PORTS ：定義容器公開的 HTTP 連接埠。 這應該與使用-p標誌的連接埠對映相符（例如，8080）。 多個連接埠之間以分號（;）分隔。
• HTTPS_PORTS ：定義容器公開的 HTTPS 連接埠。 這應該與使用-p標誌的連接埠對映相符（例如，8081）。 多個連接埠之間以分號（;）分隔。
• IronSecureDoc_LicenseKey （必要）：設定 IronSecureDoc 授權金鑰。 重要提示：請勿公開此數值。

基本範例：編輯文件中的文本

有關 API 端點的完整列表，請參閱完整的REST API 參考文件。

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
   -H 'accept: */*' \
   -H 'Content-Type: multipart/form-data' \
   -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' \
   -F 'words_to_redact="sensitiveWord"' \
   -F 'draw_black_box=true' \
   -F 'match_whole_word=true' \
   -F 'match_case=true'

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
   -H 'accept: */*' \
   -H 'Content-Type: multipart/form-data' \
   -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' \
   -F 'words_to_redact="sensitiveWord"' \
   -F 'draw_black_box=true' \
   -F 'match_whole_word=true' \
   -F 'match_case=true'

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-regular-expression' \
   -H 'accept: */*' \
   -H 'Content-Type: multipart/form-data' \
   -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' \
   -F 'regular_expression="[0-9]"' \
   -F 'draw_black_box=true'

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-regular-expression' \
   -H 'accept: */*' \
   -H 'Content-Type: multipart/form-data' \
   -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' \
   -F 'regular_expression="[0-9]"' \
   -F 'draw_black_box=true'