Hosting IronSecureDoc on Linux Using C

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:latestdocker pull ironsoftwareofficial/ironsecuredoc:latestGereksinimler
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
- Ubuntu (x86_64 / amd64) - Docker Desktop İndirme Bağlantısı
- Debian (x86_64 / amd64) - Docker Desktop İndirme Bağlantısı
- Fedora (x86_64 / amd64) - Docker Desktop İndirme Bağlantısı
- Red Hat Enterprise Linux (x86_64 / amd64) - Docker Desktop'ı indirmek için link
Adım Adım Kılavuz
1. Docker Desktop'ı Kurun
Docker Desktop'ı henüz kurmadıysanız, bu adımları takip edin:
- Docker Desktop indirme sayfasına gidin.
- Docker Desktop kurulum dosyasını Linux için indirin.
- Kurulum dosyasını çalıştırın ve ekrandaki yönergeleri izleyin.
- 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:latestdocker pull ironsoftwareofficial/ironsecuredoc:latest3. Sertifikasız Kapsayıcıyı Çalıştırın
Gerekli ortam değişkenleriyle Docker kapsayıcısını çalıştırın:

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latestdocker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latestFiligranları Kaldırmak İçin Deneme veya Lisans Anahtarı Uygula
<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 sertifikayla çalıştırmanız gerekiyorsa, sertifika oluşturma ve yerel makineyi yapılandırma adımlarını izleyin:
Sertifika Oluştur:
dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER> dotnet dev-certs https --trustdotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER> dotnet dev-certs https --trustSHELL<CREDENTIAL_PLACEHOLDER>ifadesini bir şifre ile değiştirin.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:latestdocker 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:latestSHELL<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>SHELLKapsayıcıyı başlat:
docker start <container_id>docker start <container_id>SHELLKapsayı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,-pbayrağı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,-pbayrağı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'/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'/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= 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.





