PIV-TOOL(1) OpenSC Tools PIV-TOOL(1)

piv-tool - ابزار کارت هوشمند برای کارت‌های PIV استاندارد HSPD-12

piv-tool [گزینه‌ها]

ابزار piv-tool می‌تواند از طریق خط فرمان برای انجام عملیات گوناگون کارت هوشمند روی یک کارت هوشمند HSPD-12 PIV مطابق با تعریف NIST 800-73-3 استفاده شود. این ابزار تنها برای استفاده با کارت‌های آزمایشی در نظر گرفته شده است. از آن می‌توان برای بارگذاری شیءها، تولید جفت‌کلیدها، و همچنین ارسال دستورهای APDU دلخواه به یک کارت، پس از احراز هویت با کارت با استفاده از کلید ارائه‌شده توسط سازندهٔ کارت، استفاده کرد.

--serial

چاپ شماره سریال کارت به‌دست‌آمده از شیء CHUID، در صورت وجود. خروجی در قالب بایت‌های هگزادسیمال است.

--name, -n

چاپ نام کارت واردشده (درایور)

--admin آرگومان, -A آرگومان

احراز هویت در کارت با استفاده از یک کلید 2DES، 3DES یا AES. آرگومان به صورت:
{A|M}:ref:alg

الزامی است، که در آن A از «EXTERNAL AUTHENTICATION» و M از «MUTUAL AUTHENTICATION» استفاده می‌کند. ref معمولاً 9B است، و alg برای 3DES برابر 03، برای 2DES برابر 01، برای AES-128 برابر 08، برای AES-192 برابر 0A یا برای AES-256 برابر 0C است. کلید توسط سازنده کارت ارائه می‌شود. متغیر محیطی PIV_EXT_AUTH_KEY باید یا به یک فایل دودویی مطابق با طول کلید یا به یک فایل متنی حاوی کلید با قالب زیر اشاره کند: XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX

--genkey آرگومان, -G آرگومان

تولید یک جفت‌کلید روی کارت و ارائه کلید عمومی در خروجی. آرگومان به صورت:
ref:alg

الزامی است، که در آن ref برابر 9A، 9C، 9D یا 9E بوده و alg به‌ترتیب برای RSA 1024، RSA 2048، ECC 256 یا ECC 384 برابر 06، 07، 11 یا 14 است.

--object ContainerID, -O ContainerID

بارگذاری یک شیء روی کارت. ContainerID مطابق با تعریف NIST 800-73-n بدون 0x آغازین است. مثال: شیء CHUID برابر 3000 است.

--cert ref, -C ref

بارگذاری یک گواهی روی کارت. ref برابر 9A، 9C، 9D یا 9E است.

--compresscert ref, -Z ref

بارگذاری یک گواهی فشرده‌شده با gzip روی کارت. ref برابر 9A، 9C، 9D یا 9E است.

--out فایل, -o فایل

فایل خروجی برای هر عملیاتی که خروجی تولید می‌کند.

--in فایل, -i فایل

فایل ورودی برای هر عملیاتی که به یک فایل ورودی نیاز دارد.

--key-slots-discovery فایل

چاپ ویژگی‌های اسلات‌های کلید. به احراز هویت 'admin' نیاز دارد.

--send-apdu apdu, -s apdu

ارسال یک APDU دلخواه به کارت در قالب AA:BB:CC:DD:EE:FF.... این گزینه می‌تواند تکرار شود.

--reader آرگومان, -r آرگومان

شمارهٔ کارت‌خوان مورد استفاده. به‌طور پیش‌فرض، نخستین کارت‌خوانی که کارتی در آن قرار دارد استفاده می‌شود. اگر آرگومان یک ATR باشد، کارت‌خوان دارای کارت منطبق انتخاب خواهد شد.

--wait, -w

انتظار برای وارد شدن کارت

--verbose, -v

باعث پرگویی بیشتر piv-tool می‌شود. برای فعال‌سازی خروجی اشکال‌زدایی در کتابخانه opensc، این پرچم را چندین بار مشخص کنید.

opensc-tool(1)

piv-tool توسط Douglas E. Engert <deengert@gmail.com> نوشته شده است.

06/02/2026 opensc