Host IronSecureDoc on Mac with C# API

1. Docker Desktop'u Yükleme

Docker Desktop'u henüz yüklemediyseniz, şu adımları izleyin:

1. Docker Desktop indirme sayfasına gidin.
2. Mac için Docker Desktop yükleyicisini indirin.
3. Yükleyiciyi çalıştırın ve ekrandaki talimatları izleyin.
4. Yüklemeden sonra Docker Desktop'u başlatın ve çalıştığından emin olun.

2. "IronSecureDoc" Docker Görüntüsünü Çek

Bir komut satırı arayüzü açın ve Docker Hub'dan en son IronSecureDoc görüntüsünü çekin:

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

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

3. Sertifikasız Konteyneri Çalıştırın

Gerekli ortam değişkenleriyle Docker konteynerini çalıştırın:

# 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

Gerçek IronSecureDoc lisans anahtarınızla <IRONSECUREDOC_LICENSE_KEY> değiştirin. Aksi takdirde, Enterprise Özelliklerinde bir filigran uygulanacaktır.

4. Konteynere Erişin

Konteyner çalıştığında, bir web tarayıcısı açarak ve şuraya giderek IronSecureDoc'a erişebilirsiniz:

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

Konteynerin başarılı bir şekilde çalıştığını gösteren IronSecureDoc arayüzünü görmelisiniz.

5. IronSecureDoc Konteynerini Sertifikalı Çalıştırın

Sertifika ile konteyner çalıştırmanız gerekiyorsa, sertifikayı oluşturmak ve yerel makineyi yapılandırmak için bu adımları izleyin:

1. Sertifika Oluştur:

   # 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> yerine bir şifre girin.

2. Docker Konteynerini Çalıştırın:

   # 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
   İpuçları Gerçek IronSecureDoc lisans anahtarınız ve sertifika şifrenizle sırasıyla <IRONSECUREDOC_LICENSE_KEY> ve <CERTIFICATE_PASSWORD> değiştirin.

6. Konteyneri Yönetme

Çalışan konteynerinizi Docker komutlarını kullanarak yönetebilirsiniz. İşte birkaç yararlı komut:

• Konteyneri durdur:

  docker stop <container_id_or_name>

  docker stop <container_id_or_name>

  SHELL

• Konteyneri başlat:

  docker start <container_id_or_name>

  docker start <container_id_or_name>

  SHELL

• Konteyneri kaldır:

  docker rm -f <container_id_or_name>

  docker rm -f <container_id_or_name>

  SHELL

Metni Kapat

# 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'

İflah etmeyi istediğiniz belgenin gerçek yoluyla /path/to/your/document.pdf'ı ve iflah etmek istediğiniz kelimeyle sensitiveWord değiştirin.

Düzenli İfade Kapat

# 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'

İflah etmeyi istediğiniz belgenin gerçek yoluyla /path/to/your/document.pdf'ı ve eşleştirip iflah etmek istediğiniz düzenli ifadeyle [0-9] değiştirin.

Sonuç

IronSecureDoc'u makinenizde başarıyla barındırdınız ve gerekli ortam değişkenleriyle yapılandırdınız. Ayrıca, hem temel hem de gelişmiş işlemler için IronSecureDoc REST API'si ile cURL kullanarak nasıl etkileşimde bulunacağınızı öğrendiniz. Daha fazla yapılandırma ve kullanım detayları için REST API Referansı'na bakın.