'\" t
.\"     Title: ykchalresp
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net>
.\"      Date: Version 1.19.1
.\"    Manual: YubiKey Personalization Tool Manual
.\"    Source: ykchalresp
.\"  Language: English
.\"
.TH "YKCHALRESP" "1" "Version 1\&.19\&.1" "ykchalresp" "YubiKey Personalization Tool M"
.\" -----------------------------------------------------------------
.\" * 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)"
ykchalresp \- اجرای عملیات چالش\-پاسخ با YubiKey
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBykchalresp\fR [\fI\-nkey\fR] [\fI\-1\fR | \fI\-2\fR] [\fI\-H\fR | \fI\-Y\fR] [\fI\-N\fR] [\fI\-x\fR] [\fI\-v\fR] [\fI\-6\fR | \fI\-8\fR] [\fI\-t\fR] [\fI\-iFILE\fR] [\fI\-V\fR] [\fI\-h\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
ارسال یک چالش (challenge) به یک YubiKey و خواندن پاسخ (response)\&. دستگاه YubiKey می‌تواند با دو حالت C/R مختلف پیکربندی شود \(em حالت استاندارد یک HMAC\-SHA1 به طول ۱۶۰ بیت است، و حالت دیگر حالت شبیه‌ساز YubiKey OTP است، به این معنی که دو فراخوانی متوالی با همان چالش به پاسخ‌های متفاوتی منجر خواهد شد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-nkey\fR
.RS 4
ارسال چالش به n\-اُمین کلید یافت‌شده\&.
.RE
.PP
\fB\-1\fR
.RS 4
ارسال چالش به اسلات ۱\&. این حالت پیش‌فرض است\&.
.RE
.PP
\fB\-2\fR
.RS 4
ارسال چالش به اسلات ۲\&.
.RE
.PP
\fB\-H\fR
.RS 4
ارسال یک چالش ۶۴ بایتی HMAC\&. این حالت پیش‌فرض است\&.
.RE
.PP
\fB\-Y\fR
.RS 4
ارسال یک چالش ۶ بایتی Yubico OTP\&.
.RE
.PP
\fB\-N\fR
.RS 4
حالت غیرمسدودکننده (non\-blocking) \(em اگر YubiKey به‌گونه‌ای پیکربندی شده باشد که پیش از ارسال پاسخ نیاز به فشردن کلید داشته باشد، عملیات لغو می‌شود\&.
.RE
.PP
\fB\-x\fR
.RS 4
چالش به‌صورت هگزادسیمال (hex) کدگذاری شده است\&.
.RE
.PP
\fB\-v\fR
.RS 4
فعال کردن حالت پرگو (verbose)\&.
.RE
.PP
\fB\-6\fR
.RS 4
خروجی دادن پاسخ در قالب OATH، به صورت ۶ رقمی\&.
.RE
.PP
\fB\-8\fR
.RS 4
خروجی دادن پاسخ در قالب OATH، به صورت ۸ رقمی\&.
.RE
.PP
\fB\-t\fR
.RS 4
استفاده از زمان فعلی به عنوان چالش به جای خواندن چالش از خط فرمان (مشابه حالت پیش‌فرض TOTP، ثانیه‌های سپری‌شده از 00:00:00 1970\-01\-01 تقسیم بر ۳۰ که به عنوان یک چالش ۸ بایتی کدگذاری شده است)\&.
.RE
.PP
\fB\-i\fR\fIFILE\fR
.RS 4
دریافت چالش از FILE به جای آرگومان\&. اگر فایل \- باشد، چالش از STDIN خوانده می‌شود\&.
.RE
.PP
\fB\-V\fR
.RS 4
نمایش نسخه ابزار و خروج\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
عملیات چالش\-پاسخ YubiKey را می‌توان با استفاده از بردار آزمون \fBNIST PUB 198 A\&.2\fR نشان داد\&.
.sp
ابتدا، یک YubiKey را با بردار آزمون برنامه‌ریزی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ ykpersonalize \-2 \-ochal\-resp \-ochal\-hmac \-ohmac\-lt64 \-a303132333435363738393a3b3c3d3e3f40414243
 \&.\&.\&.
Commit? (y/n) [n]: y
$
.fi
.if n \{\
.RE
.\}
.sp
اکنون، چالش آزمون NIST را به YubiKey ارسال کرده و بررسی کنید که نتیجه با مقدار مورد انتظار مطابقت دارد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ ykchalresp \-2 \*(AqSample #2\*(Aq
0922d3405faa3d194f82a45830737d5cc6c75d24
$
.fi
.if n \{\
.RE
.\}
.SH "اشکالات (BUGS)"
.sp
گزارش اشکالات ykchalresp در ردیاب مسائل:
https://github\&.com/Yubico/yubikey\-personalization/issues
.SH "همچنین ببینید (SEE ALSO)"
.sp
صفحه خانگی ykpersonalize:
https://developers\&.yubico\&.com/yubikey\-personalization
.sp
دستگاه‌های YubiKey را می‌توان از Yubico تهیه کرد:
http://www\&.yubico\&.com