1. IronSecureDoc
  2. Eğitimler
  3. Azure Barındırma ve Kurulum

Hosting IronSecureDoc on Linux Using C

Curtis Chau
Curtis Chau
Güncellendi:
This article was translated from English: Does it need improvement?
Translated
View the article in English
IronSecureDoc on Docker

IronSecureDoc, çevrimiçi SaaS hizmetlerinin zahmeti ve yükü olmadan, basit bir REST API'nin arkasında size güçlü PDF manipülasyonu sağlamak üzere tasarlanmış bir Docker konteyneridir. Bu kılavuz, ortam değişkenlerini ayarlama ve REST API'yi kullanmaya yönelik temel bir örnek dahil olmak üzere IronSecureDoc'u makinenize barındırma adımlarında size yol gösterecektir. Tam API için REST API Referansımıza bakın.

docker pull ironsoftwareofficial/ironsecuredoc:latest
docker pull ironsoftwareofficial/ironsecuredoc:latest
SHELL

Ön Koşullar

UyarıDocker Desktop, Linux uzerinde, başlangicta bir sanal makineyi (VM) calistirir ve ozellestirilmis bir docker baglamasi, desktop-linux oluşturur ve kullanir.

Bu, Linux Docker Engine üzerinde dağıtılan (kurulumdan önce) imaj ve konteynerlerin Docker Desktop for Linux'ta bulunmadığı anlamına gelir.

Platformlar

Adım Adım Kılavuz

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. Linux 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

Komut istemcisini açın ve Docker Hub'dan en son IronSecureDoc görüntüsünü çekin:

docker pull ironsoftwareofficial/ironsecuredoc:latest
docker pull ironsoftwareofficial/ironsecuredoc:latest
SHELL

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

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

Swagger UI in Browser
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

Watermarkları Kaldırmak İçin Deneme veya Lisans Anahtarı Uygulayın

İpuçları
<IRONSECUREDOC_LICENSE_KEY> ile gerçek IronSecureDoc lisans anahtarinizi değiştirin. Aksi takdirde, Enterprise Özelliklerinde bir filigran uygulanacaktır.

Swagger UI in Browser

)}]

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
Swagger UI in Browser

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

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

  1. Sertifika Oluştur:

    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> ile bir sifre değiştirin.

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

    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> ve <CERTIFICATE_PASSWORD> ile sirasiyla gerçek IronSecureDoc lisans anahtarinizi ve sertifika sifrenizi değiştirin.

6. Konteyneri Yönetme

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

  • Konteyneri durdur:

    docker stop <container_id>
    docker stop <container_id>
    SHELL

  • Konteyneri başlat:

    docker start <container_id>
    docker start <container_id>
    SHELL

  • Konteyneri kaldır:

    docker rm -f <container_id>
    docker rm -f <container_id>
    SHELL

<container_id> ile gerçek konteyner kimligi veya adini değiştirin.

Ortam Değişkenleri

Konteyner, aşağıdaki ortam değişkenleri kullanılarak yapılandırılabilir:

  • PDF_MAX_SIZE_MB (Varsıyılan: 30): PDF yukleme icin izin verilen maksimum dosya boyutunu Megabayt olarak ayarlar.
  • REQUEST_TIMEOUT_SECONDS (Varsıyılan: 5): API istekleri icin zaman asimi suresini saniye olarak ayarlar. -1 değeri, isteklerin süresiz çalışmasına izin verir.
  • ALLOWED_ORIGINS: Izin verilen kaynak URL'lerini belirterek CORS (Cross-Origin Resource Sharing) i duzenler. Birden fazla URL'yi virgülle ayırın. '*' veya "all" kullanarak her kaynaktan istek kabul edebilirsiniz.
  • HTTP_PORTS: Konteynerin aciga cikaracagi HTTP portlarini tanimlar. Bu, -p bayragi ile kullanilan port eslemeleriyle eslesmelidir (ornegin, 8080). Birden fazla portu noktalı virgül (;) ile ayırın.
  • HTTPS_PORTS: Konteynerin aciga cikaracagi HTTPS portlarini tanimlar. Bu, -p bayragi ile kullanilan port eslemeleriyle eslesmelidir (ornegin, 8081). Birden fazla portu noktalı virgül (;) ile ayırın.
  • IronSecureDoc_LicenseKey (Gerekli): IronSecureDoc lisans anahtarini ayarlar. Önemli: Bu değeri herkese açık olarak paylaşmayın.

Temel Örnek: Bir Belgedeki Metni Kapatın

API uç noktalarının tam listesi için REST API Referansı'na bakın.

Metni Kapat

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

/path/to/your/document.pdf ile duzenlemek istediginiz belgenin gerçek yolunu ve sensitiveWord ile duzenlemek istediginiz kelimeyi değiştirin.

Düzenli İfade Kapat

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

/path/to/your/document.pdf ile duzenlemek istediginiz belgenin gerçek yolunu ve [0-9] ile eslestirip duzenlemek istediginiz duzenli ifadeyi 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.

Sıkça Sorulan Sorular

IronSecureDoc nedir ve nasıl çalışır?

IronSecureDoc, REST API üzerinden güçlü PDF manipülasyonu sunan, çevrimdışı belge güvenliğini SaaS hizmetlerine bağlı kalmadan sağlayan bir Docker konteyneridir.

Bir Linux sunucusunda IronSecureDoc'u kurmak için gereksinimler nelerdir?

Bir Linux sunucusunda IronSecureDoc'u kurmak için, Ubuntu, Debian, Fedora veya Red Hat Enterprise Linux gibi Linux dağıtımınızda Docker Desktop'un yüklü olduğundan emin olun.

IronSecureDoc Docker görüntüsünü nasıl indirebilirim?

IronSecureDoc Docker görüntüsünü terminalinizde şu komutu çalıştırarak indirin: docker pull ironsoftwareofficial/ironsecuredoc:latest.

IronSecureDoc konteynerini SSL sertifikası olmadan çalıştırmak mümkün mü?

Evet, bir SSL sertifikası olmadan konteyneri şu komutu kullanarak çalıştırabilirsiniz: docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=-e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest.

IronSecureDoc arayüzüne tarayıcımda nasıl erişebilirim?

Konteyneri başlattıktan sonra, IronSecureDoc arayüzüne web tarayıcınızda http://localhost:8080/swagger/index.html adresini ziyaret ederek erişin.

IronSecureDoc için bir SSL sertifikasını nasıl oluşturur ve güvenir hale getiririm?

Bir SSL sertifikası oluşturun: dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p ve ona güvenin: dotnet dev-certs https --trust.

IronSecureDoc'ta yapılandırma için mevcut olan ortam değişkenleri nelerdir?

IronSecureDoc'ta yapılandırılabilir ortam değişkenleri PDF_MAX_SIZE_MB, REQUEST_TIMEOUT_SECONDS, ALLOWED_ORIGINS, HTTP_PORTS, HTTPS_PORTS ve IronSecureDoc_LicenseKey içerir.

IronSecureDoc kullanarak bir PDF'de metni nasıl karartabilirim?

Bir PDF'de metni karartmak için bir cURL komutu kullanın: curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' gerekli form verileriyle birlikte.

Çalışan bir IronSecureDoc Docker konteynerini durdurmak için hangi komutu kullanmalıyım?

Çalışan bir Docker konteynerini şu komut ile durdurun: docker stop.

IronSecureDoc için kapsamlı bir API uç noktaları listesini nerede bulabilirim?

Tam API uç noktaları listesi IronSecureDoc web sitesindeki REST API Referansı'nda mevcuttur.

Curtis Chau
Curtis Chau
  Mühendislik takımıyla şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Sürüm: 2024.10 just released
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz?
bir örnek çalıştırın PDF'inizin şifrelenmiş hale gelmesini izleyin.