| YUBICO-PIV-TOOL(1) | User Commands | YUBICO-PIV-TOOL(1) |
نام (NAME)
yubico-piv-tool - ابزاری برای مدیریت اعتبارات احراز هویت شخصی (PIV) روی Yubikeyها
خلاصه دستور (SYNOPSIS)
yubico-piv-tool [OPTION]...
توضیحات (DESCRIPTION)
- -h, --help
- چاپ راهنما و خروج
- --full-help
- چاپ راهنما، شامل گزینه‌های پنهان، و خروج
- -V, --version
- چاپ نسخه و خروج
- -v, --verbose[=INT]
- چاپ اطلاعات بیشتر (پیش‌فرض=`0')
- -r, --reader=STRING
- تنها استفاده از کارت‌خوان منطبق (پیش‌فرض=`Yubikey')
- -k, --key[=STRING]
- کلید مدیریتی مورد استفاده؛ در صورت مشخص نشدن، کلید درخواست خواهد شد (پیش‌فرض=`010203040506070801020304050607080102030405060708')
- -a, --action=ENUM
- اقدام برای انجام (مقادیر ممکن: "version"، "generate"، "set-mgm-key"، "reset"، "pin-retries"، "import-key"، "import-certificate"، "set-chuid"، "request-certificate"، "verify-pin"، "verify-bio"، "change-pin"، "change-puk"، "unblock-pin"، "selfsign-certificate"، "delete-certificate"، "read-certificate"، "read-public-key"، "status"، "test-signature"، "test-decipher"، "list-readers"، "set-ccc"، "write-object"، "read-object"، "attest"، "move-key"، "delete-key")
- می‌توان چندین اقدام را به طور هم‌زمان مشخص کرد که به ترتیب اجرا خواهند شد؛ برای نمونه: --action=verify-pin --action=request-certificate
- -s, --slot=ENUM
- اسلات کلید برای انجام عملیات (مقادیر ممکن: "9a"، "9c"، "9d"، "9e"، "82"، "83"، "84"، "85"، "86"، "87"، "88"، "89"، "8a"، "8b"، "8c"، "8d"، "8e"، "8f"، "90"، "91"، "92"، "93"، "94"، "95"، "f9")
- اسلات 9a برای احراز هویت PIV اسلات 9c برای امضای دیجیتال (PIN همیشه بررسی می‌شود) اسلات 9d برای مدیریت کلید اسلات 9e برای احراز هویت کارت (PIN هرگز بررسی نمی‌شود) اسلات‌های 82-95 برای مدیریت کلیدهای بازنشسته اسلات f9 برای تصدیق اعتبار (Attestation)
- --to-slot=ENUM
- اسلاتی که کلید موجود باید به آن منتقل شود (مقادیر ممکن: "9a"، "9c"، "9d"، "9e"، "82"، "83"، "84"، "85"، "86"، "87"، "88"، "89"، "8a"، "8b"، "8c"، "8d"، "8e"، "8f"، "90"، "91"، "92"، "93"، "94"، "95"، "f9")
- اسلات 9a برای احراز هویت PIV اسلات 9c برای امضای دیجیتال (PIN همیشه بررسی می‌شود) اسلات 9d برای مدیریت کلید اسلات 9e برای احراز هویت کارت (PIN هرگز بررسی نمی‌شود) اسلات‌های 82-95 برای مدیریت کلیدهای بازنشسته اسلات f9 برای تصدیق اعتبار (Attestation)
- -A, --algorithm=ENUM
- الگوریتم مورد استفاده (مقادیر ممکن: "RSA1024"، "RSA2048"، "RSA3072"، "RSA4096"، "ECCP256"، "ECCP384"، "ED25519"، "X25519" پیش‌فرض=`RSA2048')
- -H, --hash=ENUM
- درهم‌سازی (هش) مورد استفاده برای امضاها (مقادیر ممکن: "SHA1"، "SHA256"، "SHA384"، "SHA512" پیش‌فرض=`SHA256')
- -n, --new-key=STRING
- کلید مدیریتی جدید برای اقدام set-mgm-key؛ در صورت مشخص نشدن، کلید درخواست خواهد شد
- --pin-retries=INT
- تعداد دفعات تلاش مجاز پیش از مسدود شدن کد pin
- --puk-retries=INT
- تعداد دفعات تلاش مجاز پیش از مسدود شدن کد puk
- -i, --input=STRING
- نام فایل ورودی، - برای stdin (پیش‌فرض=`-')
- -o, --output=STRING
- نام فایل خروجی، - برای stdout (پیش‌فرض=`-')
- -K, --key-format=ENUM
- قالب کلید در حال خواندن/نوشتن (مقادیر ممکن: "PEM"، "PKCS12"، "GZIP"، "DER"، "SSH" پیش‌فرض=`PEM')
- --compress
- فشرده‌سازی گواهی‌های بزرگ با استفاده از GZIP پیش از وارد کردن (پیش‌فرض=غیرفعال)
- --global
- بازنشانی کل دستگاه برای تمام برنامه‌های کاربردی (پیش‌فرض=غیرفعال)
- -p, --password=STRING
- گذرواژه برای رمزگشایی فایل کلید خصوصی؛ در صورت مشخص نشدن، گذرواژه درخواست خواهد شد
- -S, --subject=STRING
- موضوع (subject) مورد استفاده برای درخواست گواهی
- موضوع باید به این صورت نوشته شود: /CN=host.example.com/OU=test/O=example.com/
- --serial=INT
- شماره سریال گواهی خودامضا
- --valid-days=INT
- مدت زمان (به روز) تا انقضای گواهی خودامضا (پیش‌فرض=`365')
- -P, --pin=STRING
- کد pin/puk برای اعتبارسنجی؛ در صورت مشخص نشدن، کد pin/puk درخواست خواهد شد
- -N, --new-pin=STRING
- کد pin/puk جدید برای تغییر دادن؛ در صورت مشخص نشدن، کد pin/puk درخواست خواهد شد
- --pin-policy=ENUM
- تنظیم سیاست pin برای اقدام generate یا import-key. تنها در YubiKey 4 یا جدیدتر در دسترس است (مقادیر ممکن: "never"، "once"، "always"، "matchonce"، "matchalways")
- --touch-policy=ENUM
- تنظیم سیاست لمس برای اقدام generate، import-key یا set-mgm-key. تنها در YubiKey 4 یا جدیدتر در دسترس است (مقادیر ممکن: "never"، "always"، "cached")
- --id=INT
- شناسه شیء برای نوشتن/خواندن شیء
- -f, --format=ENUM
- قالب داده‌ها برای نوشتن/خواندن شیء (مقادیر ممکن: "hex"، "base64"، "binary" پیش‌فرض=`hex')
- --attestation
- افزودن امضای متقابل تصدیق اعتبار (attestation cross-signature) (پیش‌فرض=غیرفعال)
- -m, --new-key-algo=ENUM
- الگوریتم کلید مدیریتی جدید برای اقدام set-mgm-key (مقادیر ممکن: "TDES"، "AES128"، "AES192"، "AES256" پیش‌فرض=`TDES')
- --scp11
- ارتباط با YubiKey از طریق یک کانال رمزنگاری‌شده انجام می‌شود. منسوخ شده است! لطفاً به جای آن از پرچم '--enc' استفاده کنید (پیش‌فرض=غیرفعال)
- --enc
- ارتباط با YubiKey از طریق یک کانال رمزنگاری‌شده انجام می‌شود (پیش‌فرض=غیرفعال)
| January 2026 | yubico-piv-tool 2.7.3 |