تی ال اس tls
اتصال امن TLS 1.3 و 1.2 و ابزارهای رمزنگاری کلید عمومی، بینیاز از OpenSSL.
واردسازی تی ال اس
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
بستهی تی ال اس پیادهسازی کامل TLS 1.2 و 1.3 به زبان سلام است و به کتابخانهی بیرونی نیاز ندارد. کارخواه با اتصال امن وصل میشود و گواهی سرور را با ریشههای سیستم بررسی میکند؛ سرور با پیکربندی کارساز جدید گواهی و کلیدش را میخواند و هر سوکت پذیرفته را با پوشش کارساز امن میکند. بیشتر برنامهها مستقیم صدایش نمیزنند: اچ تی تی پی، پست الکترونیک و وبسوکت برای https، SMTPS و wss از آن استفاده میکنند. برای کدی که به سبک OpenSSL نوشته شده (زمینه، SSL_connect، SSL_read)، اس اس ال همان رابط را روی این بسته میدهد.
ابزارهای رمزنگاری این بسته برای پروتکل و ذخیرهسازی خودتان هم به کار میآیند: دو طرف با ECDH راز مشترک میسازند، با HKDF از آن کلید درمیآورند و با AES-GCM پیام را رمز و مهر میکنند؛ P-256 امضا میکند و امضا را میسنجد. کلیدها و دادهها به شکل متن بیس۶۴ رد و بدل میشوند تا بایتهای دودویی درون رشته سالم بمانند.
نکتههایی که باید بدانید:
- پس از
اتصال امن،اتصال معتبررا بسنجید. دستدهی ناموفق یا گواهی بد اتصال بسته میدهد وخطای اتصالدلیلش را میگوید. خواندنیکرشتهبرمیگرداند که در بایت صفر تمام میشود. برای دادهی دودوییخواندن بایتونوشتن بایترا با بافر خودتان به کار ببرید.- کارخواه نمیتواند گواهی ارائه کند (TLS دوطرفه ندارد) و هر
اتصالبا ارجاع داده میشود و هر بار مال یک نخ است. - nonce در AES-GCM را زیر یک کلید هرگز تکرار نکنید؛ بخش مهر کردن شمارندهای نشان میدهد که جلوی این کار را میگیرد.
- AES-GCM تا جایی که پردازنده دستورهای AES را دارد از آنها استفاده میکند: AES-NI و PCLMULQDQ در x86-64 و افزونههای رمز در AArch64، در هر ساختی که با پشتیبان LLVM باشد و همهی نسخههای انتشار را شامل میشود. این
ای ای دی جدیدومهر خام ای ای اس جی سی اموگشودن خام ای ای اس جی سی امو لایهی رکورد TLS را در بر میگیرد، پس پروتکلهای پراکسی و ویپیان بیهیچ تغییری از آن بهره میبرند. پشتیبانهای دیگر و پردازندههای بی این دستورها همان کد جدولمحور را به کار میبرند که همان بایتها را میدهد. پردازنده میگوید کدام مسیر در کار است و میتواند مسیر نرمافزاری را بخواهد.
اتصال به سرور و رفتار با گواهی خراب
اتصال امن همهی دستدهی را انجام میدهد و زنجیرهی گواهی را با ریشههای سیستم و نامی که به پیکربندی جدید دادهاید میسنجد. اگر چیزی درست نباشد، اتصال باز نمیشود و خطای اتصال دلیلش را میگوید: گواهی منقضی شده، برای نام دیگری صادر شده، یا به ریشهی مورد اعتمادی نمیرسد. پیش از نوشتن همیشه اتصال معتبر را بررسی کنید. برنامهی زیر یک سایت سالم و سه میزبانی را که badssl.com عمدا خراب نگه داشته امتحان میکند.
واردسازی تی ال اس
تابع آزمودن(میزبان: رشته):
پیکربندی := تی ال اس.پیکربندی جدید(میزبان)
ناپایا اتصال := تی ال اس.اتصال امن(میزبان، ۴۴۳، پیکربندی)
اگر وارونه تی ال اس.اتصال معتبر(اتصال):
سرچاپ میزبان، "رد شد:"، تی ال اس.خطای اتصال(اتصال)
برگشت
پایان
سرچاپ میزبان، تی ال اس.نسخه(اتصال)، تی ال اس.نام رمز(اتصال)، تی ال اس.تعداد گواهی همتا(اتصال)، "گواهی"
تی ال اس.بستن اتصال(اتصال)
پایان
تابع ریشه:
آزمودن("www.salamlang.ir")
آزمودن("expired.badssl.com")
آزمودن("wrong.host.badssl.com")
آزمودن("self-signed.badssl.com")
پایاناین برنامه به شبکه نیاز دارد، پس اینجا فقط بررسی میشود. در یک اجرا خطهای زیر را چاپ کرد؛ نام رمز و شمار گواهیها به سرور بستگی دارد.
www.salamlang.ir TLS1.3 TLS_CHACHA20_POLY1305_SHA256 3 گواهی
expired.badssl.com رد شد: certificate verification failed: certificate expired
wrong.host.badssl.com رد شد: certificate verification failed: hostname does not match certificate
self-signed.badssl.com رد شد: certificate verification failed: no trusted issuer found
برای سرور خصوصی که مرجع گواهی خودش را دارد، ca_file را در پیکربندی روی فایل PEM آن مرجع بگذارید. insecure_skip_verify بررسی را خاموش میکند؛ فقط برای آزمایش سریع روی دستگاه خودتان به کارش ببرید، هرگز در برنامهای که دیگران به آن تکیه میکنند.
رمزگذاری رکوردها با AES-GCM
مهر ای ای اس جی سی ام متن را رمز میکند و یک برچسب به آن میافزاید تا گشودن ای ای اس جی سی ام هر تغییری را بفهمد: کلید نادرست، نانس نادرست یا یک بایت عوض شده همه موفق را نادرست میکنند، به جای اینکه دادهی بیمعنی برگردد. کلید ۳۲ بایت تصادفی به شکل base64 است؛ یک بار با نمک تصادفی(۳۲) بسازید و پنهان نگهش دارید. نانس زیر یک کلید هرگز نباید تکرار شود. قاعدهی ساده یک شمارنده است: نانس جی سی ام(۰) برای پیام نخست، نانس جی سی ام(۱) برای بعدی، و شمارنده کنار رکورد نگه داشته میشود تا بعداً بتوان آن را گشود.
واردسازی تی ال اس
تابع ریشه:
کلید := "q1V0kA8mY8l3R9m0bJvT0F6c0w2f5yYQ1aZt3pK8sXo="
رکوردها := ["balance=120"، "balance=95"، "balance=310"]
ناپایا مهرشدهها := وکتور {} برگردان وکتور<رشته>
ناپایا موفق := نادرست
هر ش، رکورد در رکوردها:
مهرشدهها.بیفزا(تی ال اس.مهر ای ای اس جی سی ام(کلید، تی ال اس.نانس جی سی ام(ش برگردان صحیح۶۴)، رکورد، موفق))
پایان
سرچاپ "مهر شد"، مهرشدهها.طول()، "رکورد:"، موفق
سرچاپ "نخستین:"، مهرشدهها.بگیر(۰)
هر ش، مهرشده در مهرشدهها:
متن := تی ال اس.گشودن ای ای اس جی سی ام(کلید، تی ال اس.نانس جی سی ام(ش برگردان صحیح۶۴)، مهرشده، موفق)
سرچاپ "رکورد"، ش، "متن:"، متن، موفق
پایان
_ := تی ال اس.گشودن ای ای اس جی سی ام(کلید، تی ال اس.نانس جی سی ام(۱)، مهرشدهها.بگیر(۰)، موفق)
سرچاپ "گشوده با نانس نادرست:"، موفق
_ := تی ال اس.گشودن ای ای اس جی سی ام("AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="، تی ال اس.نانس جی سی ام(۰)، مهرشدهها.بگیر(۰)، موفق)
سرچاپ "گشوده با کلید نادرست:"، موفق
پایانبا کلید و نانس ثابت خروجی همیشه یکی است و برای همین برنامه میتواند آن را چاپ کند. خطر هم همینجاست: یک نانس برای دو متن متفاوت به مهاجم دربارهی هر دو اطلاعات میدهد؛ پس تا وقتی کلید عوض نشده شمارنده را از صفر شروع نکنید.
کلید مشترک از کلیدهای عمومی
دو برنامه که هرگز همدیگر را ندیدهاند میتوانند بی آنکه کلیدی بفرستند روی یک کلید توافق کنند. هر کدام با تولید کلید ای سی دی اچ یک جفت کلید ECDH میسازد و فقط کلید عمومیاش را برای دیگری میفرستد. سپس راز مشترک ای سی دی اچ به هر دو یک راز یکسان میدهد و اچ کی دی اف شا۲۵۶ از آن کلیدی برای AES-GCM میسازد. کسی که هر دو کلید عمومی را دیده باز هم نمیتواند راز را حساب کند. متن info میگوید کلید برای چه کاری است، تا از یک راز بتوان کلیدهای جدا برای کارهای جدا گرفت.
واردسازی تی ال اس
ساختار طرف:
همگانی کلید خصوصی: رشته = ""
همگانی کلید عمومی: رشته = ""
پایان
تابع طرف تازه(): طرف:
ناپایا ط := طرف {}
_ := تی ال اس.تولید کلید ای سی دی اچ(ط.کلید خصوصی، ط.کلید عمومی)
برگشت ط
پایان
تابع کلید نشست(من: طرف، عمومی دیگری: رشته، نمک: رشته): رشته:
ناپایا موفق := نادرست
مشترک := تی ال اس.راز مشترک ای سی دی اچ(من.کلید خصوصی، عمومی دیگری، موفق)
برگشت تی ال اس.اچ کی دی اف شا۲۵۶(مشترک، نمک، "notes app v1 session"، ۳۲، موفق)
پایان
تابع ریشه:
آرش := طرف تازه()
بهار := طرف تازه()
نمک := تی ال اس.نمک تصادفی(۱۶)
کلید آرش := کلید نشست(آرش، بهار.کلید عمومی، نمک)
کلید بهار := کلید نشست(بهار، آرش.کلید عمومی، نمک)
سرچاپ "هر دو طرف به یک کلید رسیدند:"، کلید آرش برابر کلید بهار
ناپایا موفق := نادرست
پیام := تی ال اس.مهر ای ای اس جی سی ام(کلید آرش، تی ال اس.نانس جی سی ام(۰)، "ساعت نه در ایستگاه"، موفق)
سرچاپ "آرش"، پیام.طول()، "نویسهی base64 فرستاد"
سرچاپ "بهار میخواند:"، تی ال اس.گشودن ای ای اس جی سی ام(کلید بهار، تی ال اس.نانس جی سی ام(۰)، پیام، موفق)
فضول := طرف تازه()
کلید فضول := کلید نشست(فضول، آرش.کلید عمومی، نمک)
_ := تی ال اس.گشودن ای ای اس جی سی ام(کلید فضول، تی ال اس.نانس جی سی ام(۰)، پیام، موفق)
سرچاپ "فضول، تنها با کلیدهای عمومی، میتواند بخواند:"، موفق
پایانECDH به تنهایی نمیگوید آن طرف کیست. در یک پروتکل واقعی کلید عمومی را امضا کنید یا با کلیدی که از پیش میشناسید مقایسه کنید، وگرنه کسی در میانه میتواند با هر طرف جداگانه کلید بسازد.
امضا و تایید با P-256
امضای پی۲۵۶ یک چکیدهی SHA-256 را با کلید خصوصی امضا میکند و هر کس نقطهی عمومی را داشته باشد با تایید امضای پی۲۵۶ آن را میسنجد. این برای فایل مجوز، فهرست بهروزرسانیها و پیامهایی مناسب است که یک نفر مینویسد و خوانندههای زیادی باید بسنجند. امضا طبق RFC 6979 است، یعنی یک کلید و یک چکیده همیشه یک امضا میدهند و هیچ عدد تصادفی در کار نیست.
واردسازی تی ال اس
واردسازی رمزنگاری
واردسازی کدگذاری
واردسازی حافظه
تابع چکیده(متن: رشته): رشته:
خروجی := حافظه.تخصیص(۳۲ برگردان طبیعی۶۴)
رمزنگاری.شا۲۵۶ بایت(متن برگردان تهی*، متن.طول()، خروجی)
نتیجه := کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۳۲)
حافظه.آزادسازی(خروجی)
برگشت نتیجه
پایان
تابع ریشه:
خصوصی فروشنده := "cqXpGz8zHwUzjEQonZMVMh4K9+jyX3zMfzeFP0025Rk="
عمومی فروشنده := تی ال اس.نقطه عمومی ای سی دی اچ(خصوصی فروشنده)
مجوز := "customer=Pars Co;seats=25;until=2027-12-31"
ناپایا موفق := نادرست
امضا := تی ال اس.امضای پی۲۵۶(خصوصی فروشنده، چکیده(مجوز)، موفق)
سرچاپ "امضا شد:"، موفق
سرچاپ "امضا:"، امضا
سرچاپ "مجوز اصلی:"، تی ال اس.تایید امضای پی۲۵۶(عمومی فروشنده، چکیده(مجوز)، امضا)
دستکاری شده := "customer=Pars Co;seats=250;until=2027-12-31"
سرچاپ "شمار کاربران دستکاری شده:"، تی ال اس.تایید امضای پی۲۵۶(عمومی فروشنده، چکیده(دستکاری شده)، امضا)
سرچاپ "امضای دوباره همان است:"، تی ال اس.امضای پی۲۵۶(خصوصی فروشنده، چکیده(مجوز)، موفق) برابر امضا
پایانکلید خصوصی در برنامه فقط برای این است که خروجی ثابت بماند. کلید واقعی را در کد ننویسید: از فایل یا متغیر محیطی بخوانید و فقط نقطهی عمومی را همراه برنامهای که میسنجد بفرستید.
کدام تابع برای کدام کار
| کار | تابع |
|---|---|
| کارخواه HTTPS یا هر TLS دیگر | پیکربندی جدید، اتصال امن، نوشتن، خواندن، بستن اتصال؛ برای درخواستهای معمولی وب، net.http این کار را برایتان میکند |
| سرور TLS | پیکربندی کارساز جدید، سپس پوشش کارساز روی هر سوکتی که پذیرفتهاید |
| امن کردن سوکتی که از پیش باز است (STARTTLS) | پوشش کارخواه |
| رمزگذاری دادهی ذخیره شده | مهر ای ای اس جی سی ام، گشودن ای ای اس جی سی ام، نانس جی سی ام |
| توافق روی کلید | تولید کلید ای سی دی اچ، راز مشترک ای سی دی اچ، اچ کی دی اف شا۲۵۶ |
| امضا و تایید | امضای پی۲۵۶، تایید امضای پی۲۵۶ |
| بررسی دستی گواهی | بارگذاری ریشه ها، تایید گواهی، خطای تایید |
گونهها
پیکربندی کارساز ServerConfig
ساختار پیکربندی کارساز| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| زنجیره | chain | Roots | زنجیرهی گواهی. |
| کلید | key | PrivateKey | کلید خصوصی. |
| سالم | ok | منطقی = نادرست | هر دو خوانده شدند. |
واردسازی تی ال اس
واردسازی شبکه.تی سی پی
واردسازی حافظه
تابع ریشه:
پ := تی ال اس.پیکربندی کارساز جدید("cert.pem"، "key.pem")
اگر وارونه پ.سالم:
سرچاپ "گواهی یا کلید خوانده نشد"
برگشت
پایان
س := تی سی پی.پیوند(۸۴۴۳)
تا درست:
ک := تی سی پی.پذیرش(س)
ناپایا ا := تی ال اس.پوشش کارساز(ک.توصیفگر، پ)
اگر تی ال اس.اتصال معتبر(ا):
اگر تی ال اس.خواندنی(ا) یا تی ال اس.در انتظار(ا) > ۰:
سرچاپ تی ال اس.خواندن(ا، ۱۰۲۴)
پایان
بافر := حافظه.تخصیص(۲۵۶ برگردان طبیعی۶۴)
تعداد := تی ال اس.خواندن بایت(ا، بافر، ۲۵۶)
_ := تی ال اس.نوشتن بایت(ا، بافر، تعداد)
تی ال اس.نگه داشتن نوشتن(ا)
_ := تی ال اس.نوشتن(ا، "HTTP/1.1 200 OK\r\nContent-Length: 5\r\n\r\nسلام")
_ := تی ال اس.فرستادن نوشته ها(ا)
حافظه.آزادسازی(بافر)
سرچاپ تی ال اس.توصیفگر(ا) >= ۰
پایان
تی ال اس.بستن اتصال(ا)
پایان
پایانپیکربندی Config
ساختار پیکربندی| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| نام کارساز | server_name | رشته = "" | نام میزبان برای SNI و بررسی گواهی. |
| پرونده گواهی ریشه | ca_file | رشته = "" | پروندهی گواهیهای ریشه؛ خالی یعنی ریشههای سیستم. |
| بدون بررسی گواهی | insecure_skip_verify | منطقی = نادرست | گواهی بررسی نشود؛ فقط برای آزمایش، چون اتصال را در برابر شنود بیدفاع میکند. |
| پروتکل برنامه | alpn | رشته = "" | پروتکل برای ALPN، مثل h2. |
| فقط ایایاس | aes_only | منطقی = نادرست | فقط رمزهای AES پیشنهاد شود. |
| تکه تکه کردن رکورد | frag_tls | منطقی = نادرست | نخستین پیام دستدهی (ClientHello) را به چند رکورد TLS میشکند تا واسطی که فقط رکورد اول را میخواند هرگز سلام کامل را نبیند. بهطور پیشفرض خاموش است. |
| تکه تکه کردن بسته | frag_tcp | منطقی = نادرست | نخستین دستهی داده را با چند نوشتن کوچک TCP میفرستد و میان آنها frag_delay_ms صبر میکند تا در یک بسته نرود. بهطور پیشفرض خاموش است. |
| برش نام سرور | frag_sni | منطقی = نادرست | یک برش در میانهی نام سرور میزند تا هیچ رکورد یا بستهای کل نام را نداشته باشد. همراه frag_tls یا frag_tcp به کار میرود. |
| کمینه اندازه تکه | frag_min | صحیح = 5 | کوچکترین قطعه به بایت هنگام تکهتکه کردن سلام. پیشفرض ۵ است. |
| بیشینه اندازه تکه | frag_max | صحیح = 20 | بزرگترین قطعه به بایت هنگام تکهتکه کردن سلام. پیشفرض ۲۰ است؛ برای هر قطعه اندازهای تصادفی میان frag_min و این مقدار برگزیده میشود. |
| تاخیر بین تکه ها | frag_delay_ms | صحیح = 0 | درنگ میان قطعههای TCP به میلیثانیه. پیشفرض ۰ است. |
| شمار نوشتن های تکه شده | frag_writes | صحیح = 1 | چند نوشتن نخست دستدهی تکهتکه شود. پیشفرض ۱ است که همان ClientHello است. |
واردسازی تی ال اس
تابع ریشه:
ناپایا پ := تی ال اس.پیکربندی جدید("example.com")
پ.پروتکل برنامه = "http/1.1"
ناپایا ا := تی ال اس.اتصال امن("example.com"، ۴۴۳، پ)
اگر وارونه تی ال اس.اتصال معتبر(ا):
سرچاپ "خطا:"، تی ال اس.خطای اتصال(ا)
برگشت
پایان
سرچاپ تی ال اس.نسخه(ا)، تی ال اس.نام رمز(ا)، تی ال اس.تعداد گواهی همتا(ا)
_ := تی ال اس.نوشتن(ا، "GET / HTTP/1.1\r\nHost: example.com\r\nConnection: close\r\n\r\n")
ناپایا پاسخ := ""
تا تی ال اس.اتصال معتبر(ا):
تکه := تی ال اس.خواندن(ا، ۴۰۹۶)
اگر تکه.طول() == ۰:
بشکن
پایان
پاسخ += تکه
پایان
سرچاپ پاسخ.طول() > ۰
تی ال اس.بستن اتصال(ا)
پایاناتصال Conn
ساختار اتصال| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| دستدهی | h | Handshake | وضعیت دستدهی. |
| میزبان | host | رشته = "" | میزبان. |
| باز | open | منطقی = نادرست | اتصال باز است. |
| ناامن | insecure | منطقی = نادرست | بدون بررسی گواهی. |
| داده معلق | pending | Buf | دادهی خواندهشدهای که هنوز برداشته نشده. |
| خطا | err | رشته = "" | پیام خطا. |
| پایان خواندن | rdone | منطقی = نادرست | وقتی طرف مقابل هشدار بستن خود را فرستاده درست میشود، یعنی دیگر دادهای نمیرسد. |
| پایان نوشتن | wdone | منطقی = نادرست | پس از آنکه CloseWrite هشدار بستن ما را فرستاد درست میشود، یعنی دیگر چیزی نباید نوشته شود. |
| خواندن مستقیم | direct | منطقی = نادرست | پس از SwitchDirect درست است: خواندنها از لایه رکورد میگذرند. |
نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
پایاها و متغیرها
ای ای دی ای ای اس۱۲۸ جی سی ام AEAD_AES_128_GCM
پایا ای ای دی ای ای اس۱۲۸ جی سی ام: صحیح۳۲ = 0AeadNew؛ کلید آن ۱۶ بایت است.// زبان: فارسی
واردسازی تی ال اس
واردسازی حافظه
پایا DIGITS := "0123456789abcdef"
تابع hex_of(ویژگی_محلی: تهی*، تعداد: صحیح): رشته:
ناپایا خروجی_مقدار := ""
تکرار تعداد در شمارنده:
بافر_محلی := (ویژگی_محلی برگردان طبیعی۸*)[شمارنده] برگردان صحیح
خروجی_مقدار += DIGITS.زیررشته(بافر_محلی / 16، 1) + DIGITS.زیررشته(بافر_محلی % 16، 1)
پایان
برگشت خروجی_مقدار
پایان
تابع filled(تعداد: صحیح، start: صحیح): تهی*:
ویژگی_محلی := حافظه.تخصیص صفرشده(تعداد برگردان طبیعی۶۴)
تکرار تعداد در شمارنده:
(ویژگی_محلی برگردان طبیعی۸*)[شمارنده] = ((start + شمارنده) % 256) برگردان طبیعی۸
پایان
برگشت ویژگی_محلی
پایان
تابع ریشه:
سرچاپ تی ال اس.ای ای دی ای ای اس۱۲۸ جی سی ام، تی ال اس.ای ای دی ای ای اس۲۵۶ جی سی ام، تی ال اس.ای ای دی چاچا۲۰ پلی۱۳۰۵
سرچاپ تی ال اس.طول برچسب ای ای دی، تی ال اس.طول نانس ای ای دی
سرچاپ تی ال اس.طول کلید ای ای دی(تی ال اس.ای ای دی ای ای اس۱۲۸ جی سی ام)، تی ال اس.طول کلید ای ای دی(تی ال اس.ای ای دی ای ای اس۲۵۶ جی سی ام)، تی ال اس.طول کلید ای ای دی(تی ال اس.ای ای دی چاچا۲۰ پلی۱۳۰۵)
کلید := filled(32، 0)
نانس := filled(12، 100)
پیام_متن := "attack at dawn"
تعداد := پیام_متن.طول()
خروجی_مقدار := حافظه.تخصیص صفرشده((تعداد + تی ال اس.طول برچسب ای ای دی) برگردان طبیعی۶۴)
بازگشت := حافظه.تخصیص صفرشده((تعداد + 1) برگردان طبیعی۶۴)
هر گونه در [تی ال اس.ای ای دی ای ای اس۱۲۸ جی سی ام، تی ال اس.ای ای دی ای ای اس۲۵۶ جی سی ام، تی ال اس.ای ای دی چاچا۲۰ پلی۱۳۰۵]:
زمینه := تی ال اس.ای ای دی جدید(گونه، کلید)
تی ال اس.مهر ای ای دی(زمینه، نانس، پوچ، 0، پیام_متن برگردان تهی*، تعداد، خروجی_مقدار)
سرچاپ گونه، hex_of(خروجی_مقدار، تعداد + تی ال اس.طول برچسب ای ای دی)
سرچاپ تی ال اس.گشودن ای ای دی(زمینه، نانس، پوچ، 0، خروجی_مقدار، تعداد، بازگشت)، (بازگشت برگردان رشته).زیررشته(0، تعداد)
(خروجی_مقدار برگردان طبیعی۸*)[0] = ((خروجی_مقدار برگردان طبیعی۸*)[0] برگردان صحیح ^ 1) برگردان طبیعی۸
سرچاپ تی ال اس.گشودن ای ای دی(زمینه، نانس، پوچ، 0، خروجی_مقدار، تعداد، بازگشت)
تی ال اس.آزادسازی ای ای دی(زمینه)
پایان
سرچاپ تی ال اس.مهر خام ای ای اس جی سی ام(کلید، 16، نانس، پوچ، 0، پیام_متن برگردان تهی*، تعداد، خروجی_مقدار)
سرچاپ hex_of(خروجی_مقدار، تعداد + تی ال اس.طول برچسب ای ای دی)
سرچاپ تی ال اس.گشودن خام ای ای اس جی سی ام(کلید، 16، نانس، پوچ، 0، خروجی_مقدار، تعداد + تی ال اس.طول برچسب ای ای دی، بازگشت)، (بازگشت برگردان رشته).زیررشته(0، تعداد)
سرچاپ تی ال اس.مهر خام چاچا۲۰ پلی۱۳۰۵(کلید، نانس، پوچ، 0، پیام_متن برگردان تهی*، تعداد، خروجی_مقدار)
سرچاپ hex_of(خروجی_مقدار، تعداد + تی ال اس.طول برچسب ای ای دی)
سرچاپ تی ال اس.گشودن خام چاچا۲۰ پلی۱۳۰۵(کلید، نانس، پوچ، 0، خروجی_مقدار، تعداد + تی ال اس.طول برچسب ای ای دی، بازگشت)، (بازگشت برگردان رشته).زیررشته(0، تعداد)
متغیر_nonce24 := filled(24، 100)
سرچاپ تی ال اس.مهر خام ایکس چاچا۲۰ پلی۱۳۰۵(کلید، متغیر_nonce24، پوچ، 0، پیام_متن برگردان تهی*، تعداد، خروجی_مقدار)
سرچاپ hex_of(خروجی_مقدار، تعداد + تی ال اس.طول برچسب ای ای دی)
سرچاپ تی ال اس.گشودن خام ایکس چاچا۲۰ پلی۱۳۰۵(کلید، متغیر_nonce24، پوچ، 0، خروجی_مقدار، تعداد + تی ال اس.طول برچسب ای ای دی، بازگشت)، (بازگشت برگردان رشته).زیررشته(0، تعداد)
ساده := حافظه.تخصیص صفرشده(16 برگردان طبیعی۶۴)
تکرار 16 در شمارنده:
(ساده برگردان طبیعی۸*)[شمارنده] = (شمارنده * 17) برگردان طبیعی۸
پایان
متغیر_cipher := حافظه.تخصیص صفرشده(16 برگردان طبیعی۶۴)
متغیر_key16 := filled(16، 0)
سرچاپ تی ال اس.بلوک ای ای اس ای سی بی(متغیر_key16، 16، ساده، متغیر_cipher، نادرست)، hex_of(متغیر_cipher، 16)
سرچاپ تی ال اس.بلوک ای ای اس ای سی بی(متغیر_key16، 16، متغیر_cipher، بازگشت، درست)، hex_of(بازگشت، 16) برابر hex_of(ساده، 16)
حافظه.آزادسازی(کلید)
حافظه.آزادسازی(نانس)
حافظه.آزادسازی(متغیر_nonce24)
حافظه.آزادسازی(خروجی_مقدار)
حافظه.آزادسازی(بازگشت)
حافظه.آزادسازی(ساده)
حافظه.آزادسازی(متغیر_cipher)
حافظه.آزادسازی(متغیر_key16)
پایانای ای دی ای ای اس۲۵۶ جی سی ام AEAD_AES_256_GCM
پایا ای ای دی ای ای اس۲۵۶ جی سی ام: صحیح۳۲ = 1AeadNew؛ کلید آن ۳۲ بایت است.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
ای ای دی چاچا۲۰ پلی۱۳۰۵ AEAD_CHACHA20_POLY1305
پایا ای ای دی چاچا۲۰ پلی۱۳۰۵: صحیح۳۲ = 2AeadNew؛ کلید آن ۳۲ بایت است.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
طول برچسب ای ای دی AEAD_TAG_LEN
پایا طول برچسب ای ای دی: صحیح۳۲ = 16نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
طول نانس ای ای دی AEAD_NONCE_LEN
پایا طول نانس ای ای دی: صحیح۳۲ = 12نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
تی ال اس۱۰ TLS10
پایا تی ال اس۱۰: صحیح۳۲ = 769واردسازی تی ال اس
واردسازی شبکه.تی سی پی
واردسازی کدگذاری
واردسازی ورودی خروجی
تابع ریشه:
ناپایا ریشهها := تی ال اس.بارگذاری ریشه ها("/etc/ssl/cert.pem")
سرچاپ تی ال اس.تعداد ریشه ها(ریشهها)
زنجیره := تی ال اس.بارگذاری فایل زنجیره گواهی("cert.pem")
سرچاپ تی ال اس.تعداد ریشه ها(زنجیره)
ناپایا کلید := تی ال اس.بارگذاری فایل کلید خصوصی("key.pem")
ناپایا کلید۲ := تی ال اس.تجزیه کلید خصوصی پم("-----BEGIN ...")
تی ال اس.آزادسازی کلید خصوصی(کلید۲)
گواهی := تی ال اس.کدگشایی شانزدهی("3082...")
سرچاپ تی ال اس.گواهی معتبر است(گواهی)، تی ال اس.نام مشترک گواهی(گواهی)
کد := تی ال اس.تایید گواهی(گواهی، ریشهها، "example.com")
سرچاپ کد، تی ال اس.خطای تایید(کد)
چکیده := تی ال اس.درهم ساز(نادرست، "پیام")
ناپایا امضا := تی ال اس.بافر جدید(۵۱۲)
سرچاپ تی ال اس.امضای آر اس ای پی کی سی اس یک(کلید، نادرست، چکیده، امضا)
سرچاپ تی ال اس.امضای آر اس ای پی اس اس(کلید، نادرست، چکیده، امضا)
سرچاپ تی ال اس.تایید آر اس ای پی اس اس با کلید(کلید، نادرست، چکیده، امضا)
ر := تی ال اس.بافر جدید(۳۲)
س := تی ال اس.بافر جدید(۳۲)
اگر تی ال اس.امضای بیضوی(کلید، چکیده، ر، س):
دیایآر := تی ال اس.کدگذاری دی ای آر بیضوی(ر، س، ۳۲)
سرچاپ تی ال اس.تایید دی ای آر بیضوی با کلید(کلید، چکیده، دیایآر)
پایان
پم := ورودی خروجی.خواندن پرونده("rsa-key.pem")
ناپایا سالم := نادرست
سرچاپ تی ال اس.طول کلید آر اس ای(پم)
سرچاپ تی ال اس.امضای آر اس ای شا۲۵۶(پم، کدگذاری.کدگذاری پایه۶۴("...")، سالم)
ناپایا پ := تی ال اس.پیکربندی جدید("internal.example")
پ.پرونده گواهی ریشه = "company-ca.pem"
پ.فقط ایایاس = درست
ناپایا ا := تی ال اس.اتصال امن("internal.example"، ۴۴۳، پ)
سرچاپ تی ال اس.اتصال معتبر(ا)
تی ال اس.بستن اتصال(ا)
ک := تی سی پی.شماره گیری("example.com"، ۴۴۳)
ناپایا ب := تی ال اس.پوشش کارخواه(ک.توصیفگر، تی ال اس.پیکربندی جدید("example.com"))
سرچاپ تی ال اس.نسخه(ب) == "TLS1.3"
تی ال اس.بستن اتصال(ب)
سرچاپ تی ال اس.تی ال اس۱۰، تی ال اس.تی ال اس۱۱، تی ال اس.تی ال اس۱۲، تی ال اس.تی ال اس۱۳
سرچاپ تی ال اس.خودآزمایی()
تی ال اس.آزادسازی ریشه ها(ریشهها)
تی ال اس.آزادسازی کلید خصوصی(کلید)
پایانتی ال اس۱۱ TLS11
پایا تی ال اس۱۱: صحیح۳۲ = 770نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
تی ال اس۱۲ TLS12
پایا تی ال اس۱۲: صحیح۳۲ = 771نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
تی ال اس۱۳ TLS13
پایا تی ال اس۱۳: صحیح۳۲ = 772نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
تابعها
کلید عمومی ام ال کم۷۶۸ Mlkem768PublicKey
تابع کلید عمومی ام ال کم۷۶۸(seed: تهی*، ek_out: تهی*)کپسوله سازی ام ال کم۷۶۸ Mlkem768Encapsulate
تابع کپسوله سازی ام ال کم۷۶۸(ek: تهی*، m: تهی*، ct_out: تهی*، ss_out: تهی*): منطقیبازگشایی ام ال کم۷۶۸ Mlkem768Decapsulate
تابع بازگشایی ام ال کم۷۶۸(seed: تهی*، ct: تهی*، ss_out: تهی*)طول کلید ای ای دی AeadKeyLen
تابع طول کلید ای ای دی(kind: صحیح): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
ای ای دی جدید AeadNew
تابع ای ای دی جدید(kind: صحیح، key: تهی*): تهی*AeadKeyLen بایت یک زمینهی رمز میسازد و برنامهی کلید AES را یک بار آماده میکند تا رکوردهای بسیار را سریع مهر کند. رمزهای AES وقتی پردازنده بگوید دستورها هست از آنها استفاده میکنند و این انتخاب همینجا، در همین فراخوانی، انجام میشود. برای شمارهی رمز ناشناخته تهی برمیگرداند. آن را با AeadFree رها کنید.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
آزادسازی ای ای دی AeadFree
تابع آزادسازی ای ای دی(ctx: تهی*)AeadNew ساخته آزاد میکند؛ تهی هم مجاز است.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
مهر ای ای دی AeadSeal
تابع مهر ای ای دی(ctx: تهی*، nonce: تهی*، aad: تهی*، aadlen: صحیح، pt: تهی*، n: صحیح، out: تهی*)n بایت از pt را در out رمز میکند و برچسب ۱۶ بایتی را درست پس از آن مینویسد، پس out به n به علاوهی AEAD_TAG_LEN بایت جا نیاز دارد. نانس ۱۲ بایت است و دادهی تأییدشدهی اضافی میتواند تهی با طول ۰ باشد. هرگز یک نانس را دو بار با یک کلید به کار نبرید.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
گشودن ای ای دی AeadOpen
تابع گشودن ای ای دی(ctx: تهی*، nonce: تهی*، aad: تهی*، aadlen: صحیح، ct: تهی*، n: صحیح، out: تهی*): منطقیn بایت ct میآید بررسی میکند و آن بایتها را در out رمزگشایی میکند. اگر چیزی تغییر کرده باشد نادرست برمیگرداند و آنگاه نباید از out استفاده کرد.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
پیکربندی جدید NewConfig
تابع پیکربندی جدید(server_name: رشته): پیکربندینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
اتصال امن Dial
تابع اتصال امن(host: رشته، port: صحیح، cfg: پیکربندی): اتصالنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
پوشش کارخواه WrapClient
تابع پوشش کارخواه(fd: صحیح۶۴، cfg: پیکربندی): اتصالنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
پیکربندی کارساز جدید NewServerConfig
تابع پیکربندی کارساز جدید(cert_file: رشته، key_file: رشته): پیکربندی کارسازنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
پوشش کارساز WrapServer
تابع پوشش کارساز(fd: صحیح۶۴، cfg: پیکربندی کارساز): اتصالنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
اتصال معتبر ConnOk
تابع اتصال معتبر(c: اتصال): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
خطای اتصال ConnError
تابع خطای اتصال(c: اتصال): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
نوشتن Write
تابع نوشتن(c &: اتصال، data: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
نوشتن بایت WriteBytes
تابع نوشتن بایت(c &: اتصال، ptr: تهی*، n: صحیح): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
نگه داشتن نوشتن Cork
تابع نگه داشتن نوشتن(c &: اتصال)نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
فرستادن نوشته ها Flush
تابع فرستادن نوشته ها(c &: اتصال): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
خواندن Read
تابع خواندن(c &: اتصال، max: صحیح): رشتهخواندن بایت را به کار ببرید.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
خواندن بایت ReadBytes
تابع خواندن بایت(c &: اتصال، buf: تهی*، max: صحیح): صحیحmax بایت در حافظهی دادهشده میخواند و تعدادشان را برمیگرداند؛ اگر اتصال بسته شده باشد ۰.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
تغییر به خواندن مستقیم SwitchDirect
تابع تغییر به خواندن مستقیم(c &: اتصال)در انتظار Pending
تابع در انتظار(c: اتصال): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
خواندنی Readable
تابع خواندنی(c: اتصال): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
توصیفگر Fd
تابع توصیفگر(c: اتصال): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam
بستن نوشتن CloseWrite
تابع بستن نوشتن(c &: اتصال)Close را صدا بزنید. اگر سمت نوشتن از پیش تمام شده باشد کاری نمیکند.// زبان: فارسی
واردسازی تی ال اس
واردسازی شبکه.تی سی پی
تابع ریشه:
پیکربندی := تی ال اس.پیکربندی کارساز جدید("cert.pem"، "key.pem")
اگر وارونه پیکربندی.سالم:
سرچاپ "the certificate or key could not be read"
برگشت
پایان
کارساز := تی سی پی.پیوند(8443)
سوکت := تی سی پی.پذیرش(کارساز)
ناپایا اتصال := تی ال اس.پوشش کارساز(سوکت.توصیفگر، پیکربندی)
اگر تی ال اس.اتصال معتبر(اتصال):
ناپایا درخواست := ""
تا درست:
بخش := تی ال اس.خواندن(اتصال، 1024)
اگر بخش.طول() برابر 0:
بشکن
پایان
درخواست += بخش
پایان
سرچاپ درخواست.طول()، اتصال.پایان خواندن
_ := تی ال اس.نوشتن(اتصال، "received " + درخواست.طول() + " bytes")
تی ال اس.بستن نوشتن(اتصال)
پایان
تی ال اس.بستن اتصال(اتصال)
تی سی پی.بستن سرور(کارساز)
پایانجداسازی اتصال Detach
تابع جداسازی اتصال(c &: اتصال)واردسازی تی ال اس
واردسازی شبکه.تی سی پی
تابع ریشه:
س := تی سی پی.شماره گیری("example.com"، ۴۴۳)
اگر وارونه تی سی پی.اتصال معتبر(س):
سرچاپ "اتصال برقرار نشد"
برگشت
پایان
ناپایا ا := تی ال اس.پوشش کارخواه(س.توصیفگر، تی ال اس.پیکربندی جدید("example.com"))
سرچاپ تی ال اس.اتصال معتبر(ا)
تی ال اس.جداسازی اتصال(ا)
تی سی پی.بستن(س)
پایانبستن اتصال Close
تابع بستن اتصال(c &: اتصال)نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
نسخه Version
تابع نسخه(c: اتصال): رشتهTLS1.3.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
نام رمز CipherName
تابع نام رمز(c: اتصال): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
تعداد گواهی همتا PeerCertCount
تابع تعداد گواهی همتا(c: اتصال): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam
آزادسازی کلید خصوصی FreePrivateKey
تابع آزادسازی کلید خصوصی(k &: PrivateKey)نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
تجزیه کلید خصوصی پم ParsePrivateKeyPEM
تابع تجزیه کلید خصوصی پم(pem: رشته): PrivateKeyنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
بارگذاری فایل کلید خصوصی LoadPrivateKeyFile
تابع بارگذاری فایل کلید خصوصی(path: رشته): PrivateKeyنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
بارگذاری فایل زنجیره گواهی LoadCertChainFile
تابع بارگذاری فایل زنجیره گواهی(path: رشته): Rootsنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
کلید عمومی ایدی۲۵۵۱۹ Ed25519PublicKey
تابع کلید عمومی ایدی۲۵۵۱۹(seed: تهی*، out: تهی*)امضای ایدی۲۵۵۱۹ Ed25519Sign
تابع امضای ایدی۲۵۵۱۹(seed: تهی*، msg: تهی*، n: صحیح، out: تهی*)بررسی امضای ایدی۲۵۵۱۹ Ed25519Verify
تابع بررسی امضای ایدی۲۵۵۱۹(pubk: تهی*، msg: تهی*، n: صحیح، sig: تهی*): منطقیکدگذاری شانزدهی HexEncodeBuf
تابع کدگذاری شانزدهی(b: Buf): رشتهواردسازی تی ال اس
واردسازی کدگذاری
تابع ریشه خطادار:
ناپایا خصوصی۱ := ""
ناپایا عمومی۱ := ""
ناپایا خصوصی۲ := ""
ناپایا عمومی۲ := ""
سرچاپ تی ال اس.تولید کلید ای سی دی اچ(خصوصی۱، عمومی۱)، تی ال اس.تولید کلید ای سی دی اچ(خصوصی۲، عمومی۲)
ناپایا سالم := نادرست
راز۱ := تی ال اس.راز مشترک ای سی دی اچ(خصوصی۱، عمومی۲، سالم)
راز۲ := تی ال اس.راز مشترک ای سی دی اچ(خصوصی۲، عمومی۱، سالم)
سرچاپ سالم، راز۱ == راز۲
نقطه۱ := تی ال اس.نقطه عمومی ای سی دی اچ(خصوصی۱)
نقطه۲ := تی ال اس.نقطه عمومی ای سی دی اچ(خصوصی۲)
سرچاپ تی ال اس.نقطه مشترک ای سی دی اچ(خصوصی۱، نقطه۲، سالم) == تی ال اس.نقطه مشترک ای سی دی اچ(خصوصی۲، نقطه۱، سالم)
نمک := تی ال اس.نمک تصادفی(۱۶)
کلید := تی ال اس.اچ کی دی اف شا۲۵۶(راز۱، نمک، "chat v1"، ۳۲، سالم)
سرچاپ سالم، کلید == تی ال اس.اچ کی دی اف شا۲۵۶(راز۲، نمک، "chat v1"، ۳۲، سالم)
سرچاپ تی ال اس.اچ کی دی اف شا۲۵۶ خام(راز۱، نمک، کدگذاری.کدگذاری پایه۶۴("chat v1")، ۳۲، سالم) == کلید
نانس := تی ال اس.نانس جی سی ام(۰)
مهرشده := تی ال اس.مهر ای ای اس جی سی ام(کلید، نانس، "سلام، این پیام رمز شده است"، سالم)
سرچاپ سالم
سرچاپ تی ال اس.گشودن ای ای اس جی سی ام(کلید، نانس، مهرشده، سالم)، سالم
_ := تی ال اس.گشودن ای ای اس جی سی ام(کلید، تی ال اس.نانس جی سی ام(۱)، مهرشده، سالم)
سرچاپ سالم
دودویی := تی ال اس.مهر بایت ای ای اس جی سی ام(کلید، نانس، کدگذاری.کدگذاری پایه۶۴("abc")، سالم)
سرچاپ تلاش کدگذاری.کدگشایی پایه۶۴(تی ال اس.گشودن بایت ای ای اس جی سی ام(کلید، نانس، دودویی، سالم))
چکیده := کدگذاری.کدگذاری پایه۶۴("0123456789abcdef0123456789abcdef")
امضا := تی ال اس.امضای پی۲۵۶(خصوصی۱، چکیده، سالم)
سرچاپ سالم، تی ال اس.تایید امضای پی۲۵۶(نقطه۱، چکیده، امضا)، تی ال اس.تایید امضای پی۲۵۶(نقطه۲، چکیده، امضا)
ب := تی ال اس.درهم ساز(نادرست، "abc")
سرچاپ تی ال اس.طول بافر(ب)، تی ال اس.کدگذاری شانزدهی(ب)
ناپایا ش := تی ال اس.کدگشایی شانزدهی("cafe")
تی ال اس.افزودن رشته به بافر(ش، "!")
سرچاپ تی ال اس.طول بافر(ش)، تی ال اس.کدگذاری شانزدهی(ش)
ناپایا ص := تی ال اس.بافر صفر جدید(۴)
سرچاپ تی ال اس.کدگذاری شانزدهی(ص)
ناپایا خالی := تی ال اس.بافر جدید(۶۴)
سرچاپ تی ال اس.طول بافر(خالی)
تی ال اس.پاک سازی بافر(ش)
تی ال اس.آزادسازی بافر(ش)
تی ال اس.آزادسازی بافر(ص)
تی ال اس.آزادسازی بافر(خالی)
پایانکدگشایی شانزدهی HexDecodeBuf
تابع کدگشایی شانزدهی(s: رشته): Bufنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
بافر جدید NewBuf
تابع بافر جدید(cap: صحیح): Bufنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
بافر صفر جدید NewZeroBuf
تابع بافر صفر جدید(n: صحیح): Bufنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
آزادسازی بافر FreeBuf
تابع آزادسازی بافر(b &: Buf)نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
پاک سازی بافر WipeBuf
تابع پاک سازی بافر(b &: Buf)نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
طول بافر BufLen
تابع طول بافر(b: Buf): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
افزودن رشته به بافر BufAppendStr
تابع افزودن رشته به بافر(b &: Buf، s: رشته)نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
بارگذاری ریشه ها LoadRoots
تابع بارگذاری ریشه ها(ca_file: رشته): Rootsنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
تعداد ریشه ها RootCount
تابع تعداد ریشه ها(r: Roots): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
آزادسازی ریشه ها FreeRoots
تابع آزادسازی ریشه ها(r &: Roots)نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
خطای تایید VerifyError
تابع خطای تایید(code: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
تایید گواهی VerifyCert
تابع تایید گواهی(der: Buf، roots: Roots، host: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
گواهی معتبر است CertIsValid
تابع گواهی معتبر است(der: Buf): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
نام مشترک گواهی CertSubjectCN
تابع نام مشترک گواهی(der: Buf): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
درهم ساز HashDigest
تابع درهم ساز(sha384: منطقی، msg: رشته): Bufنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
امضای آر اس ای پی کی سی اس یک SignRSAPKCS1
تابع امضای آر اس ای پی کی سی اس یک(k: PrivateKey، sha384: منطقی، digest: Buf، sigout &: Buf): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
امضای آر اس ای پی اس اس SignRSAPSS
تابع امضای آر اس ای پی اس اس(k: PrivateKey، sha384: منطقی، digest: Buf، sigout &: Buf): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
امضای بیضوی SignECDSA
تابع امضای بیضوی(k: PrivateKey، digest: Buf، rout: Buf، sout: Buf): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
کدگذاری دی ای آر بیضوی ECDSADerEncode
تابع کدگذاری دی ای آر بیضوی(rbytes: Buf، sbytes: Buf، width: صحیح): Bufنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
تایید آر اس ای پی اس اس با کلید VerifyRSAPSSWithKey
تابع تایید آر اس ای پی اس اس با کلید(k: PrivateKey، sha384: منطقی، digest: Buf، sig: Buf): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
تایید دی ای آر بیضوی با کلید VerifyECDSADERWithKey
تابع تایید دی ای آر بیضوی با کلید(k: PrivateKey، digest: Buf، dersig: Buf): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
مهر خام ای ای اس جی سی ام AesGcmSealRaw
تابع مهر خام ای ای اس جی سی ام(key: تهی*، keylen: صحیح، nonce: تهی*، aad: تهی*، aadlen: صحیح، pt: تهی*، n: صحیح، out: تهی*): منطقیn بایت رمزشده و برچسب ۱۶ بایتی را در out مینویسد. برای طول کلید نادرست نادرست برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
گشودن خام ای ای اس جی سی ام AesGcmOpenRaw
تابع گشودن خام ای ای اس جی سی ام(key: تهی*، keylen: صحیح، nonce: تهی*، aad: تهی*، aadlen: صحیح، sealed: تهی*، sealed_len: صحیح، out: تهی*): منطقیAesGcmSealRaw: sealed_len برچسب را هم میشمارد. برای طول کلید نادرست، دادهی کوتاه یا دادهی تغییریافته نادرست برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
مهر خام چاچا۲۰ پلی۱۳۰۵ ChaCha20Poly1305SealRaw
تابع مهر خام چاچا۲۰ پلی۱۳۰۵(key: تهی*، nonce: تهی*، aad: تهی*، aadlen: صحیح، pt: تهی*، n: صحیح، out: تهی*): منطقیn بایت رمزشده و برچسب ۱۶ بایتی را در out مینویسد.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
گشودن خام چاچا۲۰ پلی۱۳۰۵ ChaCha20Poly1305OpenRaw
تابع گشودن خام چاچا۲۰ پلی۱۳۰۵(key: تهی*، nonce: تهی*، aad: تهی*، aadlen: صحیح، sealed: تهی*، sealed_len: صحیح، out: تهی*): منطقیChaCha20Poly1305SealRaw: sealed_len برچسب را هم میشمارد. اگر داده کوتاه باشد یا تغییر کرده باشد نادرست برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
تولید کلید ای سی دی اچ EcdhP256Generate
تابع تولید کلید ای سی دی اچ(priv &: رشته، pub_spki &: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
راز مشترک ای سی دی اچ EcdhP256Shared
تابع راز مشترک ای سی دی اچ(priv_b64: رشته، peer_spki_b64: رشته، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
اچ کی دی اف شا۲۵۶ HkdfSha256
تابع اچ کی دی اف شا۲۵۶(ikm_b64: رشته، salt_b64: رشته، info: رشته، out_len: صحیح، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
مهر ای ای اس جی سی ام AesGcmSeal
تابع مهر ای ای اس جی سی ام(key_b64: رشته، nonce_b64: رشته، plaintext: رشته، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
گشودن ای ای اس جی سی ام AesGcmOpen
تابع گشودن ای ای اس جی سی ام(key_b64: رشته، nonce_b64: رشته، sealed_b64: رشته، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
نانس جی سی ام GcmNonce
تابع نانس جی سی ام(counter: صحیح۶۴): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
نمک تصادفی RandomSalt
تابع نمک تصادفی(n: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
نقطه عمومی ای سی دی اچ EcdhP256PublicPoint
تابع نقطه عمومی ای سی دی اچ(priv_b64: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
نقطه مشترک ای سی دی اچ EcdhP256SharedPoint
تابع نقطه مشترک ای سی دی اچ(priv_b64: رشته، peer_point_b64: رشته، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
اچ کی دی اف شا۲۵۶ خام HkdfSha256Raw
تابع اچ کی دی اف شا۲۵۶ خام(ikm_b64: رشته، salt_b64: رشته، info_b64: رشته، out_len: صحیح، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
مهر بایت ای ای اس جی سی ام AesGcmSealBytes
تابع مهر بایت ای ای اس جی سی ام(key_b64: رشته، nonce_b64: رشته، plaintext_b64: رشته، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
گشودن بایت ای ای اس جی سی ام AesGcmOpenBytes
تابع گشودن بایت ای ای اس جی سی ام(key_b64: رشته، nonce_b64: رشته، sealed_b64: رشته، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
امضای پی۲۵۶ P256Sign
تابع امضای پی۲۵۶(priv_b64: رشته، digest_b64: رشته، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
تایید امضای پی۲۵۶ P256Verify
تابع تایید امضای پی۲۵۶(pub_point_b64: رشته، digest_b64: رشته، sig_b64: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam
امضای آر اس ای شا۲۵۶ RsaSignPkcs1Sha256
تابع امضای آر اس ای شا۲۵۶(pem: رشته، digest_b64: رشته، ok &: منطقی): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
طول کلید آر اس ای RsaKeyBits
تابع طول کلید آر اس ای(pem: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
رمزگذاری آر اس ای اوئپ RsaEncryptOaepSha1
تابع رمزگذاری آر اس ای اوئپ(pem: رشته، plain_b64: رشته، ok &: منطقی): رشتهواردسازی تی ال اس
واردسازی کدگذاری
واردسازی ورودی خروجی
تابع ریشه:
کلید := ورودی خروجی.خواندن پرونده("public.pem")
ناپایا موفق := نادرست
رمز := تی ال اس.رمزگذاری آر اس ای اوئپ(کلید، کدگذاری.کدگذاری پایه۶۴("سلام")، موفق)
اگر وارونه موفق:
سرچاپ "کلید عمومی RSA خوانده نشد"
برگشت
پایان
سرچاپ رمز.طول() > ۰
پایانمهر خام ایکس چاچا۲۰ پلی۱۳۰۵ XChaCha20Poly1305SealRaw
تابع مهر خام ایکس چاچا۲۰ پلی۱۳۰۵(key: تهی*، nonce24: تهی*، aad: تهی*، aadlen: صحیح، pt: تهی*، n: صحیح، out: تهی*): منطقیn بایت رمزشده و برچسب ۱۶ بایتی را در out مینویسد.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
گشودن خام ایکس چاچا۲۰ پلی۱۳۰۵ XChaCha20Poly1305OpenRaw
تابع گشودن خام ایکس چاچا۲۰ پلی۱۳۰۵(key: تهی*، nonce24: تهی*، aad: تهی*، aadlen: صحیح، sealed: تهی*، sealed_len: صحیح، out: تهی*): منطقیXChaCha20Poly1305SealRaw: sealed_len برچسب را هم میشمارد. اگر داده کوتاه باشد یا تغییر کرده باشد نادرست برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
بلوک ای ای اس ای سی بی AesEcbBlock
تابع بلوک ای ای اس ای سی بی(key: تهی*، keylen: صحیح، inp: تهی*، out: تهی*، decrypt: منطقی): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam
خودآزمایی SelfTest
تابع خودآزمایی(): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam
پوشش کارخواه با سلام خام WrapClientRaw
تابع پوشش کارخواه با سلام خام(fd: صحیح۶۴، hello: تهی*، hlen: صحیح، xpriv: تهی*، auth: تهی*، authlen: صحیح، cfg: پیکربندی): اتصالnet.utls میکند. کلید خصوصی ایکس۲۵۵۱۹ سهم کلید پیام را میخواهد. کلید احراز غیرخالی بررسی گواهی را به قاعدهی ریالیتی که net.reality به کار میبرد تغییر میدهد. با HelloRetryRequest شکست میخورد.پوشش کارخواه خام پسا کوانتومی WrapClientRawPq
تابع پوشش کارخواه خام پسا کوانتومی(fd: صحیح۶۴، hello: تهی*، hlen: صحیح، xpriv: تهی*، pq_seed: تهی*، auth: تهی*، authlen: صحیح، cfg: پیکربندی): اتصالکلید عمومی ایکس۲۵۵۱۹ X25519Public
تابع کلید عمومی ایکس۲۵۵۱۹(priv: تهی*، out: تهی*)راز مشترک ایکس۲۵۵۱۹ X25519Shared
تابع راز مشترک ایکس۲۵۵۱۹(priv: تهی*، peer: تهی*، out: تهی*): منطقیاشتقاق اچ کی دی اف HkdfSha256Derive
تابع اشتقاق اچ کی دی اف(ikm: تهی*، ikmlen: صحیح، salt: تهی*، saltlen: صحیح، info: رشته، out: تهی*، outlen: صحیح): منطقیاچ مک شا۵۱۲ خام HmacSha512Raw
تابع اچ مک شا۵۱۲ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)پوشش کارساز با سلام خام WrapServerRaw
تابع پوشش کارساز با سلام خام(fd: صحیح۶۴، ch: تهی*، chlen: صحیح، cert: تهی*، certlen: صحیح، seed: تهی*): اتصالnet.reality میکند.