Hosting IronSecureDoc on Linux Using C#

플랫폼

• 우분투 (x86_64 / amd64) - Docker Desktop 다운로드 링크
• 데비안 (x86_64 / amd64) - Docker Desktop 다운로드 링크
• 페도라 (x86_64 / amd64) - Docker Desktop 다운로드 링크
• 레드햇 Enterprise 리눅스 (x86_64 / amd64) - Docker Desktop 다운로드 링크

1. Docker Desktop 설치

Docker Desktop을 아직 설치하지 않았다면 다음 단계를 따르세요.

1. Docker Desktop 다운로드 페이지 로 이동합니다.
2. Linux용 Docker Desktop 설치 프로그램을 다운로드하세요.
3. 설치 프로그램을 실행하고 화면의 지시를 따르십시오.
4. 설치가 완료되면 Docker Desktop을 시작하고 정상적으로 실행 중인지 확인하십시오.

2. "IronSecureDoc" Docker 이미지를 다운로드합니다.

명령 프롬프트를 열고 Docker Hub에서 최신 IronSecureDoc 이미지를 가져오세요.

docker pull ironsoftwareofficial/ironsecuredoc:latest

docker pull ironsoftwareofficial/ironsecuredoc:latest

3. 인증서 없이 컨테이너 실행

필요한 환경 변수를 설정하여 Docker 컨테이너를 실행하세요.

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

SHELL

워터마크를 제거하려면 체험판 또는 라이선스 키를 적용하세요.

[{티:(
<IRONSECUREDOC_LICENSE_KEY>을 실제 IronSecureDoc 라이선스 키로 교체하십시오. 그렇지 않으면 Enterprise 기능에 워터마크가 적용됩니다.

)}]

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

   SHELL

   <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

   SHELL

   <IRONSECUREDOC_LICENSE_KEY>과 <CERTIFICATE_PASSWORD>을 각각 실제 IronSecureDoc 라이선스 키와 인증서 비밀번호로 교체하십시오.

6. 컨테이너 관리

Docker 명령어를 사용하여 실행 중인 컨테이너를 관리할 수 있습니다. 다음은 몇 가지 유용한 명령어입니다.

• 컨테이너를 중지합니다 .

  docker stop <container_id>

  docker stop <container_id>

  SHELL

• 컨테이너를 시작합니다 .

  docker start <container_id>

  docker start <container_id>

  SHELL

• 용기를 제거하세요 :

  docker rm -f <container_id>

  docker rm -f <container_id>

  SHELL

<container_id>을 실제 컨테이너 ID 또는 이름으로 교체하십시오.

텍스트 수정

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'

/path/to/your/document.pdf을 교체하여 편집하고 싶은 문서의 실제 경로로 설정하고 sensitiveWord 을 교체하여 편집하고 싶은 단어로 설정하십시오.

정규 표현식 수정

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'

/path/to/your/document.pdf을 교체하여 편집하고 싶은 문서의 실제 경로로 설정하고 [0-9]을 교체하여 적합 및 편집하려는 정규 표현식으로 설정하십시오.

결론

IronSecureDoc을 컴퓨터에 성공적으로 설치하고 필요한 환경 변수를 설정했습니다. 또한 cURL을 사용하여 기본 및 고급 작업을 통해 IronSecureDoc REST API와 상호 작용하는 방법을 배웠습니다. 자세한 구성 및 사용 정보는 전체 REST API 참조 문서를 참조하십시오.