Host IronSecureDoc on Mac with C# API

1. Docker Desktop 설치

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

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

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

명령줄 인터페이스를 열고 Docker Hub에서 최신 IronSecureDoc 이미지를 가져옵니다.

# Pull the latest IronSecureDoc image
docker pull ironsoftwareofficial/ironsecuredoc:latest

# Pull the latest IronSecureDoc image
docker pull ironsoftwareofficial/ironsecuredoc:latest

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

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

# Run the Docker container with 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 the Docker container with 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

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

4. 컨테이너에 접근하기

컨테이너가 실행되면 웹 브라우저를 열고 다음 주소로 이동하여 IronSecureDoc에 액세스할 수 있습니다.

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

컨테이너가 성공적으로 실행 중임을 나타내는 IronSecureDoc 인터페이스가 표시될 것입니다.

5. 인증서를 사용하여 IronSecureDoc 컨테이너를 실행합니다.

컨테이너를 인증서와 함께 실행해야 하는 경우, 다음 단계를 따라 인증서를 생성하고 로컬 머신을 구성하십시오.

1. 인증서 생성 :

   # Generate and trust HTTPS development certificate
   dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

   # Generate and trust HTTPS development certificate
   dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

   SHELL

   <CREDENTIAL_PLACEHOLDER>을 비밀번호로 대체하십시오.

2. Docker 컨테이너 실행 :

   # Run the container with HTTPS support
   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

   # Run the container with HTTPS support
   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_or_name>

  docker stop <container_id_or_name>

  SHELL

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

  docker start <container_id_or_name>

  docker start <container_id_or_name>

  SHELL

• 용기를 제거하세요 :

  docker rm -f <container_id_or_name>

  docker rm -f <container_id_or_name>

  SHELL

텍스트 수정

# Redact specific words in a PDF document
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'

# Redact specific words in a PDF document
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을 수정하려는 단어로 대체하십시오.

정규 표현식 수정

# Redact text based on a regular expression in a PDF document
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'

# Redact text based on a regular expression in a PDF document
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 참조 문서를 참조하십시오.