'\" t
.\"     Title: ykpamcfg
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: Version 2.27
.\"    Manual: Yubico PAM Module Manual
.\"    Source: yubico-pam
.\"  Language: Persian
.\"
.TH "YKPAMCFG" "1" "Version 2\&.27" "yubico\-pam" "Yubico PAM Module Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
ykpamcfg \- مدیریت تنظیمات کاربر برای ماژول Yubico PAM
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBykpamcfg\fR [\-1 | \-2] [\-A] [\-p] [\-i] [\-v] [\-V] [\-h]
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-1\fR
.RS 4
استفاده از slot 1\&. این حالت پیش‌فرض است\&.
.RE
.PP
\fB\-2\fR
.RS 4
استفاده از slot 2\&.
.RE
.PP
\fB\-A\fR \fIaction\fR
.RS 4
انتخاب عملیات برای اجرا\&. بخش عملیات‌ها (ACTIONS) را در ادامه ببینید\&.
.RE
.PP
\fB\-p\fR \fIpath\fR
.RS 4
تعیین فایل خروجی، پیش‌فرض
~/\&.yubico/challenge است\&.
.RE
.PP
\fB\-i\fR \fIiterations\fR
.RS 4
تعداد تکرارها (iterations) برای استفاده در PBKDF2 مربوط به پاسخ مورد انتظار\&.
.RE
.PP
\fB\-v\fR
.RS 4
فعال‌سازی حالت پرگو (verbose)\&.
.RE
.PP
\fB\-V\fR
.RS 4
نمایش نسخه و خروج\&.
.RE
.PP
\fB\-h\fR
.RS 4
نمایش راهنما و خروج\&.
.RE
.SH "عملیات‌ها (ACTIONS)"
.SS "add_hmac_chalresp"
.sp
ماژول PAM می‌تواند از حالت چالش\-پاسخ (Challenge\-response یا C/R) مبتنی بر HMAC\-SHA1 که در YubiKeyها از نسخه 2\&.2 به بعد موجود است برای \fBاحراز هویت آفلاین\fR استفاده کند\&. این عملیات اطلاعات وضعیت اولیه را به همراه C/R که باید در ورود بعدی صادر شود ایجاد می‌کند\&.
.sp
این ابزار در حال حاضر اطلاعات وضعیت را در فایلی درون دایرکتوری خانگی کاربر جاری ذخیره می‌کند (~/\&.yubico/challenge\-123456 برای یک YubiKey با قابلیت خواندن شماره سریال از طریق API فعال، و ~/\&.yubico/challenge برای دستگاه فاقد آن)\&.
.sp
ماژول PAM از یک دایرکتوری سراسری سیستم برای این فایل‌های وضعیت پشتیبانی می‌کند (در صورتی که دایرکتوری خانگی کاربر رمزنگاری شده باشد)، اما در یک دایرکتوری سراسری سیستم، بخش \fIchallenge\fR باید با نام کاربری جایگزین شود\&. مثال: /var/yubico/challenges/alice\-123456
.sp
برای استفاده از حالت سراسری سیستم، در حال حاضر باید فایل‌های وضعیت ایجاد شده را به صورت دستی منتقل کرده و ماژول PAM را بر همان اساس پیکربندی کنید\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
ابتدا، یک YubiKey را برای چالش\-پاسخ روی slot 2 برنامه‌ریزی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ ykpersonalize \-2 \-ochal\-resp \-ochal\-hmac \-ohmac\-lt64 \-oserial\-api\-visible
\&.\&.\&.
Commit? (y/n) [n]: y
.fi
.if n \{\
.RE
.\}
.sp
اکنون، کاربر جاری را طوری تنظیم کنید که برای ورود به این YubiKey نیاز داشته باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ ykpamcfg \-2 \-v
\&.\&.\&.
Stored initial challenge and expected response in \*(Aq/home/alice/\&.yubico/challenge\-123456\*(Aq\&.
.fi
.if n \{\
.RE
.\}
.sp
سپس، احراز هویت با PAM را به عنوان مثال به این صورت پیکربندی کنید (\fIابتدا یک نسخه پشتیبان تهیه کنید\fR):
.sp
\fI/etc/pam\&.d/common\-auth\fR (از اوبونتو 10\&.10):
.sp
.if n \{\
.RS 4
.\}
.nf
auth  required        pam_unix\&.so nullok_secure try_first_pass
auth  [success=1 new_authtok_reqd=ok ignore=ignore default=die] pam_yubico\&.so mode=challenge\-response
auth  requisite       pam_deny\&.so
auth  required        pam_permit\&.so
auth  optional        pam_ecryptfs\&.so unwrap
.fi
.if n \{\
.RE
.\}
.SH "گزارش باگ‌ها (BUGS)"
.sp
گزارش باگ‌های ykpamcfg در سامانه ردیابی اشکالات: https://github\&.com/Yubico/yubico\-pam/issues
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBpam_yubico\fR(8)
.sp
صفحه خانگی yubico\-pam: https://developers\&.yubico\&.com/yubico\-pam
.sp
دستگاه‌های YubiKey را می‌توان از Yubico تهیه کرد: http://www\&.yubico\&.com