پرش به محتوا

کتابخانه

دانلود @fingerprintjs/fingerprintjs و نشانی CDN ایرانی

@fingerprintjs/fingerprintjs یه کتابخانه جاوااسکریپت متن باز برای ساخت اثر انگشت مرورگره. از ویژگی های مرورگر و دستگاه بازدیدکننده، مثل نحوه رندر گرافیک، فونت ها و تنظیمات صفحه نمایش، یه شناسه می سازه. با این شناسه می تونی بازدیدکننده های تکراری رو تشخیص بدی، مثلا برای جلوگیری از ثبت نام های چندباره یا سوءاستفاده از کد تخفیف.

نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.

آخرین نسخه
۵.۳.۰
نسخه‌ها در مخزن
۹
مجوز
MIT
سازنده
FingerprintJS, Inc
آخرین بررسی
آخرین به‌روزرسانی
توضیحات

آخرین نسخه

آخرین نسخه ۵.۳.۰ آخرین

۶۰۰ کیلوبایت· ۸ فایل· انتشار

دانلود
نشانی مستقیم فایل اصلی https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@5.3.0/dist/fp.min.js
کد آماده با SRI <script src="https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@5.3.0/dist/fp.min.js" integrity="sha256-KHQIx3fj/S4qaZv7fp3eM2RYJOePrwQp1XQOBC31Zr0=" crossorigin="anonymous"></script>

SHA-256: 287408c777e3fd2e2a699bfb7e9dde33645824e78faf0429d5740e042df566bd

درباره @fingerprintjs/fingerprintjs (فینگرپرینت جی اس)

@fingerprintjs/fingerprintjs یه کتابخانه جاوااسکریپته که توی مرورگر بازدیدکننده اجرا می شه و از ترکیب چند ویژگی مرورگر و دستگاه یه شناسه می سازه. ویژگی هایی مثل نحوه رندر گرافیک، فونت های نصب شده، اندازه و عمق رنگ صفحه نمایش، منطقه زمانی و زبان. هر کدوم از این ها تنهایی چیز خاصی نیست، ولی ترکیبشون معمولا اونقدر متمایزه که دفعه بعد بشه همون بازدیدکننده رو شناخت. نه کوکی لازمه، نه لاگین.

این کتابخانه مشکلی رو حل می کنه که توی سایت های ایرانی خیلی ملموسه. محدودیت بر اساس IP اغلب جواب نمی ده. بخش بزرگی از کاربرها با اینترنت موبایل یا شبکه های مشترک میان و IP یکسان دارن، خیلی ها هم با فیلترشکن مدام IP عوض می کنن. اگه فروشگاهی داری که برای اولین خرید کد تخفیف می ده، سایتی با دوره آزمایشی رایگان، یا فرمی که مدام اسپم می گیره، شناسه مرورگر یه سیگنال کمکی خوبه، کنار تایید شماره موبایل و کپچا.

ولی از اول بدون که یکتا بودن این شناسه تضمین شده نیست. دو دستگاه خیلی شبیه هم ممکنه شناسه یکسان بگیرن. بعضی مرورگرها هم عمدا خروجی بعضی ویژگی ها رو دستکاری می کنن و حالت های حریم خصوصی می تونن شناسه رو عوض کنن. نسخه متن باز دقتش از سرویس تجاری همین شرکت پایین تره. پس برای احراز هویت یا هر تصمیمی که یه اشتباهش گرون تموم می شه، تنها بهش تکیه نکن. چون کد سمت مرورگر اجرا می شه، کاربر می تونه دستکاریش کنه. شناسه رو همیشه سمت سرور بررسی کن و فقط یکی از چند سیگنالت بدون.

یه نکته دیگه حریم خصوصیه. شناسایی بازدیدکننده بدون اطلاع خودش حساسیت داره. توی صفحه قوانین و حریم خصوصی سایتت شفاف بنویس که برای پیشگیری از تقلب ازش استفاده می کنی و قوانین مرتبط رو هم خودت بررسی کن. طبق اطلاعات منبع، مجوزش MIT هست، ولی قبل از استفاده تجاری فایل مجوز همون نسخه ای که برمی داری رو هم نگاه کن. نسخه های رسمی و بدون تغییر این کتابخانه توی مخزن داخلی ما هم در دسترسه، برای روزهایی که دسترسی به npm و سرویس های خارجی قطع یا کند می شه.

راهنمای استفاده

کار با این کتابخانه سخت نیست و بیشتر کار سمت سرور خودته.

  • فایل کتابخانه رو از همین صفحه بگیر و روی هاست خودت بذار. اگه پروژه ات ابزار build داره، با npm هم می تونی نصبش کنی.
  • کد آماده پایین همین صفحه رو به صفحه ات اضافه کن. بهتره آخر صفحه باشه و فقط توی صفحه هایی بیاد که واقعا لازمش دارن، مثل ثبت نام، ثبت سفارش یا فرم دریافت کد تخفیف.
  • بعد از لود اسکریپت، اول تابع load رو صدا بزن تا کتابخانه آماده بشه، بعدش با get نتیجه رو بگیر. توی نتیجه، visitorId همون شناسه بازدیدکنندسه و components جزئیات سیگنال های جمع شده رو نشون می ده.
  • شناسه رو همراه درخواست اصلی، مثلا ثبت نام یا اعمال کد تخفیف، به سرور بفرست و اونجا با داده های قبلی مقایسه کن.
  • منطق تصمیم گیری رو سمت سرور بنویس. مثلا به جای مسدود کردن مستقیم، یه امتیاز ریسک بده یا تایید بیشتر بخواه.
  • قبل از انتشار، توی چند مرورگر، گوشی و حالت ناشناس تست کن تا ببینی شناسه چقدر ثابت می مونه.

اگه سایتت وردپرسیه، اسکریپت رو با قالب یا یه افزونه درج کد اضافه کن و مقدار شناسه رو با فرم یا درخواست AJAX به PHP برسون.

همه نسخه‌ها (۹)

نسخه‌های ۵.x ۵ نسخه
  • ۵.۳.۰ آخرین نسخه ۶۰۰ کیلوبایت·
    دانلودنسخه 5.3.0
    نشانی مستقیم فایل اصلی 5.3.0 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@5.3.0/dist/fp.min.js
  • ۵.۲.۰ ۵۹۶ کیلوبایت·
    دانلودنسخه 5.2.0
    نشانی مستقیم فایل اصلی 5.2.0 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@5.2.0/dist/fp.min.js
  • ۵.۱.۰ ۵۸۰ کیلوبایت·
    دانلودنسخه 5.1.0
    نشانی مستقیم فایل اصلی 5.1.0 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@5.1.0/dist/fp.min.js
  • ۵.۰.۱ ۵۶۱ کیلوبایت·
    دانلودنسخه 5.0.1
    نشانی مستقیم فایل اصلی 5.0.1 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@5.0.1/dist/fp.min.js
  • ۵.۰.۰ ۵۶۱ کیلوبایت·
    دانلودنسخه 5.0.0
    نشانی مستقیم فایل اصلی 5.0.0 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@5.0.0/dist/fp.min.js
نسخه‌های ۳.x ۳ نسخه
  • ۳.۴.۲ ۵۲۵ کیلوبایت·
    دانلودنسخه 3.4.2
    نشانی مستقیم فایل اصلی 3.4.2 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@3.4.2/dist/fp.min.js
  • ۳.۳.۲ ۴۹۰ کیلوبایت·
    دانلودنسخه 3.3.2
    نشانی مستقیم فایل اصلی 3.3.2 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@3.3.2/dist/fp.min.js
  • ۳.۳.۰ ۴۸۷ کیلوبایت·
    دانلودنسخه 3.3.0
    نشانی مستقیم فایل اصلی 3.3.0 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@3.3.0/dist/fp.min.js
نسخه‌های ۲.x ۱ نسخه
  • ۲.۱.۵ قدیمی‌ترین نسخه ۹۵ کیلوبایت·
    دانلودنسخه 2.1.5
    نشانی مستقیم فایل اصلی 2.1.5 https://mirror.wbweb.ir/npm/@fingerprintjs/fingerprintjs@2.1.5/dist/fingerprint2.min.js

پرسش‌های رایج

  • اثر انگشت مرورگر یعنی ساختن یه شناسه از ویژگی های مرورگر و دستگاه، مثل فونت ها، رندر گرافیک، صفحه نمایش و زبان. FingerprintJS این ویژگی ها رو توی مرورگر جمع می کنه و ترکیبشون رو به یه شناسه تبدیل می کنه. چون به کوکی وابسته نیست، با پاک کردن کوکی ها معمولا عوض نمی شه.

  • نه. دو دستگاه خیلی مشابه ممکنه شناسه یکسان بگیرن و بعضی مرورگرها یا افزونه های حریم خصوصی هم خروجی ها رو تغییر می دن. برای همین شناسه رو یه سیگنال کمکی بدون، نه مدرک قطعی. برای تصمیم های حساس، کنارش از تایید شماره موبایل یا روش های دیگه هم استفاده کن.

  • با پاک کردن کوکی ها معمولا عوض نمی شه، چون شناسه از ویژگی های مرورگر ساخته می شه. حالت ناشناس هم بسته به مرورگر ممکنه نتیجه رو تغییر بده یا نده. به روزرسانی مرورگر یا تغییر تنظیمات هم گاهی شناسه رو عوض می کنه، پس ثابت موندنش رو تضمین شده فرض نکن.

  • چون بازدیدکننده رو بدون کوکی شناسایی می کنه، حساسیت حریم خصوصی داره. استفاده رو به یه هدف مشخص مثل پیشگیری از تقلب محدود کن، توی صفحه حریم خصوصی سایتت شفاف توضیح بده که چی جمع می شه و برای چی، و قوانین و مقررات مرتبط رو هم خودت بررسی کن.

  • آره، ولی افزونه آماده وردپرس نیست و یه کتابخانه جاوااسکریپته. اسکریپت رو با قالب یا یه افزونه درج کد فقط توی صفحه های لازم اضافه کن، شناسه رو با فرم یا AJAX به سرور بفرست و بعدش توی PHP بررسیش کن و تصمیم بگیر.

چیزی که لازم دارید اینجا نیست؟

نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.