کتابخانه‌ی استاندارد · امنیت و رمزنگاری

تی ال اس 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 عمدا خراب نگه داشته امتحان می‌کند.

tls-https-check.salam
واردسازی تی ال اس

تابع آزمودن(میزبان: رشته):
    پیکربندی := تی ال اس.پیکربندی جدید(میزبان)
    ناپایا اتصال := تی ال اس.اتصال امن(میزبان، ۴۴۳، پیکربندی)
    اگر وارونه تی ال اس.اتصال معتبر(اتصال):
        سرچاپ میزبان، "رد شد:"، تی ال اس.خطای اتصال(اتصال)
        برگشت
    پایان
    سرچاپ میزبان، تی ال اس.نسخه(اتصال)، تی ال اس.نام رمز(اتصال)، تی ال اس.تعداد گواهی همتا(اتصال)، "گواهی"
    تی ال اس.بستن اتصال(اتصال)
پایان

تابع ریشه:
    آزمودن("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 است؛ یک بار با نمک تصادفی(۳۲) بسازید و پنهان نگهش دارید. نانس زیر یک کلید هرگز نباید تکرار شود. قاعده‌ی ساده یک شمارنده است: نانس جی سی ام(۰) برای پیام نخست، نانس جی سی ام(۱) برای بعدی، و شمارنده کنار رکورد نگه داشته می‌شود تا بعداً بتوان آن را گشود.

tls-sealed-records.salam
واردسازی تی ال اس

تابع ریشه:
    کلید := "q1V0kA8mY8l3R9m0bJvT0F6c0w2f5yYQ1aZt3pK8sXo="
    رکوردها := ["balance=120"، "balance=95"، "balance=310"]

    ناپایا مهرشده‌ها := وکتور {} برگردان وکتور<رشته>
    ناپایا موفق := نادرست
    هر ش، رکورد در رکوردها:
        مهرشده‌ها.بیفزا(تی ال اس.مهر ای ای اس جی سی ام(کلید، تی ال اس.نانس جی سی ام(ش برگردان صحیح۶۴)، رکورد، موفق))
    پایان
    سرچاپ "مهر شد"، مهرشده‌ها.طول()، "رکورد:"، موفق
    سرچاپ "نخستین:"، مهرشده‌ها.بگیر(۰)

    هر ش، مهرشده در مهرشده‌ها:
        متن := تی ال اس.گشودن ای ای اس جی سی ام(کلید، تی ال اس.نانس جی سی ام(ش برگردان صحیح۶۴)، مهرشده، موفق)
        سرچاپ "رکورد"، ش، "متن:"، متن، موفق
    پایان

    _ := تی ال اس.گشودن ای ای اس جی سی ام(کلید، تی ال اس.نانس جی سی ام(۱)، مهرشده‌ها.بگیر(۰)، موفق)
    سرچاپ "گشوده با نانس نادرست:"، موفق
    _ := تی ال اس.گشودن ای ای اس جی سی ام("AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="، تی ال اس.نانس جی سی ام(۰)، مهرشده‌ها.بگیر(۰)، موفق)
    سرچاپ "گشوده با کلید نادرست:"، موفق
پایان
خروجیمهر شد 3 رکورد: true نخستین: q/F2IqBhzaLO/CFJROFcuA2GEUtg3H4MyDU5 رکورد 0 متن: balance=120 true رکورد 1 متن: balance=95 true رکورد 2 متن: balance=310 true گشوده با نانس نادرست: false گشوده با کلید نادرست: false

با کلید و نانس ثابت خروجی همیشه یکی است و برای همین برنامه می‌تواند آن را چاپ کند. خطر هم همین‌جاست: یک نانس برای دو متن متفاوت به مهاجم درباره‌ی هر دو اطلاعات می‌دهد؛ پس تا وقتی کلید عوض نشده شمارنده را از صفر شروع نکنید.

کلید مشترک از کلیدهای عمومی

دو برنامه که هرگز همدیگر را ندیده‌اند می‌توانند بی آن‌که کلیدی بفرستند روی یک کلید توافق کنند. هر کدام با تولید کلید ای سی دی اچ یک جفت کلید ECDH می‌سازد و فقط کلید عمومی‌اش را برای دیگری می‌فرستد. سپس راز مشترک ای سی دی اچ به هر دو یک راز یکسان می‌دهد و اچ کی دی اف شا۲۵۶ از آن کلیدی برای AES-GCM می‌سازد. کسی که هر دو کلید عمومی را دیده باز هم نمی‌تواند راز را حساب کند. متن info می‌گوید کلید برای چه کاری است، تا از یک راز بتوان کلیدهای جدا برای کارهای جدا گرفت.

tls-secure-channel.salam
واردسازی تی ال اس

ساختار طرف:
    همگانی کلید خصوصی: رشته = ""
    همگانی کلید عمومی: رشته = ""
پایان

تابع طرف تازه(): طرف:
    ناپایا ط := طرف {}
    _ := تی ال اس.تولید کلید ای سی دی اچ(ط.کلید خصوصی، ط.کلید عمومی)
    برگشت ط
پایان

تابع کلید نشست(من: طرف، عمومی دیگری: رشته، نمک: رشته): رشته:
    ناپایا موفق := نادرست
    مشترک := تی ال اس.راز مشترک ای سی دی اچ(من.کلید خصوصی، عمومی دیگری، موفق)
    برگشت تی ال اس.اچ کی دی اف شا۲۵۶(مشترک، نمک، "notes app v1 session"، ۳۲، موفق)
پایان

تابع ریشه:
    آرش := طرف تازه()
    بهار := طرف تازه()
    نمک := تی ال اس.نمک تصادفی(۱۶)

    کلید آرش := کلید نشست(آرش، بهار.کلید عمومی، نمک)
    کلید بهار := کلید نشست(بهار، آرش.کلید عمومی، نمک)
    سرچاپ "هر دو طرف به یک کلید رسیدند:"، کلید آرش برابر کلید بهار

    ناپایا موفق := نادرست
    پیام := تی ال اس.مهر ای ای اس جی سی ام(کلید آرش، تی ال اس.نانس جی سی ام(۰)، "ساعت نه در ایستگاه"، موفق)
    سرچاپ "آرش"، پیام.طول()، "نویسه‌ی base64 فرستاد"
    سرچاپ "بهار می‌خواند:"، تی ال اس.گشودن ای ای اس جی سی ام(کلید بهار، تی ال اس.نانس جی سی ام(۰)، پیام، موفق)

    فضول := طرف تازه()
    کلید فضول := کلید نشست(فضول، آرش.کلید عمومی، نمک)
    _ := تی ال اس.گشودن ای ای اس جی سی ام(کلید فضول، تی ال اس.نانس جی سی ام(۰)، پیام، موفق)
    سرچاپ "فضول، تنها با کلیدهای عمومی، می‌تواند بخواند:"، موفق
پایان
خروجیهر دو طرف به یک کلید رسیدند: true آرش 68 نویسه‌ی base64 فرستاد بهار می‌خواند: ساعت نه در ایستگاه فضول، تنها با کلیدهای عمومی، می‌تواند بخواند: false

ECDH به تنهایی نمی‌گوید آن طرف کیست. در یک پروتکل واقعی کلید عمومی را امضا کنید یا با کلیدی که از پیش می‌شناسید مقایسه کنید، وگرنه کسی در میانه می‌تواند با هر طرف جداگانه کلید بسازد.

امضا و تایید با P-256

امضای پی۲۵۶ یک چکیده‌ی SHA-256 را با کلید خصوصی امضا می‌کند و هر کس نقطه‌ی عمومی را داشته باشد با تایید امضای پی۲۵۶ آن را می‌سنجد. این برای فایل مجوز، فهرست به‌روزرسانی‌ها و پیام‌هایی مناسب است که یک نفر می‌نویسد و خواننده‌های زیادی باید بسنجند. امضا طبق RFC 6979 است، یعنی یک کلید و یک چکیده همیشه یک امضا می‌دهند و هیچ عدد تصادفی در کار نیست.

tls-signed-license.salam
واردسازی تی ال اس
واردسازی رمزنگاری
واردسازی کدگذاری
واردسازی حافظه

تابع چکیده(متن: رشته): رشته:
    خروجی := حافظه.تخصیص(۳۲ برگردان طبیعی۶۴)
    رمزنگاری.شا۲۵۶ بایت(متن برگردان تهی*، متن.طول()، خروجی)
    نتیجه := کدگذاری.کدگذاری بایت‌ها پایه۶۴(خروجی، ۳۲)
    حافظه.آزادسازی(خروجی)
    برگشت نتیجه
پایان

تابع ریشه:
    خصوصی فروشنده := "cqXpGz8zHwUzjEQonZMVMh4K9+jyX3zMfzeFP0025Rk="
    عمومی فروشنده := تی ال اس.نقطه عمومی ای سی دی اچ(خصوصی فروشنده)

    مجوز := "customer=Pars Co;seats=25;until=2027-12-31"
    ناپایا موفق := نادرست
    امضا := تی ال اس.امضای پی۲۵۶(خصوصی فروشنده، چکیده(مجوز)، موفق)
    سرچاپ "امضا شد:"، موفق
    سرچاپ "امضا:"، امضا

    سرچاپ "مجوز اصلی:"، تی ال اس.تایید امضای پی۲۵۶(عمومی فروشنده، چکیده(مجوز)، امضا)
    دستکاری شده := "customer=Pars Co;seats=250;until=2027-12-31"
    سرچاپ "شمار کاربران دستکاری شده:"، تی ال اس.تایید امضای پی۲۵۶(عمومی فروشنده، چکیده(دستکاری شده)، امضا)
    سرچاپ "امضای دوباره همان است:"، تی ال اس.امضای پی۲۵۶(خصوصی فروشنده، چکیده(مجوز)، موفق) برابر امضا
پایان
خروجیامضا شد: true امضا: Z9NSfoPJN31QJ2ELmSVzzziGYOZrA/+elf2AUQXUjx4uBr0U+Pyx7HxCt/gsuGacDKrD0KcJ6g1KkSOOjI1Hlg== مجوز اصلی: true شمار کاربران دستکاری شده: false امضای دوباره همان است: true

کلید خصوصی در برنامه فقط برای این است که خروجی ثابت بماند. کلید واقعی را در کد ننویسید: از فایل یا متغیر محیطی بخوانید و فقط نقطه‌ی عمومی را همراه برنامه‌ای که می‌سنجد بفرستید.

کدام تابع برای کدام کار

کارتابع
کارخواه HTTPS یا هر TLS دیگرپیکربندی جدید، اتصال امن، نوشتن، خواندن، بستن اتصال؛ برای درخواست‌های معمولی وب، net.http این کار را برایتان می‌کند
سرور TLSپیکربندی کارساز جدید، سپس پوشش کارساز روی هر سوکتی که پذیرفته‌اید
امن کردن سوکتی که از پیش باز است (STARTTLS)پوشش کارخواه
رمزگذاری داده‌ی ذخیره شدهمهر ای ای اس جی سی ام، گشودن ای ای اس جی سی ام، نانس جی سی ام
توافق روی کلیدتولید کلید ای سی دی اچ، راز مشترک ای سی دی اچ، اچ کی دی اف شا۲۵۶
امضا و تاییدامضای پی۲۵۶، تایید امضای پی۲۵۶
بررسی دستی گواهیبارگذاری ریشه ها، تایید گواهی، خطای تایید

گونه‌ها

پیکربندی کارساز ServerConfig

ساختار پیکربندی کارساز
پیکربندی سرور: زنجیره‌ی گواهی و کلید خصوصی.
نامانگلیسیگونهتوضیح
زنجیرهchainRootsزنجیره‌ی گواهی.
کلیدkeyPrivateKeyکلید خصوصی.
سالمokمنطقی = نادرستهر دو خوانده شدند.
tls-Server.salam
واردسازی تی ال اس
واردسازی شبکه.تی سی پی
واردسازی حافظه

تابع ریشه:
    پ := تی ال اس.پیکربندی کارساز جدید("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 است.
tls-Client.salam
واردسازی تی ال اس

تابع ریشه:
    ناپایا پ := تی ال اس.پیکربندی جدید("example.com")
    پ.پروتکل برنامه = "http/1.1"
    ناپایا ا := تی ال اس.اتصال امن("example.com"، ۴۴۳، پ)
    اگر وارونه تی ال اس.اتصال معتبر(ا):
        سرچاپ "خطا:"، تی ال اس.خطای اتصال(ا)
        برگشت
    پایان
    سرچاپ تی ال اس.نسخه(ا)، تی ال اس.نام رمز(ا)، تی ال اس.تعداد گواهی همتا(ا)
    _ := تی ال اس.نوشتن(ا، "GET / HTTP/1.1\r\nHost: example.com\r\nConnection: close\r\n\r\n")
    ناپایا پاسخ := ""
    تا تی ال اس.اتصال معتبر(ا):
        تکه := تی ال اس.خواندن(ا، ۴۰۹۶)
        اگر تکه.طول() == ۰:
            بشکن
        پایان
        پاسخ += تکه
    پایان
    سرچاپ پاسخ.طول() > ۰
    تی ال اس.بستن اتصال(ا)
پایان

اتصال Conn

ساختار اتصال
یک اتصال TLS.
نامانگلیسیگونهتوضیح
دست‌دهیhHandshakeوضعیت دست‌دهی.
میزبانhostرشته = ""میزبان.
بازopenمنطقی = نادرستاتصال باز است.
ناامنinsecureمنطقی = نادرستبدون بررسی گواهی.
داده معلقpendingBufداده‌ی خوانده‌شده‌ای که هنوز برداشته نشده.
خطاerrرشته = ""پیام خطا.
پایان خواندنrdoneمنطقی = نادرستوقتی طرف مقابل هشدار بستن خود را فرستاده درست می‌شود، یعنی دیگر داده‌ای نمی‌رسد.
پایان نوشتنwdoneمنطقی = نادرستپس از آنکه CloseWrite هشدار بستن ما را فرستاد درست می‌شود، یعنی دیگر چیزی نباید نوشته شود.
خواندن مستقیمdirectمنطقی = نادرستپس از SwitchDirect درست است: خواندن‌ها از لایه رکورد می‌گذرند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam

پایاها و متغیرها

ای ای دی ای ای اس۱۲۸ جی سی ام AEAD_AES_128_GCM

پایا ای ای دی ای ای اس۱۲۸ جی سی ام: صحیح۳۲ = 0
شماره‌ی رمز AES-128-GCM برای AeadNew؛ کلید آن ۱۶ بایت است.
tls-Aead.salam
// زبان: فارسی
واردسازی تی ال اس
واردسازی حافظه

پایا 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)
پایان
خروجی0 1 2 16 12 16 32 32 0 7b163ac4b869989bef1e3371f1a41dc78d25d87c287515a3bf23f863acc9 true attack at dawn false 1 296faa071a8276ff4a423b89ad0b5537a90cc7db07314a46d350158ee5c0 true attack at dawn false 2 5565cfabfbce56338ffe711e85e78bbd1978d881377eec1a128409ee14bd true attack at dawn false true 7b163ac4b869989bef1e3371f1a41dc78d25d87c287515a3bf23f863acc9 true attack at dawn true 5565cfabfbce56338ffe711e85e78bbd1978d881377eec1a128409ee14bd true attack at dawn true 1d078dd19c45a9e3f310f95ed1019b35c7694970811df3af39456b18b9ba true attack at dawn true 69c4e0d86a7b0430d8cdb78070b4c55a true true

ای ای دی ای ای اس۲۵۶ جی سی ام AEAD_AES_256_GCM

پایا ای ای دی ای ای اس۲۵۶ جی سی ام: صحیح۳۲ = 1
شماره‌ی رمز AES-256-GCM برای AeadNew؛ کلید آن ۳۲ بایت است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam

ای ای دی چاچا۲۰ پلی۱۳۰۵ AEAD_CHACHA20_POLY1305

پایا ای ای دی چاچا۲۰ پلی۱۳۰۵: صحیح۳۲ = 2
شماره‌ی رمز ChaCha20-Poly1305 برای AeadNew؛ کلید آن ۳۲ بایت است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam

طول برچسب ای ای دی AEAD_TAG_LEN

پایا طول برچسب ای ای دی: صحیح۳۲ = 16
طول برچسب تأیید که مهر کردن بعد از بایت‌های رمزشده می‌افزاید: ۱۶.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam

طول نانس ای ای دی AEAD_NONCE_LEN

پایا طول نانس ای ای دی: صحیح۳۲ = 12
طول نانس این رمزها به بایت: ۱۲.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam

تی ال اس۱۰ TLS10

پایا تی ال اس۱۰: صحیح۳۲ = 769
شماره‌ی نسخه‌ی TLS 1.0؛ پشتیبانی نمی‌شود.
tls-Certs.salam
واردسازی تی ال اس
واردسازی شبکه.تی سی پی
واردسازی کدگذاری
واردسازی ورودی خروجی

تابع ریشه:
    ناپایا ریشه‌ها := تی ال اس.بارگذاری ریشه ها("/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 1.1؛ پشتیبانی نمی‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

تی ال اس۱۲ TLS12

پایا تی ال اس۱۲: صحیح۳۲ = 771
TLS 1.2.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

تی ال اس۱۳ TLS13

پایا تی ال اس۱۳: صحیح۳۲ = 772
TLS 1.3.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

تابع‌ها

کلید عمومی ام ال کم۷۶۸ Mlkem768PublicKey

تابع کلید عمومی ام ال کم۷۶۸(seed: تهی*، ek_out: تهی*)
کلید کپسوله‌سازی ۱۱۸۴ بایتی ML-KEM-768 را از یک بذر ۶۴ بایتی (همان d و z در FIPS 203) می‌سازد.

کپسوله سازی ام ال کم۷۶۸ Mlkem768Encapsulate

تابع کپسوله سازی ام ال کم۷۶۸(ek: تهی*، m: تهی*، ct_out: تهی*، ss_out: تهی*): منطقی
با یک پیام ۳۲ بایتی به یک کلید ML-KEM-768 کپسوله می‌کند و رمزنوشته ۱۰۸۸ بایتی و کلید مشترک ۳۲ بایتی را می‌نویسد. اگر کلید نادرست باشد نادرست برمی‌گرداند. در کار واقعی بایت‌های تصادفی را به‌عنوان پیام بدهید.

بازگشایی ام ال کم۷۶۸ Mlkem768Decapsulate

تابع بازگشایی ام ال کم۷۶۸(seed: تهی*، ct: تهی*، ss_out: تهی*)
رمزنوشته ۱۰۸۸ بایتی را با کلید برآمده از یک بذر ۶۴ بایتی بازمی‌گشاید و کلید مشترک ۳۲ بایتی را می‌نویسد. رمزنوشته خراب همان کلید رد ضمنی را می‌دهد که FIPS 203 می‌خواهد.

طول کلید ای ای دی AeadKeyLen

تابع طول کلید ای ای دی(kind: صحیح): صحیح
طول کلید یک شماره‌ی رمز به بایت: ۱۶ برای AES-128-GCM و ۳۲ برای بقیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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 1.3 یا 1.2 را انجام می‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam

پوشش کارخواه WrapClient

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

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

پیکربندی کارساز جدید NewServerConfig

تابع پیکربندی کارساز جدید(cert_file: رشته، key_file: رشته): پیکربندی کارساز
گواهی و کلید سرور را از پرونده‌های PEM می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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 &: اتصال)
رکوردهای نوشته‌شده را تا Flush نگه می‌دارد تا پاسخی که چند نوشتن دارد یکجا فرستاده شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam

فرستادن نوشته ها Flush

تابع فرستادن نوشته ها(c &: اتصال): منطقی
رکوردهایی را که Cork نگه داشته می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam

خواندن Read

تابع خواندن(c &: اتصال، max: صحیح): رشته
تا این قدر بایت را به شکل رشته می‌خواند؛ رشته‌ی خالی یعنی اتصال بسته شد یا مهلت تمام شد. متن در بایت صفر تمام می‌شود، پس برای داده‌ی دودویی خواندن بایت را به کار ببرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Client.salam

خواندن بایت ReadBytes

تابع خواندن بایت(c &: اتصال، buf: تهی*، max: صحیح): صحیح
تا max بایت در حافظه‌ی داده‌شده می‌خواند و تعدادشان را برمی‌گرداند؛ اگر اتصال بسته شده باشد ۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam

تغییر به خواندن مستقیم SwitchDirect

تابع تغییر به خواندن مستقیم(c &: اتصال)
خواندن‌های بعدی را مستقیم از سوکت می‌کند، برای لحظه‌ای که همتایی با XTLS Vision فرمان مستقیم را می‌فرستد. بایت‌هایی که از پیش خوانده شده‌اند اول داده می‌شوند.

در انتظار Pending

تابع در انتظار(c: اتصال): صحیح
بایت‌هایی که رمزگشایی شده و آماده‌ی خواندن‌اند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam

خواندنی Readable

تابع خواندنی(c: اتصال): منطقی
بی‌انتظار چیزی برای خواندن هست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam

توصیفگر Fd

تابع توصیفگر(c: اتصال): صحیح۶۴
توصیف‌گر سوکت زیرین.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Server.salam

بستن نوشتن CloseWrite

تابع بستن نوشتن(c &: اتصال)
بستن نیم‌طرفه: هشدار بستن را می‌فرستد و سمت ارسال سوکت را می‌بندد، اما سمت دریافت باز می‌ماند؛ پس طرف مقابل پایان داده‌های شما را می‌بیند و باز هم می‌تواند پاسخ بدهد. پس از آن Close را صدا بزنید. اگر سمت نوشتن از پیش تمام شده باشد کاری نمی‌کند.
tls-CloseWrite.salam
// زبان: فارسی
واردسازی تی ال اس
واردسازی شبکه.تی سی پی

تابع ریشه:
    پیکربندی := تی ال اس.پیکربندی کارساز جدید("cert.pem"، "key.pem")
    اگر وارونه پیکربندی.سالم:
        سرچاپ "the certificate or key could not be read"
        برگشت
    پایان
    کارساز := تی سی پی.پیوند(8443)
    سوکت := تی سی پی.پذیرش(کارساز)
    ناپایا اتصال := تی ال اس.پوشش کارساز(سوکت.توصیفگر، پیکربندی)
    اگر تی ال اس.اتصال معتبر(اتصال):
        ناپایا درخواست := ""
        تا درست:
            بخش := تی ال اس.خواندن(اتصال، 1024)
            اگر بخش.طول() برابر 0:
                بشکن
            پایان
            درخواست += بخش
        پایان
        سرچاپ درخواست.طول()، اتصال.پایان خواندن
        _ := تی ال اس.نوشتن(اتصال، "received " + درخواست.طول() + " bytes")
        تی ال اس.بستن نوشتن(اتصال)
    پایان
    تی ال اس.بستن اتصال(اتصال)
    تی سی پی.بستن سرور(کارساز)
پایان

جداسازی اتصال Detach

تابع جداسازی اتصال(c &: اتصال)
هشدار بستن را می‌فرستد و حالت TLS را آزاد می‌کند، ولی سوکت را باز می‌گذارد.
tls-Detach.salam
واردسازی تی ال اس
واردسازی شبکه.تی سی پی

تابع ریشه:
    س := تی سی پی.شماره گیری("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
کلید RSA یا EC را از متن PEM می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

بارگذاری فایل کلید خصوصی LoadPrivateKeyFile

تابع بارگذاری فایل کلید خصوصی(path: رشته): PrivateKey
کلید را از پرونده‌ی PEM می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

بارگذاری فایل زنجیره گواهی LoadCertChainFile

تابع بارگذاری فایل زنجیره گواهی(path: رشته): Roots
زنجیره‌ی گواهی را از پرونده‌ی PEM می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

کلید عمومی ایدی۲۵۵۱۹ Ed25519PublicKey

تابع کلید عمومی ایدی۲۵۵۱۹(seed: تهی*، out: تهی*)
کلید عمومی ایدی۲۵۵۱۹ ۳۲ بایتی (RFC 8032) یک بذر ۳۲ بایتی را در نشانگر خروجی می‌نویسد.

امضای ایدی۲۵۵۱۹ Ed25519Sign

تابع امضای ایدی۲۵۵۱۹(seed: تهی*، msg: تهی*، n: صحیح، out: تهی*)
پیام را با بذر ایدی۲۵۵۱۹ امضا می‌کند و امضای ۶۴ بایتی را می‌نویسد. کد با بردارهای RFC 8032 سنجیده شده و زمان‌ثابت نیست.

بررسی امضای ایدی۲۵۵۱۹ Ed25519Verify

تابع بررسی امضای ایدی۲۵۵۱۹(pubk: تهی*، msg: تهی*، n: صحیح، sig: تهی*): منطقی
امضای ۶۴ بایتی ایدی۲۵۵۱۹ را با کلید عمومی و پیام می‌سنجد. مقدار S غیرمتعارف را رد می‌کند.

کدگذاری شانزدهی HexEncodeBuf

تابع کدگذاری شانزدهی(b: Buf): رشته
بافر را به شانزدهی تبدیل می‌کند.
tls-Crypto.salam
واردسازی تی ال اس
واردسازی کدگذاری

تابع ریشه خطادار:
    ناپایا خصوصی۱ := ""
    ناپایا عمومی۱ := ""
    ناپایا خصوصی۲ := ""
    ناپایا عمومی۲ := ""
    سرچاپ تی ال اس.تولید کلید ای سی دی اچ(خصوصی۱، عمومی۱)، تی ال اس.تولید کلید ای سی دی اچ(خصوصی۲، عمومی۲)
    ناپایا سالم := نادرست
    راز۱ := تی ال اس.راز مشترک ای سی دی اچ(خصوصی۱، عمومی۲، سالم)
    راز۲ := تی ال اس.راز مشترک ای سی دی اچ(خصوصی۲، عمومی۱، سالم)
    سرچاپ سالم، راز۱ == راز۲

    نقطه۱ := تی ال اس.نقطه عمومی ای سی دی اچ(خصوصی۱)
    نقطه۲ := تی ال اس.نقطه عمومی ای سی دی اچ(خصوصی۲)
    سرچاپ تی ال اس.نقطه مشترک ای سی دی اچ(خصوصی۱، نقطه۲، سالم) == تی ال اس.نقطه مشترک ای سی دی اچ(خصوصی۲، نقطه۱، سالم)

    نمک := تی ال اس.نمک تصادفی(۱۶)
    کلید := تی ال اس.اچ کی دی اف شا۲۵۶(راز۱، نمک، "chat v1"، ۳۲، سالم)
    سرچاپ سالم، کلید == تی ال اس.اچ کی دی اف شا۲۵۶(راز۲، نمک، "chat v1"، ۳۲، سالم)
    سرچاپ تی ال اس.اچ کی دی اف شا۲۵۶ خام(راز۱، نمک، کدگذاری.کدگذاری پایه۶۴("chat v1")، ۳۲، سالم) == کلید

    نانس := تی ال اس.نانس جی سی ام(۰)
    مهرشده := تی ال اس.مهر ای ای اس جی سی ام(کلید، نانس، "سلام، این پیام رمز شده است"، سالم)
    سرچاپ سالم
    سرچاپ تی ال اس.گشودن ای ای اس جی سی ام(کلید، نانس، مهرشده، سالم)، سالم
    _ := تی ال اس.گشودن ای ای اس جی سی ام(کلید، تی ال اس.نانس جی سی ام(۱)، مهرشده، سالم)
    سرچاپ سالم
    دودویی := تی ال اس.مهر بایت ای ای اس جی سی ام(کلید، نانس، کدگذاری.کدگذاری پایه۶۴("abc")، سالم)
    سرچاپ تلاش کدگذاری.کدگشایی پایه۶۴(تی ال اس.گشودن بایت ای ای اس جی سی ام(کلید، نانس، دودویی، سالم))

    چکیده := کدگذاری.کدگذاری پایه۶۴("0123456789abcdef0123456789abcdef")
    امضا := تی ال اس.امضای پی۲۵۶(خصوصی۱، چکیده، سالم)
    سرچاپ سالم، تی ال اس.تایید امضای پی۲۵۶(نقطه۱، چکیده، امضا)، تی ال اس.تایید امضای پی۲۵۶(نقطه۲، چکیده، امضا)

    ب := تی ال اس.درهم ساز(نادرست، "abc")
    سرچاپ تی ال اس.طول بافر(ب)، تی ال اس.کدگذاری شانزدهی(ب)
    ناپایا ش := تی ال اس.کدگشایی شانزدهی("cafe")
    تی ال اس.افزودن رشته به بافر(ش، "!")
    سرچاپ تی ال اس.طول بافر(ش)، تی ال اس.کدگذاری شانزدهی(ش)
    ناپایا ص := تی ال اس.بافر صفر جدید(۴)
    سرچاپ تی ال اس.کدگذاری شانزدهی(ص)
    ناپایا خالی := تی ال اس.بافر جدید(۶۴)
    سرچاپ تی ال اس.طول بافر(خالی)
    تی ال اس.پاک سازی بافر(ش)
    تی ال اس.آزادسازی بافر(ش)
    تی ال اس.آزادسازی بافر(ص)
    تی ال اس.آزادسازی بافر(خالی)
پایان
خروجیtrue true true true true true true true true سلام، این پیام رمز شده است true false abc true true false 32 ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad 3 cafe21 00000000 0

کدگشایی شانزدهی HexDecodeBuf

تابع کدگشایی شانزدهی(s: رشته): Buf
شانزدهی را به بافر برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam

بافر جدید NewBuf

تابع بافر جدید(cap: صحیح): Buf
بافر خالی با این ظرفیت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam

بافر صفر جدید NewZeroBuf

تابع بافر صفر جدید(n: صحیح): Buf
بافری با n بایت صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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
گواهی‌های ریشه را از پرونده‌ی PEM می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: 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: رشته): صحیح
گواهی DER را با ریشه‌ها و نام میزبان بررسی می‌کند؛ صفر یعنی معتبر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

گواهی معتبر است CertIsValid

تابع گواهی معتبر است(der: Buf): منطقی
گواهی DER درست خوانده می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

نام مشترک گواهی CertSubjectCN

تابع نام مشترک گواهی(der: Buf): رشته
نام مشترک (CN) گواهی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

درهم ساز HashDigest

تابع درهم ساز(sha384: منطقی، msg: رشته): Buf
چکیده‌ی SHA-256، یا با پارامتر اول درست SHA-384، در یک بافر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam

امضای آر اس ای پی کی سی اس یک SignRSAPKCS1

تابع امضای آر اس ای پی کی سی اس یک(k: PrivateKey، sha384: منطقی، digest: Buf، sigout &: Buf): منطقی
امضای RSA با PKCS#1 v1.5.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

امضای آر اس ای پی اس اس SignRSAPSS

تابع امضای آر اس ای پی اس اس(k: PrivateKey، sha384: منطقی، digest: Buf، sigout &: Buf): منطقی
امضای RSA-PSS.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

امضای بیضوی SignECDSA

تابع امضای بیضوی(k: PrivateKey، digest: Buf، rout: Buf، sout: Buf): منطقی
امضای ECDSA با r و s جدا.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

کدگذاری دی ای آر بیضوی ECDSADerEncode

تابع کدگذاری دی ای آر بیضوی(rbytes: Buf، sbytes: Buf، width: صحیح): Buf
r و s را به قالب DER امضا تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

تایید آر اس ای پی اس اس با کلید VerifyRSAPSSWithKey

تابع تایید آر اس ای پی اس اس با کلید(k: PrivateKey، sha384: منطقی، digest: Buf، sig: Buf): منطقی
امضای RSA-PSS را با کلید بررسی می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

تایید دی ای آر بیضوی با کلید VerifyECDSADERWithKey

تابع تایید دی ای آر بیضوی با کلید(k: PrivateKey، digest: Buf، dersig: Buf): منطقی
امضای ECDSA با قالب DER را بررسی می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

مهر خام ای ای اس جی سی ام AesGcmSealRaw

تابع مهر خام ای ای اس جی سی ام(key: تهی*، keylen: صحیح، nonce: تهی*، aad: تهی*، aadlen: صحیح، pt: تهی*، n: صحیح، out: تهی*): منطقی
AES-GCM یک‌باره روی حافظه: کلید ۱۶ یا ۳۲ بایتی و نانس ۱۲ بایتی. 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: تهی*): منطقی
ChaCha20-Poly1305 یک‌باره روی حافظه: کلید ۳۲ بایتی و نانس ۱۲ بایتی. n بایت رمزشده و برچسب ۱۶ بایتی را در out می‌نویسد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam

گشودن خام چاچا۲۰ پلی۱۳۰۵ ChaCha20Poly1305OpenRaw

تابع گشودن خام چاچا۲۰ پلی۱۳۰۵(key: تهی*، nonce: تهی*، aad: تهی*، aadlen: صحیح، sealed: تهی*، sealed_len: صحیح، out: تهی*): منطقی
وارونه‌ی ChaCha20Poly1305SealRaw: sealed_len برچسب را هم می‌شمارد. اگر داده کوتاه باشد یا تغییر کرده باشد نادرست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam

تولید کلید ای سی دی اچ EcdhP256Generate

تابع تولید کلید ای سی دی اچ(priv &: رشته، pub_spki &: رشته): منطقی
جفت کلید ECDH روی منحنی P-256: کلید خصوصی بیس۶۴ و کلید عمومی 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 &: منطقی): رشته
متن را با AES-GCM رمز و مهر می‌کند؛ خروجی بیس۶۴ است. هرگز یک نانس را با یک کلید دو بار به کار نبرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam

گشودن ای ای اس جی سی ام AesGcmOpen

تابع گشودن ای ای اس جی سی ام(key_b64: رشته، nonce_b64: رشته، sealed_b64: رشته، ok &: منطقی): رشته
متن مهرشده را باز می‌کند؛ اگر دست خورده یا کلید و نانس نادرست باشد، سالم نادرست می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam

نانس جی سی ام GcmNonce

تابع نانس جی سی ام(counter: صحیح۶۴): رشته
نانس ۱۲ بایتی از یک شمارنده؛ برای هر پیام شمارنده را یکی بالا ببرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam

نمک تصادفی RandomSalt

تابع نمک تصادفی(n: صحیح): رشته
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 &: منطقی): رشته
امضای ECDSA قطعی با RFC 6979 روی یک چکیده؛ ۶۴ بایت r و s به شکل بیس۶۴.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam

تایید امضای پی۲۵۶ P256Verify

تابع تایید امضای پی۲۵۶(pub_point_b64: رشته، digest_b64: رشته، sig_b64: رشته): منطقی
امضا را با نقطه‌ی عمومی بررسی می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Crypto.salam

امضای آر اس ای شا۲۵۶ RsaSignPkcs1Sha256

تابع امضای آر اس ای شا۲۵۶(pem: رشته، digest_b64: رشته، ok &: منطقی): رشته
چکیده را با کلید RSA متن PEM امضا می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

طول کلید آر اس ای RsaKeyBits

تابع طول کلید آر اس ای(pem: رشته): صحیح
طول کلید RSA بر حسب بیت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

رمزگذاری آر اس ای اوئپ RsaEncryptOaepSha1

تابع رمزگذاری آر اس ای اوئپ(pem: رشته، plain_b64: رشته، ok &: منطقی): رشته
داده‌ی کوچکی را با کلید عمومی RSA (به شکل PEM) و پدینگ OAEP با SHA-1 رمز می‌کند؛ ورودی و خروجی پایه۶۴ هستند.
tls-RsaEncryptOaepSha1.salam
واردسازی تی ال اس
واردسازی کدگذاری
واردسازی ورودی خروجی

تابع ریشه:
    کلید := ورودی خروجی.خواندن پرونده("public.pem")
    ناپایا موفق := نادرست
    رمز := تی ال اس.رمزگذاری آر اس ای اوئپ(کلید، کدگذاری.کدگذاری پایه۶۴("سلام")، موفق)
    اگر وارونه موفق:
        سرچاپ "کلید عمومی RSA خوانده نشد"
        برگشت
    پایان
    سرچاپ رمز.طول() > ۰
پایان

مهر خام ایکس چاچا۲۰ پلی۱۳۰۵ XChaCha20Poly1305SealRaw

تابع مهر خام ایکس چاچا۲۰ پلی۱۳۰۵(key: تهی*، nonce24: تهی*، aad: تهی*، aadlen: صحیح، pt: تهی*، n: صحیح، out: تهی*): منطقی
ChaCha20-Poly1305 یک‌باره با نانس ۲۴ بایتی: یک کلید یک‌بارمصرف از کلید و ۱۶ بایت نخست نانس ساخته می‌شود که نانس تصادفی را ایمن می‌کند. 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: منطقی): منطقی
یک بلوک ۱۶ بایتی را با AES و کلیدی ۱۶ یا ۳۲ بایتی، بدون زنجیره‌سازی، رمز یا رمزگشایی می‌کند. این یک قطعه‌ی سازنده برای سرایندهای پروتکل است، نه راهی برای رمز کردن پیام. برای طول کلید نادرست نادرست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Aead.salam

خودآزمایی SelfTest

تابع خودآزمایی(): صحیح
آزمون‌های درونی بسته را اجرا و گزارش می‌کند؛ شمار شکست‌ها را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: tls-Certs.salam

پوشش کارخواه با سلام خام WrapClientRaw

تابع پوشش کارخواه با سلام خام(fd: صحیح۶۴، hello: تهی*، hlen: صحیح، xpriv: تهی*، auth: تهی*، authlen: صحیح، cfg: پیکربندی): اتصال
دست‌دهی کلاینت تی‌ال‌اس ۱.۳ را روی سوکت با ClientHello که خودتان ساخته‌اید اجرا می‌کند، همان‌طور که net.utls می‌کند. کلید خصوصی ایکس۲۵۵۱۹ سهم کلید پیام را می‌خواهد. کلید احراز غیرخالی بررسی گواهی را به قاعده‌ی ریالیتی که net.reality به کار می‌برد تغییر می‌دهد. با HelloRetryRequest شکست می‌خورد.

پوشش کارخواه خام پسا کوانتومی WrapClientRawPq

تابع پوشش کارخواه خام پسا کوانتومی(fd: صحیح۶۴، hello: تهی*، hlen: صحیح، xpriv: تهی*، pq_seed: تهی*، auth: تهی*، authlen: صحیح، cfg: پیکربندی): اتصال
مانند WrapClientRaw است و بذر ۶۴ بایتی ML-KEM پشت کلید مشترک X25519MLKEM768 را هم می‌گیرد، تا اگر کارساز آن گروه را برگزید دست‌دهی تمام شود.

کلید عمومی ایکس۲۵۵۱۹ 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: تهی*): اتصال
سمت سرور تی‌ال‌اس ۱.۳ را با ClientHello که از پیش خوانده شده، گواهی DER و بذر ایدی۲۵۵۱۹ که دست‌دهی را امضا می‌کند اجرا می‌کند، همان‌طور که net.reality می‌کند.