نوشته George Curta ·
پنهان‌سازی PII در تصاویر — راهنمای استفاده
داده‌های شخصی درون اسکن‌ها، عکس‌ها و اسکرین‌شات‌ها را شناسایی و بپوشانید. این راهنما گردش کار بارگذاری، تحلیل، پنهان‌سازی و دانلود، محدودیت‌های اندازه و فرمت، پشتیبانی زبان OCR و فراخوانی API زیربنایی را پوشش می‌دهد.
گردش کار: بارگذاری، تحلیل، پنهان‌سازی، دانلود
هر تصویر همان چهار مرحله را طی می‌کند، چه از برنامه وب استفاده کنید، چه مستقیماً API را فراخوانی کنید، یا ابزار anonym_legal_redact_image را از طریق سرور MCP فراخوانی کنید.
۱. بارگذاری
یک فایل PNG یا JPG انتخاب کنید. پیش از ارسال هر چیزی به سرور، برنامه نوع و اندازه فایل را در برابر محدودیت بارگذاری پلن شما بررسی می‌کند.
۲. تحلیل
OCR (Tesseract) متن داخل تصویر را می‌خواند و ثبت می‌کند هر بخش از متن کجا قرار دارد. سپس این متن استخراج‌شده از همان تشخیص‌دهنده PII که برای اسناد استفاده می‌شود عبور می‌کند و موجودیت‌های یافت‌شده و موقعیت آنها را بازمی‌گرداند — هنوز چیزی پنهان نشده است.
۳. پنهان‌سازی
درخواست را دوباره با تنظیم mode روی "redact" اجرا کنید تا هر ناحیه شناسایی‌شده با یک جعبه مشکی توپر که مستقیماً روی پیکسل‌های تصویر کشیده می‌شود پوشانده شود. این یک پنهان‌سازی تصویری یک‌طرفه است، نه رمزگذاری برگشت‌پذیر.
۴. دانلود
تصویر پنهان‌شده به‌صورت یک فایل (PNG یا نوع محتوای اصلی) بازگردانده می‌شود که آن را به‌صورت محلی ذخیره می‌کنید — پس از ارسال پاسخ، چیزی روی سرور باقی نمی‌ماند.
محدودیت‌های اندازه و پیکسل
- فقط PNG و JPG (JPEG) پشتیبانی می‌شوند. سایر فرمت‌های رستری مانند TIFF، BMP، WebP و GIF در حال حاضر پشتیبانی نمی‌شوند.
- تصاویر در سمت سرور به ۲۰ مگابایت محدود شده‌اند. محدودیت پلن خود شما ممکن است پایین‌تر باشد — پلن Basic بارگذاری‌ها را به ۵ مگابایت محدود می‌کند (Pro با ۱۰ مگابایت، Business با ۲۰ مگابایت)؛ پلن رایگان اصلاً شامل پنهان‌سازی PII در تصاویر نمی‌شود.
- رزولوشن کل (عرض × ارتفاع) به ۱۵۰ مگاپیکسل محدود شده است. بارگذاری‌های بالاتر از این حد پیش از پردازش رد می‌شوند.
پشتیبانی زبان 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 یا یک نشست احرازهویت‌شده، مشابه اندپوینت‌های تحلیل متن). درخواست‌های بدون توکن معتبر ۴۰۱ بازمی‌گردانند.
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 در حال حاضر پشتیبانی نمی‌شوند.
محدودیت‌های اندازه و رزولوشن چیست؟
۲۰ مگابایت و ۱۵۰ مگاپیکسل رزولوشن کل، که با محدودیت بارگذاری پلن خود شما بیشتر محدود می‌شود (۵ مگابایت در Basic، ۱۰ مگابایت در Pro، ۲۰ مگابایت در 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.