'\" t
.\"     Title: ykpersonalize
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net>
.\"      Date: Version 1.20.0
.\"    Manual: YubiKey Personalization Tool Manual
.\"    Source: ykpersonalize
.\"  Language: English
.\"
.TH "YKPERSONALIZE" "1" "Version 1\&.20\&.0" "ykpersonalize" "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)"
ykpersonalize \- شخصی‌سازی توکن‌های OTP در YubiKey
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBykpersonalize\fR [\fI\-Nkey\fR] [\fI\-1\fR | \fI\-2\fR] [\fI\-sfile\fR] [\fI\-ifile\fR] [\fI\-fformat\fR] [\fI\-axxx\fR] [\fI\-cxxx\fR] [\fI\-ooption\fR] [\fI\-y\fR] [\fI\-v\fR] [\fI\-d\fR] [\fI\-h\fR] [\fI\-n\fR] [\fI\-t\fR] [\fI\-u\fR] [\fI\-x\fR] [\fI\-z\fR] [\fI\-m\fR] [\fI\-S\fR] [\fI\-V\fR] [\fI\-Dxxx\fR_]
.SH "توضیحات (DESCRIPTION)"
.sp
تنظیم کلید AES، شناسه کاربری (user ID) و سایر تنظیمات در یک YubiKey\&. برای دریافت توضیحات کامل پیرامون مفهوم تمامی پارامترها، به دفترچه راهنمای مرجع مراجعه کنید: راهنمای YubiKey (https://www\&.yubico\&.com/wp\-content/uploads/2015/03/YubiKeyManual_v3\&.4\&.pdf)
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-Nkey\fR
.RS 4
استفاده از n\-امین YubiKey یافت‌شده\&.
.RE
.PP
\fB\-1\fR
.RS 4
تغییر پیکربندی نخست\&. این حالت پیش‌فرض بوده و معمولاً برای تولید OTP واقعی استفاده می‌شود\&. در این پیکربندی، پرچم گزینه‌ی
\fB\-oappend\-cr\fR
به‌طور پیش‌فرض تنظیم شده است\&.
.RE
.PP
\fB\-2\fR
.RS 4
تغییر پیکربندی دوم\&. این گزینه فقط برای YubiKey II است و معمولاً برای تولید کلید ایستا (static key) استفاده می‌شود\&. در این پیکربندی، پرچم‌های گزینه‌ی
\fB\-oappend\-cr\fR،
\fB\-ostatic\-ticket\fR،
\fB\-ostrong\-pw1\fR،
\fB\-ostrong\-pw2\fR
و
\fB\-oman\-update\fR
به‌طور پیش‌فرض تنظیم شده‌اند\&.
.RE
.PP
\fB\-z\fR
.RS 4
حذف پیکربندی در اسلات (slot) انتخاب‌شده\&.
.RE
.PP
\fB\-s\fR\fIfile\fR
.RS 4
ذخیره پیکربندی در فایل به‌جای کلید (اگر فایل \- باشد، به stdout ارسال می‌شود)\&.
.RE
.PP
\fB\-i\fR\fIfile\fR
.RS 4
خواندن پیکربندی از فایل (اگر فایل \- باشد، از stdin خوانده می‌شود)\&. وارد کردن پیکربندی فقط برای قالب ycfg معتبر است\&.
.RE
.PP
\fB\-f\fR\fIformat\fR
.RS 4
قالبی که باید با
\fB\-s\fR
و
\fB\-i\fR
استفاده شود\&. گزینه‌های معتبر عبارتند از
\fBycfg\fR
و
\fBlegacy\fR\&.
.RE
.PP
\fB\-a\fR[\fIxxx\fR]
.RS 4
کلید مخفی AES به‌صورت یک مقدار هگز ۳۲ نویسه‌ای (یا ۴۰ نویسه‌ای برای OATH\-HOTP/HMAC CHAL\-RESP) (نه modhex) (در صورت عدم تعیین، کلید از stdin درخواست می‌شود)\&. اگر از
\fB\-a\fR
استفاده نشود، یک کلید تصادفی تولید خواهد شد\&.
.RE
.PP
\fB\-c\fR[\fIxxx\fR]
.RS 4
یک مقدار هگز ۱۲ نویسه‌ای (نه modhex) برای استفاده به‌عنوان کد دسترسی جهت برنامه‌ریزی\&. نکته: این گزینه کد دسترسی را تنظیم نمی‌کند؛ این کار از طریق
\fB\-oaccess\fR\fI=\fR
انجام می‌شود\&. اگر هیچ آرگومانی داده نشود، کد از طریق stdin درخواست خواهد شد\&.
.RE
.PP
\fB\-o\fR\fIoption\fR
.RS 4
تغییر گزینه پیکربندی\&. آرگومان‌های ممکن برای گزینه عبارتند از:
.PP
\fBfixed\fR=\fIfffffffffff\fR
.RS 4
شناسه عمومی (\fIpublic identity\fR)
به صورت modhex برای YubiKey، به طول ۰ تا ۳۲ نویسه (کدگذاری تا ۱۶ بایت)\&. همچنین امکان تعیین شناسه به‌صورت هگز وجود دارد، کافی است پیشوند \(cqh:\(cq را به ابتدای مقدار بیفزایید\&. این بخش ثابت (fixed) با فشردن دکمه روی YubiKey پیش از OTP ارسال می‌شود\&. برای نمونه می‌تواند به‌عنوان یک شناسه برای کاربر استفاده شود\&.
.RE
.PP
\fBuid\fR[=\fIuuuuuu\fR]
.RS 4
بخش uid از OTP تولیدشده، که به آن
\fIشناسه خصوصی (private identity)\fR
نیز گفته می‌شود، در قالب هگز\&. باید ۱۲ نویسه باشد\&. این uid شامل ۶ بایت داده ایستا است که در هر OTP (به‌صورت رمزنگاری‌شده) گنجانده می‌شود و برای اعتبارسنجی اینکه OTP واقعاً با کلید AES مشترک میان YubiKey و سرویس اعتبارسنجی رمز شده است به‌کار می‌رود\&. از آنجا که این مقدار تنها برای دارندگان کلید AES قابل خواندن است، نمی‌توان از آن برای شناسایی YubiKey استفاده کرد\&. اگر آرگومانی ارائه نشود، uid از stdin درخواست می‌شود\&.
.RE
.PP
\fBaccess\fR[=\fIfffffffffff\fR]
.RS 4
کد دسترسی جدید به صورت هگز برای تنظیم\&. باید ۱۲ نویسه باشد\&. در صورت تنظیم یک کد دسترسی، برای برنامه‌ریزی‌های بعدی YubiKey الزامی خواهد بود\&. اگر آرگومانی ارائه نشود، کد از طریق stdin درخواست می‌شود\&.
.RE
.PP
\fBoath\-imf\fR=\fIxxx\fR
.RS 4
تنظیم OATH Initial Moving Factor\&. این مقدار شمارنده اولیه برای YubiKey است\&. این مقدار باید عددی بین 0 و 1048560 و بخش‌پذیر بر 16 باشد\&.
.RE
.PP
\fIticket\-flag\fR
.RS 4
تنظیم/پاک‌کردن پرچم بلیت (ticket flag)، به بخش
\fITicket Flags\fR
مراجعه کنید\&.
.RE
.PP
\fIconfiguration\-flag\fR
.RS 4
تنظیم/پاک‌کردن پرچم پیکربندی (configuration flag)، به بخش
\fIConfiguration flags\fR
مراجعه کنید\&.
.RE
.RE
.PP
\fB\-y\fR
.RS 4
اعمال همیشگی تغییرات بدون درخواست تأیید\&.
.RE
.PP
\fB\-d\fR
.RS 4
اجرای آزمایشی (dry\-run)، اجرا بدون نوشتن روی YubiKey\&.
.RE
.PP
\fB\-v\fR
.RS 4
ارائه جزئیات بیشتر (حالت پرگو)\&.
.RE
.PP
\fB\-h\fR
.RS 4
نمایش راهنما\&.
.RE
.PP
\fB\-V\fR
.RS 4
نمایش نسخه\&.
.RE.SS "تنها در YubiKey Neo"
.PP
\fB\-n\fR URI
.RS 4
برنامه‌ریزی URI برای NFC NDEF\&.
.RE
.PP
\fB\-t\fR text
.RS 4
برنامه‌ریزی متن NFC NDEF\&.
.RE
.SS "تنها در YubiKey 3 و 4"
.PP
\fB\-m\fR mode
.RS 4
تنظیم پیکربندی دستگاه برای YubiKey\&. این مقدار در قالب
\fImode:cr_timeout:autoeject_timeout\fR
تجزیه می‌شود که در آن mode یکی از موارد زیر است:
.PP
0
.RS 4
تنها دستگاه OTP\&.
.RE
.PP
1
.RS 4
تنها دستگاه CCID\&.
.RE
.PP
2
.RS 4
دستگاه ترکیبی OTP/CCID\&.
.RE
.PP
3
.RS 4
تنها دستگاه U2F\&.
.RE
.PP
4
.RS 4
دستگاه ترکیبی OTP/U2F\&.
.RE
.PP
5
.RS 4
دستگاه ترکیبی U2F/CCID\&.
.RE
.PP
6
.RS 4
دستگاه ترکیبی OTP/U2F/CCID\&. برای تنظیم MODE_FLAG_EJECT مقدار 80 را بیفزایید، برای نمونه: 81

cr_timeout مهلت زمانی برحسب ثانیه برای انتظار YubiKey جهت فشردن کلید برای پاسخ به چالش (challenge response) است (پیش‌فرض 15 است)

autoeject_timeout مهلت زمانی برحسب ثانیه پیش از خارج‌شدن خودکار کارت در حالت 81 است
.RE
.RE
.sp
حذف حالت OTP همچنین ارتباط بین ykpersonalize و YubiKey را غیرفعال می‌کند\&. تغییرات بعدی حالت باید با ykneomgr (برای حالت CCID) یا u2f\-host (برای حالت U2F) انجام شود\&.
.SS "YubiKey 3 و بالاتر"
.PP
\fB\-S\fR\fI0605\&...\fR
.RS 4
تنظیم scanmap برای استفاده با YubiKey\&. این مقدار باید 45 بایت یکتا در قالب 90 نویسه باشد\&. برای بازنشانی به مقدار پیش‌فرض YubiKey، آرگومان را خالی بگذارید\&. نقشه اسکن (scanmap) باید به این ترتیب فرستاده شود:
.sp
.if n \{\
.RS 4
.\}
.nf
cbdefghijklnrtuvCBDEFGHIJKLNRTUV0123456789!\et\er
.fi
.if n \{\
.RE
.\}
.sp
مقدار scanmap پیش‌فرض در YubiKey به این صورت است:
.sp
.if n \{\
.RS 4
.\}
.nf
06050708090a0b0c0d0e0f111517181986858788898a8b8c8d8e8f9195979899271e1f202122232425269e2b28
.fi
.if n \{\
.RE
.\}
.sp
یک مثال برای چیدمان ساده‌شده Dvorak ایالات متحده (U\&.S\&.):
.sp
.if n \{\
.RS 4
.\}
.nf
0c110b071c180d0a0619130f120e09378c918b879c988d8a8699938f928e89b7271e1f202122232425269e2b28
.fi
.if n \{\
.RE
.\}
.sp
یا برای یک صفحه‌کلید فرانسوی azerty (ارقام تبدیل‌شده/shifted هستند):
.sp
.if n \{\
.RS 4
.\}
.nf
06050708090a0b0c0d0e0f111517181986858788898a8b8c8d8e8f9195979899a79e9fa0a1a2a3a4a5a6382b28
.fi
.if n \{\
.RE
.\}
.sp
یا برای یک صفحه‌کلید فرانسوی BÉPO (چیدمان Dvorak فرانسوی):
.sp
.if n \{\
.RS 4
.\}
.nf
0b140c0938363707130512330f0d16188b948c89b8b6b787938592b38f8d9698a79e9fa0a1a2a3a4a5a69c2b28
.fi
.if n \{\
.RE
.\}
.sp
و یک مثال برای ترکی (به جای i معمولی، دارای ı بدون نقطه است):
.sp
.if n \{\
.RS 4
.\}
.nf
06050708090a0b340d0e0f111517181986858788898a8b8c8d8e8f9195979899271e1f202122232425269e2b28
.fi
.if n \{\
.RE
.\}
.sp
توجه داشته باشید که پیش از به‌کارگیری این مقادیر، باید هرگونه فاصله خالی (whitespace) موجود در این مثال‌ها را حذف کنید\&.
.RE.SS "YubiKey 5 و بالاتر"
.PP
\fB\-D\fR\fI0403\&...\fR
.RS 4
تنظیم deviceinfo برای استفاده با این YubiKey\&.
.RE
.SS "YubiKey 2\&.3 و بالاتر"
.PP
\fB\-u\fR
.RS 4
به‌روزرسانی پیکربندی موجود، به‌جای بازنویسی آن\&. این کار فقط در صورتی ممکن است که اسلات به‌صورت قابل به‌روزرسانی (updatable) پیکربندی شده باشد\&.
.RE
.PP
\fB\-x\fR
.RS 4
جابه‌جایی اسلات‌های پیکربندی ۱ و ۲ در داخل YubiKey\&. این کار فقط در صورتی ممکن است که هر دو اسلات به‌صورت قابل به‌روزرسانی (updatable) پیکربندی شده باشند\&.
.RE
.SH "پرچم‌های بلیت (TICKET FLAGS)"
.PP
\fBtab\-first\fR
.RS 4
ارسال یک نویسهٔ تب (tab) به عنوان نخستین نویسه\&. این گزینه معمولاً برای رفتن به فیلد ورودی بعدی استفاده می‌شود\&.
.RE
.PP
\fBappend\-tab1\fR
.RS 4
ارسال یک نویسهٔ تب (tab) میان بخش ثابت و بخش گذرواژهٔ یک‌بارمصرف\&. این گزینه زمانی کاربرد دارد که بخش ثابت برابر با نام کاربری باشد و دو فیلد ورودی داشته باشید که با تب میان آن‌ها جابه‌جا می‌شوید\&.
.RE
.PP
\fBappend\-tab2\fR
.RS 4
ارسال یک نویسهٔ تب (tab) به عنوان آخرین نویسه\&.
.RE
.PP
\fBappend\-delay1\fR
.RS 4
افزودن نیم ثانیه تاخیر پیش از ارسال بخش گذرواژهٔ یک‌بارمصرف\&. این گزینه تنها برای سفت‌افزارهای 1\&.x و 2\&.x معتبر است\&.
.RE
.PP
\fBappend\-delay2\fR
.RS 4
افزودن نیم ثانیه تاخیر پس از ارسال بخش گذرواژهٔ یک‌بارمصرف\&. این گزینه تنها برای سفت‌افزارهای 1\&.x و 2\&.x معتبر است\&.
.RE
.PP
\fBappend\-cr\fR
.RS 4
افزودن یک carriage return (نویسهٔ بازگشت به ابتدای سطر یا Enter) پس از ارسال بخش گذرواژهٔ یک‌بارمصرف\&.
.RE
.SS "سفت‌افزار YubiKey 2\&.0 و بالاتر"
.PP
\fBprotect\-cfg2\fR
.RS 4
هنگامی که روی پیکربندی ۱ نوشته شود، به‌روزرسانی‌های بعدی پیکربندی ۲ را مسدود می‌کند\&. هنگامی که روی پیکربندی ۲ نوشته شود، از فعال شدن بیت قفل (lock bit) روی پیکربندی ۱ جلوگیری می‌کند\&.
.RE
.SS "سفت‌افزار YubiKey 2\&.1 و بالاتر"
.PP
\fBoath\-hotp\fR
.RS 4
تنظیم حالت OATH\-HOTP به‌جای حالت YubiKey\&. در این حالت، توکن بر اساس استاندارد OATH\-HOTP عمل می‌کند\&.
.RE
.SS "سفت‌افزار YubiKey 2\&.2 و بالاتر"
.PP
\fBchal\-resp\fR
.RS 4
تنظیم حالت چالش\-پاسخ (challenge\-response)\&.
.RE
.SH "پرچم‌های پیکربندی (CONFIGURATION FLAGS)"
.PP
\fBsend\-ref\fR
.RS 4
ارسال یک رشتهٔ مرجع شامل تمام ۱۶ نویسهٔ modhex پیش از بخش ثابت\&. در هنگام ترکیب با
\fB\-ostrong\-pw2\fR
این گزینه یک
\fI!\fR
پیش از باقی رشته ارسال می‌کند\&.
.RE
.PP
\fBpacing\-10ms\fR
.RS 4
افزودن ۱۰ میلی‌ثانیه تاخیر میان فشردن کلیدها\&.
.RE
.PP
\fBpacing\-20ms\fR
.RS 4
افزودن ۲۰ میلی‌ثانیه تاخیر میان فشردن کلیدها\&.
.RE
.PP
\fBstatic\-ticket\fR
.RS 4
تولید یک رشتهٔ ثابت به عنوان خروجی به‌جای گذرواژهٔ یک‌بارمصرف\&. این گذرواژه همچنان بر پایهٔ کلید AES است و باید حدس زدن آن دشوار و به‌خاطر سپردنش غیرممکن باشد\&.
.RE.SS "تنها میان‌افزار YubiKey 1\&.x"
.PP
\fBticket\-first\fR
.RS 4
ارسال گذرواژه یک‌بارمصرف پیش از بخش ثابت\&.
.RE
.PP
\fBallow\-hidtrig\fR
.RS 4
اجازه به راه‌اندازی از طریق HID/صفحه‌کلید با دو بار فشردن کلید caps\-، num یا scroll\-lock\&. به دلایل امنیتی توصیه نمی‌شود\&.
.RE
.SS "میان‌افزار YubiKey 2\&.0 و بالاتر"
.PP
\fBshort\-ticket\fR
.RS 4
محدود کردن طول رشته ایستا به حداکثر ۱۶ رقم\&. این پرچم تنها همراه با گزینه
\fB\-ostatic\-ticket\fR
معنادار است\&. زمانی که
\fB\-oshort\-ticket\fR
بدون
\fB\-ostatic\-ticket\fR
استفاده شود، YubiKey را در «حالت اسکن‌کد» برنامه‌ریزی می‌کند؛ در این حالت کلید محتویات fixed، uid و key را به عنوان کدهای اسکن خام صفحه‌کلید ارسال می‌کند\&. برای نمونه، با استفاده از رشته ثابت
\fIh:8b080f0f122c9a12150f079e\fR
در این حالت، عبارت
\fIHello World!\fR
روی یک صفحه‌کلید qwerty ارسال خواهد شد\&. این حالت کدهای اسکن خام را ارسال می‌کند، بنابراین خروجی میان چیدمان‌های گوناگون صفحه‌کلید متفاوت خواهد بود\&.
.RE
.PP
\fBstrong\-pw1\fR
.RS 4
بزرگ کردن دو حرف نخست رشته خروجی\&. این مورد برای سازگاری با سامانه‌های قدیمی است که استفاده از هر دو نویسه کوچک و بزرگ را در گذرواژه اجباری می‌کنند، و هیچ امنیتی اضافه نمی‌کند\&.
.RE
.PP
\fBstrong\-pw2\fR
.RS 4
جایگزین کردن هشت نویسه نخست الفبای modhex با شماره‌های ۰ تا ۷\&. همانند
\fB\-ostrong\-pw1\fR، این گزینه نیز برای پشتیبانی از سامانه‌های قدیمی در نظر گرفته شده است\&.
.RE
.PP
\fBman\-update\fR
.RS 4
فعال‌سازی به‌روزرسانی گذرواژه ایستا توسط کاربر\&. تنها با گزینه
\fB\-ostatic\-ticket\fR
معنادار است\&. این گزینه فقط برای میان‌افزار 2\&.x معتبر است\&.
.RE
.SS "میان‌افزار YubiKey 2\&.1 و بالاتر"
.PP
\fBoath\-hotp8\fR
.RS 4
تولید یک HOTP هشت‌رقمی به جای شش‌رقمی\&.
.RE
.PP
\fBoath\-fixed\-modhex1\fR
.RS 4
ارسال نخستین بایت بخش ثابت به صورت modhex\&.
.RE
.PP
\fBoath\-fixed\-modhex2\fR
.RS 4
ارسال دو بایت نخست بخش ثابت به صورت modhex\&.
.RE
.PP
\fBoath\-fixed\-modhex\fR
.RS 4
ارسال بخش ثابت به صورت modhex\&.
.RE
.PP
\fBoath\-id\fR=m:OOTTUUUUUUUU
.RS 4
پیکربندی شناسه توکن OATH با مقدار ارائه‌شده\&. برای جزئیات به توضیحات این گزینه در بخش 2\&.2 مراجعه کنید، اما توجه داشته باشید که کلید YubiKey 2\&.1 نمی‌تواند شماره سریال خود را گزارش کند و بنابراین باید مقدار شناسه توکن مشخص شود\&.
.RE
.SS "میان‌افزار YubiKey 2\&.2 و بالاتر"
.PP
\fBchal\-yubico\fR
.RS 4
حالت چالش\-پاسخ Yubico OTP\&.
.RE
.PP
\fBchal\-hmac\fR
.RS 4
تولید پاسخ‌های چالش HMAC\-SHA1\&.
.RE
.PP
\fBhmac\-lt64\fR
.RS 4
محاسبه HMAC روی ورودی کمتر از ۶۴ بایت\&. هر مقداری که در آخرین بایت چالش باشد به عنوان نشانگر پایان ورودی (با ردیابی به عقب از انتهای بار مفید) استفاده می‌شود\&.
.RE
.PP
\fBchal\-btn\-trig\fR
.RS 4
کلید YubiKey پیش از پاسخ به چالش، منتظر می‌ماند تا کاربر کلید را (ظرف ۱۵ ثانیه) فشار دهد\&.
.RE
.PP
\fBserial\-btn\-visible\fR
.RS 4
اگر دکمه هنگام روشن شدن فشرده شود، YubiKey شماره سریال خود را ارسال می‌کند\&. این گزینه تنها برای سری میان‌افزارهای 2\&.x معتبر است\&.
.RE
.PP
\fBserial\-usb\-visible\fR
.RS 4
کلید YubiKey شماره سریال خود را در فیلد iSerial مربوط به USB مشخص می‌کند\&. این گزینه در میان‌افزارهای 3\&.0 و 3\&.1 در دسترس نیست\&.
.RE
.PP
\fBserial\-api\-visible\fR
.RS 4
کلید YubiKey اجازه می‌دهد تا شماره سریال آن با استفاده از یک فراخوانی API خوانده شود\&.
.RE
.PP
\fBoath\-id\fR[=m:OOTTUUUUUUUU]
.RS 4
پیکربندی شناسه توکن OATH با مقدار ارائه‌شده، یا در صورت استفاده بدون مقدار، به‌کارگیری شناسه استاندارد توکن YubiKey\&.
.RE
.sp
شناسه استاندارد توکن OATH برای Yubico YubiKey عبارت است از: (modhex) OO=ub، TT=he، و (ده‌دهی) UUUUUUUU=شماره سریال\&.
.sp
دلیل استفاده از شماره سریال ده‌دهی، آسان کردن تطبیق دادن شماره سریال پشت YubiKey با یک ورودی در فهرستی از توکن‌های مرتبط برای انسان است\&. سایر کدگذاری‌ها را می‌توان با استفاده از گزینه‌های مناسب oath\-fixed\-modhex انجام داد\&.
.sp
توجه داشته باشید که YubiKey باید به گونه‌ای برنامه‌ریزی شده باشد که اجازه خواندن شماره سریال خود را بدهد، در غیر این صورت ساخت خودکار شناسه توکن امکان‌پذیر نخواهد بود\&.
.sp
برای جزئیات بیشتر به بخش «5\&.3\&.4 \- OATH\-HOTP Token Identifier» از راهنمای YubiKey به نشانی http://yubico\&.com/files/YubiKey_manual\-2\&.0\&.pdf مراجعه کنید\&..SS "سفت‌افزار YubiKey 2\&.3 و بالاتر"
.PP
\fBuse\-numeric\-keypad\fR
.RS 4
ارسال اسکن‌کدها برای فشردن کلیدهای صفحه‌کلید عددی هنگام ارسال ارقام \- به کار با برخی چیدمان‌های صفحه‌کلید کمک می‌کند\&. این گزینه فقط برای سری سفت‌افزارهای 2\&.x معتبر است\&.
.RE
.PP
\fBfast\-trig\fR
.RS 4
راه‌اندازی سریع‌تر هنگامی که فقط پیکربندی ۱ موجود باشد\&. این گزینه در نسخه‌های سفت‌افزار 3\&.0 و بالاتر همواره فعال است\&.
.RE
.PP
\fBallow\-update\fR
.RS 4
اجازه به‌روزرسانی (یا جابه‌جایی) پارامترهای مشخصی را در یک پیکربندی در آینده می‌دهد\&.
.RE
.PP
\fBdormant\fR
.RS 4
یک پیکربندی ذخیره‌شده در YubiKey را پنهان/آشکار می‌کند\&.
.RE
.SS "سفت‌افزار YubiKey 2\&.4/3\&.1 و بالاتر"
.PP
\fBled\-inv\fR
.RS 4
رفتار LED روی YubiKey را معکوس می‌کند\&.
.RE
.SS "حالت OATH\-HOTP"
.sp
هنگام استفاده از حالت OATH\-HOTP، یک کلید HMAC به اندازه ۱۶۰ بیت (۲۰ بایت، ۴۰ نویسه هگزادسیمال) می‌تواند با \fB\-a\fR ارائه شود\&.
.SS "حالت چالش\-پاسخ (Challenge\-response)"
.sp
در حالت \fBCHAL\-RESP\fR، توکن هنگام فشردن دکمه هیچ فشرده‌شدن کلیدی (keypress) تولید نخواهد کرد (اگرچه کاملاً امکان‌پذیر است که یک اسلات دارای پیکربندی تولیدکننده فشرده‌شدن کلید باشد و دیگری در حالت چالش\-پاسخ قرار گیرد)\&. در عوض، باید از برنامه‌ای با توانایی ارسال گزارش‌های ویژگی USB HID به توکن، برای ارسال چالش به آن و خواندن پاسخ استفاده شود\&.
.SS "Modhex"
.sp
روش Modhex شیوه‌ای برای نوشتن ارقام هگزادسیمال است که در آن \(lqارقام\(rq به‌گونه‌ای انتخاب شده‌اند که در بیشتر چیدمان‌های صفحه‌کلید در یک موقعیت قرار گیرند\&. برای تبدیل از هگزادسیمال به modhex، می‌توانید استفاده کنید از:
.sp
.if n \{\
.RS 4
.\}
.nf
tr "[0123456789abcdef]" "[cbdefghijklnrtuv]"
.fi
.if n \{\
.RE
.\}
.sp
برای تبدیل در جهت معکوس، استفاده کنید از:
.sp
.if n \{\
.RS 4
.\}
.nf
tr "[cbdefghijklnrtuv]" "[0123456789abcdef]"
.fi
.if n \{\
.RE
.\}
.SS "مثال‌ها (EXAMPLES)"
.sp
برنامه‌ریزی برای YubiCloud:
.sp
.if n \{\
.RS 4
.\}
.nf
ouid=`dd if=/dev/urandom 2>/dev/null | tr \-d \*(Aq[:upper:]\*(Aq | tr \-cd \*(Aq[:xdigit:]\*(Aq | fold \-w12 | head \-1`
ofixed=ff`dd if=/dev/urandom 2>/dev/null | tr \-d \*(Aq[:upper:]\*(Aq | tr \-cd \*(Aq[:xdigit:]\*(Aq | fold \-w10 | head \-1`
ykpersonalize \-1 \-ouid=h:$ouid \-ofixed=h:$ofixed
.fi
.if n \{\
.RE
.\}
.sp
این دستور یک کلید را با یک uid تصادفی ۶ بایتی و یک رشته ثابت ۱۲ نویسه‌ای که با vv آغاز می‌شود برنامه‌ریزی می‌کند\&. این مورد برای بارگذاری در YubiCloud در نشانی https://upload\&.yubico\&.com مناسب است\&.
.SS "گزارش باگ‌ها (BUGS)"
.sp
باگ‌های ykpersonalize را در سامانه پیگیری مسائل گزارش دهید: https://github\&.com/Yubico/yubikey\-personalization/issues
.SS "همچنین ببینید (SEE ALSO)"
.sp
صفحه اصلی ykpersonalize در نشانی https://developers\&.yubico\&.com/yubikey\-personalization
.sp
می‌توان YubiKeyها را از Yubico تهیه کرد: http://www\&.yubico\&.com