رمزنگاری 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، یک نمک تصادفی و کلید به دست آمده. چون نمک هر بار تازه است، دو کاربر با گذرواژهی یکسان دو رشتهی متفاوت میگیرند و جدولی که لو برود با یک فهرست از پیش ساخته شکسته نمیشود. هنگام ورود، تایید گذرواژه شمار دورها و نمک را از همان رشتهی ذخیره شده میخواند؛ پس جز همین رشته چیزی لازم نیست نگه دارید.
واردسازی رمزنگاری
واردسازی رشته
ساختار کاربر:
همگانی اسم: رشته = ""
همگانی درهم: رشته = ""
پایان
تابع ثبت کاربر(کاربران &: وکتور<کاربر>، اسم: رشته، گذرواژه: رشته):
کاربران.بیفزا(کاربر { اسم = اسم، درهم = رمزنگاری.درهم گذرواژه(گذرواژه) })
پایان
تابع احراز هویت(کاربران: وکتور<کاربر>، اسم: رشته، گذرواژه: رشته): منطقی:
هر ک در کاربران:
اگر ک.اسم برابر اسم:
برگشت رمزنگاری.تایید گذرواژه(گذرواژه، ک.درهم)
پایان
پایان
برگشت نادرست
پایان
تابع ریشه:
ناپایا کاربران := وکتور {} برگردان وکتور<کاربر>
ثبت کاربر(کاربران، "سارا"، "correct horse battery")
ثبت کاربر(کاربران، "امید"، "correct horse battery")
بخشها := رشته.تفکیک کردن(کاربران.بگیر(۰).درهم، "$")
سرچاپ "شمار بخشها:"، بخشها.طول()، "الگوریتم:"، بخشها.بگیر(۰)، "دور:"، بخشها.بگیر(۱)
سرچاپ "گذرواژهی یکسان، درهم یکسان؟"، کاربران.بگیر(۰).درهم برابر کاربران.بگیر(۱).درهم
سرچاپ "سارا با گذرواژهی درست:"، احراز هویت(کاربران، "سارا"، "correct horse battery")
سرچاپ "سارا با گذرواژهی نادرست:"، احراز هویت(کاربران، "سارا"، "correct horse")
سرچاپ "کاربر ناشناس:"، احراز هویت(کاربران، "هیچکس"، "x")
پایانبرای «کاربر نادرست» و «گذرواژهی نادرست» یک پیام یکسان نشان دهید تا کسی نتواند با فرم ورود بفهمد کدام حسابها وجود دارند.
دورهای بیشتر و ارتقای درهمهای قدیمی
هزینهی درهم گذرواژه تعداد دورهای آن است: هر حدسی که مهاجم امتحان میکند به اندازهی یک ورود کار میبرد. پی بی کِی دی اف۲ شانزدهی تعداد دور را میگیرد، پس درهم قویتر همان رشتهی چهار بخشی درهم گذرواژه است که با ۶۰۰٬۰۰۰ دور دستی ساخته میشود. کاربران فعلی لازم نیست کاری بکنند. در ورود موفق بعدی، برنامه میبیند درهم ذخیرهشده دور کمتری از هدف دارد و درهم تازهای از همان گذرواژهای که کاربر وارد کرده ذخیره میکند.
واردسازی رمزنگاری
واردسازی رشته
پایا دورها := ۶۰۰۰۰۰
تابع درهم قوی(گذرواژه: رشته): رشته:
نمک := رمزنگاری.تصادفی ایمن شانزدهی(۱۶)
برگشت "pbkdf2-sha256$" + دورها + "$" + نمک + "$" + رمزنگاری.پی بی کِی دی اف۲ شانزدهی(گذرواژه، نمک، دورها، ۳۲)
پایان
تابع دورهای(ذخیره: رشته): صحیح:
برگشت رشته.تفکیک کردن(ذخیره، "$").دریافت(۱).به صحیح()
پایان
تابع ورود(ذخیره &: رشته، گذرواژه: رشته): منطقی:
اگر وارونه رمزنگاری.تایید گذرواژه(گذرواژه، ذخیره): برگشت نادرست پایان
اگر دورهای(ذخیره) کوچکتر دورها:
ذخیره = درهم قوی(گذرواژه)
سرچاپ " درهم ذخیرهشده به"، دورهای(ذخیره)، "دور ارتقا یافت"
پایان
برگشت درست
پایان
تابع ریشه:
ناپایا ذخیره := رمزنگاری.درهم گذرواژه("چای ساعت پنج")
سرچاپ "درهم گذرواژه"، دورهای(ذخیره)، "دور به کار میبرد"
سرچاپ "ورود:"، ورود(ذخیره، "چای ساعت پنج")
سرچاپ "ورود دوباره:"، ورود(ذخیره، "چای ساعت پنج")
سرچاپ "گذرواژهی نادرست:"، ورود(ذخیره، "قهوه ساعت شش")
پایانششصد هزار دور کسر محسوسی از یک ثانیه طول میکشد، که هدف همین است، ولی یعنی نقطهی ورود باید محدودیت نرخ داشته باشد، وگرنه تلاشهای موازی زیاد سرور را مشغول نگه میدارند.
بررسی امضای وبهوک
درگاههای پرداخت، گیتهاب و بیشتر سرویسها درخواستهایی را که برایتان میفرستند امضا میکنند: با رازی که هر دو طرف میدانید از بدنهی خام یک HMAC میسازند و در یک سرآیند میگذارند. برای بررسی، همان HMAC را روی بدنه، درست همانطور که رسیده، حساب کنید و دو مقدار را مقایسه کنید. مقایسه را با برابری راز انجام دهید، نه با برابر: مقایسهی معمولی در نخستین نویسهی متفاوت میایستد و زمانی که میبرد به مهاجم میگوید چه مقدار از امضای جعلیاش درست بوده است.
واردسازی رمزنگاری
تابع بررسی امضا(راز: رشته، بدنه: رشته، سرآیند: رشته): منطقی:
مورد انتظار := "sha256=" + رمزنگاری.اچ مک شا۲۵۶ شانزدهی(راز، بدنه)
برگشت رمزنگاری.برابری راز(مورد انتظار، سرآیند)
پایان
تابع ریشه:
راز := "whsec_4f9a1c"
بدنه := "{\"event\":\"order.paid\",\"id\":1042}"
سرآیند := "sha256=" + رمزنگاری.اچ مک شا۲۵۶ شانزدهی(راز، بدنه)
سرچاپ "امضا: " + سرآیند
سرچاپ "درخواست اصلی:"، بررسی امضا(راز، بدنه، سرآیند)
سرچاپ "بدنهی دستخورده:"، بررسی امضا(راز، "{\"event\":\"order.paid\",\"id\":9999}"، سرآیند)
سرچاپ "راز اشتباه:"، بررسی امضا("guess"، بدنه، سرآیند)
پایانبایتهایی را که دریافت کردهاید امضا کنید، نه نسخهای که یک بار خوانده و دوباره ساختهاید: کتابخانهی JSON ممکن است ترتیب کلیدها یا فاصلهها را عوض کند و آن وقت امضا دیگر نمیخواند.
چکیدهی دادههای بزرگ
شا۲۵۶ شانزدهی همهی متن را یکجا میخواهد. برای فایل یا دانلودی که تکه تکه میرسد، یک وضعیت در حال اجرا نگه دارید: شا۲۵۶ جدید آن را میسازد، به روز رسانی شا۲۵۶ هر تکه را به آن میدهد و نهایی شا۲۵۶ چکیدهی ۳۲ بایتی را مینویسد. همانطور که برنامه نشان میدهد، نتیجه با درهم کردن یکجای همهی داده یکی است.
واردسازی رمزنگاری
واردسازی کدگذاری
واردسازی حافظه
تابع ریشه:
تکهها := ["first block of the file, "، "second block, "، "and the last one."]
ناپایا همه := ""
ناپایا ح := رمزنگاری.شا۲۵۶ جدید()
هر تکه در تکهها:
رمزنگاری.به روز رسانی شا۲۵۶(ح، تکه برگردان تهی*، تکه.طول())
همه += تکه
پایان
خروجی := حافظه.تخصیص(۳۲ برگردان طبیعی۶۴)
رمزنگاری.نهایی شا۲۵۶(ح، خروجی)
تکه به تکه := کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۳۲)
رمزنگاری.شا۲۵۶ بایت(همه برگردان تهی*، همه.طول()، خروجی)
یکجا := کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۳۲)
حافظه.آزادسازی(خروجی)
سرچاپ "تکه به تکه: " + تکه به تکه
سرچاپ "یکجا: " + یکجا
سرچاپ "یکسان:"، تکه به تکه برابر یکجا
سرچاپ "شکل شانزدهی: " + رمزنگاری.شا۲۵۶ شانزدهی(همه)
پایانتابعهای ... بایت و نهایی ... بایتهای خام را در حافظهای که خودتان گرفتهاید مینویسند؛ برای تبدیل آنها به متن از کدگذاری بایتها پایه۶۴ در بستهی کدگذاری استفاده کنید. وضعیتهای SHA-512 و SHA-384 هم با شا۵۱۲ جدید، شا۳۸۴ جدید، به روز رسانی شا۵۱۲ و نهایی شا۵۱۲ همینطور کار میکنند.
کلید API و توکن
کلید API، پیوند بازنشانی گذرواژه یا شناسهی نشست نباید حدس زدنی باشد؛ پس آن را با توکن تصادفی ایمن بسازید که از منبع تصادفی امن سیستم عامل میخواند. توکن تصادفی ایمن(n) تعداد n بایت تصادفی را به شکل 2n نویسهی شانزدهی برمیگرداند. فقط چکیدهی SHA-256 کلید را ذخیره کنید: پایگاه دادهی دزدیده شده هیچ کلید کارآمدی به دست نمیدهد و بررسی کلیدی که با درخواست میآید فقط یک چکیده و یک برابری راز است. اینجا چکیدهی ساده کافی است چون کلید بلند و تصادفی است؛ گذرواژه کوتاه است و آدمها انتخابش میکنند و برای همین به درهم گذرواژه نیاز دارد.
واردسازی رمزنگاری
تابع ریشه:
کلید := "sk_" + رمزنگاری.توکن تصادفی ایمن(۲۴)
سرچاپ "طول کلید:"، کلید.طول()
ذخیره شده := رمزنگاری.شا۲۵۶ شانزدهی(کلید)
سرچاپ "طول چکیدهی ذخیره شده:"، ذخیره شده.طول()
سرچاپ "کلید درست پذیرفته شد:"، رمزنگاری.برابری راز(رمزنگاری.شا۲۵۶ شانزدهی(کلید)، ذخیره شده)
سرچاپ "کلید جعلی پذیرفته شد:"، رمزنگاری.برابری راز(رمزنگاری.شا۲۵۶ شانزدهی("sk_" + رمزنگاری.توکن تصادفی ایمن(۲۴))، ذخیره شده)
سرچاپ "دو کلید متفاوتاند:"، رمزنگاری.توکن تصادفی ایمن(۲۴) نابرابر رمزنگاری.توکن تصادفی ایمن(۲۴)
پایانکدام تابع برای کدام کار
| کار | تابع |
|---|---|
| نگهداری و بررسی گذرواژهی کاربر | درهم گذرواژه، تایید گذرواژه |
| امضای پیام یا بررسی درخواست امضا شده | اچ مک شا۲۵۶ شانزدهی و برابری راز |
| چکیدهی فایل یا شناسهی محتوا | شا۲۵۶ شانزدهی، یا برای دادهی تکه تکه شا۲۵۶ جدید، به روز رسانی شا۲۵۶ و نهایی شا۲۵۶ |
| توکن، کلید یا عدد یکبار مصرف | توکن تصادفی ایمن، تصادفی ایمن شانزدهی، بایت های تصادفی |
| کلید ساخته شده از یک عبارت عبور | پی بی کِی دی اف۲ شانزدهی |
| کلید جدول درهمسازی، نه برای امنیت | درهم رشته، درهم بایت، درهم عدد |
| کار با سامانهی قدیمی که MD5 یا SHA-1 میخواهد | ام دی۵ شانزدهی، شا۱ شانزدهی؛ برای کار تازه به کارشان نبرید |
برای توکنهای امضا شده که ادعاها را با خود میبرند jwt را ببینید و برای رمزگذاری tls را.
گونهها
شا۲۵۶ Sha256
ساختار شا۲۵۶| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| وضعیت | h | طبیعی۳۲[] | وضعیت درونی. |
| بلوک | blk | طبیعی۸[] | بلوک ناقص. |
| طول بلوک | blen | صحیح = 0 | طول بلوک ناقص. |
| مجموع | total | طبیعی۶۴ = 0 | شمار کل بایتها. |
واردسازی رمزنگاری
واردسازی کدگذاری
واردسازی حافظه
تابع ریشه:
سرچاپ رمزنگاری.شا۲۵۶ شانزدهی("abc")
سرچاپ رمزنگاری.شا۵۱۲ شانزدهی("abc").طول()
سرچاپ رمزنگاری.شا۱ شانزدهی("abc")
سرچاپ رمزنگاری.شا۱ پایه۶۴("abc")
سرچاپ رمزنگاری.ام دی۵ شانزدهی("abc")
متن := "abc"
خروجی := حافظه.تخصیص(۶۴ برگردان طبیعی۶۴)
رمزنگاری.شا۲۵۶ بایت(متن برگردان تهی*، ۳، خروجی)
سرچاپ کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۳۲)
رمزنگاری.شا۳۸۴ بایت(متن برگردان تهی*، ۳، خروجی)
سرچاپ کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۴۸)
رمزنگاری.شا۵۱۲ بایت(متن برگردان تهی*، ۳، خروجی)
سرچاپ کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۱۶).طول()
رمزنگاری.شا۱ بایت(متن برگردان تهی*، ۳، خروجی)
سرچاپ کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۲۰)
رمزنگاری.ام دی۵ بایت(متن برگردان تهی*، ۳، خروجی)
سرچاپ کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۱۶)
ناپایا ح := رمزنگاری.شا۲۵۶ جدید()
رمزنگاری.به روز رسانی شا۲۵۶(ح، "a" برگردان تهی*، ۱)
رمزنگاری.به روز رسانی شا۲۵۶(ح، "bc" برگردان تهی*، ۲)
رمزنگاری.نهایی شا۲۵۶(ح، خروجی)
سرچاپ کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۳۲)
ناپایا ب := رمزنگاری.شا۵۱۲ جدید()
رمزنگاری.به روز رسانی شا۵۱۲(ب، متن برگردان تهی*، ۳)
رمزنگاری.نهایی شا۵۱۲(ب، خروجی)
سرچاپ ب.طول چکیده
ناپایا س := رمزنگاری.شا۳۸۴ جدید()
رمزنگاری.به روز رسانی شا۵۱۲(س، متن برگردان تهی*، ۳)
رمزنگاری.نهایی شا۵۱۲(س، خروجی)
سرچاپ س.طول چکیده، کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۴۸)
حافظه.آزادسازی(خروجی)
سرچاپ رمزنگاری.درهم رشته("سلام") == رمزنگاری.درهم رشته("سلام")، رمزنگاری.درهم رشته("a") != رمزنگاری.درهم رشته("b")
سرچاپ رمزنگاری.درهم بایت(متن برگردان تهی*، ۳ برگردان طبیعی۶۴) == رمزنگاری.درهم رشته("abc")
سرچاپ رمزنگاری.درهم عدد(۴۲ برگردان طبیعی۶۴) != رمزنگاری.درهم عدد(۴۳ برگردان طبیعی۶۴)
پایانشا۵۱۲ Sha512
ساختار شا۵۱۲| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| وضعیت | 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: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
ام دی۵ شانزدهی Md5Hex
تابع ام دی۵ شانزدهی(data: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
اچ مک شا۱ خام HmacSha1Raw
تابع اچ مک شا۱ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)واردسازی رمزنگاری
واردسازی کدگذاری
واردسازی حافظه
تابع ریشه:
کلید := "key"
پیام := "The quick brown fox jumps over the lazy dog"
سرچاپ رمزنگاری.اچ مک شا۲۵۶ شانزدهی(کلید، پیام)
سرچاپ رمزنگاری.اچ مک شا۱ شانزدهی(کلید، پیام)
سرچاپ رمزنگاری.اچ مک شا۱ بیس۶۴(کلید، پیام)
سرچاپ رمزنگاری.اچ مک شا۳۸۴ شانزدهی(کلید، پیام).طول()، رمزنگاری.اچ مک شا۵۱۲ شانزدهی(کلید، پیام).طول()
خروجی := حافظه.تخصیص(۶۴ برگردان طبیعی۶۴)
رمزنگاری.اچ مک شا۲۵۶ بایت(کلید، پیام، خروجی)
الف := کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۳۲)
رمزنگاری.اچ مک شا۲۵۶ خام(کلید برگردان تهی*، ۳، پیام برگردان تهی*، پیام.طول()، خروجی)
سرچاپ الف == کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۳۲)
رمزنگاری.اچ مک شا۱ بایتی(کلید، پیام، خروجی)
ب := کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۲۰)
رمزنگاری.اچ مک شا۱ خام(کلید برگردان تهی*، ۳، پیام برگردان تهی*، پیام.طول()، خروجی)
سرچاپ ب == کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۲۰)، ب == رمزنگاری.اچ مک شا۱ بیس۶۴(کلید، پیام)
رمزنگاری.اچ مک شا۳۸۴ بایت(کلید، پیام، خروجی)
ج := کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۴۸)
رمزنگاری.اچ مک شا۳۸۴ خام(کلید برگردان تهی*، ۳، پیام برگردان تهی*، پیام.طول()، خروجی)
سرچاپ ج == کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۴۸)
رمزنگاری.اچ مک شا۵۱۲ بایت(کلید، پیام، خروجی)
د := کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۶۴)
رمزنگاری.اچ مک شا۵۱۲ خام(کلید برگردان تهی*، ۳، پیام برگردان تهی*، پیام.طول()، خروجی)
سرچاپ د == کدگذاری.کدگذاری بایتها پایه۶۴(خروجی، ۶۴)
حافظه.آزادسازی(خروجی)
پایاناچ مک شا۱ بایتی HmacSha1Bytes
تابع اچ مک شا۱ بایتی(key: رشته، msg: رشته، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۱ شانزدهی HmacSha1Hex
تابع اچ مک شا۱ شانزدهی(key: رشته، msg: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۱ بیس۶۴ HmacSha1Base64
تابع اچ مک شا۱ بیس۶۴(key: رشته، msg: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
شا۲۵۶ شانزدهی Sha256Hex
تابع شا۲۵۶ شانزدهی(data: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
اچ مک شا۲۵۶ خام HmacSha256Raw
تابع اچ مک شا۲۵۶ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۳۸۴ خام HmacSha384Raw
تابع اچ مک شا۳۸۴ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۵۱۲ خام HmacSha512Raw
تابع اچ مک شا۵۱۲ خام(key: تهی*، klen: صحیح، msg: تهی*، mlen: صحیح، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۲۵۶ بایت HmacSha256Bytes
تابع اچ مک شا۲۵۶ بایت(key: رشته، msg: رشته، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۳۸۴ بایت HmacSha384Bytes
تابع اچ مک شا۳۸۴ بایت(key: رشته، msg: رشته، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۵۱۲ بایت HmacSha512Bytes
تابع اچ مک شا۵۱۲ بایت(key: رشته، msg: رشته، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۳۸۴ شانزدهی HmacSha384Hex
تابع اچ مک شا۳۸۴ شانزدهی(key: رشته، msg: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۵۱۲ شانزدهی HmacSha512Hex
تابع اچ مک شا۵۱۲ شانزدهی(key: رشته، msg: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
اچ مک شا۲۵۶ شانزدهی HmacSha256Hex
تابع اچ مک شا۲۵۶ شانزدهی(key: رشته، msg: رشته): رشتهاچ مک شا۲۵۶ خام را به کار ببرید.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hmac.salam
درهم بی کریپت با نمک BcryptHashWithSalt
تابع درهم بی کریپت با نمک(password: رشته، cost: صحیح، salt: تهی*): رشتهدرهم بی کریپت، اما به جای نمک تصادفی، نمک ۱۶ بایتی خودتان را از یک اشارهگر میگیرد، پس ورودی یکسان همیشه همان رشته را میدهد؛ برای آزمون و پاسخهای شناختهشده، نه برای نگهداری گذرواژههای واقعی.واردسازی رمزنگاری
واردسازی حافظه
واردسازی رشته
تابع ریشه:
ذخیره := رمزنگاری.درهم بی کریپت("s3cret-پسورد"، ۱۰)
سرچاپ رشته.شروع با(ذخیره، "$2y$10$")، ذخیره.طول()
سرچاپ رمزنگاری.درهم بی کریپت است(ذخیره)، رمزنگاری.هزینه بی کریپت(ذخیره)
سرچاپ رمزنگاری.تایید بی کریپت("s3cret-پسورد"، ذخیره)، رمزنگاری.تایید بی کریپت("wrong"، ذخیره)
سرچاپ ذخیره نابرابر رمزنگاری.درهم بی کریپت("s3cret-پسورد"، ۱۰)
نمک := حافظه.تخصیص(۱۶ برگردان طبیعی۶۴)
بایتها := نمک برگردان طبیعی۸*
تکرار ۱۶ در ی:
بایتها[ی] = (ی * ۷) برگردان طبیعی۸
پایان
ثابت := رمزنگاری.درهم بی کریپت با نمک("s3cret-پسورد"، ۴، نمک)
سرچاپ ثابت
سرچاپ ثابت برابر رمزنگاری.درهم بی کریپت با نمک("s3cret-پسورد"، ۴، نمک)
حافظه.آزادسازی(نمک)
سرچاپ رمزنگاری.تایید بی کریپت("U*U"، "$2a$05$CCCCCCCCCCCCCCCCCCCCC.E5YPO9kmyuRGyh0XouQYb4YMJKvyOeW")
سرچاپ رمزنگاری.درهم بی کریپت است("pbkdf2-sha256$1000$aa$bb")، رمزنگاری.هزینه بی کریپت("هش نیست")
پایاندرهم بی کریپت BcryptHash
تابع درهم بی کریپت(password: رشته، cost: صحیح): رشته$2y$هزینه$نمک+درهم را برمیگرداند، همان قالبی که password_hash در PHP مینویسد. هزینه لگاریتم پایهی ۲ تعداد دورهاست: هر یک واحد افزایش کار را دو برابر میکند؛ ۱۰ انتخاب رایجی است و مقدار میان ۴ و ۳۱ نگه داشته میشود. فقط ۷۲ بایت نخست گذرواژه به حساب میآید.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Bcrypt.salam
درهم بی کریپت است IsBcryptHash
تابع درهم بی کریپت است(encoded: رشته): منطقی$2a$، $2b$ یا $2y$ شروع میشود. وقتی پایگاه داده هم درهم bcrypt و هم رشتهی درهم گذرواژه دارد به کار میآید.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Bcrypt.salam
هزینه بی کریپت BcryptCost
تابع هزینه بی کریپت(encoded: رشته): صحیح$2y$10$...؛ اگر رشته درهم bcrypt نباشد -1. آن را با هزینهی هدف خود مقایسه کنید تا بدانید کی باید گذرواژه را دوباره درهم کرد.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Bcrypt.salam
تایید بی کریپت BcryptVerify
تابع تایید بی کریپت(password: رشته، encoded: رشته): منطقی$2a$، $2b$ یا $2y$، با همان هزینه و نمکی که در آن است، در زمان ثابت میسنجد؛ درهمهای ساختهشده با PHP و دیگر کتابخانههای bcrypt هم پذیرفته میشوند. برای هر قالب دیگری نادرست است.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Bcrypt.salam
تصادفی ایمن شانزدهی RandomHex
تابع تصادفی ایمن شانزدهی(n: صحیح): رشتهواردسازی رمزنگاری
واردسازی رشته
واردسازی حافظه
تابع ریشه:
ذخیره := رمزنگاری.درهم گذرواژه("s3cret-پسورد")
سرچاپ رشته.شروع با(ذخیره، "pbkdf2-sha256$")
سرچاپ رمزنگاری.تایید گذرواژه("s3cret-پسورد"، ذخیره)، رمزنگاری.تایید گذرواژه("wrong"، ذخیره)
سرچاپ ذخیره != رمزنگاری.درهم گذرواژه("s3cret-پسورد")
سرچاپ رمزنگاری.پی بی کِی دی اف۲ شانزدهی("password"، "salt"، ۱، ۳۲)
سرچاپ رمزنگاری.برابری راز("abc"، "abc")، رمزنگاری.برابری راز("abc"، "xyz")
سرچاپ رمزنگاری.تصادفی ایمن شانزدهی(۱۶).طول()، رمزنگاری.توکن تصادفی ایمن(۳۲).طول() > ۰
ب := حافظه.تخصیص(۸ برگردان طبیعی۶۴)
رمزنگاری.بایت های تصادفی(ب، ۸)
حافظه.آزادسازی(ب)
پایانتوکن تصادفی ایمن RandomToken
تابع توکن تصادفی ایمن(n: صحیح): رشتهتصادفی ایمن شانزدهی)؛ برای توکن نشست و بازیابی گذرواژه.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Password.salam
بایت های تصادفی RandomBytes
تابع بایت های تصادفی(p: تهی*، n: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Password.salam
شا۵۱۲ شانزدهی Sha512Hex
تابع شا۵۱۲ شانزدهی(data: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
شا۲۵۶ بایت Sha256Bytes
تابع شا۲۵۶ بایت(p: تهی*، n: صحیح، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
شا۳۸۴ بایت Sha384Bytes
تابع شا۳۸۴ بایت(p: تهی*، n: صحیح، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
شا۵۱۲ بایت Sha512Bytes
تابع شا۵۱۲ بایت(p: تهی*، n: صحیح، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
شا۲۵۶ جدید Sha256New
تابع شا۲۵۶ جدید(): شا۲۵۶نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
به روز رسانی شا۲۵۶ Sha256Update
تابع به روز رسانی شا۲۵۶(s &: شا۲۵۶، p: تهی*، n: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
نهایی شا۲۵۶ Sha256Final
تابع نهایی شا۲۵۶(s: شا۲۵۶، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
شا۳۸۴ جدید Sha384New
تابع شا۳۸۴ جدید(): شا۵۱۲نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
شا۵۱۲ جدید Sha512New
تابع شا۵۱۲ جدید(): شا۵۱۲نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
به روز رسانی شا۵۱۲ Sha512Update
تابع به روز رسانی شا۵۱۲(s &: شا۵۱۲، p: تهی*، n: صحیح)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
نهایی شا۵۱۲ Sha512Final
تابع نهایی شا۵۱۲(s: شا۵۱۲، out: تهی*)outlen مینویسد.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
پی بی کِی دی اف۲ شانزدهی Pbkdf2HmacSha256Hex
تابع پی بی کِی دی اف۲ شانزدهی(password: رشته، salt: رشته، iterations: صحیح، keylen: صحیح): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Password.salam
درهم گذرواژه HashPassword
تابع درهم گذرواژه(password: رشته): رشتهpbkdf2-sha256$1000$نمک$درهم را برمیگرداند که در پایگاه داده نگه میدارید. هر بار خروجی فرق میکند. ۱۰۰۰ دور با معیارهای امروز کم است؛ برای درهم قویتر راهنما را ببینید.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Password.salam
تایید گذرواژه VerifyPassword
تابع تایید گذرواژه(password: رشته، encoded: رشته): منطقیpbkdf2-sha256$دور$نمک$درهم، با همان دور و نمکی که در آن است، در زمان ثابت میسنجد. برای هر قالب دیگری نادرست است.نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Password.salam
برابری راز SecretEquals
تابع برابری راز(a: رشته، b: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Password.salam
شا۱ شانزدهی Sha1Hex
تابع شا۱ شانزدهی(data: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
شا۱ پایه۶۴ Sha1Base64
تابع شا۱ پایه۶۴(data: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam
شا۱ بایت Sha1Bytes
تابع شا۱ بایت(p: تهی*، n: صحیح، out: تهی*)نمونهی این مورد همراه با موارد بالاتر آمده است: crypto-Hash.salam