.\" paperkey manpage copyright (C) 2007, 2012, 2013 Peter Palfrader .\" Examples have been taken from David Shaw's README. .\" .\" This document is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This document is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program; if not, write to the Free Software .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, .\" MA 02110-1301 USA .\" .\" .\" paperkey, the software, is written and .\" copyright 2007, 2008 David Shaw .TH PAPERKEY 1 "June 2012" "PAPERKEY" .SH "نام (NAME)" paperkey \- استخراج اطلاعات محرمانه از کلیدهای محرمانه OpenPGP .SH "خلاصه دستور (SYNOPSIS)" .B paperkey\fR [\fB\-\-secret\-key=\fR\fIFILE\fR] [\fB\-\-output=\fR\fIFILE\fR] [\fB\-\-output\-type=\fR\fBbase16\fR|\fBraw\fR] [\fB\-\-output\-width=\fR\fIWIDTH\fR] .LP .B paperkey\fR \fB\-\-pubring=\fR\fIFILE\fR [\fB\-\-secrets=\fR\fIFILE\fR] [\fB\-\-input\-type=\fR\fBauto\fR|\fBbase16\fR|\fBraw\fR] [\fB\-\-output=\fR\fIFILE\fR] [\fB\-\-ignore\-crc\-error\fR] [\fB\-\-comment=\fR\fISTRING\fR] [\fB\-\-file\-format\fR] .LP .B paperkey\fR \fB\-\-version\fR .SH "انگیزه (MOTIVATION)" همانند تمام داده‌ها، باید از کلیدهای محرمانه نیز نسخه پشتیبان تهیه کرد. در واقع، پشتیبان‌گیری از کلیدهای محرمانه حتی از سایر داده‌ها نیز بااهمیت‌تر است، چرا که در صورت مفقود شدن، بازتولید آن‌ها غیرممکن خواهد بود. تمام فایل‌هایی که با کلیدهای گم‌شده رمزگذاری شده‌اند برای همیشه (یا دست‌کم برای مدتی بسیار طولانی) غیرقابل رمزگشایی باقی می‌مانند. افزون بر نگهداری نسخه‌های پشتیبان از اطلاعات کلید محرمانه بر روی رسانه‌های دیجیتال مانند حافظه‌های فلش USB یا CDها، عاقلانه است که یک نسخه «آخرین چاره» نیز بر روی کاغذهای معمولی نگهداری شود تا در صورت غیرقابل خواندن شدن رسانه‌های دیجیتال به هر دلیلی، بتوان از آن بهره برد. کاغذ در صورت نگهداری مناسب می‌تواند اطلاعات را برای چندین دهه یا حتی بیشتر حفظ کند. .PP در GnuPG، PGP یا سایر پیاده‌سازی‌های OpenPGP، کلید محرمانه معمولاً شامل اطلاعاتی بسیار فراتر از تنها اعداد محرمانه مهم است. آن‌ها همچنین تمام مقادیر عمومی جفت‌کلیدها، شناسه‌های کاربری (user IDs)، تاریخ‌های انقضا و موارد دیگر را نگهداری می‌کنند. به منظور به حداقل رساندن اطلاعاتی که باید به صورت دستی یا با کمک OCR، کدهای QR یا نرم‌افزارهای مشابه وارد شوند، \fBpaperkey\fR تنها اطلاعات محرمانه را از کلیدهای محرمانه OpenPGP استخراج می‌کند. برای بازیابی کلید محرمانه فرض بر این است که کلید عمومی همچنان در دسترس است؛ برای نمونه از طریق کارگزارهای کلید عمومی اینترنت (keyservers). .SH "توضیحات (DESCRIPTION)" دستور \fBpaperkey\fR دو حالت کاری دارد: .PP حالت نخست با استخراج تنها بخش محرمانه از یک کلید محرمانه، «کلیدهای کاغذی» ایجاد می‌کند و داده‌ها را به شکلی مناسب برای چاپ، یا در حالت خام (raw) برای پردازش‌های بعدی قالب‌بندی می‌نماید. .PP حالت دیگر، کلیدهای محرمانه را از روی چنین کلید کاغذی و یک نسخه از کلید عمومی بازسازی می‌کند و همچنین مجموع مقابله‌ای‌های (checksums) موجود در کلید کاغذی را اعتبارسنجی می‌نماید. این حالت با به‌کارگیری گزینه \fB\-\-pubring\fR فعال می‌شود که در این وضعیت استفاده از آن الزامی است. اگر روی کلید محرمانه اصلی یک عبارت عبور (passphrase) تنظیم شده باشد، همان عبارت عبور بر روی کلید بازسازی‌شده نیز قرار خواهد گرفت. .PP ورودی از ورودی استاندارد (standard\-in) خوانده می‌شود، مگر زمانی که از گزینه‌های \fB\-\-secret\-key\fR یا \fB\-\-secrets\fR استفاده شود؛ خروجی نیز در خروجی استاندارد (standard\-out) چاپ می‌شود، مگر آنکه با گزینه \fB\-\-output\fR تغییر یابد. .SH "ملاحظات امنیتی (SECURITY CONSIDERATIONS)" لطفاً توجه داشته باشید که \fBpaperkey\fR وضعیت حفاظت و رمزگذاری و همچنین الزامات امنیتی نگهداری کلید محرمانه شما را تغییر نمی‌دهد. اگر کلید محرمانه توسط عبارت عبور محافظت شده باشد، کلید کاغذی نیز محافظت‌شده خواهد بود. اگر کلید محرمانه بدون محافظت باشد، کلید کاغذی نیز محافظت نخواهد شد. .SH "گزینه‌ها (OPTIONS)" \fB\-\-help\fR, \fB\-h\fR نمایش یک پیام راهنمای کوتاه و خروج موفقیت‌آمیز. .LP .TP \fB\-\-version\fR, \fB\-V\fR چاپ اطلاعات نسخه و حق رونوشت و خروج موفقیت‌آمیز. .LP .TP \fB\-\-verbose\fR, \fB\-v\fR چاپ اطلاعات وضعیت و پیشرفت کار در خطای استاندارد هنگام پردازش ورودی. تکرار این گزینه خروجی‌های تفصیلی‌تری تولید می‌کند. .LP .TP \fB\-\-output=\fR\fIFILE\fR, \fB\-o\fR هدایت خروجی به فایل مشخص‌شده به جای چاپ در خروجی استاندارد. .LP .TP \fB\-\-comment=\fR\fISTRING\fR گنجاندن توضیح مشخص‌شده در خروجی base16. .LP .TP \fB\-\-file\-format\fR ابزار paperkey به طور خودکار قالب فایلی را که استفاده می‌کند، به عنوان توضیح در ابتدای خروجی base16 درج می‌نماید. این دستور صرفاً این قالب فایل را چاپ کرده و با موفقیت خارج می‌شود. .SH "گزینه‌های استخراج اطلاعات محرمانه (OPTIONS FOR EXTRACTING SECRET INFORMATION)" .TP \fB\-\-output\-type=base16\fR, \fB\-\-output\-type=raw\fR انتخاب نوع خروجی. سبک base16 اطلاعات را به شیوه یک hex-dump کلاسیک، شامل شماره خطوط و مجموع مقابله‌ای CRC در هر خط کدگذاری می‌کند تا خطایابی در فایل ورودی در طول مرحله بازیابی آسان‌تر شود. حالت خام یا باینری (raw) صرفاً یک نسخه تخلیه‌شده از اطلاعات محرمانه است که برای ارسال به تولیدکننده‌های بارکد یا ابزارهای مشابه در نظر گرفته شده است. .LP .TP \fB\-\-output\-width=\fR\fIWIDTH\fR تعیین عرض خط در حالت خروجی base16. مقدار پیش‌فرض ۷۸ نویسه است. .LP .TP \fB\-\-secret\-key=\fR\fIFILE\fR فایلی که کلید محرمانه از آن خوانده می‌شود. اگر این گزینه ارائه نشود، \fBpaperkey\fR از ورودی استاندارد داده‌ها را می‌خواند. .SH "گزینه‌های بازسازی کلیدهای خصوصی (OPTIONS FOR RE-CREATING PRIVATE KEYS)" .TP \fB\-\-input\-type=auto\fR, \fB\-\-input\-type=base16\fR, \fB\-\-input\-type=raw\fR مشخص می‌کند که ورودی داده‌شده در قالب base16 (تولیدشده توسط \fBpaperkey\fR) است یا در قالب raw. مقدار پیش‌فرض (auto) تلاش می‌کند تا قالب مورد استفاده را به طور خودکار تشخیص دهد. .LP .TP \fB\-\-pubring=\fR\fIFILE\fR فایلی که اطلاعات کلید عمومی از آن خوانده می‌شود. فرض بر این است که کاربر می‌تواند کلید عمومی را از منابعی مانند کارگزارهای کلید عمومی اینترنت دریافت کند. .LP .TP \fB\-\-secrets=\fR\fIFILE\fR فایلی که اطلاعات محرمانه استخراج‌شده (کلید کاغذی) از آن خوانده می‌شود. در صورت عدم تعیین، اطلاعات از ورودی استاندارد خوانده خواهد شد. .LP .TP \fB\-\-ignore\-crc\-error\fR رد نکردن ورودی‌های خراب و ادامه عملیات علی‌رغم وجود هرگونه خطای CRC. .SH "مثال‌ها (EXAMPLES)" دریافت کلید محرمانه از key.gpg و تولید فایل متنی to\-be\-printed.txt که حاوی داده‌های محرمانه است: .PP .B $ paperkey \-\-secret\-key my\-secret\-key.gpg \-\-output to\-be\-printed.txt .PP دریافت داده‌های کلید محرمانه از my\-key\-text\-file.txt و ترکیب آن با my\-public\-key.gpg برای بازسازی my\-secret\-key.gpg: .PP .B $ paperkey \-\-pubring my\-public\-key.gpg \-\-secrets my\-key\-text\-file.txt \-\-output my\-secret\-key.gpg .PP اگر گزینه \-\-output مشخص نشود، خروجی به خروجی استاندارد (stdout) ارسال می‌شود. اگر گزینه \-\-secret\-key مشخص نشود، داده‌ها از ورودی استاندارد (stdin) خوانده می‌شوند؛ بنابراین می‌توانید دستوراتی مانند زیر را اجرا کنید: .PP .B $ gpg \-\-export\-secret\-key my\-key | paperkey | lpr .SH "همچنین ببینید (SEE ALSO)" .BR gpg (1), .BR http://www.jabberwocky.com/software/paperkey .SH "نویسندگان (AUTHORS)" ابزار \fBpaperkey\fR توسط David Shaw نوشته شده است.