1. IronSecureDoc
  2. Nasıl Yapılır
  3. Metin Sansürü

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 redakte etmeyi tartışacağız. Bu, hizmetin veya sürecin, çalışan IronSecureDoc sunucusuna PDF ile basit bir POST isteği göndererek hassas bilgileri hızlı ve kolay bir şekilde redakte etmesini sağlar. Bunu, Swagger belgelerini kullanarak görsel olarak göstereceğiz. POST isteği, hem zorunlu hem de isteğe bağlı parametreleri alır ve son derece özelleştirilebilir; yanıt, redakte edilmiş metni içeren PDF'yi döner.

IronSecureDoc ile PDF Üzerinde Metin Redakte Etme

  1. IronSecureDoc Docker Görüntüsünü Çekin ve Başlatın
  2. Swagger ile API'yi test edin
  3. Redakte edilecek metni belirtin
  4. Sağlanan detaylarla API çağrısını gerçekleştirin
  5. Redakte edilmiş PDF belgesini dışa aktarın

IronSecureDoc'u Çekin ve Başlatın

IronSecureDoc henüz çalışmıyorsa, lütfen kurulumu yapmak için aşağıdaki bağlantıları takip edin:

Yerel BarındırmaBuluta Yayınlama

[POST] Metin Redaksiyon API'si

[POST] Metin Redaksiyon API uç noktası, bir PDF belgesi içinde hassas metni redakte yoluyla gizlemenizi sağlar. Bu işlevsellik, hukuki sözleşmeler, tıbbi kayıtlar veya mali raporlar gibi gizli belgeleri ele alan uygulamalar için gereklidir. Bu API'yi kullanmak, belirli metnin kalıcı olarak kaldırılmasını sağlamakta ve artırılmış güvenlik sağlamakta ve veri koruma standartlarına uygunluğu sağlamaktadır.

Lütfen dikkate alınBir metin redakte edildiğinde, içerik geri kurtarılamaz.

Swagger

Swagger, geliştiricilere RESTful API'lerle kullanıcı dostu bir web arayüzü üzerinden etkileşim kurmalarını sağlayan güçlü bir araçtır. Python, Java veya diğer dilleri kullanıyor olun, Swagger bu API'yi test etmek ve uygulamak için kolay bir yol sunar.

Swagger ile Metin Sansürü Adımları

  1. Swagger UI'ye erişin:

    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

  2. [POST] Metin Redaksiyon API'sini Bulun:

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

    Metni düzenle

  3. Yapılandırmaları Belirtin:

    Bu örnekte, POST isteğinde hem PDF dosyasını hem de sansürlenecek kelimeleri sunuyorum. "we" kelimesini sansürleyeceğiz ve üzerine siyah bir kutu yerleştireceğiz. Bu gösterim için, belirli yapılandırmalarla 'sample.pdf' dosyasını kullanacağız:

    • draw_black_box: true
    • match_whole_word: true
    • words_to_redact: biz

  4. Örnek Bir PDF Yükleyin:

    Talep gövdesine, redaksiyon uygulamak istediğiniz örnek bir PDF dosyası yükleyin. Dosyanın pdf_file olarak eklendiğinden emin olun.

  5. İsteği Gerçekleştir:

    Talebi çalıştırmak için 'Yürüt' düğmesine tıklayın. Yanıt, redakte edilmiş PDF'yi içerecektir. Bu Swagger UI etkileşimi, redaksiyon sürecini kolayca test etmenizi sağlar, anında geri bildirim sağlar.

Komut İsteminde CURL İsteği Kullanma

Alternatif olarak, aynı sonucu elde etmek için Komut İstemi'ni curl POST isteği ile 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 alın
Varsayılan olarak, PowerShell curl ifadesini, yerleşik bir PowerShell cmdlet'i olan Invoke-WebRequest için bir takma ad olarak yorumlayabilir. curl yerine curl.exe kullanmayı deneyin.

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

)}]

Gerekli İstek Gövdesi Parametreleri

AdVeri TürüAçıklama
pdf_fileapplication/pdfManipüle etmek istediğiniz PDF dosyası.
redakte_edilecek_kelimelerarray[string]Bu parametre, kelimeler listesini alır ve girdiyi eşleşen metni redakte eder.

Opsiyonel İstek Gövdesi Parametreleri

AdVeri TürüAçıklama
user_passwordstringGirdi PDF'nin bir kullanıcı parolası varsa bu gereklidir. Parola korumalı PDF için parola sağlanmadan işlem başarısız olur.
owner_passwordstringGirdi PDF'nin bir sahibi parolası varsa bu gereklidir. Parola korumalı PDF için parola sağlanmadan işlem başarısız olur.
belirli_sayfalararray[int]Metnin hangi sayfalarda kapatılacağını belirtmenizi sağlar. Varsayılan olarak değer null olup, bu demek oluyor ki sağlanan kelime tüm sayfalarda sansürlenecek.
siyah_kutu_cizbooleanSansürlenen metnin üzerine siyah bir kutu çizilip çizilmeyeceğini belirtmenizi sağlar. Varsayılan olarak, bu değer True olarak ayarlanmıştır.
tam_kelime_eslesmebooleanKelime içindeki kısmi eşleşmelerin de sansürlenip sansürlenmeyeceğini belirtir. Örneğin, sağlanan kelime 'olmak' ise, 'uyumak' gibi 'olmak' içeren her kelimenin 'olmak' kısmı da sansürlenecek. Varsayılan olarak, bu True olarak ayarlanmıştır.
es_kucuk_buyuk_harfe_duyarlibooleanSağlanan kelimenin harf büyüklüğü açısından kesin eşleşme olup olmaması gerektiğini belirtir. Varsayılan olarak, bu değer null olup, bu True olarak ayarlandığında, küçük ve büyük harfli dizgiler eşleşmeyecektir. Örneğin, sağlanan kelime 'BİZ', küçük harf 'biz' sansürlenmeyecek.
metin_üzerine_yazistringRedakte edilmiş metnin üzerine kelimeler veya semboller gibi metni belirtir. Varsayılan olarak, bu dize boştur.
save_as_pdfabooleanDeğiştirilmiş PDF'i PDF/A-3 uyumluluğuyla kaydeder. Varsayılan olarak, bu False olarak ayarlanmıştır.
save_as_pdfuabooleanDeğiştirilmiş PDF'i PDF/UA uyumluluğuyla kaydeder. Varsayılan olarak, bu False olarak ayarlanmıştır.

Opsiyonel Başlık Parametreleri

AdVeri TürüAçıklama
yazarstringSizi PDF belgesinin yazarı olarak tanımlamanızda yararlıdır. Varsayılan olarak, bu alan boş.
başlıkstringPDF belgesinin başlığını görüntüler. Varsayılan olarak, bu alan boş.
konustringPDF belgesinin içeriğini hızlı bir şekilde tanımlamanızda yararlıdır. Varsayılan olarak, bu alan boştur.

Sıkça Sorulan Sorular

Bir POST isteği kullanarak PDF'de metni nasıl sansürleyebilirim?

Bir POST isteğiyle IronSecureDoc sunucusuna PDF dosyasını ve sansürlemek istediğiniz kelimeleri göndererek PDF'de metni sansürleyebilirsiniz. Sunucu isteği işler ve sansürlenmiş metin içeren PDF'yi geri döndürür.

PDF sansürleme için IronSecureDoc API'sini kullanmanın adımları nelerdir?

IronSecureDoc API'sini PDF sansürleme için kullanmak üzere öncelikle IronSecureDoc Docker İmajını çekip başlatmalı, API'yi Swagger kullanarak test etmeli, sansürlenecek metni belirtmeli, API çağrısını icra etmeli ve sonunda sansürlenmiş PDF belgesini dışa aktarmalısınız.

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

Swagger'e erişerek IronSecureDoc API'sini test edebilirsiniz, bu da sağlanan uç noktaları kullanarak sansürleme sürecini simüle etmenize olanak tanır.

Bir PDF sansürleme isteğinde hangi parametreler özelleştirilebilir?

Bir PDF sansürleme isteğinde kullanıcı_şifresi, sahibi_şifresi, belirli_sayfalar, siyah_kutu_çiz, tam_kelime_eşleşmesi, vaka_eşleşmesi, yerleştirme_metin, PDF/A olarak_kaydet ve PDF/UA olarak_kaydet gibi parametreleri daha fazla özelleştirmek amacıyla özelleştirebilirsiniz.

Curl kullanarak bir PDF sansürleme isteği nasıl icra edilir?

Curl kullanarak bir PDF sansürleme isteği icra etmek için gerekli parametreleri ve dosya yolunu komut satırınızda belirleyerek bir curl POST isteği komutu kullanabilirsiniz.

PDF'niz sansür sırasında şifre korumalıysa ne yapmalıyım?

PDF'niz şifre korumalıysa, sansürleme sürecinin belgeye erişim sağlayabilmesi ve değiştirebilmesi için opsiyonel parametreler arasında kullanıcı_şifresi veya sahibi_şifresi eklemelisiniz.

'siyah_kutu_çiz' parametresinin metin sansürlemedeki amacı nedir?

'Siyah_kutu_çiz' parametresi, sansürlenmiş metnin siyah bir kutuyla kaplanmasını belirtir. Bu seçenek, sansürlenmiş alanları görüntüleme açısından yararlıdır ve varsayılan olarak etkindir.

IronSecureDoc'u sansürleme amacıyla yerel olarak nasıl barındırabilirim?

Windows, Mac veya Linux gibi çeşitli işletim sistemleri için sağlanan eğitimleri izleyerek, IronSecureDoc'u yerel olarak barındırabilirsiniz. Bu, sansürleme sürecini yerel sunucunuzda yönetmenize olanak tanır.

PDF'de belirli sayfaları sansürlemek mümkün mü?

Evet, belirli sayfaları sansürlenecek sayfalar olarak hedeflemenize olanak tanıyan 'belirli_sayfalar' parametresini kullanarak bu sayfaları sansürleyebilirsiniz.

PDF'de sansürlenmiş alanlara metin yerleştirebilir miyim?

Evet, sansürlenmiş alanlara yerleştirilmiş özel bir mesaj veya geçici mesajla değiştirmenize olanak tanıyan 'yerleştirme_metin' parametresini kullanarak bu alana metin yerleştirebilirsiniz.

IronSecureDoc, .NET 10 ve onun müşteri kütüphaneleri ile uyumlu mu?

Evet, IronSecureDoc, NuGet paketi IronSoftware.SecureDoc.Client aracılığıyla .NET istemcisi sağlar ve bu, .NET 6–9 gibi önceki sürümlere ek olarak .NET 10 ile uyumludur. Bu, .NET 10 uygulamalarında sansürleme ve ilgili API'leri sorunsuzca entegre etmenizi sağlar.

Curtis Chau
Curtis Chau
  Mühendislik ekibiyle şimdi sohbet edin
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.