Host IronSecureDoc on Mac with C# API

1. Docker Desktop'ı Kurun

Docker Desktop'ı henüz kurmadıysanız, bu adımları takip edin:

1. Docker Desktop indirme sayfasına gidin.
2. Mac için Docker Desktop kurulum dosyasını indirin.
3. Kurulum dosyasını çalıştırın ve ekrandaki yönergeleri izleyin.
4. Kurulumdan sonra, Docker Desktop'ı başlatın ve çalıştığından emin olun.

2. 'IronSecureDoc' Docker Görüntüsünü Çekin

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 Kapsayıcıyı Çalıştırın

Gerekli ortam değişkenleriyle Docker kapsayıcısını ç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

<IRONSECUREDOC_LICENSE_KEY> kısmını gerçek IronSecureDoc lisans anahtarınızla değiştirin. Aksi takdirde, Enterprise Özellikleri üzerinde bir filigran uygulanacaktır.

4. Kapsayıcıya Erişim

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

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

Kapsayıcınızın başarıyla çalıştığını gösteren IronSecureDoc arayüzünü görmelisiniz.

5. Sertifikalı IronSecureDoc Kapsayıcısını Çalıştırın

Kapsayıcıyı bir sertifikalı çalıştırmanız gerekiyorsa, sertifikayı oluşturma ve yerel makineyi yapılandırma adımlarını 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> ifadesini bir şifre ile değiştirin.

2. Docker Kapsayıcısını Çalıştır:

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

6. Kapsayıcıyı Yönetme

Docker komutlarını kullanarak çalışan kapsayıcınızı yönetebilirsiniz. İşte birkaç faydalı komut:

• Kapsayıcıyı durdur:

  docker stop <container_id_or_name>

  docker stop <container_id_or_name>

  SHELL

• Kapsayıcıyı başlat:

  docker start <container_id_or_name>

  docker start <container_id_or_name>

  SHELL

• Kapsayıcıyı kaldır:

  docker rm -f <container_id_or_name>

  docker rm -f <container_id_or_name>

  SHELL

Metni Karart

# 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'yi sansürlemek istediğiniz belgenin gerçek yoluyla ve sensitiveWord'yi sansürlemek istediğiniz WORD kelimeyle değiştirin.

Düzenli İfade Karart

# 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'yi, sansürlemek istediğiniz belgenin gerçek yoluyla ve [0-9]'yi, eşleştirmek ve sansürlemek istediğiniz düzenli ifadeyle 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, cURL kullanarak IronSecureDoc REST API'si ile hem temel hem de ileri düzey işlemlerle nasıl etkileşimde bulunulacağını öğrendiniz. Daha fazla yapılandırma ve kullanım ayrıntıları için tam REST API Referansına bakın.