اثر انگشت تی ال اس net.utls

دیوار آتشی که ترافیک شما را نمی‌خواند، هنوز می‌تواند پیام اول را بخواند. ClientHello یک اتصال TLS رمزها، افزونه‌ها و ترتیبشان، منحنی‌ها و الگوریتم‌های امضایی را که کارخواه پشتیبانی می‌کند فهرست می‌کند، و هر کتابخانه‌ی TLS این فهرست را به شکل خودش می‌نویسد. این فهرست یک اثر انگشت است (JA3 شناخته‌شده‌ترین راه نوشتنش است) و کارخواه پراکسی که فهرست پیش‌فرض کتابخانه‌اش را به کار ببرد اثر انگشتی دارد که هیچ مرورگری ندارد. این بسته خودِ ClientHello را از روی توصیفی که می‌توانید بخوانید و عوض کنید می‌سازد تا چینش یک مرورگر را داشته باشد.

نمایه یک Spec برای یک خانواده‌ی کارخواه برمی‌گرداند. ساخت یک مشخصه و چند Options (نام سرور، فهرست ALPN، بر زدن افزونه‌ها) را به یک Hello تبدیل می‌کند: بایت‌های پیام با عدد تصادفی تازه، جفت کلید X25519 تازه و شناسه‌ی نشست تصادفی. پوشش کارخواه سپس روی سوکت وصل‌شده با آن پیام دست‌دهی TLS 1.3 را اجرا می‌کند و یک tls.Conn معمولی برمی‌گرداند. جی ای سه اثر انگشت هر پیامی را می‌نویسد و رکورد آن را در یک رکورد TLS می‌پیچد، مثلاً برای دادن به ابزار تکه‌تکه‌کردن سانسورشکن. ریالیتی این بسته را برای پیامی که اثبات خود را در آن مهر می‌کند به کار می‌برد.

نمایه‌ها

این‌ها تقریب‌هایی هستند که از حافظه‌ی آنچه این کارخواه‌ها می‌فرستند نوشته شده‌اند، نه ضبط واقعی. مقایسه با ضبط مرورگر واقعی اینجا ممکن نبود. ساختار به دو راه سنجیده شد: پیام‌ها با net.censor.ParseClientHello خوانده می‌شوند و با سرور بسته‌ی tls دست‌دهی TLS 1.3 واقعی را کامل می‌کنند. مرورگرها با هر انتشار پیامشان را عوض می‌کنند، پس نمایه را نقطه‌ی شروع بدانید و Spec را (فهرست‌های متنی ساده است) مطابق مرورگر دلخواه ویرایش کنید.

مشخصه چگونه نوشته می‌شود

فهرست‌های Spec متنی از عددهای شانزدهی جداشده با فاصله‌اند. g0 تا g4 جایگاه‌های GREASE هستند که به یک مقدار رزروشده‌ی تصادفی (0a0a، 1a1a و ...) تبدیل می‌شوند؛ pad جای افزونه‌ی پرکننده است. extensions ترتیب روی سیم است؛ 0000 نام سرور، 0010 ALPN، 0033 سهم کلید، fe0d GREASE برای ECH و ... . key_shares می‌گوید کدام سهم‌ها فرستاده شود: 001d X25519 با جفت کلید همان پیام، 0017 سهم secp256r1 با بایت تصادفی و 11ec X25519MLKEM768.

چیزهایی که گیر می‌اندازند

• سهم‌های کلید غیر از X25519 کلیدی پشتشان نیست. سهم secp256r1 بایت تصادفی است و بخش ML-KEM سهم ترکیبی یک کلید کپسوله‌سازی تصادفیِ خوش‌ساخت است. سروری که یکی از آن گروه‌ها را برگزیند نمی‌تواند دست‌دهی را با شما تمام کند؛ برای X25519 می‌تواند. با pq = false گروه ترکیبی را کلاً از پیام کنار بگذارید.
• پیام به طور پیش‌فرض ALPN h2 پیشنهاد می‌کند. اگر سرور آن را برگزیند با چیزی حرف می‌زنید که HTTP/2 انتظار دارد. برای انتقال پراکسی alpn = "http/1.1" بگذارید، یا "none" تا افزونه حذف شود.
• بعضی بایت‌ها عمداً تصادفی‌اند. مقدارهای GREASE، طول ECH، عدد تصادفی، شناسه‌ی نشست و سهم‌های کلید با هر ساخت عوض می‌شوند. JA3 مقدارهای GREASE و بایت کلید را نادیده می‌گیرد، پس JA3 هر نمایه پایدار است.
• فقط TLS 1.3 و بدون HelloRetryRequest. دست‌دهی از پیام سفارشی با پیام روشن شکست می‌خورد اگر سرور گروه دیگری بخواهد یا فقط TLS 1.2 بداند.
• پیام را آزاد کنید. Hello مالک بافرهایش است: وقتی تمام کردید آزادسازی سلام را صدا بزنید.

ساخت پیام و خواندن JA3

نمونه برای سه نمایه یک پیام با کنار گذاشتن سهم ترکیبی می‌سازد و رشته‌های JA3 را چاپ می‌کند. رشته‌ی JA3 نگارش، رمزها، شناسه‌ی افزونه‌ها، منحنی‌ها و قالب نقطه‌هاست، هرکدام به صورت عدد دهدهی و با حذف GREASE. ترتیب شناسه‌ی افزونه‌ها روشن‌ترین تفاوت میان نمایه‌هاست.

// زبان: فارسی
واردسازی شبکه.اثر انگشت تی ال اس

تابع ریشه:
    سرچاپ "نمایه‌ها:"، اثر انگشت تی ال اس.نام نمایه‌ها()
    ناپایا o := اثر انگشت تی ال اس.گزینه‌ها {}
    o.نام کارساز = "www.example.com"
    o.کلید پسا کوانتومی = نادرست
    هر name در ["chrome"، "firefox"، "safari"]:
        ناپایا h := اثر انگشت تی ال اس.ساخت(اثر انگشت تی ال اس.نمایه(name)، o)
        سرچاپ name، "پیام آغازین بزرگ‌تر از ۴۰۰ بایت است:"، h.خام.طول بزرگتر 400
        سرچاپ اثر انگشت تی ال اس.جی ای سه(h.خام)
        اثر انگشت تی ال اس.آزادسازی سلام(h)
    پایان
    سرچاپ "نمایه‌ی ناشناخته معتبر است:"، اثر انگشت تی ال اس.نمایه("netscape").معتبر
پایان

دست‌دهی از یک نمایه

پوشش کارخواه سوکت وصل‌شده، مشخصه، گزینه‌ها و یک tls.Config می‌گیرد. گواهی به شکل عادی بررسی می‌شود. نتیجه یک tls.Conn است، پس هر تابع tls و پشتیبانی TLS انتقال شبکه با آن کار می‌کند.

// زبان: فارسی
واردسازی شبکه.تی سی پی
واردسازی شبکه.اثر انگشت تی ال اس
واردسازی تی ال اس

تابع ریشه:
    c := تی سی پی.شماره گیری("www.example.com"، 443)
    ناپایا o := اثر انگشت تی ال اس.گزینه‌ها {}
    o.نام کارساز = "www.example.com"
    o.پروتکل برنامه = "http/1.1"
    cfg := تی ال اس.پیکربندی جدید("www.example.com")
    ناپایا t := اثر انگشت تی ال اس.پوشش کارخواه(c.توصیفگر، اثر انگشت تی ال اس.نمایه("chrome")، o، cfg)
    اگر وارونه تی ال اس.اتصال معتبر(t):
        سرچاپ "شکست خورد:"، تی ال اس.خطای اتصال(t)
        برگشت 1
    پایان
    تی ال اس.نوشتن(t، "GET / HTTP/1.1\r\nHost: www.example.com\r\nConnection: close\r\n\r\n")
    سرچاپ تی ال اس.خواندن(t، 200)
    تی ال اس.بستن اتصال(t)
پایان

محدودیت‌ها

• نمایه‌ها تقریب‌اند، نه ضبط. با مرورگر زنده مقایسه نشدند و کارخواه‌های واقعی از انتشاری به انتشار دیگر تغییر می‌کنند.
• ML-KEM ندارد. سهم ترکیبی جانگهدار است (بالا را ببینید) و سروری که آن را برگزیند دست‌دهی را می‌شکند.
• از سرگیری نشست و افزونه‌ی کلید پیش‌اشتراکی ندارد. پیام همیشه اتصال اول است.
• افزونه‌ی ECH فقط GREASE است. شکل یکی واقعی را دارد و چیزی در آن رمز نشده.
• لایه‌ی رکورد و دست‌دهی از کتابخانه است. رکورد اول مثل مرورگرها نگارش قدیمی 0x0301 دارد، اما طول‌ها و زمان‌بندی آنچه پس از پیام می‌آید مال بسته‌ی tls است، نه مرورگر.
• فقط TLS 1.3. سروری که با TLS 1.2 جواب بدهد دست‌دهی را شکست می‌دهد.

گونه‌ها

ساختار بایت‌ها

ساختار مشخصات

ساختار گزینه‌ها

ساختار سلام کارخواه

تابع‌ها

تابع جی ای سه(b: بایت‌ها): رشته

تابع آزادسازی بایت‌ها(b &: بایت‌ها)

تابع آزادسازی سلام(h &: سلام کارخواه)

تابع به شانزدهی(b: بایت‌ها): رشته

تابع جایگاه شناسه نشست(): صحیح

تابع تنظیم شناسه نشست(h &: سلام کارخواه، sid: تهی*)

تابع ساخت(sp: مشخصات، o: گزینه‌ها): سلام کارخواه

تابع نمایه(name: رشته): مشخصات

تابع نام نمایه‌ها(): رشته

تابع نام نمایه‌های قدیمی(): رشته

تابع رکورد(h: سلام کارخواه): بایت‌ها

تابع بذر پسا کوانتومی سلام(h: سلام کارخواه): تهی*

تابع پوشش کارخواه(fd: صحیح۶۴، sp: مشخصات، o: گزینه‌ها، cfg: تی ال اس.پیکربندی): تی ال اس.اتصال