نام (NAME)

signify — امضا و اعتبارسنجی رمزنگارانهٔ فایل‌ها

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

signify -C [-q] [-p pubkey] [-t keytype] -x sigfile [file ...] signify -G [-n] [-c comment] -p pubkey -s seckey signify -S [-enz] [-x sigfile] -s seckey -m message signify -V [-eqz] [-p pubkey] [-t keytype] [-x sigfile] -m message

توضیحات (DESCRIPTION)

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

-C: یک فهرست مجموع مقابله‌ای (checksum) امضاشده را اعتبارسنجی کرده و سپس مجموع مقابله‌ای هر فایل را بررسی می‌کند. اگر هیچ فایلی مشخص نشود، همهٔ آن‌ها بررسی می‌شوند. sigfile باید خروجی امضاشدهٔ sha256(1) باشد.
-G: یک جفت‌کلید جدید تولید می‌کند. نام کلیدها باید به‌ترتیب برای کلیدهای عمومی و مخفی از قرارداد keyname.pub و keyname.sec پیروی کند.
-S: فایل پیام مشخص‌شده را امضا کرده و یک امضا ایجاد می‌کند.
-V: تطابق پیام و امضا را اعتبارسنجی می‌کند.

سایر گزینه‌ها به شرح زیر هستند:

-c comment: توضیحی (comment) را که باید در زمان تولید کلید اضافه شود مشخص می‌کند.
-e: هنگام امضا کردن، پیام را بعد از امضا جاسازی می‌کند. هنگام اعتبارسنجی، پیام را از امضا استخراج می‌کند. (این امر مستلزم آن است که امضا با استفاده از -e ایجاد شده باشد و یک فایل پیام جدید در خروجی ایجاد می‌کند.)
-m message: هنگام امضا کردن، فایلی است که حاوی پیام برای امضاست. هنگام اعتبارسنجی، فایلی است که حاوی پیام برای اعتبارسنجی است. هنگام اعتبارسنجی با -e -، فایلی است که باید ایجاد شود.
-n: هنگام تولید یک جفت‌کلید، عبارت عبور درخواست نمی‌شود. در غیر این صورت، signify از کاربر برای محافظت از کلید مخفی، عبارت عبور درخواست خواهد کرد. هنگام امضا کردن با -z -، یک برچسب زمانی صفر در سرآیندِ gzip(1) ذخیره می‌کند.
-p pubkey: کلید عمومی تولیدشده توسط -G که توسط -V برای بررسی یک امضا استفاده می‌شود.
-q: حالت بی‌صدا. از نمایش خروجی‌های اطلاعاتی جلوگیری می‌کند.
-s seckey: کلید مخفی (خصوصی) تولیدشده توسط -G که توسط -S برای امضای یک پیام استفاده می‌شود.
-t keytype: هنگام استنتاج کلید صحیح برای بررسی یک امضا، اطمینان حاصل می‌کند که کلید واقعی با /etc/signify/*-keytype.pub مطابقت داشته باشد.
-x sigfile: فایل امضا برای ایجاد یا اعتبارسنجی. پیش‌فرض message.sig است.
-z: امضا و اعتبارسنجی آرشیوهای gzip(1) ، که در آن داده‌های امضا در سرآیندِ gzip(1) جاسازی می‌شوند.

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

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

The signify utility exits 0 on success, and >0 if an error occurs. ممکن است به یکی از دلایل زیر ناموفق باشد:

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

مثال‌ها (EXAMPLES)

ایجاد یک جفت‌کلید جدید:

$ signify -G -p newkey.pub -s
  newkey.sec

امضای یک فایل، با تعیین نام امضا:

$ signify -S -s key.sec -m
  message.txt -x msg.sig

اعتبارسنجی یک امضا با استفاده از نام پیش‌فرض امضا:

$ signify -V -p key.pub -m
  generalsorders.txt

اعتبارسنجی یک دایرکتوری انتشار حاوی SHA256.sig و یک مجموعه کامل از فایل‌های انتشار:

$ signify -C -p /etc/signify/openbsd-80-base.pub -x SHA256.sig

اعتبارسنجی یک bsd.rd پیش از ارتقا:

$ signify -C -p /etc/signify/openbsd-80-base.pub -x SHA256.sig bsd.rd

امضای یک آرشیو gzip:

$ signify -Sz -s key-arc.sec -m in.tgz -x out.tgz

اعتبارسنجی یک خط لوله gzip:

$ ftp url | signify -Vz -t arc | tar ztf -

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

gzip(1), pkg_add(1), sha256(1), fw_update(8), sysupgrade(8)

تاریخچه (HISTORY)

دستور signify اولین بار در OpenBSD 5.5 ظاهر شد.

نویسندگان (AUTHORS)

Ted Unangst <tedu@openbsd.org> و Marc Espie <espie@openbsd.org>.