در گذشته، کوکی‌های شخص ثالث برای ذخیره و انتقال اطلاعات مربوط به وضعیت یک کاربر، مانند وضعیت ورود به سیستم، اطلاعات مربوط به دستگاهی که استفاده می‌کنند یا اینکه آیا شناخته شده و قابل اعتماد هستند، استفاده می‌شد. به عنوان مثال، اینکه آیا کاربر با SSO وارد شده است، آیا کاربر نوع خاصی از دستگاه سازگار دارد یا اینکه کاربر شناخته شده و قابل اعتماد است. با منسوخ شدن پشتیبانی از کوکی های شخص ثالث ، بسیاری از این موارد استفاده باید با وسایل دیگری پشتیبانی شوند.
رمزهای دولتی خصوصی راهی برای به اشتراک گذاری اطلاعات در سراسر وب ارائه می دهند، اما به روشی حفظ حریم خصوصی از طریق کنترل میزان داده هایی که واقعاً می توانند به اشتراک گذاشته شوند.
توکن‌های دولتی خصوصی (که قبلاً به عنوان توکن‌های اعتماد شناخته می‌شد) اجازه می‌دهند اعتماد به اعتبار کاربر از یک زمینه به زمینه دیگر منتقل شود و در عین حال به سایت‌ها در مبارزه با کلاهبرداری و تمایز ربات‌ها از انسان‌های واقعی بدون ردیابی غیرفعال کمک می‌کند.
این سند به تشریح جزئیات فنی برای اجرای توکن‌های دولتی خصوصی (PST) می‌پردازد. برای یک طرح کلی تر در سطح بالا، به نمای کلی PST مراجعه کنید.
توکن های دولتی خصوصی چگونه کار می کنند؟
ارتباط کلیدی برای درک در PST بین صادرکنندگان و بازخریدکنندگان است. صادرکنندگان و بازخریدکنندگان می توانند در یک شرکت باشند.
- صادرکنندگان - این موجودیت ها سیگنال هایی در مورد یک کاربر دارند (به عنوان مثال، اینکه آیا آن کاربر یک ربات است یا نه) و آن سیگنال را در رمزی که در دستگاه کاربر ذخیره می شود جاسازی می کند (جزئیات بیشتر در بخش های بعدی).
- Redeemers - این نهادها ممکن است سیگنالی در مورد یک کاربر نداشته باشند، اما باید چیزی در مورد آنها بدانند (به عنوان مثال، اینکه آیا آن کاربر یک ربات است یا نه) و برای درک قابل اعتماد بودن آن کاربر، درخواست بازخرید توکن از صادرکننده را دارند.
هر تعامل PST مستلزم آن است که صادرکنندگان و بازخریدکنندگان با یکدیگر همکاری کنند تا سیگنال‌ها را در سراسر وب به اشتراک بگذارند. این سیگنال ها مقادیر درشتی هستند که برای شناسایی افراد به اندازه کافی دقیق نیستند.
آیا توکن های دولتی خصوصی برای من مناسب هستند؟
شرکت هایی که تصمیمات اعتماد می گیرند و می خواهند این اطلاعات در همه زمینه ها در دسترس باشد، ممکن است از PST ها بهره مند شوند. برای اطلاعات بیشتر در مورد موارد استفاده بالقوه PST، به مستندات ما در مورد موارد استفاده PST مراجعه کنید.
توکن ها را صادر و بازخرید کنید
پیاده سازی PST در سه مرحله انجام می شود:
- صدور توکن
- بازخرید توکن ها
- ارسال رکورد بازخرید
در مرحله اول، توکن ها برای یک مرورگر (معمولاً پس از نوعی اعتبارسنجی) صادر می شوند. در مرحله دوم، نهاد دیگری برای بازخرید توکنی که برای خواندن ارزش آن توکن صادر شده بود، درخواست می‌کند. در مرحله نهایی، طرف بازخرید کننده یک رکورد بازخرید (RR) با مقدار موجود در توکن دریافت می کند. سپس آن طرف بازخرید کننده می تواند از آن سابقه به عنوان گواهی آن کاربر برای اهداف مختلف استفاده کند.
استراتژی رمزی خود را تعریف کنید
برای تعریف استراتژی توکن خود، باید مفاهیم کلیدی PST (توکن ها و سوابق بازخرید)، متغیرها، رفتارها و محدودیت ها را بدانید تا بتوانید در مورد استفاده بالقوه آنها در مورد استفاده خود فکر کنید.
توکن ها و سوابق بازخریدی: چه رابطه ای بین آنها وجود دارد؟
هر دستگاه می تواند تا 500 توکن در هر وب سایت و صادرکننده سطح بالا ذخیره کند. همچنین، هر توکن دارای ابرداده است که نشان می دهد صادرکننده از کدام کلید برای صدور آن استفاده کرده است. از این اطلاعات می توان برای تصمیم گیری برای بازخرید یا عدم بازخرید توکن در طول فرآیند بازخرید استفاده کرد. داده‌های PST به صورت داخلی توسط مرورگر روی دستگاه کاربر ذخیره می‌شود و فقط توسط PST API قابل دسترسی است.
هنگامی که یک توکن بازخرید می شود، رکورد بازخرید (RR) در دستگاه ذخیره می شود. این حافظه به عنوان یک حافظه پنهان برای بازخریدهای آینده عمل می کند. محدودیت بازخرید دو توکن هر 48 ساعت ، برای هر دستگاه، صفحه و صادرکننده وجود دارد. فراخوان‌های بازخرید جدید در صورت امکان از RRهای ذخیره شده در حافظه پنهان استفاده می‌کنند تا اینکه درخواستی برای صادرکننده ایجاد کنند.
- توکن های جدید صادر می شوند (حداکثر 500 در هر صادرکننده، سایت و دستگاه).
- همه نشانه‌ها در فروشگاه رمز روی دستگاه ذخیره می‌شوند (شبیه به فروشگاه کوکی).
- اگر هیچ RR فعالی یافت نشد، پس از صدور می توان RR های جدید تولید کرد (حداکثر 2 در هر 48 ساعت).
- RR ها تا زمان انقضا فعال در نظر گرفته می شوند و به عنوان یک کش محلی استفاده می شوند.
- تماس‌های بازخرید جدید به حافظه پنهان محلی (RRهای جدید ایجاد نمی‌شود) وارد می‌شوند.
پس از تعریف مورد استفاده خود، باید طول عمر RR خود را با دقت تعیین کنید زیرا این مشخص می کند که چند بار می توانید از آنها در مورد خود استفاده کنید.
قبل از تعریف استراتژی خود مطمئن شوید که رفتارها و متغیرهای حیاتی زیر را درک کرده اید:
| متغیر / رفتار | شرح | استفاده بالقوه |
|---|---|---|
| فراداده کلید رمزی | هر توکن را می توان با استفاده از یک و تنها یک کلید رمزنگاری صادر کرد و در PST محدودیت شش کلید برای هر صادرکننده وجود دارد. | یکی از راه‌های بالقوه برای استفاده از این متغیر، تعریف محدوده‌ای از اعتماد به توکن‌های خود بر اساس کلیدهای رمزنگاری شماست (به عنوان مثال، کلید 1 = اعتماد بالا در حالی که کلید 6 = بدون اعتماد). |
| تاریخ انقضای توکن | تاریخ انقضای توکن با تاریخ انقضای کلید یکسان است. | کلیدها را می توان حداقل هر 60 روز یکبار چرخاند و تمام نشانه های صادر شده با کلیدهای نامعتبر نیز نامعتبر در نظر گرفته می شوند. |
| محدودیت نرخ بازخرید رمز | محدودیت دو بازخرید توکن برای هر دستگاه و صادرکننده هر 48 ساعت وجود دارد. | بستگی به تعداد تخمینی بازخریدهای مورد نیاز مورد استفاده شما در هر 48 ساعت دارد. |
| حداکثر تعداد صادرکنندگان در هر مبدا سطح بالا | حداکثر تعداد صادرکنندگان در هر مبدا سطح بالا در حال حاضر دو نفر است. | صادرکنندگان هر صفحه را با دقت مشخص کنید. |
| توکن ها به ازای صادرکننده در یک دستگاه | حداکثر تعداد توکن برای هر صادرکننده در یک دستگاه خاص در حال حاضر 500 است. | اطمینان حاصل کنید که تعداد توکن ها کمتر از 500 در هر صادرکننده است. هنگام تلاش برای صدور توکن، مطمئن شوید که خطاهای صفحه وب خود را کنترل می کنید. |
| چرخش تعهدات کلیدی | هر صادرکننده PST موظف است یک نقطه پایانی را با تعهدات کلیدی که می‌توان هر 60 روز یکبار تغییر داد و هر چرخش سریع‌تر از آن نادیده گرفته شود، افشا کند. | اگر قرار است کلیدهای شما در کمتر از 60 روز منقضی شوند، برای جلوگیری از اختلال، باید تعهدات کلیدی خود را قبل از آن تاریخ به روز کنید (به جزئیات مراجعه کنید). |
| طول عمر رکورد رستگاری | طول عمر RR را می توان به منظور تعیین تاریخ انقضا تعریف کرد. از آنجایی که RRها برای جلوگیری از تماس‌های غیرضروری بازخرید جدید با صادرکننده در حافظه پنهان ذخیره می‌شوند، این مهم است که مطمئن شوید سیگنال‌های بازخرید به اندازه کافی جدید دارید. | از آنجایی که هر 48 ساعت یک محدودیت نرخ بازخرید دو توکن وجود دارد، مهم است که طول عمر RR خود را تعریف کنید تا بتوانید تماس‌های بازخرید را حداقل در این بازه زمانی با موفقیت اجرا کنید (طول عمر RR باید بر این اساس تنظیم شود). توصیه می شود این طول عمر را به ترتیب هفته ها تنظیم کنید. |
سناریوهای نمونه
سناریوی شماره 1: طول عمر RR کمتر از 24 ساعت است (t=t) و بازخرید چندین بار در طول پنجره 48 ساعته انجام می شود.
سناریوی شماره 2: طول عمر RR 24 ساعت است و بازخرید چندین بار در طول پنجره 48 ساعته انجام می شود.
سناریوی شماره 3: طول عمر RR 48 ساعت است و بازخرید چندین بار در طول پنجره 48 ساعت انجام می شود.
دمو را اجرا کنید
قبل از پذیرش PST، توصیه می‌کنیم ابتدا نسخه نمایشی را تنظیم کنید. برای آزمایش نسخه نمایشی PST، باید Chrome را با پرچم اجرا کنید تا تعهدات کلید صادرکننده نسخه آزمایشی را فعال کنید (دستورالعمل‌های موجود در صفحه نمایشی را دنبال کنید).
با اجرای این نسخه نمایشی، مرورگر شما از سرورهای صادرکننده نسخه آزمایشی و بازخرید کننده برای تهیه و مصرف توکن ها استفاده می کند.
ملاحظات فنی
اگر مراحل زیر را اجرا کنید، نسخه ی نمایشی به بهترین شکل اجرا می شود:
- قبل از اجرای Chrome با پرچم، مطمئن شوید که تمام نمونه‌های Chrome را متوقف کرده‌اید.
- اگر روی یک دستگاه ویندوز کار می‌کنید، به این راهنمای نحوه ارسال پارامترها به باینری اجرایی Chrome نگاهی بیندازید.
- در حین استفاده از برنامه آزمایشی، برای مشاهده نشانه‌های صادر شده/استفاده شده توسط صادرکننده نسخه آزمایشی، Chrome DevTools را در بخش Applications > Storage > Private State Tokens باز کنید.
برای پذیرش تنظیم کنید
صادرکننده شوید
صادرکنندگان نقش کلیدی در PST دارند. آنها برای تعیین اینکه آیا کاربر یک ربات است یا نه، مقادیری را به توکن ها اختصاص می دهند. اگر می خواهید با PST به عنوان یک صادرکننده شروع کنید، باید با تکمیل فرآیند ثبت نام صادرکننده، ثبت نام کنید.
برای درخواست برای تبدیل شدن به یک صادرکننده، اپراتور وب سایت صادرکننده باید با استفاده از الگوی "New PST Issuer" یک شماره جدید در مخزن GitHub باز کند. برای پر کردن مشکل، راهنمایی های موجود در مخزن را دنبال کنید. هنگامی که یک نقطه پایانی تأیید شد، در این مخزن ادغام می شود و زیرساخت سمت سرور Chrome شروع به واکشی آن کلیدها می کند.
سرورهای صادرکننده
صادرکنندگان و بازخریدکنندگان بازیگران کلیدی PST هستند. سرورها و توکن ها ابزارهای کلیدی برای PST هستند. در حالی که قبلاً جزئیاتی در مورد توکن ها و در اسناد Github ارائه کرده ایم، می خواهیم جزئیات بیشتری را در مورد سرورهای PST ارائه دهیم. برای راه اندازی به عنوان صادرکننده PST، ابتدا باید یک سرور صادرکننده راه اندازی کنید.
محیط خود را مستقر کنید: سرورهای صادرکننده
برای پیاده سازی سرور صادرکننده نشانه، باید برنامه سمت سرور خود را بسازید که نقاط پایانی HTTP را در معرض نمایش قرار دهد.
مؤلفه صادرکننده از دو ماژول اصلی تشکیل شده است: (1) سرور صادرکننده و (2) صادرکننده توکن.
مانند همه برنامه های کاربردی وب، ما یک لایه حفاظتی اضافی را برای سرور صادرکننده شما توصیه می کنیم.
سرور صادرکننده: در اجرای مثال ما، سرور صادرکننده ما یک سرور Node.js است که از چارچوب Express برای میزبانی نقاط پایانی صادرکننده HTTP استفاده می‌کند. می توانید کد نمونه را در GitHub بررسی کنید.
صادرکننده رمز: مؤلفه رمزنگاری صادرکننده به زبان خاصی نیاز ندارد، اما به دلیل الزامات عملکرد این مؤلفه، ما یک پیاده‌سازی C را به عنوان مثال ارائه می‌کنیم که از کتابخانه Boring SSL برای مدیریت توکن‌ها استفاده می‌کند. می‌توانید نمونه کد صادرکننده و اطلاعات بیشتر درباره نصب را در GitHub بیابید
کلیدها: جزء صادرکننده توکن از کلیدهای سفارشی EC برای رمزگذاری توکن ها استفاده می کند. این کلیدها باید محافظت شده و در فضای ذخیره سازی ایمن نگهداری شوند.
الزامات فنی برای سرورهای صادرکننده
طبق پروتکل، شما باید حداقل دو نقطه پایانی HTTP را در سرور صادرکننده خود پیاده سازی کنید:
- Key-commitment (به عنوان مثال،
/.well-known/private-state-token/key-commitment): این نقطه پایانی جایی است که جزئیات کلید عمومی رمزگذاری شما در دسترس مرورگرها خواهد بود تا تأیید شود که سرور شما قانونی است. - صدور توکن (به عنوان مثال،
/.well-known/private-state-token/issuance): نقطه پایانی صدور توکن که در آن تمام درخواست های توکن رسیدگی می شود. این نقطه پایانی، نقطه ادغام مؤلفه صادرکننده توکن خواهد بود.
همانطور که قبلا ذکر شد، با توجه به ترافیک بالای مورد انتظار این سرور به طور بالقوه مدیریت می کند، توصیه می کنیم آن را با استفاده از یک زیرساخت مقیاس پذیر (به عنوان مثال، در یک محیط ابری) مستقر کنید تا بتوانید باطن خود را بر اساس تقاضای متغیر تنظیم کنید.
به سرور صادرکننده تماس بفرستید
برای صدور توکن‌های جدید، یک تماس واکشی وب‌سایت با پشته صادرکننده خود اجرا کنید.
// issuer request
await fetch("/.well-known/private-state-token/issuance", {
method: "POST",
privateToken: {
version: 1,
operation: "token-request"
}
});
سرورهای Redeemer
شما باید با ساختن اپلیکیشن سمت سرور خود، سرویس بازخرید توکن را پیاده سازی کنید. این به شما امکان می دهد نشانه هایی را که صادرکننده ارسال می کند بخوانید. مراحل زیر نحوه بازخرید توکن ها و همچنین نحوه خواندن سوابق بازخرید مرتبط با آن توکن ها را تشریح می کند.
می‌توانید انتخاب کنید که صادرکننده و بازخریدکننده در یک سرور (یا گروهی از سرورها) اجرا شوند.
الزامات فنی برای سرورهای Redeemer
طبق پروتکل، شما باید حداقل دو نقطه پایانی HTTP را برای سرور Redeemer خود پیاده سازی کنید:
-
/.well-known/private-state-token/redemption: نقطه پایانی که در آن تمام بازخرید توکن ها انجام می شود. این نقطه پایانی جایی است که مؤلفه بازخرید کننده رمز یکپارچه خواهد شد
یک تماس با سرور Redeemer ارسال کنید
برای بازخرید توکن‌ها، باید یک تماس واکشی وب‌سایت در پشته بازخریدکننده خود پیاده‌سازی کنید تا بتوانید توکن‌های صادر شده قبلی را بازخرید کنید.
// redemption request
await fetch("/.well-known/private-state-token/redemption", {
method: "POST",
privateToken: {
version: 1,
operation: "token-redemption",
refreshPolicy: "none"
}
});
نمونه کد را ببینید.
پس از بازخرید توکن، می‌توانید رکورد بازخرید (RR) را با انجام یک تماس واکشی دیگر ارسال کنید:
// attach redemption records from the issuers to the request
await fetch("<DESTINATION_RESOURCE>", {
method: "POST",
privateToken: {
version: 1,
operation: "send-redemption-record",
issuers: [<ISSUER_DOMAIN>]
}
});
نمونه کد را ببینید.
پیاده سازی خود را مستقر کنید
برای آزمایش پیاده سازی خود، ابتدا به صفحه وب که در آن فراخوانی صادر شده است بروید و تأیید کنید که نشانه(ها) بر اساس منطق شما ایجاد شده اند. در پشتیبان خود بررسی کنید که تماس ها مطابق با مشخصات انجام شده است. سپس، به صفحه وب که در آن تماس بازخرید برقرار شده است بروید و مطابق منطق خود تأیید کنید که RR ها ایجاد شده اند.
استقرار در دنیای واقعی
توصیه می‌کنیم وب‌سایت‌های هدفی را انتخاب کنید که بخشی از موارد استفاده خاص شما هستند:
- تعداد کمی از بازدیدهای ماهانه (~ کمتر از 1 میلیون بازدید در ماه): ابتدا باید API را برای یک مخاطب کوچک شروع کنید.
- شما مالک آن هستید و آن را کنترل می کنید: در صورت لزوم می توانید به سرعت اجرا را بدون تأییدیه های پیچیده غیرفعال کنید
- بیش از یک صادرکننده: محدود کردن مقدار توکن ها به منظور ساده کردن آزمایش.
- بیش از دو بازخرید کننده: در صورت بروز مشکل باید عیب یابی را ساده کنید.
عیب یابی
می‌توانید PSTها را از برگه‌های «شبکه ابزارهای توسعه‌دهنده Chrome» و «برنامه» بررسی کنید.
در تب Network:
در برگه برنامه:
درباره این ادغام DevTools بیشتر بخوانید.
بهترین روش ها و عیب یابی سرور
برای اینکه سرور صادرکننده و بازخریدکننده شما به طور مؤثر کار کند، توصیه می‌کنیم بهترین روش‌های زیر را اجرا کنید تا اطمینان حاصل شود که با هیچ گونه چالش دسترسی، امنیت، ورود به سیستم یا ترافیک برای PST مواجه نمی‌شوید.
- نقاط پایانی شما باید با استفاده از TLS 1.3 یا 1.2 از رمزنگاری قوی استفاده کنند.
- زیرساخت شما باید برای رسیدگی به حجم ترافیک متغیر (از جمله افزایش) آماده باشد.
- اطمینان حاصل کنید که کلیدهای شما محافظت شده و ایمن هستند و با خط مشی کنترل دسترسی، استراتژی مدیریت کلید، و طرح‌های تداوم کسب و کار شما همسو هستند.
- معیارهای مشاهده پذیری را به پشته خود اضافه کنید تا مطمئن شوید که پس از رفتن به تولید، دیدی برای درک استفاده، تنگناها و مشکلات عملکرد خواهید داشت.
اطلاعات بیشتر
- بررسی اسناد توسعه دهنده:
- با خواندن نمای کلی شروع کنید تا با PST و قابلیت های آن آشنا شوید.
- ویدیوی معرفی PST را تماشا کنید.
- نسخه ی نمایشی PST را امتحان کنید.
- همچنین توضیح API را بخوانید تا جزئیات بیشتری در مورد آن بدانید.
- در مورد مشخصات فعلی API بیشتر بخوانید.
- از طریق مشکلات GitHub یا تماس های W3C در گفتگو مشارکت کنید.
- برای درک بهتر هر یک از اصطلاحات، واژه نامه Privacy Sandbox را مرور کنید.
- برای کسب اطلاعات بیشتر درباره مفاهیم Chrome، مانند «نسخه آزمایشی اصلی» یا «پرچم‌های Chrome»، ویدیوها و مقالات کوتاه موجود در goo.gle/cc را مرور کنید.