Hosting IronSecureDoc on Linux Using C

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, güçlü PDF manipülasyonu sunan basit bir REST API'ye sahip Docker kapsayıcısıdır. Bu kılavuz, ortam değişkenlerini ayarlama ve REST API'yi kullanmanın temel bir örneği de dahil olmak üzere, IronSecureDoc'u makinenizde barındırma adımlarını size anlatacaktır. Tam API için, REST API Referansı sayfamızı görüntüleyin.

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

Gereksinimler

UyarıLinux'ta Docker Desktop, başlangıçta özel bir docker bağlamı desktop-linux oluşturan ve kullanan bir Sanal Makine (VM) çalıştırır.

Bu, kurulumdan önce Linux Docker Engine üzerinde dağıtılan görüntülerin ve kapsayıcıların Linux için Docker Desktop'ta mevcut olmadığı anlamına gelir.

Platformlar

Adım Adım Kılavuz

1. Docker Desktop'ı Kurun

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

  1. Docker Desktop indirme sayfasına gidin.
  2. Docker Desktop kurulum dosyasını Linux için 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 istemi 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 Kapsayıcıyı Çalıştırın

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

Filigranları Kaldırmak İçin Deneme veya Lisans Anahtarı Uygula

İpuçları
<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.

Swagger UI in Browser

)}]

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

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

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

    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> 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>
    docker stop <container_id>
    SHELL
  • Kapsayıcıyı başlat:

    docker start <container_id>
    docker start <container_id>
    SHELL
  • Kapsayıcıyı kaldır:

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

<container_id> ifadesini gerçek konteyner kimliği veya adıyla değiştirin.

Ortam Değişkenleri

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

  • PDF_MAX_SIZE_MB (Varsayılan: 30): PDF yüklemeleri için izin verilen maksimum dosya boyutunu megabayt cinsinden ayarlar.
  • REQUEST_TIMEOUT_SECONDS (Varsayılan: 5): API istekleri için zaman aşımı süresini saniye cinsinden ayarlar. -1 değeri, isteklerin süresiz çalışmasına izin verir.
  • ALLOWED_ORIGINS: İzin verilen kaynak URL'lerini belirterek Cross-Origin Resource Sharing (CORS) yapılandırır. Birden çok URL'yi virgülle ayırın. Herhangi bir kökenden gelen istekleri kabul etmek için * veya "all" kullanın.
  • HTTP_PORTS: Konteynerin açığa çıkardığı HTTP bağlantı noktalarını tanımlar. Bu, -p bayrağını (ör. 8080) kullanan bağlantı noktası eşlemesiyle eşleşmelidir. Birden fazla portu noktalı virgülle (;) ayırın.
  • HTTPS_PORTS: Konteynerin açığa çıkardığı HTTPS bağlantı noktalarını tanımlar. Bu, -p bayrağını (ör. 8081) kullanan bağlantı noktası eşlemesiyle eşleşmelidir. Birden fazla portu noktalı virgülle (;) ayırın.
  • IronSecureDoc_LicenseKey (Gerekli): IronSecureDoc lisans anahtarını ayarlar. Önemli: Bu değeri herkese açık olarak paylaşmayın.

Temel Örnek: Bir Belgede Metni Karartma

Tüm API uç noktalarının tam listesini görmek için tam REST API Referansına bakın.

Metni Karart

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

Düzenli İfade Karart

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

Sıkça Sorulan Sorular

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

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

Bir Linux sunucuda IronSecureDoc kurulumunun gereksinimleri nelerdir?

Bir Linux sunucuda IronSecureDoc kurmak için, Ubuntu, Debian, Fedora veya Red Hat Enterprise Linux gibi sürümlerde Docker Desktop'un kurulu olduğundan emin olun.

IronSecureDoc Docker imajını nasıl indirebilirim?

IronSecureDoc Docker imajını terminalinizdeki şu komutu yürüterek indirin: docker pull ironsoftwareofficial/ironsecuredoc:latest.

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

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

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

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

IronSecureDoc için SSL sertifikasını nasıl oluşturabilirim ve güvenebilir miyim?

dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p kullanarak bir SSL sertifikası oluşturun ve dotnet dev-certs https --trust ile güven sağlayın.

IronSecureDoc'da yapılandırma için hangi ortam değişkenleri mevcut?

IronSecureDoc'da 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'te metni nasıl karartabilirim?

Gerekli form verileri ile curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' kullanarak bir PDF'te metni karartabilirsiniz.

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

Çalışan bir Docker konteynerini docker stop komutunu kullanarak durdurun.

IronSecureDoc için kapsamlı bir API uç noktaları listesine nereden ulaşabilirim?

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

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

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

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz?
bir örnek çalıştırın PDF'nizin şifrelenmesini izleyin.