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

رمزنگاری crypto

چکیده‌ی SHA و MD5، امضای HMAC، عدد تصادفی امن و درهم کردن گذرواژه.

واردسازی رمزنگاری

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

این بسته ابزارهای پایه‌ی رمزنگاری را دارد که به زبان سلام نوشته شده‌اند: چکیده‌های SHA-1، SHA-2 و MD5، HMAC، درهم‌سازی گذرواژه با PBKDF2، مقایسه در زمان ثابت و بایت‌های تصادفی امن از سیستم‌عامل. درهم‌سازی، امضا و رازها را پوشش می‌دهد ولی رمز نمی‌کند. برای رمز کردن (AES-GCM، ChaCha20-Poly1305 و تبادل کلید) تی ال اس و برای توکن امضاشده‌ای که ادعا حمل می‌کند جی دبلیو تی را به کار ببرید.

بیشتر تابع‌ها سه شکل دارند: ... شانزدهی یک رشته می‌گیرد و متن شانزدهی برمی‌گرداند و ساده‌ترین است؛ ... بایت و ... خام چکیده‌ی خام را در حافظه‌ای که خودتان می‌دهید می‌نویسند؛ و سه‌تایی شروع، به‌روزرسانی و پایان SHA-256 داده‌ای را که تکه‌تکه می‌رسد درهم می‌کند.

نکته‌هایی که باید درست انجام شوند:

  • درهم گذرواژه فقط ۱۰۰۰ دور PBKDF2 به کار می‌برد. این خیلی کمتر از توصیه‌ی امروزی است (OWASP برای SHA-256 ششصد هزار دور می‌خواهد). برای سامانه‌های تازه همان رشته را با دورهای بیشتر بسازید، همان‌طور که بخش دوم نشان می‌دهد؛ تایید گذرواژه تعداد دور را از رشته‌ی ذخیره‌شده می‌خواند، پس هر دو نوع کار می‌کنند.
  • رازها را با برابری راز مقایسه کنید، هرگز با ==.
  • رشته در نخستین بایت صفر تمام می‌شود. برای داده یا کلید دودویی شکل‌های ... بایت و ... خام را با اشاره‌گر و طول به کار ببرید؛ شا۲۵۶ شانزدهی روی بافری که صفر دارد فقط بخش پیش از صفر را درهم می‌کند.
  • درهم‌های جدول درهم‌سازی سریع‌اند و رمزنگارانه نیستند؛ MD5 و SHA-1 فقط برای سامانه‌های قدیمی‌ای است که آن‌ها را لازم دارند.

نگهداری گذرواژه

یک سامانه‌ی ورود برای هر کاربر فقط یک رشته نگه می‌دارد: خروجی درهم گذرواژه. این رشته چهار بخش دارد که با $ از هم جدا شده‌اند: نام الگوریتم، شمار دورهای PBKDF2، یک نمک تصادفی و کلید به دست آمده. چون نمک هر بار تازه است، دو کاربر با گذرواژه‌ی یکسان دو رشته‌ی متفاوت می‌گیرند و جدولی که لو برود با یک فهرست از پیش ساخته شکسته نمی‌شود. هنگام ورود، تایید گذرواژه شمار دورها و نمک را از همان رشته‌ی ذخیره شده می‌خواند؛ پس جز همین رشته چیزی لازم نیست نگه دارید.

crypto-passwords.salam
واردسازی رمزنگاری
واردسازی رشته

ساختار کاربر:
    همگانی اسم: رشته = ""
    همگانی درهم: رشته = ""
پایان

تابع ثبت کاربر(کاربران &: وکتور<کاربر>، اسم: رشته، گذرواژه: رشته):
    کاربران.بیفزا(کاربر { اسم = اسم، درهم = رمزنگاری.درهم گذرواژه(گذرواژه) })
پایان

تابع احراز هویت(کاربران: وکتور<کاربر>، اسم: رشته، گذرواژه: رشته): منطقی:
    هر ک در کاربران:
        اگر ک.اسم برابر اسم:
            برگشت رمزنگاری.تایید گذرواژه(گذرواژه، ک.درهم)
        پایان
    پایان
    برگشت نادرست
پایان

تابع ریشه:
    ناپایا کاربران := وکتور {} برگردان وکتور<کاربر>
    ثبت کاربر(کاربران، "سارا"، "correct horse battery")
    ثبت کاربر(کاربران، "امید"، "correct horse battery")

    بخش‌ها := رشته.تفکیک کردن(کاربران.بگیر(۰).درهم، "$")
    سرچاپ "شمار بخش‌ها:"، بخش‌ها.طول()، "الگوریتم:"، بخش‌ها.بگیر(۰)، "دور:"، بخش‌ها.بگیر(۱)
    سرچاپ "گذرواژه‌ی یکسان، درهم یکسان؟"، کاربران.بگیر(۰).درهم برابر کاربران.بگیر(۱).درهم
    سرچاپ "سارا با گذرواژه‌ی درست:"، احراز هویت(کاربران، "سارا"، "correct horse battery")
    سرچاپ "سارا با گذرواژه‌ی نادرست:"، احراز هویت(کاربران، "سارا"، "correct horse")
    سرچاپ "کاربر ناشناس:"، احراز هویت(کاربران، "هیچ‌کس"، "x")
پایان
خروجیشمار بخش‌ها: 4 الگوریتم: pbkdf2-sha256 دور: 1000 گذرواژه‌ی یکسان، درهم یکسان؟ false سارا با گذرواژه‌ی درست: true سارا با گذرواژه‌ی نادرست: false کاربر ناشناس: false

برای «کاربر نادرست» و «گذرواژه‌ی نادرست» یک پیام یکسان نشان دهید تا کسی نتواند با فرم ورود بفهمد کدام حساب‌ها وجود دارند.

دورهای بیشتر و ارتقای درهم‌های قدیمی

هزینه‌ی درهم گذرواژه تعداد دورهای آن است: هر حدسی که مهاجم امتحان می‌کند به اندازه‌ی یک ورود کار می‌برد. پی بی کِی دی اف۲ شانزدهی تعداد دور را می‌گیرد، پس درهم قوی‌تر همان رشته‌ی چهار بخشی درهم گذرواژه است که با ۶۰۰٬۰۰۰ دور دستی ساخته می‌شود. کاربران فعلی لازم نیست کاری بکنند. در ورود موفق بعدی، برنامه می‌بیند درهم ذخیره‌شده دور کمتری از هدف دارد و درهم تازه‌ای از همان گذرواژه‌ای که کاربر وارد کرده ذخیره می‌کند.

crypto-password-rounds.salam
واردسازی رمزنگاری
واردسازی رشته

پایا دورها := ۶۰۰۰۰۰

تابع درهم قوی(گذرواژه: رشته): رشته:
    نمک := رمزنگاری.تصادفی ایمن شانزدهی(۱۶)
    برگشت "pbkdf2-sha256$" + دورها + "$" + نمک + "$" + رمزنگاری.پی بی کِی دی اف۲ شانزدهی(گذرواژه، نمک، دورها، ۳۲)
پایان

تابع دورهای(ذخیره: رشته): صحیح:
    برگشت رشته.تفکیک کردن(ذخیره، "$").دریافت(۱).به صحیح()
پایان

تابع ورود(ذخیره &: رشته، گذرواژه: رشته): منطقی:
    اگر وارونه رمزنگاری.تایید گذرواژه(گذرواژه، ذخیره): برگشت نادرست پایان
    اگر دورهای(ذخیره) کوچکتر دورها:
        ذخیره = درهم قوی(گذرواژه)
        سرچاپ "  درهم ذخیره‌شده به"، دورهای(ذخیره)، "دور ارتقا یافت"
    پایان
    برگشت درست
پایان

تابع ریشه:
    ناپایا ذخیره := رمزنگاری.درهم گذرواژه("چای ساعت پنج")
    سرچاپ "درهم گذرواژه"، دورهای(ذخیره)، "دور به کار می‌برد"
    سرچاپ "ورود:"، ورود(ذخیره، "چای ساعت پنج")
    سرچاپ "ورود دوباره:"، ورود(ذخیره، "چای ساعت پنج")
    سرچاپ "گذرواژه‌ی نادرست:"، ورود(ذخیره، "قهوه ساعت شش")
پایان
خروجیدرهم گذرواژه 1000 دور به کار می‌برد درهم ذخیره‌شده به 600000 دور ارتقا یافت ورود: true ورود دوباره: true گذرواژه‌ی نادرست: false

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

بررسی امضای وب‌هوک

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

crypto-webhook.salam
واردسازی رمزنگاری

تابع بررسی امضا(راز: رشته، بدنه: رشته، سرآیند: رشته): منطقی:
    مورد انتظار := "sha256=" + رمزنگاری.اچ مک شا۲۵۶ شانزدهی(راز، بدنه)
    برگشت رمزنگاری.برابری راز(مورد انتظار، سرآیند)
پایان

تابع ریشه:
    راز := "whsec_4f9a1c"
    بدنه := "{\"event\":\"order.paid\",\"id\":1042}"
    سرآیند := "sha256=" + رمزنگاری.اچ مک شا۲۵۶ شانزدهی(راز، بدنه)
    سرچاپ "امضا: " + سرآیند

    سرچاپ "درخواست اصلی:"، بررسی امضا(راز، بدنه، سرآیند)
    سرچاپ "بدنه‌ی دست‌خورده:"، بررسی امضا(راز، "{\"event\":\"order.paid\",\"id\":9999}"، سرآیند)
    سرچاپ "راز اشتباه:"، بررسی امضا("guess"، بدنه، سرآیند)
پایان
خروجیامضا: sha256=9d396fc7d426c8baf9dd3da910e4cd8bc378e42dfc08dc2bdf1681692f33554b درخواست اصلی: true بدنه‌ی دست‌خورده: false راز اشتباه: false

بایت‌هایی را که دریافت کرده‌اید امضا کنید، نه نسخه‌ای که یک بار خوانده و دوباره ساخته‌اید: کتابخانه‌ی JSON ممکن است ترتیب کلیدها یا فاصله‌ها را عوض کند و آن وقت امضا دیگر نمی‌خواند.

چکیده‌ی داده‌های بزرگ

شا۲۵۶ شانزدهی همه‌ی متن را یک‌جا می‌خواهد. برای فایل یا دانلودی که تکه تکه می‌رسد، یک وضعیت در حال اجرا نگه دارید: شا۲۵۶ جدید آن را می‌سازد، به روز رسانی شا۲۵۶ هر تکه را به آن می‌دهد و نهایی شا۲۵۶ چکیده‌ی ۳۲ بایتی را می‌نویسد. همان‌طور که برنامه نشان می‌دهد، نتیجه با درهم کردن یک‌جای همه‌ی داده یکی است.

crypto-checksum.salam
واردسازی رمزنگاری
واردسازی کدگذاری
واردسازی حافظه

تابع ریشه:
    تکه‌ها := ["first block of the file, "، "second block, "، "and the last one."]
    ناپایا همه := ""
    ناپایا ح := رمزنگاری.شا۲۵۶ جدید()
    هر تکه در تکه‌ها:
        رمزنگاری.به روز رسانی شا۲۵۶(ح، تکه برگردان تهی*، تکه.طول())
        همه += تکه
    پایان
    خروجی := حافظه.تخصیص(۳۲ برگردان طبیعی۶۴)
    رمزنگاری.نهایی شا۲۵۶(ح، خروجی)
    تکه به تکه := کدگذاری.کدگذاری بایت‌ها پایه۶۴(خروجی، ۳۲)

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

    سرچاپ "تکه به تکه: " + تکه به تکه
    سرچاپ "یکجا: " + یکجا
    سرچاپ "یکسان:"، تکه به تکه برابر یکجا
    سرچاپ "شکل شانزدهی: " + رمزنگاری.شا۲۵۶ شانزدهی(همه)
پایان
خروجیتکه به تکه: E+f0zAqMN9MLnvZXyBef5ki729TQh4fngTGDH5hLL1M= یکجا: E+f0zAqMN9MLnvZXyBef5ki729TQh4fngTGDH5hLL1M= یکسان: true شکل شانزدهی: 13e7f4cc0a8c37d30b9ef657c8179fe648bbdbd4d08787e78131831f984b2f53

تابع‌های ... بایت و نهایی ... بایت‌های خام را در حافظه‌ای که خودتان گرفته‌اید می‌نویسند؛ برای تبدیل آن‌ها به متن از کدگذاری بایت‌ها پایه۶۴ در بسته‌ی کدگذاری استفاده کنید. وضعیت‌های SHA-512 و SHA-384 هم با شا۵۱۲ جدید، شا۳۸۴ جدید، به روز رسانی شا۵۱۲ و نهایی شا۵۱۲ همین‌طور کار می‌کنند.

کلید API و توکن

کلید API، پیوند بازنشانی گذرواژه یا شناسه‌ی نشست نباید حدس زدنی باشد؛ پس آن را با توکن تصادفی ایمن بسازید که از منبع تصادفی امن سیستم عامل می‌خواند. توکن تصادفی ایمن(n) تعداد n بایت تصادفی را به شکل 2n نویسه‌ی شانزدهی برمی‌گرداند. فقط چکیده‌ی SHA-256 کلید را ذخیره کنید: پایگاه داده‌ی دزدیده شده هیچ کلید کارآمدی به دست نمی‌دهد و بررسی کلیدی که با درخواست می‌آید فقط یک چکیده و یک برابری راز است. این‌جا چکیده‌ی ساده کافی است چون کلید بلند و تصادفی است؛ گذرواژه کوتاه است و آدم‌ها انتخابش می‌کنند و برای همین به درهم گذرواژه نیاز دارد.

crypto-api-keys.salam
واردسازی رمزنگاری

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

    ذخیره شده := رمزنگاری.شا۲۵۶ شانزدهی(کلید)
    سرچاپ "طول چکیده‌ی ذخیره شده:"، ذخیره شده.طول()

    سرچاپ "کلید درست پذیرفته شد:"، رمزنگاری.برابری راز(رمزنگاری.شا۲۵۶ شانزدهی(کلید)، ذخیره شده)
    سرچاپ "کلید جعلی پذیرفته شد:"، رمزنگاری.برابری راز(رمزنگاری.شا۲۵۶ شانزدهی("sk_" + رمزنگاری.توکن تصادفی ایمن(۲۴))، ذخیره شده)
    سرچاپ "دو کلید متفاوت‌اند:"، رمزنگاری.توکن تصادفی ایمن(۲۴) نابرابر رمزنگاری.توکن تصادفی ایمن(۲۴)
پایان
خروجیطول کلید: 51 طول چکیده‌ی ذخیره شده: 64 کلید درست پذیرفته شد: true کلید جعلی پذیرفته شد: false دو کلید متفاوت‌اند: true

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

کارتابع
نگهداری و بررسی گذرواژه‌ی کاربردرهم گذرواژه، تایید گذرواژه
امضای پیام یا بررسی درخواست امضا شدهاچ مک شا۲۵۶ شانزدهی و برابری راز
چکیده‌ی فایل یا شناسه‌ی محتواشا۲۵۶ شانزدهی، یا برای داده‌ی تکه تکه شا۲۵۶ جدید، به روز رسانی شا۲۵۶ و نهایی شا۲۵۶
توکن، کلید یا عدد یک‌بار مصرفتوکن تصادفی ایمن، تصادفی ایمن شانزدهی، بایت های تصادفی
کلید ساخته شده از یک عبارت عبورپی بی کِی دی اف۲ شانزدهی
کلید جدول درهم‌سازی، نه برای امنیتدرهم رشته، درهم بایت، درهم عدد
کار با سامانه‌ی قدیمی که MD5 یا SHA-1 می‌خواهدام دی۵ شانزدهی، شا۱ شانزدهی؛ برای کار تازه به کارشان نبرید

برای توکن‌های امضا شده که ادعاها را با خود می‌برند jwt را ببینید و برای رمزگذاری tls را.

گونه‌ها

شا۲۵۶ Sha256

ساختار شا۲۵۶
وضعیت SHA-256 برای داده‌ای که تکه‌تکه می‌رسد، مثل یک پرونده‌ی بزرگ.
نامانگلیسیگونهتوضیح
وضعیتhطبیعی۳۲[]وضعیت درونی.
بلوکblkطبیعی۸[]بلوک ناقص.
طول بلوکblenصحیح = 0طول بلوک ناقص.
مجموعtotalطبیعی۶۴ = 0شمار کل بایت‌ها.
crypto-Hash.salam
واردسازی رمزنگاری
واردسازی کدگذاری
واردسازی حافظه

تابع ریشه:
    سرچاپ رمزنگاری.شا۲۵۶ شانزدهی("abc")
    سرچاپ رمزنگاری.شا۵۱۲ شانزدهی("abc").طول()
    سرچاپ رمزنگاری.شا۱ شانزدهی("abc")
    سرچاپ رمزنگاری.شا۱ پایه۶۴("abc")
    سرچاپ رمزنگاری.ام دی۵ شانزدهی("abc")

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

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

    سرچاپ رمزنگاری.درهم رشته("سلام") == رمزنگاری.درهم رشته("سلام")، رمزنگاری.درهم رشته("a") != رمزنگاری.درهم رشته("b")
    سرچاپ رمزنگاری.درهم بایت(متن برگردان تهی*، ۳ برگردان طبیعی۶۴) == رمزنگاری.درهم رشته("abc")
    سرچاپ رمزنگاری.درهم عدد(۴۲ برگردان طبیعی۶۴) != رمزنگاری.درهم عدد(۴۳ برگردان طبیعی۶۴)
پایان
خروجیba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad 128 a9993e364706816aba3e25717850c26c9cd0d89d qZk+NkcGgWq6PiVxeFDCbJzQ2J0= 900150983cd24fb0d6963f7d28e17f72 ungWv48Bz+pBQUDeXa4iI7ADYaOWF3qctBD/YfIAFa0= ywB1P0WjXou1oD1pmsZQBycsMqsO3tFjGotgWkP/W+2AhgcroefMI1i67KE0yCWn 24 qZk+NkcGgWq6PiVxeFDCbJzQ2J0= kAFQmDzST7DWlj99KOF/cg== ungWv48Bz+pBQUDeXa4iI7ADYaOWF3qctBD/YfIAFa0= 64 48 ywB1P0WjXou1oD1pmsZQBycsMqsO3tFjGotgWkP/W+2AhgcroefMI1i67KE0yCWn true true true true

شا۵۱۲ Sha512

ساختار شا۵۱۲
وضعیت SHA-512 یا SHA-384 برای داده‌ی تکه‌تکه.
نامانگلیسیگونهتوضیح
وضعیتhطبیعی۶۴[]وضعیت درونی.
بلوکblkطبیعی۸[]بلوک ناقص.
طول بلوکblenصحیح = 0طول بلوک ناقص.
مجموعtotalطبیعی۶۴ = 0شمار کل بایت‌ها.
طول چکیدهoutlenصحیح = 64طول چکیده: ۶۴ برای SHA-512 و ۴۸ برای SHA-384.

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

تابع‌ها

درهم بایت HashBytes

تابع درهم بایت(p: تهی*، n: طبیعی۶۴): طبیعی۶۴
درهم سریع و غیررمزنگارانه‌ی بایت‌ها؛ برای جدول درهم و مانند آن، نه برای امنیت.

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

درهم رشته HashStr

تابع درهم رشته(s: رشته): طبیعی۶۴
درهم سریع یک رشته.

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

درهم عدد HashInt

تابع درهم عدد(x: طبیعی۶۴): طبیعی۶۴
درهم سریع یک عدد.

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

ام دی۵ بایت Md5Bytes

تابع ام دی۵ بایت(p: تهی*، n: صحیح، out: تهی*)
چکیده‌ی MD5، ۱۶ بایت، را در خروجی می‌نویسد. MD5 شکسته است؛ فقط برای سازگاری با سامانه‌های قدیمی.

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

ام دی۵ شانزدهی Md5Hex

تابع ام دی۵ شانزدهی(data: رشته): رشته
چکیده‌ی MD5 به شکل شانزدهی.

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

اچ مک شا۱ خام HmacSha1Raw

تابع اچ مک شا۱ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)
HMAC-SHA1 خام.
crypto-Hmac.salam
واردسازی رمزنگاری
واردسازی کدگذاری
واردسازی حافظه

تابع ریشه:
    کلید := "key"
    پیام := "The quick brown fox jumps over the lazy dog"
    سرچاپ رمزنگاری.اچ مک شا۲۵۶ شانزدهی(کلید، پیام)
    سرچاپ رمزنگاری.اچ مک شا۱ شانزدهی(کلید، پیام)
    سرچاپ رمزنگاری.اچ مک شا۱ بیس۶۴(کلید، پیام)
    سرچاپ رمزنگاری.اچ مک شا۳۸۴ شانزدهی(کلید، پیام).طول()، رمزنگاری.اچ مک شا۵۱۲ شانزدهی(کلید، پیام).طول()

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

اچ مک شا۱ بایتی HmacSha1Bytes

تابع اچ مک شا۱ بایتی(key: رشته، msg: رشته، out: تهی*)
HMAC-SHA1، ۲۰ بایت.

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

اچ مک شا۱ شانزدهی HmacSha1Hex

تابع اچ مک شا۱ شانزدهی(key: رشته، msg: رشته): رشته
HMAC-SHA1 به شکل شانزدهی؛ برای سرویس‌های قدیمی.

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

اچ مک شا۱ بیس۶۴ HmacSha1Base64

تابع اچ مک شا۱ بیس۶۴(key: رشته، msg: رشته): رشته
HMAC-SHA1 به شکل بیس۶۴؛ مثلاً امضای OAuth 1.

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

شا۲۵۶ شانزدهی Sha256Hex

تابع شا۲۵۶ شانزدهی(data: رشته): رشته
چکیده‌ی SHA-256 به شکل شانزدهی، ۶۴ نویسه.

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

اچ مک شا۲۵۶ خام HmacSha256Raw

تابع اچ مک شا۲۵۶ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)
HMAC-SHA256 با کلید و پیامی که به شکل اشاره‌گر و طول می‌دهید؛ برای داده‌ی دودویی.

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

اچ مک شا۳۸۴ خام HmacSha384Raw

تابع اچ مک شا۳۸۴ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)
HMAC-SHA384 خام.

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

اچ مک شا۵۱۲ خام HmacSha512Raw

تابع اچ مک شا۵۱۲ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)
HMAC-SHA512 خام.

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

اچ مک شا۲۵۶ بایت HmacSha256Bytes

تابع اچ مک شا۲۵۶ بایت(key: رشته، msg: رشته، out: تهی*)
HMAC-SHA256، ۳۲ بایت، را در خروجی می‌نویسد.

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

اچ مک شا۳۸۴ بایت HmacSha384Bytes

تابع اچ مک شا۳۸۴ بایت(key: رشته، msg: رشته، out: تهی*)
HMAC-SHA384، ۴۸ بایت.

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

اچ مک شا۵۱۲ بایت HmacSha512Bytes

تابع اچ مک شا۵۱۲ بایت(key: رشته، msg: رشته، out: تهی*)
HMAC-SHA512، ۶۴ بایت.

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

اچ مک شا۳۸۴ شانزدهی HmacSha384Hex

تابع اچ مک شا۳۸۴ شانزدهی(key: رشته، msg: رشته): رشته
HMAC-SHA384 به شکل شانزدهی.

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

اچ مک شا۵۱۲ شانزدهی HmacSha512Hex

تابع اچ مک شا۵۱۲ شانزدهی(key: رشته، msg: رشته): رشته
HMAC-SHA512 به شکل شانزدهی.

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

اچ مک شا۲۵۶ شانزدهی HmacSha256Hex

تابع اچ مک شا۲۵۶ شانزدهی(key: رشته، msg: رشته): رشته
امضای HMAC-SHA256 پیام با کلید، به شکل شانزدهی؛ برای بررسی این‌که پیام دست‌نخورده و از طرف دارنده‌ی کلید است. کلید و پیام در بایت صفر تمام می‌شوند؛ برای داده‌ی دودویی اچ مک شا۲۵۶ خام را به کار ببرید.

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

درهم بی کریپت با نمک BcryptHashWithSalt

تابع درهم بی کریپت با نمک(password: رشته، cost: صحیح، salt: تهی*): رشته
مانند درهم بی کریپت، اما به جای نمک تصادفی، نمک ۱۶ بایتی خودتان را از یک اشاره‌گر می‌گیرد، پس ورودی یکسان همیشه همان رشته را می‌دهد؛ برای آزمون و پاسخ‌های شناخته‌شده، نه برای نگه‌داری گذرواژه‌های واقعی.
crypto-Bcrypt.salam
واردسازی رمزنگاری
واردسازی حافظه
واردسازی رشته

تابع ریشه:
    ذخیره := رمزنگاری.درهم بی کریپت("s3cret-پسورد"، ۱۰)
    سرچاپ رشته.شروع با(ذخیره، "$2y$10$")، ذخیره.طول()
    سرچاپ رمزنگاری.درهم بی کریپت است(ذخیره)، رمزنگاری.هزینه بی کریپت(ذخیره)
    سرچاپ رمزنگاری.تایید بی کریپت("s3cret-پسورد"، ذخیره)، رمزنگاری.تایید بی کریپت("wrong"، ذخیره)
    سرچاپ ذخیره نابرابر رمزنگاری.درهم بی کریپت("s3cret-پسورد"، ۱۰)

    نمک := حافظه.تخصیص(۱۶ برگردان طبیعی۶۴)
    بایت‌ها := نمک برگردان طبیعی۸*
    تکرار ۱۶ در ی:
        بایت‌ها[ی] = (ی * ۷) برگردان طبیعی۸
    پایان
    ثابت := رمزنگاری.درهم بی کریپت با نمک("s3cret-پسورد"، ۴، نمک)
    سرچاپ ثابت
    سرچاپ ثابت برابر رمزنگاری.درهم بی کریپت با نمک("s3cret-پسورد"، ۴، نمک)
    حافظه.آزادسازی(نمک)

    سرچاپ رمزنگاری.تایید بی کریپت("U*U"، "$2a$05$CCCCCCCCCCCCCCCCCCCCC.E5YPO9kmyuRGyh0XouQYb4YMJKvyOeW")
    سرچاپ رمزنگاری.درهم بی کریپت است("pbkdf2-sha256$1000$aa$bb")، رمزنگاری.هزینه بی کریپت("هش نیست")
پایان
خروجیtrue 60 true 10 true false true $2y$04$..aMDPuhIhC2NyXLTDrgYO/9Y.COrykLUBeabR0At.majK/6aYKMi true true false -1

درهم بی کریپت BcryptHash

تابع درهم بی کریپت(password: رشته، cost: صحیح): رشته
گذرواژه را با bcrypt و نمک تصادفی ۱۶ بایتی درهم می‌کند و رشته‌ی ۶۰ نویسه‌ای $2y$هزینه$نمک+درهم را برمی‌گرداند، همان قالبی که password_hash در PHP می‌نویسد. هزینه لگاریتم پایه‌ی ۲ تعداد دورهاست: هر یک واحد افزایش کار را دو برابر می‌کند؛ ۱۰ انتخاب رایجی است و مقدار میان ۴ و ۳۱ نگه داشته می‌شود. فقط ۷۲ بایت نخست گذرواژه به حساب می‌آید.

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

درهم بی کریپت است IsBcryptHash

تابع درهم بی کریپت است(encoded: رشته): منطقی
درست است وقتی رشته شکل درهم bcrypt را دارد: ۶۰ نویسه که با $2a$، $2b$ یا $2y$ شروع می‌شود. وقتی پایگاه داده هم درهم bcrypt و هم رشته‌ی درهم گذرواژه دارد به کار می‌آید.

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

هزینه بی کریپت BcryptCost

تابع هزینه بی کریپت(encoded: رشته): صحیح
هزینه‌ای که در درهم bcrypt نوشته شده، مثلا ۱۰ برای $2y$10$...؛ اگر رشته درهم bcrypt نباشد -1. آن را با هزینه‌ی هدف خود مقایسه کنید تا بدانید کی باید گذرواژه را دوباره درهم کرد.

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

تایید بی کریپت BcryptVerify

تابع تایید بی کریپت(password: رشته، encoded: رشته): منطقی
گذرواژه را با رشته‌ی ذخیره‌شده‌ی $2a$، $2b$ یا $2y$، با همان هزینه و نمکی که در آن است، در زمان ثابت می‌سنجد؛ درهم‌های ساخته‌شده با PHP و دیگر کتابخانه‌های bcrypt هم پذیرفته می‌شوند. برای هر قالب دیگری نادرست است.

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

تصادفی ایمن شانزدهی RandomHex

تابع تصادفی ایمن شانزدهی(n: صحیح): رشته
n بایت تصادفی امن از سیستم‌عامل، به شکل شانزدهی با ۲n نویسه؛ برای شناسه‌ها و نمک.
crypto-Password.salam
واردسازی رمزنگاری
واردسازی رشته
واردسازی حافظه

تابع ریشه:
    ذخیره := رمزنگاری.درهم گذرواژه("s3cret-پسورد")
    سرچاپ رشته.شروع با(ذخیره، "pbkdf2-sha256$")
    سرچاپ رمزنگاری.تایید گذرواژه("s3cret-پسورد"، ذخیره)، رمزنگاری.تایید گذرواژه("wrong"، ذخیره)
    سرچاپ ذخیره != رمزنگاری.درهم گذرواژه("s3cret-پسورد")

    سرچاپ رمزنگاری.پی بی کِی دی اف۲ شانزدهی("password"، "salt"، ۱، ۳۲)
    سرچاپ رمزنگاری.برابری راز("abc"، "abc")، رمزنگاری.برابری راز("abc"، "xyz")

    سرچاپ رمزنگاری.تصادفی ایمن شانزدهی(۱۶).طول()، رمزنگاری.توکن تصادفی ایمن(۳۲).طول() > ۰
    ب := حافظه.تخصیص(۸ برگردان طبیعی۶۴)
    رمزنگاری.بایت های تصادفی(ب، ۸)
    حافظه.آزادسازی(ب)
پایان
خروجیtrue true false true 120fb6cffcf8b32c43e7225256c4f837a86548c92ccc35480805987cb70be17b true false 32 true

توکن تصادفی ایمن RandomToken

تابع توکن تصادفی ایمن(n: صحیح): رشته
توکن تصادفی امن از n بایت، به شکل 2n نویسه‌ی شانزدهی (همانند تصادفی ایمن شانزدهی)؛ برای توکن نشست و بازیابی گذرواژه.

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

بایت های تصادفی RandomBytes

تابع بایت های تصادفی(p: تهی*، n: صحیح)
n بایت تصادفی امن را در حافظه‌ی داده‌شده می‌نویسد. اگر سیستم‌عامل نتواند، برنامه متوقف می‌شود.

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

شا۵۱۲ شانزدهی Sha512Hex

تابع شا۵۱۲ شانزدهی(data: رشته): رشته
چکیده‌ی SHA-512 به شکل شانزدهی، ۱۲۸ نویسه.

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

شا۲۵۶ بایت Sha256Bytes

تابع شا۲۵۶ بایت(p: تهی*، n: صحیح، out: تهی*)
چکیده‌ی SHA-256، ۳۲ بایت، را در خروجی می‌نویسد.

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

شا۳۸۴ بایت Sha384Bytes

تابع شا۳۸۴ بایت(p: تهی*، n: صحیح، out: تهی*)
چکیده‌ی SHA-384، ۴۸ بایت.

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

شا۵۱۲ بایت Sha512Bytes

تابع شا۵۱۲ بایت(p: تهی*، n: صحیح، out: تهی*)
چکیده‌ی SHA-512، ۶۴ بایت.

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

شا۲۵۶ جدید Sha256New

تابع شا۲۵۶ جدید(): شا۲۵۶
وضعیت تازه‌ی SHA-256.

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

به روز رسانی شا۲۵۶ Sha256Update

تابع به روز رسانی شا۲۵۶(s &: شا۲۵۶، p: تهی*، n: صحیح)
تکه‌ی بعدی داده را می‌افزاید.

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

نهایی شا۲۵۶ Sha256Final

تابع نهایی شا۲۵۶(s: شا۲۵۶، out: تهی*)
چکیده‌ی نهایی را در خروجی می‌نویسد.

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

شا۳۸۴ جدید Sha384New

تابع شا۳۸۴ جدید(): شا۵۱۲
وضعیت تازه‌ی SHA-384؛ با تابع‌های شا۵۱۲ ادامه دهید.

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

شا۵۱۲ جدید Sha512New

تابع شا۵۱۲ جدید(): شا۵۱۲
وضعیت تازه‌ی SHA-512.

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

به روز رسانی شا۵۱۲ Sha512Update

تابع به روز رسانی شا۵۱۲(s &: شا۵۱۲، p: تهی*، n: صحیح)
تکه‌ی بعدی داده را می‌افزاید.

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

نهایی شا۵۱۲ Sha512Final

تابع نهایی شا۵۱۲(s: شا۵۱۲، out: تهی*)
چکیده‌ی نهایی را به طول outlen می‌نویسد.

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

پی بی کِی دی اف۲ شانزدهی Pbkdf2HmacSha256Hex

تابع پی بی کِی دی اف۲ شانزدهی(password: رشته، salt: رشته، iterations: صحیح، keylen: صحیح): رشته
کلید را با PBKDF2-HMAC-SHA256 از گذرواژه و نمک با شمار تکرار داده‌شده می‌سازد.

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

درهم گذرواژه HashPassword

تابع درهم گذرواژه(password: رشته): رشته
گذرواژه را با PBKDF2-HMAC-SHA256، ۱۰۰۰ دور و نمک تصادفی ۱۶ بایتی درهم می‌کند و pbkdf2-sha256$1000$نمک$درهم را برمی‌گرداند که در پایگاه داده نگه می‌دارید. هر بار خروجی فرق می‌کند. ۱۰۰۰ دور با معیارهای امروز کم است؛ برای درهم قوی‌تر راهنما را ببینید.

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

تایید گذرواژه VerifyPassword

تابع تایید گذرواژه(password: رشته، encoded: رشته): منطقی
گذرواژه را با رشته‌ی pbkdf2-sha256$دور$نمک$درهم، با همان دور و نمکی که در آن است، در زمان ثابت می‌سنجد. برای هر قالب دیگری نادرست است.

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

برابری راز SecretEquals

تابع برابری راز(a: رشته، b: رشته): منطقی
دو راز را در زمان ثابت مقایسه می‌کند تا زمان پاسخ چیزی درباره‌ی محتوای آن‌ها لو ندهد (فقط این‌که طولشان فرق دارد یا نه)؛ برای توکن‌ها و امضاها.

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

شا۱ شانزدهی Sha1Hex

تابع شا۱ شانزدهی(data: رشته): رشته
چکیده‌ی SHA-1 به شکل شانزدهی. SHA-1 هم برای امنیت دیگر کافی نیست؛ برای امضا SHA-256 را به کار ببرید.

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

شا۱ پایه۶۴ Sha1Base64

تابع شا۱ پایه۶۴(data: رشته): رشته
چکیده‌ی SHA-1 به شکل بیس۶۴؛ مثلاً برای دست‌دهی وب‌سوکت.

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

شا۱ بایت Sha1Bytes

تابع شا۱ بایت(p: تهی*، n: صحیح، out: تهی*)
چکیده‌ی SHA-1، ۲۰ بایت، را در خروجی می‌نویسد.

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