نام (NAME)

scrypt — رمزنگاری و رمزگشایی فایل‌ها

خلاصه دستور (SYNOPSIS)

scrypt {enc | dec | info} [-f] [--logN value] [-M maxmem] [-m maxmemfrac] [-P] [-p value] [--passphrase method:arg] [-r value] [-t maxtime] [-v] infile [outfile] scrypt --version

توضیحات (DESCRIPTION)

scrypt enc فایل infile را رمزنگاری کرده و در صورت مشخص بودن، نتیجه را در outfile و در غیر این صورت در خروجی استاندارد می‌نویسد. از کاربر خواسته می‌شود یک عبارت عبور را (دو بار) وارد کند تا برای تولید کلید رمزنگاری مشتق‌شده استفاده شود.

scrypt dec فایل infile را رمزگشایی کرده و در صورت مشخص بودن، نتیجه را در outfile و در غیر این صورت در خروجی استاندارد می‌نویسد. از کاربر خواسته می‌شود عبارت عبوری که در زمان رمزنگاری برای تولید کلید رمزنگاری مشتق‌شده استفاده شده بود را وارد کند.

scrypt info اطلاعات مربوط به پارامترهای رمزنگاری استفاده‌شده برای infile را ارائه می‌دهد.

مگر اینکه از طریق --passphrase به‌گونه دیگری مشخص شده باشد، scrypt عبارت‌های عبور را از ترمینال کنترل‌کننده خود، یا در صورت عدم موفقیت، از ورودی استاندارد (stdin) می‌خواند. اعلان‌ها تنها زمانی چاپ می‌شوند که scrypt در حال خواندن عبارت عبور از یک ترمینال باشد.

گزینه‌ها (OPTIONS)

-f

اجرای عملیات را اجبار می‌کند حتی اگر پیش‌بینی شود که به مقدار بیش از حدی از حافظه یا زمان پردازنده (CPU) نیاز دارد. هیچ هشداری درباره فراتر رفتن از محدودیت‌های حافظه یا زمان پردازنده چاپ نمی‌شود.

--logN value

پارامتر کاری N را روی 2^value تنظیم می‌کند. اگر --logN تنظیم شده باشد، -r و -p نیز باید تنظیم شوند. در صورت ارائه چنین پارامترهای صریحی، محدودیت‌های منابع تعیین‌شده توسط -M, -m و -t اعمال نمی‌شوند.

-M maxmem

حداکثر از maxmem بایت حافظه RAM برای محاسبه کلید رمزنگاری مشتق‌شده استفاده می‌کند.

-m maxmemfrac

حداکثر از کسر maxmemfrac از حافظه RAM موجود برای محاسبه کلید رمزنگاری مشتق‌شده استفاده می‌کند. حداکثر مقدار ممکن برای maxmemfrac برابر 0.5 است.

-P

مترادف منسوخ‌شده برای --passphrase dev:stdin-once.

-p value

پارامتر کاری p را روی value تنظیم می‌کند. اگر -p تنظیم شده باشد، --logN و -r نیز باید تنظیم شوند. در صورت ارائه چنین پارامترهای صریحی، محدودیت‌های منابع تعیین‌شده توسط -M, -m و -t اعمال نمی‌شوند.

--passphrase method:arg

عبارت عبور را با استفاده از روش مشخص‌شده می‌خواند.

dev:tty-stdin

تلاش می‌کند عبارت عبور را از dev/tty/ بخواند؛ اگر موفق نشد، آن را از ورودی استاندارد (stdin) می‌خواند. این رفتار پیش‌فرض است.

dev:stdin-once

تلاش می‌کند عبارت عبور را از ورودی استاندارد (stdin) بخواند، و این کار را حتی هنگام رمزنگاری تنها یک بار انجام می‌دهد. اگر infile نیز ورودی استاندارد (یا '-') باشد، نمی‌توان از این گزینه استفاده کرد.

dev:tty-once

تلاش می‌کند عبارت عبور را از dev/tty/ بخواند، و این کار را حتی هنگام رمزنگاری تنها یک بار انجام می‌دهد.

env:VAR

عبارت عبور را از متغیر محیطی مشخص‌شده توسط VAR می‌خواند.

ذخیره عبارت عبور در یک متغیر محیطی ممکن است یک خطر امنیتی باشد.

تنها در صورتی از این گزینه استفاده کنید که کاملاً مطمئن باشید چه کاری انجام می‌دهید.

file:FILENAME

عبارت عبور را از فایل مشخص‌شده توسط FILENAME می‌خواند.

ذخیره عبارت عبور در یک فایل ممکن است یک خطر امنیتی باشد.

تنها در صورتی از این گزینه استفاده کنید که کاملاً مطمئن باشید چه کاری انجام می‌دهید.

-r value

پارامتر کاری r را روی value تنظیم می‌کند. اگر -r تنظیم شده باشد، --logN و -p نیز باید تنظیم شوند. در صورت ارائه چنین پارامترهای صریحی، محدودیت‌های منابع تعیین‌شده توسط -M, -m و -t اعمال نمی‌شوند.

-t maxtime

حداکثر از maxtime ثانیه زمان پردازنده (CPU) برای محاسبه کلید رمزنگاری مشتق‌شده استفاده می‌کند.

-v

پارامترهای رمزنگاری (N, r, p) و محدودیت‌های حافظه/پردازنده را چاپ می‌کند.

--version

نسخه scrypt را چاپ کرده و خارج می‌شود.

در scrypt enc, محدودیت‌های حافظه و زمان پردازنده با انتخاب پارامترهای مناسب برای تابع اشتقاق کلید scrypt اعمال می‌شوند. در scrypt dec, محدودیت‌های حافظه و زمان پردازنده با خروج همراه با خطا در صورتی که رمزگشایی فایل به حافظه یا زمان پردازنده بسیار زیادی نیاز داشته باشد، اعمال می‌گردند.

وضعیت خروج (EXIT STATUS)

ابزار scrypt در صورت موفقیت با وضعیت 0 و در صورت بروز خطا با مقداری بزرگتر از 0 خارج می‌شود.

توجه داشته باشید که اگر فایل رمزنگاری‌شده ورودی معیوب باشد، scrypt dec ممکن است پیش از تشخیص معیوب بودن ورودی و خروج با وضعیت غیر صفر، خروجی تولید کند؛ بنابراین کاربران باید خروجی را به مکانی امن هدایت کرده و پیش از استفاده از داده‌های رمزگشایی‌شده، وضعیت خروج scrypt را بررسی نمایند.

پارامترهای الگوریتم (ALGORITHM PARAMETERS)

الگوریتم scrypt دارای سه پارامتر کاری قابل تنظیم است: N, r, p. هنگام رمزگشایی، scrypt همواره از مقادیر مشخص‌شده در هدر رمزنگاری استفاده خواهد کرد. هنگام رمزنگاری، scrypt مقادیر مناسب را بر اساس سرعت و حافظه سیستم شما (تحت تأثیر -M, -m و/یا -t) انتخاب می‌کند، مگر اینکه پارامترهای صریح را از طریق --logN, -p, -r مشخص نمایید.

همچنین ببینید (SEE ALSO)

Colin Percival, Stronger Key Derivation via Sequential Memory-Hard Functions, BSDCan'09, May 2009. Colin Percival and Simon Josefsson, The scrypt Password-Based Key Derivation Function, IETF RFC 7914, August 2016.

تاریخچه (HISTORY)

ابزار scrypt در مه ۲۰۰۹ توسط Colin Percival به عنوان نمایشی از تابع اشتقاق کلید scrypt نوشته شد. تابع اشتقاق کلید scrypt در مارس ۲۰۰۹ توسط Colin Percival ابداع شد تا امکان محافظت از فایل‌های کلید سیستم پشتیبان‌گیری Tarsnap با یک عبارت عبور فراهم گردد.