IronSecureDoc을 사용한 Stirling PDF Docker Compose 대체 방법

IronSecureDoc 설정은 Docker 기반 배포 덕분에 간단합니다. 이것은 개발자가 복잡한 설치 과정을 거치지 않고 보안 기능을 빠르게 통합할 수 있게 해줍니다.

1단계: IronSecureDoc Docker 이미지 가져오기

시작하려면, 최신 IronSecureDoc Docker 이미지를 가져오십시오:

docker pull ironsoftwareofficial/ironsecuredoc:latest

docker pull ironsoftwareofficial/ironsecuredoc:latest

2단계: IronSecureDoc 컨테이너 실행

이미지를 다운로드한 후 필요한 환경 변수를 사용하여 컨테이너를 실행하십시오:

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

귀하의 유효한 라이선스 키로 <IRONSECUREDOC_LICENSE_KEY>를 대체하세요. 이는 서비스가 완전한 기능으로 실행되게 합니다.

3단계: API 엔드포인트 접근

컨테이너가 실행되고 나면, Swagger를 통해 API 엔드포인트를 탐색할 수 있습니다:

• Swagger UI (포트 8080):
  http://localhost:8080/swagger/index.html

이 설정으로, 애플리케이션에 IronSecureDoc의 고급 보안 기능을 통합할 수 있습니다.

StirlingPDF는 Docker를 사용하여 빠르게 배포할 수 있는 오픈 소스 PDF 처리 도구입니다. 설정은 간단하며 보안 및 문서 조작 기능을 즉시 활용할 수 있습니다.

1단계: StirlingPDF Docker 이미지 가져오기

먼저, 최신 StirlingPDF Docker 이미지를 다운로드하려면 다음을 실행하십시오:

docker pull casjaysdevdocker/stirlingpdf:latest

docker pull casjaysdevdocker/stirlingpdf:latest

또는 Docker Desktop에서 검색하십시오:

2단계: StirlingPDF 컨테이너 실행

이미지가 사용 가능해지면 새 컨테이너를 시작할 수 있습니다. Docker 인터페이스에서 설정을 다음과 같이 구성합니다:

• 컨테이너 이름: StirlingPDF
• 호스트 포트: 8090

또한 CLI를 통해 실행할 수도 있습니다:

docker run --rm -p 8090:8080 casjaysdevdocker/stirlingpdf:latest

docker run --rm -p 8090:8080 casjaysdevdocker/stirlingpdf:latest

3단계: API에 액세스하기

컨테이너가 실행되면 StirlingPDF Swagger UI에 접근하여 사용 가능한 API 엔드포인트를 탐색할 수 있습니다:

http://localhost:8090/swagger-ui/index.html#/

이 설정을 통해 StirlingPDF의 문서 보안 기능을 사용할 수 있습니다.

텍스트 삭제

기밀 정보를 처리할 때 가장 중요한 보안 기능 중 하나는 삭제, 즉 PDF 문서에서 민감한 내용을 영구히 삭제할 수 있는 기능입니다. IronSecureDoc는 이 작업을 잘 수행하며, 특정 단어나 구문을 빠르게 삭제할 수 있는 사용하기 쉽고 효율적인 API 엔드포인트를 제공합니다.

• 유연한 텍스트 삭제: 사용자는 삭제할 정확한 단어나 구문을 지정할 수 있습니다. API는 부분 단어 및 전체 단어 매칭을 query 매개변수를 통해 구성할 수 있도록 지원합니다.

• 대소문자 민감도 제어: 대소문자 구분 매칭을 전환할 수 있어 검색 동작에 대한 정확한 제어를 제공합니다.

• 시각적 삭제: 선택한 텍스트를 검은 상자로 시각적으로 가려 PDF 내 삭제된 영역을 명확히 표시할 수 있습니다.

이를 설명하기 위해 'Dummy'라는 구문이 포함된 PDF 문서를 고려해 보세요:

IronSecureDoc의 간단한 API를 사용하여 개발자는 민감한 텍스트를 삭제하는 명령을 쉽게 내릴 수 있습니다.

다음은 Curl을 사용한 실제 예제입니다:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/redact-text?draw_black_box=true&match_whole_word=false&words_to_redact=Dummy&match_case=false&save_as_pdfa=false&save_as_pdfua=false' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/redact-text?draw_black_box=true&match_whole_word=false&words_to_redact=Dummy&match_case=false&save_as_pdfa=false&save_as_pdfua=false' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

명령이 성공적으로 실행되면 다음과 유사한 응답을 받게 됩니다:

결과 PDF는 IronSecureDoc의 효과적인 삭제 기능을 보여줍니다. 민감한 내용은 영구히 가려져 기밀 정보가 안전하게 유지됩니다:

IronSecureDoc는 정규 표현식 또는 PDF 내 특정 영역을 사용하여 내용을 삭제하는 고급 삭제 방법도 지원합니다:

• /v1/document-services/pdfs/redact-regular-expression
• /v1/document-services/pdfs/redact-region

이 간단하지만 강력한 기능은 문서가 개인정보 보호를 유지하고 엄격한 데이터 보호 기준을 충족할 수 있도록 보장합니다.

문서 인증

문서 인증은 PDF 파일의 진위성과 무결성을 보장합니다. IronSecureDoc는 전용 API를 사용하여 이 프로세스를 단순화합니다. Swagger UI를 사용하여 PDF 문서를 인증하는 방법은 다음과 같습니다:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/certify?certificate_password=P%40ssw0rd123&certificate_permissions=3' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf' \
  -F 'certificate_file=@certificate.p12;type=application/x-pkcs12'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/certify?certificate_password=P%40ssw0rd123&certificate_permissions=3' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf' \
  -F 'certificate_file=@certificate.p12;type=application/x-pkcs12'

이 API가 호출되면 PDF는 디지털 인증서로 서명되어 그 내용이 잠기고 그 진위성이 입증됩니다. certificate_permissions 매개변수는 인증 후 수신자가 문서로 수행할 수 있는 작업(예: 인쇄 또는 양식 작성)을 결정합니다.

서버 응답에는 다운로드 가능한 인증 파일이 포함되어 있어 PDF가 안전하고 검증 가능하며 규정을 준수하도록 인증 프로세스를 자동화하는 매끄러운 방법을 제공합니다.

PDF 문서 서명

인증과 함께 IronSecureDoc는 PDF 문서를 디지털 방식으로 서명할 수 있는 또 다른 중요한 기능을 제공합니다. 전체 문서를 잠그는 인증과 달리, 디지털 서명은 검증을 추가하면서 반드시 편집을 제한하지는 않습니다.

Swagger UI의 /v1/document-services/pdfs/sign 엔드포인트를 사용하여 문서의 특정 페이지에 눈에 띄는 서명 이미지를 넣을 수 있습니다. 서명 이미지의 위치와 크기를 조정하여 서명의 위치와 크기를 커스터마이즈할 수 있습니다.

서명 배치 외에도 사용자 또는 소유자 암호를 제공하고, 신뢰를 높이기 위해 인증서를 적용하고, 옵션으로 문서를 규정을 준수하기 위해 PDF/A 또는 PDF/UA 형식으로 변환할 수 있습니다.

문서에 서명하려면:

1. 서명하려는 PDF를 업로드합니다.
2. 유효한 디지털 인증서 파일(.p12 형식)을 업로드합니다.
3. 서명 이미지 파일(PNG 또는 JPEG)을 업로드합니다.
4. 서명 위치 좌표 및 크기를 설정합니다.
5. 실행을 클릭합니다.

완료되면 서버는 배포 준비가 된 디지털 서명이 된 PDF를 반환합니다. 이 기능은 승인 워크플로를 자동화하거나 저작권을 확인하거나 공식 문서에 브랜드를 추가하는 데 뛰어나며 문서의 무결성을 유지합니다.

PDF 파일 암호화

PDF 보안의 가장 중요한 기둥 중 하나는 암호화입니다. IronSecureDoc를 사용하면 개발자는 강력한 사용자 및 소유자 비밀번호를 사용하여 문서를 암호화할 수 있으며, 또한 문서 사용에 대한 권한 설정을 세부 조정할 수 있습니다. Swagger UI를 사용하여 이 작업을 수행하려면 /v1/document-services/pdfs/encrypt 엔드포인트로 이동하여 필요한 필드를 구성하세요:

다음과 같은 다양한 문서 기능을 제한할 수 있습니다:

• 콘텐츠 추출
• 양식 작성
• 주석
• 인쇄
• 수정

완전한 잠금을 원하는 경우 이러한 옵션을 모두 거짓으로 설정하세요. 참조용 당와 같은 CURL 명령이 있습니다:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?allow_extracting_content=false&allow_form_filling=false&allow_annotations=false&allow_printing=false&allow_modifications=false&new_user_password=123&new_owner_password=123' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?allow_extracting_content=false&allow_form_filling=false&allow_annotations=false&allow_printing=false&allow_modifications=false&new_user_password=123&new_owner_password=123' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

실행 후 출력은 완전히 암호화된 PDF 파일이 되어 사용자가 열 때 비밀번호 입력을 요구합니다.

이 기능은 민감한 기록을 보호하고, 액세스를 제한하며, 배포 후에도 문서 통제를 보장하는 데 필수적입니다. 내부 메모, 법률 문서 또는 고객 보고서에 관계없이 IronSecureDoc는 개발 흐름을 방해하지 않으면서 문서 보안을 쉽게 적용할 수 있게 합니다.

PDF에서 텍스트 추출

PDF 파일에서 콘텐츠를 추출해야 합니까? IronSecureDoc는 /v1/document-services/pdfs/extract 엔드포인트를 사용하여 텍스트를 빠르고 정확하게 추출하는 방법을 제공합니다. 이 기능은 청구서, 보고서 또는 대형 문서에서 콘텐츠 검색을 자동화하고자 할 때 특히 유용하며, 수작업으로 복사 및 붙여넣기를 하지 않아도 됩니다. 텍스트를 추출하려면 Swagger UI로 이동하여 제공된 양식을 사용하여 파일을 업로드하세요:

파라미터를 통해 비밀번호 입력(PDF가 보호된 경우)이 가능하며 선택한 페이지의 콘텐츠만 필요한 경우 페이지 번호를 지정할 수도 있습니다. 또한 다음 CURL 명령을 사용할 수도 있습니다:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/extract' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@long_text_test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/extract' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@long_text_test.pdf;type=application/pdf'

실행 후 API는 추출된 텍스트를 일반 응답 본문으로 반환합니다:

이 출력은 필요에 따라 구문 분석, 저장 또는 분석할 수 있습니다. 이는 간단하고 빠르며, 특별한 플러그인이나 수동 검토가 필요하지 않습니다. 문서 처리 파이프라인을 구축하거나 파일의 콘텐츠에 빠르게 액세스하려는 경우, 이 기능이 작업을 완료합니다.

문서 비밀번호 확인

보안 PDF를 처리하기 전에 비밀번호가 유효한지 확인하는 것이 좋습니다. IronSecureDoc는 /v1/document-services/pdfs/verify-password 엔드포인트를 사용하여 사용자와 소유자 비밀번호를 빠르고 신뢰성 있게 확인하는 방법을 제공합니다. 이는 제3자 문서 또는 보관된 파일을 포함하는 작업 흐름을 자동화할 때 특히 유용하며, 추가 작업 전에 비밀번호의 정확성을 확인해야 합니다.

Swagger UI에서 보안 PDF를 업로드한 다음 접속 수준에 따라 관련 user_password 또는 owner_password 필드를 채우세요:

제출 후 비밀번호가 유효하면 API는 성공(200 OK)을 반환하고 유효하지 않다면 오류를 반환합니다. 이 경량 검증 단계는 시간을 절약하고 불필요한 실패를 방지하며 자동 PDF 처리 간소화를 도와줍니다.

디지털 서명 확인

디지털 서명을 확인하는 것은 PDF 문서가 서명 후 수정되지 않았고 서명이 유효한지 확인하기 위한 중요한 단계입니다. IronSecureDoc는 /v1/document-services/pdfs/verify-signatures 엔드포인트를 통해 이 기능을 제공합니다. 이 엔드포인트는 외부 소스에서 문서를 받았거나 준수 및 신뢰가 필수적인 경우에 특히 유용합니다.

Swagger UI에서 서명된 PDF 파일을 업로드하기만 하면 되며, 필요시 파일에 엑세스하기 위해 user_password 또는 owner_password를 입력하세요:

이 작업은 CURL 요청을 사용하여 실행할 수도 있습니다:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/verify-signatures' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test_Signed.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/verify-signatures' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test_Signed.pdf;type=application/pdf'

요청 실행 후 API는 JSON 형식으로 자세한 검증 결과를 반환합니다. 서명이 완전하고 정품인 경우 true를 반환합니다. 변조되었거나 유효하지 않은 경우, 자세한 실패 지표를 보게 됩니다.

이 기능은 PDF 워크플로의 모든 서명이 검증 가능하고 안전하도록 보장하며, 이는 법률, 금융 및 준수에 민감한 문서에 필수적인 단계입니다.

PDF 정제

StirlingPDF는 /api/v1/security/auto-redact 엔드포인트를 사용하여 PDF 문서의 내용을 정제하는 간단하고 유연한 방법을 제공합니다. 이 기능은 복잡한 설정 없이 PDF에서 민감한 단어나 패턴을 제거하려는 개발자에게 이상적입니다.

Swagger UI에서 정제 매개변수를 쉽게 구성할 수 있습니다. PDF를 업로드하고, 정제할 텍스트 목록(예: "더미")을 입력하고, 다음과 같은 옵션을 조정합니다:

• useRegex – 정규 표현식을 기반으로 수정
• wholeWordSearch – 전체 단어만 일치
• redactColor – 수정 색상 사용자 정의 (예: 검정색 #000000)
• customPadding – 수정된 영역에 여백 추가
• convertPDFToImage – 추가 보호를 위해 출력을 이미지로 변환

일단 실행을 클릭하면 StirlingPDF는 파일을 처리하고 구성에 따라 모든 일치하는 콘텐츠를 제거합니다.

서명 유효성 검사

/api/v1/security/validate-signature 엔드포인트를 사용하여 PDF 파일에 내장된 디지털 서명의 진위 여부를 빠르게 확인할 수 있습니다. 엔드포인트는 기본 및 사용자 지정 인증서 검증을 모두 지원합니다. fileInput(기본64 또는 파일 문자열로 된 PDF)와 특정 인증서에 대해 검증하려면 certFile을 선택적으로 제공하여 요청 본문을 제출하기만 하면 됩니다.

이 API는 검증 상태를 설명하는 JSON 구조를 반환합니다.

디지털 인증서를 사용하여 PDF 파일 서명

StirlingPDF는 /api/v1/security/cert-sign 엔드포인트를 사용하여 인증서를 통해 PDF 파일을 디지털로 서명할 수 있게 합니다. Swagger UI를 통해 PDF를 업로드하고 디지털 서명 옵션을 구성할 수 있습니다. 필요한 것은 다음과 같습니다:

• fileInput – 서명하고자 하는 PDF 파일
• certType – 사용 중인 인증서 유형
• privateKeyFile, certFile, p12File, 또는 jksFile – 인증서 유형에 따라
• password – 키 저장소 또는 개인 키를 위해

서명 경험을 향상시킬 수도 있습니다:

• showSignature – PDF에 서명을 시각적으로 표시
• reason, location, name – 서명에 대한 메타데이터
• pageNumber – 서명이 나타나야 하는 페이지
• showLogo – 서명과 함께 로고를 표시할지 여부

실행을 누르면 StirlingPDF가 입력을 처리하고 디지털 서명이 추가된 PDF를 반환합니다.

비밀번호 보호 추가

StirlingPDF는 /api/v1/security/add-password 엔드포인트를 사용하여 문서를 비밀번호 보호로 잠글 수 있게 합니다. 이 기능을 통해 사용자 및 소유자 비밀번호를 정의하고 세밀한 권한 설정을 할 수 있습니다.

Swagger UI를 사용하여 다음과 같이 설정합니다:

• fileInput – 보호하고자 하는 PDF 업로드
• password – 문서를 열기 위해 사용자의 비밀번호가 필요합니다
• ownerPassword – 파일 내 편집 권한 제어
• keyLength – 암호화 강도를 선택 (예: 256비트)

그 외에도 다음과 같은 문서 제한을 전환할 수 있습니다:

• canPrint, canModify, canFillInForm
• canExtractContent, canExtractForAccessibility
• canModifyAnnotations, canAssembleDocument

실행을 누르면 출력은 구성된 대로 권한이 지정된 비밀번호 보호 PDF가 됩니다.

IronSecureDoc는 다양한 조직 요구에 맞춘 Enterprise급 라이선스 옵션을 제공합니다. 고객은 IronSecureDoc Enterprise 라이선스 단독 또는 다양한 제품이 포함된 포괄적인 Iron Suite Enterprise 라이선스 중에서 선택할 수 있습니다.

IronSecureDoc Enterprise 라이선스

• 가격: USD 14,999
• 특징:
  • 코드 없이 또는 프로그래밍 언어로 로컬 또는 클라우드에 호스팅되는 Enterprise PDF 서버 지원
  • 문서를 보호하기 위해 무제한 PDF 편집, 서명 및 암호화
  • 오프라인 에어 갭 환경을 지원
  • 할인된 지원 및 업데이트 번들이 제공됩니다

Iron Suite Unlimited Enterprise License

• 가격: USD 19,995
• 특징:
  • 모든 Iron Software 제품 포함: IronPDF, IronOCR, IronXL, IronWord, IronBarcode 등
  • 무제한 개발자, 위치 및 프로젝트 포함, OEM 재배포 포함
  • 맞춤형 영구 Enterprise 라이선스
  • 오프라인 에어 갭 환경을 지원
  • Enterprise 전용 옵션 제공
  • Suite 및 IronSecureDoc를 커버하는 지원 및 업데이트 구독

지원 및 업데이트

Iron Software는 중단 없는 서비스를 보장하기 위해 다양한 지원 및 제품 업데이트 옵션을 제공합니다:

• 연간 구독: 연간 $7,500 (매년 갱신, 언제든 해지 가능)
• 1년 패키지: $10,000 (일회성 구매)
• 5년 패키지: $30,000 (일회성 구매)

이 패키지는 Iron Software의 엔지니어링 팀의 지원과 함께 지속적인 제품 업데이트, 보안 기능 업그레이드에 대한 접근을 제공합니다.

평가 옵션

IronSecureDoc 구매 전에 평가를 원하는 조직을 위해 무료 체험판을 제공합니다. 이 체험판은 전체 기능을 제공하며 즉각적인 재정적 약속 없이 실제 환경에서 포괄적인 평가를 할 수 있습니다.

적절한 라이선스 옵션을 선택함으로써 기업은 특정 요구에 맞춤화된 강력한 문서 보안을 보장할 수 있습니다.

StirlingPDF는 간단한 오픈소스 모델을 제공합니다:

무료 등급

AGPL v3 라이선스 하에 제공되며, 핵심 기능을 무료로 사용하고 자체 호스팅할 수 있습니다. 개발자 또는 소규모 내부 사용에 적합합니다.

Enterprise License

비 AGPL 준수 또는 추가 지원이 필요한 기업을 위한 상업적 라이선스를 제공합니다. 가격은 맞춤화 되어 있으며 팀과의 연락이 필요합니다.

IronSecureDoc는 조직 내 원활한 통합 및 운영을 촉진하도록 설계된 포괄적인 문서 및 지원 리소스를 제공합니다.

방대한 문서

IronSecureDoc는 다음을 포괄하는 자세한 문서를 제공합니다:

• 빠른 시작 가이드: 로컬 서버 및 클라우드 플랫폼을 포함한 다양한 환경에서 IronSecureDoc의 설정 및 실행을 위한 단계별 지침.
• API 참조: PDF 삭제, 암호화, 디지털 서명과 같은 작업을 위한 엔드포인트를 설명하는 포괄적인 RESTful API 문서.
• 튜토리얼 및 사용법: 개발 경험을 향상시키기 위한 다양한 프로그래밍 언어 및 프레임워크와의 통합 기술을 보여주는 실용적인 가이드.

전문 지원

IronSecureDoc는 다음을 통해 견고한 지원을 보장합니다:

• 직접 엔지니어링 지원: 라이브 채팅, 이메일 또는 화면 공유를 통해 전담 엔지니어 팀에 접근하여 기술 문의에 대한 적시적이고 전문적인 응답 제공.
• 지속적 개선: 사용자 피드백을 기반으로 제품을 발전시켜 사용자의 변화하는 요구를 충족하는 약속.

이러한 체계적인 문서 및 지원 접근 방식은 사용자 중심의 경험을 제공하겠다는 IronSecureDoc의 헌신을 강조하며, 기업 환경 내에서의 효율적인 구현과 지속적인 사용을 촉진합니다.

문서

StirlingPDF는 다양한 플랫폼에 대한 설치 가이드, 고급 구성 옵션, 광범위한 기능 목록을 다루는 포괄적인 문서를 제공합니다.

지원

오픈 소스 프로젝트로서 StirlingPDF는 커뮤니티 주도의 지원에 의존합니다. 사용자는 GitHub 및 Discord와 같은 플랫폼을 통해 도움을 받을 수 있으며, 여기서 문제를 보고하고, 기능을 요청하며 다른 사용자 및 기여자와 협력할 수 있습니다.