1. IronSecureDoc
  2. Nasıl Yapılır
  3. Metni Redakte Et

How to Redact Text in C# PDF with IronSecureDoc

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

Bu makalede, IronSecureDoc kullanarak bir PDF üzerindeki metni sansürlemeyi tartışacağız. Bu, hizmet veya sürecin çalışan IronSecureDoc sunucusuna PDF ile basit bir POST isteği yaparak, hassas bilgileri hızlı ve kolay bir şekilde sansürlemesine olanak tanır. Bunu Swagger dokümanlarını kullanarak görsel olarak göstereceğiz. POST isteği hem gerekli hem de isteğe bağlı parametreleri alır ve oldukça özelleştirilebilir; Yanıt, sansürlenen metinle PDF'i döner.

IronSecureDoc ile PDF Üzerinde Metin Sansürleme Yöntemi

  1. IronSecureDoc Docker Görüntüsünü Çek ve Başlat
  2. Swagger kullanarak API'yi test edin
  3. Sansürlenecek metni belirtin
  4. Sağlanan bilgilerle API çağrısını yürütün
  5. Sansürlenen PDF belgesini dışa aktarın

IronSecureDoc'u Çekin ve Başlatın

Henüz IronSecureDoc çalışmıyorsa, aşağıdaki bağlantıları takip ederek kurulumunu yapın:

Yerel SunucuBulut'a Dağıtın

[POST] Metin Sansürleme API'si

[POST] Metin Sansürleme API'si, bir PDF belgesindeki hassas metni sansür kullanarak gizlemenize olanak tanır. Bu işlevsellik, gizli belgeleri yöneten uygulamalar, örneğin hukuki sözleşmeler, tıbbi kayıtlar veya finansal raporlar için esastır. Bu API'yi kullanarak, belirli metnin kalıcı olarak kaldırılmasını sağlayarak daha fazla güvenlik sağlar ve veri koruma standartlarına uyumu garanti eder.

Lütfen dikkate alinBir metin sansürlendiğinde, içerik kurtarılamaz.

Swagger

Swagger, geliştiricilerin RESTful API'lerle kullanıcı dostu bir web arayüzü aracılığıyla etkileşimde bulunmalarını sağlayan güçlü bir araçtır. Python, Java veya diğer diller gibi diller kullanıyor olsanız da, Swagger bu API'yi test etmek ve uygulamak için uygun bir yol sunar.

Swagger ile Metin Sansürleme Adımları

  1. Swagger UI'ya Erişim:

API sunucunuz yerel olarak çalışıyorsa, web tarayıcınızda http://localhost:8080/swagger/index.html adresine giderek Swagger'a erişebilirsiniz.

Swagger belgeleri

  1. [POST] Metin Kırpma API'sini Bulun:

Swagger UI içinde, [POST] /v1/document-services/pdfs/redact-text uç noktasını bulun.

Metin gizleme

  1. Yapılandırmaları Belirleyin:

Bu örnekte, POST isteğinde hem PDF dosyasını hem de kırpılacak kelimeleri sağlıyorum. 'we' kelimesini kırpacak ve üzerine siyah bir kutu yerleştireceğiz. Bu gösteri için aşağıdaki yapılandırmalarla 'sample.pdf' dosyasını kullanacağız:

  • draw_black_box: true
  • match_whole_word: true
  • words_to_redact: biz
  1. Örnek bir PDF Yükleyin:

İstek gövdesinde, sansür uygulamak istediğiniz bir örnek PDF dosyasını yükleyin. Ensure that the file is added as pdf_file.

  1. Talebi Çalıştır:

İsteği çalıştırmak için 'Execute' düğmesine tıklayın. Yanıt, kırpılan PDF'yi içerecek. Bu Swagger UI etkileşimi, kırpma sürecini kolayca test etmenizi sağlar ve anında geri bildirim verir.

Komut İstemi Aracılığıyla CURL İsteği Kullan

Alternatif olarak, aynı sonucu elde etmek için bir curl POST isteği ile Komut İstemini kullanabiliriz.

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
 -H 'accept: */*' \
 -H 'Content-Type: multipart/form-data' \
 -F 'pdf_file=@sample.pdf;type=application/pdf' \
 -F 'words_to_redact="we"' \
 -F 'draw_black_box=true' \
 -F 'match_whole_word=true'
curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
 -H 'accept: */*' \
 -H 'Content-Type: multipart/form-data' \
 -F 'pdf_file=@sample.pdf;type=application/pdf' \
 -F 'words_to_redact="we"' \
 -F 'draw_black_box=true' \
 -F 'match_whole_word=true'
SHELL

Lütfen dikkate alin
Varsayılan olarak, PowerShell curl öğesini yerleşik bir PowerShell cmdlet'i olan Invoke-WebRequest için bir takma ad olarak algılayabilir. curl yerine curl.exe kullanmayı deneyin.

curl.exe --version
curl.exe --version
SHELL

)}]

Gerekli İstek Gövde Parametreleri

İsimVeri TipiAçıklama
pdf_fileapplication/pdfDüzenlemek istediğiniz PDF dosyası.
words_to_redactarray[string]Bu parametre, kelimeler listesini alır ve girişe eşleşen metni kırpar.

İsteğe Bağlı İstek Gövde Parametreleri

İsimVeri TipiAçıklama
user_passwordstringGirdi PDF'sinde kullanıcının parolası varsa gereklidir. Parolalı PDF için parola sağlanmazsa işlem başarısız olur.
owner_passwordstringGirdi PDF'sinde sahibin parolası varsa gereklidir. Parolalı PDF için parola sağlanmazsa işlem başarısız olur.
specific_pagesarray[int]Hangi sayfalarda metni kırpmanız gerektiğini belirlemenize olanak tanır. Varsayılan olarak, değer null'dur, yani tüm sayfalardaki sağlanan kelime kırpılacaktır.
draw_black_boxbooleanKırpılan metin üzerinde siyah bir kutu çizip çizmeyeceğinizi belirtmenizi sağlar. Varsayılan olarak, bu değer True olarak ayarlıdır.
match_whole_wordbooleanKelimeler içindeki kısmi eşleşmelerin de kırpılıp kırpılmayacağını belirtir. Örneğin, sağlanan kelime 'are' ise, 'hare' gibi 'are' içeren herhangi bir kelime de 'are' olarak kırpılacaktır. Varsayılan olarak, bu True olarak ayarlıdır.
match_casebooleanSağlanan kelimenin, durum açısından tam bir eşleşme olması gerekip gerekmediğini belirtir. Varsayılan olarak, bu değer null'dur. Not: Bunu True olarak ayarlamak, küçük ve büyük harf dizgelerinin eşleşmeyeceği anlamına gelir. Örneğin, sağlanan kelime 'WE' ise, küçük harfli hali 'we' kırpılmayacaktır.
overlay_textstringKırpılan metin üzerine kelimeler veya semboller gibi kaplama metni belirtir. Varsayılan olarak, bu dize boştur.
save_as_pdfabooleanDeğiştirilmiş PDF'yi PDF/A-3 uyumu ile kaydeder. Varsayılan olarak, False olarak ayarlanmıştır.
save_as_pdfuabooleanDeğiştirilmiş PDF'yi PDF/UA uyumu ile kaydeder. Varsayılan olarak, False olarak ayarlanmıştır.

İsteğe Bağlı Başlık Parametreleri

İsimVeri TipiAçıklama
authorstringSizi PDF belgesinin yazarı olarak tanımlamanız için kullanışlıdır. Varsayılan olarak, bu alan boştur.
titlestringPDF belgesinin başlığını görüntüler. Varsayılan olarak, bu alan boştur.
subjectstringPDF belgesinin içeriğini bir bakışta tanımlamanızı sağlar. Varsayılan olarak, bu alan boştur.

Sıkça Sorulan Sorular

Bir POST isteği kullanarak bir PDF'deki metni nasıl redakte edebilirim?

Metni redakte etmek için, IronSecureDoc sunucusuna PDF dosyası ve redakte etmek istediğiniz kelimelerle birlikte bir POST isteği gönderebilirsiniz. Sunucu isteği işler ve redakte edilmiş metinle bir PDF döndürür.

IronSecureDoc API'sini PDF redaksiyonu için kullanmanın adımları nelerdir?

IronSecureDoc API'sini PDF redaksiyonu için kullanmak amacıyla, IronSecureDoc Docker Görüntüsünü indirip başlatmalı, API'yi kullanmadan önce Swagger ile test etmeli, redakte edilecek metni belirtmeli, API çağrısını gerçekleştirmeli ve sonunda redakte edilmiş PDF belgesini dışa aktarmalısınız.

IronSecureDoc API'sini üretimde kullanmadan önce nasıl test edebilirim?

IronSecureDoc API'sini Swagger kullanarak test edebilirsiniz. Swagger UI'ye erişim sağlayarak sağlanan uç noktalarla redaksiyon sürecini simüle edebilirsiniz.

Bir PDF redaksiyon isteğinde hangi parametreler özelleştirilebilir?

Bir PDF redaksiyon isteğinde, user_password, owner_password, specific_pages, draw_black_box, match_whole_word, match_case, overlay_text, save_as_pdfa ve save_as_pdfua gibi parametreleri özelleştirebilirsiniz.

curl kullanarak bir PDF redaksiyon isteğini nasıl gerçekleştirebilirim?

curl kullanarak bir PDF redaksiyon isteği gerçekleştirmek için, gerekli parametreleri ve dosya yolunu komut isteminde belirtmek üzere bir curl POST isteği komutu kullanabilirsiniz.

Redaksiyon işlemi sırasında PDF'im şifre korumalıysa ne yapmalıyım?

PDF'iniz şifre korumalıysa, redaksiyon işleminin belgeye erişimi ve değişikliği sağlayabilmesi için opsiyonel parametrelere user_password veya owner_password eklemeniz gereklidir.

'draw_black_box' parametresinin metin redaksiyonundaki amacı nedir?

'draw_black_box' parametresi redakte edilen metni bir siyah kutu ile kapatmayı belirtir. Bu seçenek, redakte edilmiş alanları görselleştirmek için faydalıdır ve varsayılan olarak etkindir.

Redaksiyon amaçları için IronSecureDoc'u yerel olarak nasıl barındırabilirim?

IronSecureDoc'u yerel olarak barındırmak için, Windows, Mac veya Linux gibi çeşitli işletim sistemleri için sağlanan kılavuzları izleyebilir, yerel sunucunuzda redaksiyon sürecini yönetebilirsiniz.

Bir PDF'deki belirli sayfaları redakte etmek mümkün mü?

Evet, 'specific_pages' parametresini kullanarak hedef belgede belirli alanları redakte etmek için hangi sayfaları redakte edeceğinizi belirtebilirsiniz.

Bir PDF'de redakte edilen alanlara metin yerleştirebilir miyim?

Evet, 'overlay_text' parametresini kullanarak redakte edilen metnin yerine kişisel bir mesaj veya yer tutucu yerleştirebilirsiniz.

IronSecureDoc .NET 10 ve istemci kütüphaneleri ile uyumlu mu?

Evet, IronSecureDoc, .NET 6–9 gibi önceki sürümlerin yanı sıra .NET 10 ile de uyumlu olan IronSoftware.SecureDoc.Client NuGet paketi üzerinden bir .NET istemcisi sunar. Bu, redaksiyon ve ilgili API'leri .NET 10 uygulamalarına sorunsuz bir şekilde entegre etmenizi sağlar.

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.