نمای کلی

APIهای مرور ایمن چه هستند؟

رابط برنامه‌نویسی کاربردی مرور ایمن فقط برای استفاده غیرتجاری است. اگر برای اهداف تجاری - یعنی «برای فروش یا درآمدزایی» - نیاز به استفاده از رابط‌های برنامه‌نویسی کاربردی برای شناسایی URLهای مخرب دارید، به رابط برنامه‌نویسی کاربردی ریسک وب مراجعه کنید.

رابط‌های برنامه‌نویسی کاربردی مرور ایمن (نسخه ۴) به برنامه‌های کلاینت شما اجازه می‌دهند تا URLها را با فهرست‌های دائماً به‌روز شده گوگل از منابع وب ناامن مقایسه کنند. نمونه‌هایی از منابع وب ناامن، سایت‌های مهندسی اجتماعی (سایت‌های فیشینگ و فریبنده) و سایت‌هایی هستند که میزبان بدافزار یا نرم‌افزارهای ناخواسته هستند. هر URL که در فهرست مرور ایمن یافت شود، ناامن تلقی می‌شود.

برای تعیین اینکه آیا یک URL در هر یک از فهرست‌های مرور ایمن قرار دارد یا خیر، کلاینت‌ها می‌توانند از Lookup API (نسخه ۴) یا Update API (نسخه ۴) استفاده کنند.

API جستجو (نسخه ۴)

API جستجو به برنامه‌های کلاینت شما اجازه می‌دهد تا URLها را برای بررسی وضعیت خود به سرور مرور ایمن گوگل ارسال کنند. این API ساده و آسان برای استفاده است، زیرا از پیچیدگی‌های Update API اجتناب می‌کند.

مزایا:

  • بررسی‌های ساده‌ی URL: شما یک درخواست HTTP POST با URLهای واقعی ارسال می‌کنید و سرور با وضعیت URLها (امن یا ناامن) پاسخ می‌دهد.

معایب:

  • حریم خصوصی: آدرس‌های اینترنتی هش نمی‌شوند، بنابراین سرور می‌داند کدام آدرس‌های اینترنتی را جستجو می‌کنید.
  • زمان پاسخ: هر درخواست جستجو توسط سرور پردازش می‌شود. ما هیچ تضمینی در مورد زمان پاسخ جستجو ارائه نمی‌دهیم.

اگر خیلی نگران حریم خصوصی URL های درخواستی نیستید و می‌توانید تأخیر ناشی از درخواست شبکه را تحمل کنید، استفاده از Lookup API را در نظر بگیرید زیرا استفاده از آن نسبتاً آسان است.

به‌روزرسانی API (نسخه ۴)

API به‌روزرسانی به برنامه‌های کلاینت شما اجازه می‌دهد نسخه‌های رمزگذاری‌شده‌ی فهرست‌های مرور ایمن را برای بررسی محلی و سمت کلاینت URLها دانلود کنند. API به‌روزرسانی برای کلاینت‌هایی طراحی شده است که به احکام با فرکانس بالا و تأخیر کم نیاز دارند. چندین مرورگر وب و پلتفرم نرم‌افزاری از این API برای محافظت از مجموعه‌های بزرگی از کاربران استفاده می‌کنند.

مزایا:

  • حریم خصوصی: شما به ندرت (فقط پس از تطبیق پیشوند هش محلی) و با استفاده از URL های هش شده با سرور تبادل داده می‌کنید، بنابراین سرور هرگز URL های واقعی مورد درخواست کلاینت‌ها را نمی‌داند.
  • زمان پاسخگویی: شما یک پایگاه داده محلی دارید که شامل کپی‌هایی از فهرست‌های مرور ایمن است؛ آنها نیازی ندارند هر بار که می‌خواهند یک URL را بررسی کنند، سرور را جستجو کنند.

معایب:

  • پیاده‌سازی: شما باید یک پایگاه داده محلی راه‌اندازی کنید و سپس نسخه‌های محلی فهرست‌های مرور ایمن (که به صورت هش‌های SHA256 با طول متغیر ذخیره می‌شوند) را دانلود و به صورت دوره‌ای به‌روزرسانی کنید.
  • بررسی‌های پیچیده URL: شما باید بدانید که چگونه URLها را استانداردسازی کنید، عبارات پسوند/پیشوند ایجاد کنید و هش‌های SHA256 را محاسبه کنید (برای مقایسه با کپی‌های محلی لیست‌های مرور ایمن و همچنین لیست‌های مرور ایمن ذخیره شده در سرور).

اگر نگران حریم خصوصی URL های درخواست شده یا تأخیر ناشی از درخواست شبکه هستید، از Update API استفاده کنید.