Autor: George Curta ·
Piltidel PII peitmine — Kasutusjuhend
Tuvasta ja kata isikuandmed skannidel, fotodel ja ekraanipiltidel. See juhend käsitleb üleslaadimise, analüüsi, peitmise ja allalaadimise töövoogu, suuruse ja vormingu piiranguid, OCR keeletuge ning aluseks olevat API kutset.
Töövoog: üleslaadimine, analüüs, peitmine, allalaadimine
Iga pilt läbib samad neli sammu, olenemata sellest, kas kasutate veebirakendust, kutsute API-d otse või kutsute anonym_legal_redact_image tööriista MCP serveri kaudu.
1. Üleslaadimine
Vali PNG- või JPG-fail. Rakendus kontrollib faili tüüpi ja suurust sinu plaani üleslaadimispiirangu vastu, enne kui midagi serverisse saadetakse.
2. Analüüs
OCR (Tesseract) loeb pildil oleva teksti ja registreerib, kus iga tekstiosa asub. Seejärel läbib see eraldatud tekst sama PII tuvastaja, mida kasutatakse dokumentide puhul, tagastades leitud olemid ja nende asukohad — midagi pole veel peidetud.
3. Peitmine
Käivita päring uuesti, määrates režiimiks (mode) "redact", et katta iga tuvastatud ala ühtlase musta kastiga, mis joonistatakse otse pildi pikslitele. See on ühesuunaline visuaalne peitmine, mitte pöörduv krüpteerimine.
4. Allalaadimine
Peidetud pilt tagastatakse failina (PNG või algne sisutüüp), mille salvestad kohalikult — serverisse ei jää pärast vastuse saatmist midagi alles.
Suuruse ja piksliarvu piirangud
- Toetatud on ainult PNG ja JPG (JPEG). Muid rasterformaate, nagu TIFF, BMP, WebP ja GIF, praegu ei toetata.
- Pildid on serveripoolselt piiratud 20 MB-ga. Sinu plaani enda piirang võib olla madalam — Basic plaan piirab üleslaadimised 5 MB-ni (Pro 10 MB, Business 20 MB); tasuta plaan ei sisalda piltidel PII peitmist üldse.
- Kogu resolutsioon (laius × kõrgus) on piiratud 150 megapiksliga. Selle piiri ületavad üleslaadimised lükatakse tagasi enne töötlemist.
OCR keeletugi
OCR töötab Tesseractil. API keele (language) väli aktsepteerib ISO 639-1 koodi (vaikimisi "en" inglise keele jaoks), mis on kaardistatud Tesseracti keelepaketiga — kaardistatud on umbes kolm tosinat keelt, sealhulgas saksa, prantsuse, hispaania, itaalia, portugali, hollandi, poola, vene, ukraina, araabia, heebrea, hindi, jaapani, korea, hiina, tai, vietnami ja türgi keel. Tegelik saadavus sõltub sellest, millised Tesseracti paketid on OCR-serverisse paigaldatud; saadaolematu keel langeb tagasi inglise keelele.
API viide
Pildi varjamine on saadaval otse API kaudu integratsioonidele, mis ei kasuta veebirakendust, ning MCP serveri kaudu kui anonym_legal_redact_image tööriist (režiim „analyze" või „redact") MCP klientidele nagu Claude.
POST /api/presidio/imageAuthentication: Autendi end Bearer tokeniga Authorization päises (API võti või autenditud seanss, samamoodi nagu teksti analüüsi endpointides). Kehtiva tokenita päringud tagastavad 401.
Request body: Saada multipart/form-data keha. Kohustuslikud väljad: file (PNG- või JPG-pilt) ja mode ("analyze" või "redact"). Valikulised väljad: language (ISO 639-1 OCR keelekood, vaikimisi "en"), entities (JSON massiiv olemitüüpidest, millele tuvastamine piiratakse), score_threshold ja fill_color (ainult redact režiimis, vaikimisi "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: Analyze režiimis on vastus JSON: tuvastatud olemid (tüüp, teksti asukoht ja usaldusskoor) pluss tokens_charged väli. Redact režiimis on vastus ise peidetud pilt (binaarne, Content-Type image/png või algne tüüp), kusjuures tokenite kulu tagastatakse X-Tokens-Charged päises.
Korduma kippuvad küsimused
Milliseid pildivorminguid toetatakse?
Ainult PNG ja JPG (JPEG). Muid rasterformaate, nagu TIFF, BMP, WebP ja GIF, praegu ei toetata.
Millised on suuruse ja resolutsiooni piirangud?
20 MB ja 150 megapikslit kogu resolutsiooni, mida piirab veelgi sinu enda plaani üleslaadimispiirang (5 MB Basic'ul, 10 MB Pro'l, 20 MB Business'il).
Kas piltidel PII peitmine nõuab tasulist plaani?
Jah. Piltidel PII peitmine nõuab Basic plaani või kõrgemat. Tasuta plaan toetab ainult teksti anonüümimist.
Kas peitmine on pöörduv?
Ei. Peitmine katab tuvastatud ala läbipaistmatu musta kastiga otse pildi pikslitel — ühesuunaline visuaalne peitmine, mitte pöörduv krüpteerimine, nagu pakub tekstianonüümija.
Kuidas kutsuda API-t otse, veebirakendust kasutamata?
Saada POST päring aadressile /api/presidio/image, koos Bearer tokeniga Authorization päises ja multipart/form-data kehaga, mis sisaldab file ja mode ("analyze" või "redact"). Vaata ülalpool API viite jaotist väljade täieliku loendi ja vastuse kuju kohta.
Proovi piltidel PII peitmist
Laadi üles skann, foto või ekraanipilt ja näe, kuidas tuvastatud PII mõne sekundiga kaetakse.
Ava veebirakendusLimitations / Important note
- OCR-based text extraction is probabilistic; low-quality scans and handwriting lower detection recall.
- Redaction is a visual, one-way black box over the detected region — not reversible encryption.
- This page is informational and is not legal advice.