使用 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'