TgWitness / مستندسازی

آنچه آزمایش شده است ←

منبع / شواهد

Telegram · برچسب‌های زمانی

تمبرهای زمانی RFC 3161 برای نقاط کنترل امضا شده: چه چیزی به مرجع ارسال می‌شود و چگونه پاسخ تأیید می‌شود.

TgWitness / مستندسازی · شواهد و تأیید

شواهد و تأیید

TgWitness درخواست‌های RFC 3161 را آماده می‌کند و پاسخ‌های مرجع تاریخ‌نگاری (TSA) را تأیید می‌کند. این رویه دستی نه یک مرجع تاریخ‌نگاری را انتخاب می‌کند و نه داده‌ای را ارسال می‌نماید؛ حالت مدرک هر دو را طبق یک برنامه زمان‌بندی‌شده (قالب مدرک) انجام می‌دهد. یک درخواست آماده‌شده هنوز یک مدرک تاریخ‌نگاری نیست.

آنچه مدرک را پیوند می‌دهد#

نمودار جریانمشاهدات حساب کاربری → زنجیره SHA-256 و امضاهای Ed25519; زنجیره SHA-256 و امضاهای Ed25519 → نقطهٔ کنترل امضا شده; نقطهٔ کنترل امضا شده → هَش دقیق بایت‌به‌بايت و نانس تصادفی; هَش دقیق بایت‌به‌بايت و نانس تصادفی → درخواست RFC 3161; درخواست RFC 3161 → TSA مستقل; TSA مستقل → پاسخ امضا‌شده TSA; نقطهٔ کنترل امضا شده → تأیید داده‌ها، عدد یک‌بار مصرف و اعتماد صریح به CA; پاسخ امضا‌شده TSA → تأیید داده‌ها، عدد یک‌بار مصرف و اعتماد صریح به CAمشاهدات حساب کاربریزنجیره SHA-256 وامضاهای Ed25519نقطهٔ کنترل امضا شدههَش دقیق بایت‌به‌بايتو نانس تصادفیدرخواست RFC 3161TSA مستقلپاسخ امضا‌شده TSAتأیید داده‌ها، عددیک‌بار مصرف و اعتمادصریح به CA
نمودار به صورت متن
  1. مشاهدات حساب کاربری → زنجیره SHA-256 و امضاهای Ed25519
  2. زنجیره SHA-256 و امضاهای Ed25519 → نقطهٔ کنترل امضا شده
  3. نقطهٔ کنترل امضا شده → هَش دقیق بایت‌به‌بايت و نانس تصادفی
  4. هَش دقیق بایت‌به‌بايت و نانس تصادفی → درخواست RFC 3161
  5. درخواست RFC 3161 → TSA مستقل
  6. TSA مستقل → پاسخ امضا‌شده TSA
  7. نقطهٔ کنترل امضا شده → تأیید داده‌ها، عدد یک‌بار مصرف و اعتماد صریح به CA
  8. پاسخ امضا‌شده TSA → تأیید داده‌ها، عدد یک‌بار مصرف و اعتماد صریح به CA

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

روند کار#

اعتبارسنج ژورنال، گام‌های معکوس و مقادیر غیرقابل تجزیه‌وتحلیل observed_at را در chronology در صورت وجود گزارش می‌کند و یک هشدار را در خروجی فرمان خود درج می‌کند. این ابزار مهرهای زمانی امضا شده را حفظ می‌کند و همچنان امضاهای آن‌ها را بررسی می‌کند. یک گام معکوس می‌تواند از اصلاح ساعت ناشی شود، بنابراین آن را با سوابق ساعت میزبان بررسی کنید. زمان مستقل از زمان‌مهرهای خارجی تأییدشده، پست‌های شاهدی که از صفحه عمومی t.me آنها خوانده شده‌اند و دورهای drand به دست می‌آید؛ --strict بر پین کردن امضاکننده و فرمت‌های پشتیبانی‌شده نظارت می‌کند.

مقادیر ضبط‌شده drand به‌صورت آفلاین تحت بررسی‌های سازگاری ساختاری و هش قرار می‌گیرند. دستور --check-drand دورهای ضبط‌شده منتخب را با پاسخ‌های رله HTTPS مقایسه می‌کند؛ نتیجه بیان می‌کند که چند دور مقایسه شده و کدام رله‌ها پاسخ داده‌اند، و دورهای مقایسه شده، حد زمانی پایین‌تر احراز شده را فراهم می‌کنند.

  1. اثر انگشت کلید کالکتور را از طریق یک کانال امن جداگانه حفظ کنید؛ این کالکتور را به طور مستقل از فایل ZIP بررسی‌شده شناسایی می‌کند.
  2. در بخش «صادرات» → «آماده‌سازی درخواست مهر زمانی»، فایل ZIP درخواست فضای کاری انتخاب‌شده را دانلود کنید. فایل‌های checkpoint.json، timestamp.tsq، SHA256SUMS و README.txt را استخراج کنید. بایت‌های نقطه‌کنترل را تغییر ندهید.
  3. یک TSA مناسب برای تحقیق انتخاب کنید. timestamp.tsq را با استفاده از روش مستندشده آن ارسال کنید، همراه با application/timestamp-query برای یک سرویس HTTP. پاسخ باینری اصلی را به عنوان timestamp.tsr، نقطه پایانی، زمان بازیابی و نتیجه درخواست ذخیره کنید. درخواست حاوی هش و نانس است نه پیام‌ها؛ متادیتای شبکه همچنان درخواست را فاش می‌کند.
  4. گواهی ریشهٔ مورد اعتماد را به‌طور مستقل از پاسخ به‌دست آور، به‌علاوهٔ هر گواهی واسطه‌ای که لازم است. گواهی‌ای که در پاسخ آمده صرفاً به این دلیل که در آنجا گنجانده شده مورد اعتماد قرار نمی‌گیرد.
  5. از یک نصب معتبر TgWitness، اعتبارسنجی کنید:
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem

در صورت نیاز --intermediates tsa-intermediates.pem را اضافه کنید. OpenSSL لازم نیست: امضا، ارجاع گواهی امضا و زنجیره در Python با کتابخانه cryptography بررسی می‌شوند؛ همان کدی که verify.py --tsa-ca به کار می‌برد. openssl ts -verify بررسی دوم مستقلی برای کارشناسی است که آن را بخواهد.

  1. پس از نقطهٔ کنترل، یک فایل ZIP مجلهٔ امضا شده را صادر کنید تا شامل آن پیش‌وند باشد. با استفاده از اثر انگشت مستقل شناخته‌شده تأیید کنید:
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json

این نشان می‌دهد که خروجی حاوی پیشوند دارای مهر زمانی است. verify.py فقط رسیدهای دارای مهر زمانی را از فایل ZIP می‌خواند، جایی که حالت شواهد آن‌ها را ذخیره می‌کند؛ پاسخ دستی در مرحله 5 بررسی می‌شود و سوابق تا این نقطه کنترل را پوشش می‌دهد.

  1. حفظ فایل ZIP، نقطهٔ کنترل، درخواست، پاسخ، زنجیرهٔ گواهی، نتایج تأیید و سوابق تحویل خارج از جمع‌آورنده. تکرار تأیید هنگام دریافت.

برای آماده‌سازی یک درخواست از یک نقطهٔ کنترل ذخیره شده:

python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip

فرآیند آماده‌سازی JSON را کانونیکال می‌کند و چک‌پوینت مطابقت‌دار را در آرشیو درج می‌کند. از بایت‌های چک‌پوینت آن آرشیو برای تأیید TSA استفاده کنید، حتی اگر فایل ورودی فضای خالی متفاوتی داشته باشد.

مرزهای اعتبارسنجی#

بررسی رفتار فعلی
داده‌ها SHA-256 بایت‌های دقیق نقطه‌ی کنترل باید با پاسخ مطابقت داشته باشد
درخواست با --request، پرس‌وجوی اصلی و نانس تأیید می‌شوند
امضای TSA امضا، گواهی امضا و زنجیره آن تا CA صریحاً تعیین‌شده در زمان مهر بررسی می‌شوند
امضای گردآورنده به‌طور جداگانه توسط اعتبارسنج مجله با یک کلید ثابت‌شده تأیید می‌شود
ابطال حالت شواهد، شواهد OCSP/CRL را که verify.py بررسی می‌کند، ذخیره می‌کند.
ارسال برنامه‌ریزی‌شده حالت شواهد، که توسط هر هدف راه‌اندازی فعال می‌شود

--request از نظر فنی اختیاری است، اما حذف آن مانع راستی‌آزمایی nonce اصلی می‌شود. در این روال کامل، مقدار request_checked در نتیجه باید true باشد. هر گواهی زنجیره باید در زمان مهر معتبر باشد و گواهی امضا باید فقط برای مهر زمانی باشد.

پاسخ TSA بایت‌های چک‌پوینت ارسال‌شده را به زمان اعلام‌شده خود متصل می‌کند. آن نتیجه را با سوابق اکتساب و تأیید محیط برای حالت انتخاب‌شده بررسی کنید. حالت مدرک شامل TSA معتبر دولت بلژیک است (http://tsa.belgium.be/connect؛ پاسخ‌های RFC 3161 امضا شده هستند، بنابراین HTTP ساده آنها را تضعیف نمی‌کند). با ارسال ریشه آن ارائه‌دهنده به --tsa-ca، verify.py یک مهر زمانی eIDAS واجد شرایط و واحد زمان‌بندی آن را گزارش می‌دهد؛ مقررات (اتحادیه اروپا) شماره 910/2014، ماده 41(2)، صحت زمان آن و یکپارچگی داده‌های پیوندی را مفروض می‌داند.

ابطال گواهی امضا#

بلافاصله پس از هر پاسخ، حالت شواهد، شواهد لغو گواهی امضای TSA را بازیابی می‌کند: یک پاسخ OCSP از آدرس OCSP AIA گواهی، در غیر این صورت CRL را از نقطه توزیع آن (حداکثر 4 MiB). این شواهد در کنار پاسخ به صورت checkpoint-N.<service>.ocsp یا .crl ذخیره شده و با آن صادر می‌شود. یک بازیابی ناموفق هرگز مانع ثبت مهر زمانی نمی‌شود؛ رکورد anchor.completed آن را به عنوان unavailable با ذکر دلیل ثبت می‌کند.

verify.py امضای پاسخ OCSP (توسط صادرکننده، یا توسط گواهی پاسخ‌دهنده که صادرکننده برای هدف امضای OCSP ارائه کرده است)، شناسه گواهی و وضعیت آن، و اینکه پاسخ در زمان genTime یا بعد از آن صادر شده یا در آن زمان هنوز معتبر بوده است (nextUpdate) را بررسی می‌کند. برای CRL، امضای صادرکننده، همان بازه زمانی و اینکه شماره سریال در فهرست ذکر نشده باشد را بررسی می‌کند. سپس گزارشی با مضمون signing certificate not revoked as of <time> (OCSP|CRL)، فرایند بررسی ناموفق بود، یا revocation not checked (no OCSP/CRL in the archive) ارائه می‌دهد. گواهی امضایی که در زمان genTime یا قبل از آن لغو شده باشد، اعتبارسنجی را با شکست مواجه می‌شود؛ لغو بعدی به صورت یک هشدار نمایش داده می‌شود.

سوابق شواهد و تمدید (RFC 4998)#

یک مهر زمانی RFC 3161 تنها تا زمانی معتبر است که الگوریتم هش، کلید امضا و گواهی TSA معتبر باشد، و یک مورد می‌تواند از آنها فراتر رود. حالت شواهد همچنین یک رکورد شواهد RFC 4998 (ERS) برای هر نقطه کنترل نگهداری‌شده نگه می‌دارد و آن را تمدید می‌کند.

در هر گذر شواهد، نقاط کنترل بدون رکورد وارد یک درخت هش می‌شوند و از TSAهای پیکربندی‌شده به ترتیب برای یک مهر زمانی روی ریشهٔ آن پرس‌وجو می‌شود. هر نقطهٔ کنترل دریافت می‌کند checkpoints/anchors/checkpoint-N.ers: یک EvidenceRecord که ArchiveTimeStampSequence حاوی یک ArchiveTimeStampChain با یک ArchiveTimeStamp حامل درخت هش کاهش‌یافته برای آن نقطه‌ی کنترل و توکن TSA است. یک رکورد می‌تواند هش‌های نقاط کنترل همسایه را فهرست کند؛ اعتبارسنج‌هایی مانند EU DSS در این مورد هشدار می‌دهند. یک خروجی ASiC-E نیز حامل META-INF/evidencerecord.ers با META-INF/ASiCEvidenceRecordManifest.xml، رکورد مدرک برای اشیاء دادهٔ کانتینر (ETSI EN 319 162-1). یک خروجی ZIP رکوردهای نقطه‌کنترل را در زیر anchors/.

تجدید مطابق RFC 4998 بخش 5 است و تنها موارد زیر را الحاق می‌کند:

نوزایی زمانی که چه چیزی مهر شده است
تأیید مجدد مهر زمانی گواهی امضای جدیدترین توکن در عرض N ماه (پیش‌فرض ۶) منقضی می‌شود، هَش امضای آن ضعیف علامت‌گذاری می‌شود، یا بنا به درخواست هش توکن قبلی، با همان الگوریتم؛ مهر به آخرین زنجیره اضافه می‌شود.
نوسازی درخت هش الگوریتم هش زنجیره به‌عنوان ضعیف علامت‌گذاری شده است، یا بنا به درخواست H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) با یک الگوریتم قوی‌تر (پیش‌فرض SHA-512)، یک زنجیره جدید اضافه می‌شود.

هر تمدید به یک فایل جدید می‌رود، checkpoint-N.renewal-K.ers؛ فایل‌های قبلی و زنجیره‌ها بایت به بایت یکسان باقی می‌مانند. اثبات تنها در صورتی به اولین مهر زمانی بازمی‌گردد که هر لینک به ترتیب بررسی شود، بنابراین در حالی که توکن جدیدترین هنوز معتبر است آن را تمدید کنید: قبل از انقضای گواهی امضای آن، ناپدید شدن اطلاعات ابطال آن یا از کار افتادن هش یا الگوریتم امضای آن. تمدید بعدی یک مهر اضافه می‌کند اما اثبات قبلی را گسترش نمی‌دهد.

حلقه پس‌زمینه در حالت شواهد، سیاست را روزانه و بنا به درخواست بررسی می‌کند (evidence_record.demand_renewal). هر تلاش در دفتر وقایع به صورت evidence_record.created یا evidence_record.renewed با سرویس، زمان، الگوریتم هش، ریشه درخت، بازه نقطه‌کنترل، ok و خطاها؛ رکوردهای غیرقابل خواندن به evidence_record.check_failed. یک TSA ناموفق با فاصله زمانی افزایش‌یافته برای مهرزنی نقطه‌کنترل، که به‌طور جداگانه شمارش می‌شود، مجدداً امتحان می‌شود، در حالی که TSA بعدی فهرست‌شده آزمایش می‌شود. سیاست (months_before_expiry, weak_algorithms, algorithm, stronger_algorithm) تنظیم پروفایل است evidence_record_policy؛ پنل هنوز کنترلی برای آن ندارد.

جمع‌کننده هر رکورد جدید را پیش از نوشتن آن، با نقطه کنترل و امضای TSA مطابقت می‌دهد. verify.py هر رکورد را در یک خروجی بررسی می‌کند: درختان هش، توکن‌ها، ترتیب زنجیره‌ها و تمدیدها، و زودترین زمان اثبات‌شده و وضعیت جدیدترین مهر را گزارش می‌دهد. EU DSS همان رکوردها را با نقطه کنترل به‌عنوان داده‌های جداگانه می‌خواند.

مقررات (اتحادیه اروپا) 2024/1183 (eIDAS 2.0) آرشیو الکترونیکی واجد شرایط و دفتر کل الکترونیکی واجد شرایط را به مقررات (اتحادیه اروپا) شماره 910/2014 افزود. TgWitness سوابق را در قالب‌های استاندارد ثبت می‌کند اما یک سرویس اعتماد نیست؛ آرشیو و دفتر کل آن فاقد وضعیت واجد شرایط هستند. یک ارائه‌دهنده واجد شرایط، در میان موارد دیگر، به موارد زیر نیاز خواهد داشت:

  • آرشیو (مواد ۴۵i و ۴۵j): ارائه‌دهنده خدمات اعتماد واجد شرایط که داده‌ها را برای دوره نگهداری قانونی یا قراردادی، پایدار و خوانا فراتر از دوره اعتبار فناوری، و محافظت‌شده در برابر از دست رفتن و تغییر، نگهداری می‌کند، به همراه گزارش یکپارچگی خودکار برای طرف‌های متکی مجاز از شروع دوره نگهداری تا بازیابی. ماده ۴۵i(2) یکپارچگی و اصالت را برای چنین خدمتی مفروض می‌داند.
  • دفتر کل (ماده‌های ۴۵k و ۴۵l): دفتر کلی که توسط یک یا چند ارائه‌دهنده خدمات اعتماد واجد شرایط ایجاد و مدیریت می‌شود، منشأ سوابق را مشخص می‌کند، آن‌ها را به‌طور منحصربه‌فرد و به ترتیب زمانی مرتب می‌سازد و تغییرات بعدی را بلافاصله قابل تشخیص می‌نماید. دفتر روزنامه TgWitness به‌صورت زنجیره‌ای هش شده و با کلید خودِ گردآورنده امضا شده است، که به‌تنهایی یک دفتر کل واجد شرایط محسوب نمی‌شود.
  • هر دو: وضعیت تأیید صلاحیت اعطا شده توسط یک مرجع نظارتی و یک ورودی در فهرست مورد اعتماد (مواد ۲۱ و ۲۲)، تعهدات مندرج در ماده ۲۴، ارزیابی انطباق حداقل هر ۲۴ ماه یک‌بار (ماده ۲۰) و استانداردهای مرجع مندرج در اقدامات اجرایی طبق مواد ۴۵j(۲) و ۴۵l(۲).

مهرهای زمانی معتبر از یک TSA معتبر (مواد ۴۱ و ۴۲)، برای هر توکن، فرضیه خاص خود را حفظ می‌کنند؛ تمدید، فرضیه‌ای برای کل سوابق ایجاد نمی‌کند.

سپردهٔ سوابق#

شناسه‌ی پرونده، فرستنده و گیرنده، زمان انتقال به وقت UTC و منبع آن، هدف، نام فایل‌ها/مقادیر SHA-256، اثر انگشت گردآورنده، بازه‌ی توالی، فواصل شناخته‌شده، نسخه‌ی اعتبارسنج و نتیجه‌ی اعتبارسنجی را ثبت کنید. این سوابق را امضا کرده و به صورت مستقل از طریق فرآیند سازمان خود نگهداری کنید. سیستم سوابق امانی چندکاربره در TgWitness پیاده‌سازی نشده است.

بررسی زنده سرویس، 9 نوامبر 2026#

یک درخواست RFC 3161 به هر سرویس پیش‌فرض ارسال شد. هر دو آن را پذیرفتند.

سرویس پاسخ واحد امضا نتیجه اعتبارسنج
http://tsa.belgium.be/connect مقرر شده، سیاست 2.16.56.13.6.3.1.1000 واحد زمان‌بندی 202301 برچسب زمانی معتبر eIDAS
https://freetsa.org/tsr اعطا شده FreeTSA مهر زمانی RFC 3161

گواهی امضای بلژیکی حاوی بیانیه انطباق qcStatements است و با واحد ثبت‌شده در اعتبارسنج مطابقت دارد. تست‌های محلی نیز از یک CA/TSA ترکیبی برای بررسی رد داده‌های تغییر یافته، نانس تغییر یافته و CA نادرست استفاده می‌کنند.

در 10 نوامبر 2026 پاسخ‌دهنده OCSP بلژیکی، یک گواهی پاسخ‌دهنده واگذارشده، برای واحد مهر زمانی 202301 پاسخ «خوب» داد. آدرس OCSP FreeTSA (پورت 2560) در عرض 40 ثانیه از میزبان آزمایشی پاسخی نداد؛ در عوض از CRL آن (PEM، 1 کیلوبایت) استفاده شد. 202301. آدرس OCSP فری‌تی‌اس‌ای (پورت 2560) پاسخ نداد در عرض 40 ثانیه از میزبان آزمایشی؛ CRL آن (PEM، 1 KB) به جای آن استفاده شد.