מאת George Curta ·
הסתרת PII בתמונות — מדריך שימוש
זהו וכסו מידע אישי בתוך סריקות, תצלומים וצילומי מסך. מדריך זה סוקר את זרימת העבודה של העלאה, ניתוח, הסתרה והורדה, מגבלות הגודל והפורמט, תמיכת שפות ה-OCR, וקריאת ה-API הבסיסית.
זרימת עבודה: העלאה, ניתוח, הסתרה, הורדה
כל תמונה עוברת את אותם ארבעה שלבים, בין אם אתה משתמש באפליקציית האינטרנט, קורא ל-API ישירות, או מפעיל את הכלי anonym_legal_redact_image דרך שרת ה-MCP.
1. העלאה
בחרו קובץ PNG או JPG. האפליקציה בודקת את סוג הקובץ וגודלו מול מגבלת ההעלאה של התוכנית שלכם לפני שליחת דבר לשרת.
2. ניתוח
OCR (Tesseract) קורא את הטקסט בתמונה ורושם היכן נמצא כל קטע טקסט. הטקסט שחולץ עובר לאחר מכן דרך אותו מזהה PII המשמש למסמכים, ומחזיר את הישויות שנמצאו ומיקומיהן — שום דבר עדיין לא הוסתר.
3. הסתרה
הריצו את הבקשה מחדש עם mode מוגדר ל-"redact" כדי לכסות כל אזור שזוהה בתיבה שחורה אטומה המצוירת ישירות על פיקסלי התמונה. זוהי הסתרה חזותית חד-כיוונית, לא הצפנה הפיכה.
4. הורדה
התמונה המוסתרת מוחזרת כקובץ (PNG או סוג התוכן המקורי) שאתם שומרים באופן מקומי — שום דבר לא נשמר בשרת לאחר שליחת התגובה.
מגבלות גודל ופיקסלים
- רק PNG ו-JPG (JPEG) נתמכים. פורמטים רסטריים נוספים כגון TIFF, BMP, WebP ו-GIF אינם נתמכים כרגע.
- תמונות מוגבלות ל-20 מגה-בייט בצד השרת. המגבלה של התוכנית שלכם עצמה עשויה להיות נמוכה יותר — תוכנית Basic מגבילה העלאות ל-5 מגה-בייט (Pro 10 מגה-בייט, Business 20 מגה-בייט); התוכנית החינמית אינה כוללת כלל הסתרת PII בתמונות.
- הרזולוציה הכוללת (רוחב × גובה) מוגבלת ל-150 מגה-פיקסל. העלאות מעל למגבלה זו נדחות לפני העיבוד.
תמיכה בשפות OCR
ה-OCR פועל על Tesseract. שדה השפה (language) של ה-API מקבל קוד ISO 639-1 (ברירת מחדל "en" עבור אנגלית) הממופה לחבילת שפה של Tesseract — כשלושים ושש שפות ממופות, כולל גרמנית, צרפתית, ספרדית, איטלקית, פורטוגזית, הולנדית, פולנית, רוסית, אוקראינית, ערבית, עברית, הינדי, יפנית, קוריאנית, סינית, תאית, וייטנאמית וטורקית. הזמינות בפועל תלויה בחבילות ה-Tesseract המותקנות בשרת ה-OCR; שפה שאינה זמינה חוזרת לאנגלית.
תיעוד API
הנמכת תמונות זמינה ישירות דרך ה-API עבור אינטגרציות שאינן עוברות דרך אפליקציית האינטרנט, וגם דרך שרת ה-MCP ככלי anonym_legal_redact_image (מצב "analyze" או "redact") עבור לקוחות MCP כמו Claude.
POST /api/presidio/imageAuthentication: התאמתו באמצעות אסימון Bearer בכותרת Authorization (אסימון API או סשן מאומת, כמו בנקודות הקצה של ניתוח טקסט). בקשות ללא אסימון תקף מחזירות 401.
Request body: שלחו גוף multipart/form-data. שדות חובה: file (תמונת PNG או JPG) ו-mode ("analyze" או "redact"). שדות אופציונליים: language (קוד שפת OCR בפורמט ISO 639-1, ברירת מחדל "en"), entities (מערך JSON של סוגי ישויות שאליהם יוגבל הזיהוי), score_threshold, ו-fill_color (רק במצב redact, ברירת מחדל "black"), operator (redact mode only: "redact" | "replace" | "mask", default "redact"), and mask_char (redact mode with operator="mask" only, default "*").
Response: במצב analyze התגובה היא JSON: הישויות שזוהו (סוג, מיקום טקסט וציון ביטחון) בתוספת שדה tokens_charged. במצב redact התגובה היא התמונה המוסתרת עצמה (בינארית, Content-Type image/png או הסוג המקורי) עם עלות האסימונים מוחזרת בכותרת X-Tokens-Charged.
שאלות נפוצות
באילו פורמטים של תמונה נתמכים?
רק PNG ו-JPG (JPEG). פורמטים רסטריים נוספים כגון TIFF, BMP, WebP ו-GIF אינם נתמכים כרגע.
מהן מגבלות הגודל והרזולוציה?
20 מגה-בייט ו-150 מגה-פיקסל רזולוציה כוללת, מוגבלים עוד יותר על ידי מגבלת ההעלאה של התוכנית שלכם עצמה (5 מגה-בייט ב-Basic, 10 מגה-בייט ב-Pro, 20 מגה-בייט ב-Business).
האם הסתרת PII בתמונות דורשת תוכנית בתשלום?
כן. הסתרת PII בתמונות דורשת תוכנית Basic ומעלה. התוכנית החינמית תומכת רק באנונימיזציה של טקסט.
האם ההסתרה הפיכה?
לא. ההסתרה מכסה את האזור שזוהה בתיבה שחורה אטומה ישירות על פיקסלי התמונה — הסתרה חזותית חד-כיוונית, לא הצפנה הפיכה כפי שמציע האנונימייזר של הטקסט.
כיצד לקרוא ל-API ישירות במקום להשתמש באפליקציית האינטרנט?
שלחו בקשת POST אל /api/presidio/image עם אסימון Bearer בכותרת Authorization וגוף multipart/form-data המכיל file ו-mode ("analyze" או "redact"). ראו את סעיף תיעוד ה-API לעיל לרשימת השדות המלאה ולצורת התגובה.
נסו הסתרת PII בתמונות
העלו סריקה, תצלום או צילום מסך וצפו כיצד PII שזוהה מכוסה תוך שניות ספורות.
פתחו את אפליקציית האינטרנטLimitations / 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.