.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "CAFF 1" .TH CAFF 1 2024-07-13 "perl v5.38.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" caff \- ابزار خودکار امضای کلید و ارسال با ایمیل (CA \- Fire and Forget) .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" .IP "\fBcaff\fR [\-eERS] [\-m \fIyes|ask\-yes|ask\-no|no\fR] [\-u \fIyourkeyid\fR] \fIkeyid\fR [\fIkeyid\fR ..]" 4 .IX Item "caff [-eERS] [-m yes|ask-yes|ask-no|no] [-u yourkeyid] keyid [keyid ..]" .PD 0 .IP "\fBcaff\fR [\-eERS] [\-m \fIyes|ask\-yes|ask\-no|no\fR] [\-u \fIyourkeyid\fR] [\fIkeyid\fR ..] <\fI/path/to/ksp\-annotated.txt\fR" 4 .IX Item "caff [-eERS] [-m yes|ask-yes|ask-no|no] [-u yourkeyid] [keyid ..] \*(Aqbold bright_red\*(Aq \& , warn => \*(Aqbright_red\*(Aq \& , notice => \*(Aqbold\*(Aq \& , info => \*(Aq\*(Aq \& , success => \*(Aqgreen\*(Aq # used in combination with \*(Aqnotice\*(Aq and \*(Aqinfo\*(Aq \& , fail => \*(Aqyellow\*(Aq # used in combination with \*(Aqnotice\*(Aq and \*(Aqinfo\*(Aq \& } .Ve .SS "تنظیمات GnuPG (GnuPG settings)" .IX Subsection "GnuPG settings" .IP "\fBgpg\fR [string]" 4 .IX Item "gpg [string]" مسیر فایل اجرایی GnuPG. پیش‌فرض: مقدار متغیر محیطی \fIGNUPGBIN\fR در صورت تنظیم، در غیر این صورت \f(CW\*(C`gpg\*(C'\fR. .IP "\fBsecret-keyring\fR [string]" 4 .IX Item "secret-keyring [string]" مسیر جاکلیدی مخفی (secret keyring) شما (GnuPG < 2.1)، یا مسیر GnuPGHOME کارگزاری که داده‌های کلید مخفی را مدیریت می‌کند (GnuPG >= 2.1). پیش‌فرض: \fR\f(CB$HOME\fR\fB/.gnupg/secring.gpg\fR. اگر در نسخه GnuPG >= 2.1 این مقدار یک دایرکتوری نباشد، دایرکتوری والد (یعنی به‌طور پیش‌فرض \fB\fR\f(CB$HOME\fR\fB/.gnupg\fR) در نظر گرفته می‌شود. .IP "\fBalso-encrypt-to\fR [keyid, or list of keyids]" 4 .IX Item "also-encrypt-to [keyid, or list of keyids]" شناسه‌های کلید (keyid) اضافی برای رمزگذاری پیام‌ها با آن‌ها. پیش‌فرض: none. .IP "\fBgpg-sign-type\fR [string]" 4 .IX Item "gpg-sign-type [string]" پیشوند دستور "sign" که برای ایجاد امضا از پوسته gpg استفاده می‌شود. می‌تواند به ترکیبی از "l" (محلی / local)، "nr" (غیرقابل‌ابطال / non-revocable) یا "t" (مورد اعتماد / trust) برای ایجاد امضایی از نوع مشخص‌شده تنظیم شود. برای جزئیات به \fBgpg\fR\|(1) مراجعه کنید. پیش‌فرض: "" (یعنی ایجاد یک امضای معمولی و قابل‌صدور). .IP "\fBgpg-sign-args\fR [string]" 4 .IX Item "gpg-sign-args [string]" دستورهای اضافی برای ارسال به gpg پس از دستور "sign". پیش‌فرض: none. .SS "تنظیمات وارد کردن کلید (Key import settings)" .IX Subsection "Key import settings" .IP "\fBno-download\fR [boolean]" 4 .IX Item "no-download [boolean]" اگر درست (true) باشد، از مرحله دریافت کلیدها از کارگزار کلید (keyserver) صرف‌نظر می‌شود. پیش‌فرض: \fB0\fR. .IP "\fBkey-files\fR [list of files]" 4 .IX Item "key-files [list of files]" فهرستی از فایل‌های حاوی کلیدها برای وارد کردن (import). .SS "تنظیمات امضا (Signing settings)" .IX Subsection "Signing settings" .IP "\fBno-sign\fR [boolean]" 4 .IX Item "no-sign [boolean]" اگر درست (true) باشد، از مرحله امضا صرف‌نظر می‌شود. پیش‌فرض: \fB0\fR. .IP "\fBask-sign\fR [boolean]" 4 .IX Item "ask-sign [boolean]" اگر درست (true) باشد، پیش از ادامه به مرحله امضا مکث می‌کند. این ویژگی برای امضای آفلاین مفید است. پیش‌فرض: \fB0\fR. .IP "\fBexport-sig-age\fR [seconds]" 4 .IX Item "export-sig-age [seconds]" شناسه‌های کاربری (UIDs) که آخرین امضای شما روی آن‌ها قدیمی‌تر از این مدت‌زمان باشد، به‌طور پیش‌فرض صادر نشوند. پیش‌فرض: \fB24*60*60\fR (یعنی یک روز). .IP "\fBlocal-user\fR [keyid, or list of keyids]" 4 .IX Item "local-user [keyid, or list of keyids]" در صورتی که بیش از یک کلید دارید، کلیدی را که برای امضا کردن استفاده می‌شود انتخاب کنید. در صورت وجود چندین keyid، به‌نوبت با هر کلید امضا خواهد شد. .IP "\fBalso-lsign-in-gnupghome\fR [auto|ask|no]" 4 .IX Item "also-lsign-in-gnupghome [auto|ask|no]" مشخص می‌کند که آیا علاوه بر امضاهای caff در GnuPGHOME اختصاصی خودش، UIDها در GnuPGHOME کاربر نیز به‌صورت محلی امضا شوند یا خیر. چنین امضاهایی غیرقابل‌صدور (non-exportable) هستند. این ویژگی زمانی مفید است که گیرنده فراموش کند امضاهای ارسالی caff را بارگذاری کند (یا در صورتی که آن‌ها نیز غیرقابل‌صدور باشند)، زیرا راهی برای پیگیری UIDهای تأییدشده فراهم می‌آورد. با این حال، توجه داشته باشید که با بارگذاری امضا توسط گیرنده و به‌روزرسانی دسته‌کلید توسط امضاکننده، امضاهای محلی حذف نخواهند شد. .Sp اگر مقدار \fIno\fR نباشد و \fBgpg-sign-type\fR شامل "l" باشد، هر امضای (محلی) صرفاً از GnuPGHOME خود caff به GnuPGHOME کاربر صادر می‌شود. در غیر این صورت، اگر مقدار \fIauto\fR باشد، هر UID که در GnuPGHOME اختصاصی caff امضا شده است، به‌طور خودکار در GnuPGHOME کاربر نیز با همان سطح گواهی (certification level) به‌صورت محلی امضا می‌شود؛ این کار نیازمند یک \fBgpg\-agent\fR\|(1) فعال است. اگر \&\fIask\fR باشد، از کاربر پرسیده می‌شود که کدام UIDها به‌صورت محلی امضا شوند. پیش‌فرض: \&\fBno\fR. .IP "\fBshow-photos\fR [boolean]" 4 .IX Item "show-photos [boolean]" اگر درست (true) باشد، gpg پیش از امضای یک کلید، عکس‌های پیوست‌شده به آن را (در صورت وجود) نمایش می‌دهد. (برنامه مشاهده عکس را می‌توان با گزینه "photo-viewer" در GnuPGHOME برنامه caff مشخص کرد.) پیش‌فرض: \fB0\fR..SS "تنظیمات ایمیل (Mail settings)" .IX Subsection "Mail settings" .IP "\fBmail\fR [yes|ask\-yes|ask\-no|no]" 4 .IX Item "mail [yes|ask-yes|ask-no|no]" مشخص می‌کند که آیا ایمیل‌ها ارسال شوند یا خیر. این یک گزینه چهارحالته است که با آن می‌توانید رفتار برنامه را تعیین کنید: yes همیشه ارسال می‌کند، no هرگز ارسال نمی‌کند؛ ask-yes و ask-no برای هر uid سؤال می‌پرسند، همراه با پیش‌فرض‌های مربوطه برای پرسش. پیش‌فرض: \fBask-yes\fR. .Sp در هر صورت، پیام‌ها در \f(CW$CONFIG\fR{'caffhome'}/keys/ نیز نوشته می‌شوند. .IP "\fBmail-cant-encrypt\fR [yes|ask\-yes|ask\-no|no]" 4 .IX Item "mail-cant-encrypt [yes|ask-yes|ask-no|no]" مقدار این گزینه به جای \fBmail\fR برای کلیدهای گیرنده‌ای که قابلیت رمزنگاری ندارند لحاظ می‌شود. پیش‌فرض آن مقدار \&\fBmail\fR است. .IP "\fBmail-subject\fR [string]" 4 .IX Item "mail-subject [string]" مقدار فیلد سرآیند «Subject:» را تنظیم می‌کند. \f(CW%k\fR به شناسه کلید طولانی کلید امضاشده بسط می‌یابد. پیش‌فرض: \f(CW\*(C`Your signed PGP key 0x%k\*(C'\fR. .IP "\fBmail-template\fR [string]" 4 .IX Item "mail-template [string]" قالب ایمیلی که در صورت تعیین شدن، به جای متن پیش‌فرض به عنوان متن بدنه ایمیل ارسالی استفاده می‌شود. متغیرهای perl زیر می‌توانند در قالب استفاده شوند: .RS 4 .IP "\fB{owner}\fR [string]" 4 .IX Item "{owner} [string]" نام شما همان‌گونه که در تنظیمات \fBowner\fR مشخص شده است. .IP "\fB{key}\fR [string]" 4 .IX Item "{key} [string]" شناسه کلید (keyid) کلیدی که امضا کرده‌اید. .IP "\fB{@uids}\fR [array]" 4 .IX Item "{@uids} [array]" شناسه‌های کاربری (UIDs) که امضاهای آن‌ها در ایمیل گنجانده شده است. .RE .RS 4 .Sp توجه داشته باشید که اگر قصد ارسال امضاهای غیرقابل صدور (یعنی اگر \fBgpg-sign-type\fR شامل «l» باشد) را دارید، احتمالاً باید قالب را سفارشی‌سازی کنید؛ زیرا بارگذاری چنین امضاهایی بی‌معنی است و به گزینه درون‌ریزی «import-local-sigs» نیاز دارند که به صورت پیش‌فرض تنظیم نشده است. .RE .IP "\fBreply-to\fR [string]" 4 .IX Item "reply-to [string]" افزودن یک سرآیند Reply-To: به پیام‌های ارسالی. پیش‌فرض: هیچ (none). .IP "\fBbcc\fR [string]" 4 .IX Item "bcc [string]" نشانی برای ارسال رونوشت پنهان (BCC) در هنگام ارسال ایمیل. پیش‌فرض: هیچ (none). .IP "\fBmailer-send\fR [array]" 4 .IX Item "mailer-send [array]" پارامترهایی برای ارسال به Mail::Mailer. پیش‌فرض: هیچ (none). تنظیم این گزینه شدیداً منع می‌شود: به جای آن MTA محلی خود را رفع ایراد کنید. .Sp برای مثال این می‌تواند به این صورت باشد: .Sp .Vb 1 \& $CONFIG{\*(Aqmailer\-send\*(Aq} = [ \*(Aqsmtp\*(Aq, Server => \*(Aqmail.server\*(Aq, Auth => [\*(Aquser\*(Aq, \*(Aqpass\*(Aq] ]; .Ve .Sp برای استفاده از کلاینت SMTP پرل، یا .Sp .Vb 1 \& $CONFIG{\*(Aqmailer\-send\*(Aq} = [ \*(Aqsendmail\*(Aq, \*(Aq\-f\*(Aq, $CONFIG{\*(Aqemail\*(Aq}, \*(Aq\-it\*(Aq ]; .Ve .Sp برای فرستادن آرگومان‌ها به برنامه sendmail. برای مشخص کردن باینری sendmail می‌توانید متغیر محیطی \f(CW\*(C`PERL_MAILERS\*(C'\fR را به صورت زیر تنظیم کنید: .Sp .Vb 1 \& $ENV{\*(AqPERL_MAILERS\*(Aq} = \*(Aqsendmail:/path/to/sendmail_compatible_mta\*(Aq; .Ve .Sp برای اطلاعات بیشتر \fBMail::Mailer\fR\|(3pm) را ببینید. .SH "نکات (NOTES)" .IX Header "NOTES" همان‌طور که در بالا اشاره شد، caff از GnuPGHOME و فایل پیکربندی GnuPG مخصوص به خود استفاده می‌کند. در واقع تنها برای کارهای امضا به جاکلیدی (keyring) اختصاصی خود نیاز دارد، اما استفاده مجدد از همان فایل پیکربندی GnuPG ناامن خواهد بود؛ زیرا کاربر ممکن است گزینه‌ای را در \f(CW$HOME\fR/.gnupg/gpg.conf تنظیم کرده باشد که کارکرد caff را مختل سازد. .PP بنابراین گزینه‌های GnuPG که برای استفاده همراه با caff در نظر گرفته شده‌اند، مانند \f(CW\*(C`keyserver\*(C'\fR یا \f(CW\*(C`cert\-digest\-algo\*(C'\fR، باید به جای آن در \&\f(CW$HOME\fR/.caff/gnupghome/gpg.conf قرار داده شوند. اگر این فایل وجود نداشته باشد، گزینه‌های GnuPG موجود در \f(CW$HOME\fR/.gnupg/gpg.conf که ایمن (و مفید) بودن آن‌ها برای caff مشخص است، به عنوان گزینه‌های خط فرمان به \fBgpg\fR\|(1) ارسال می‌شوند..SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" .IP "Peter Palfrader " 4 .IX Item "Peter Palfrader " .PD 0 .IP "Christoph Berg " 4 .IX Item "Christoph Berg " .IP "Guilhem Moulin " 4 .IX Item "Guilhem Moulin " .PD .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBgpg\fR\|(1), \fBpgp\-clean\fR\|(1), /usr/share/doc/signing\-party/caff/