PKCS15-TOOL(1) OpenSC Tools PKCS15-TOOL(1)

pkcs15-tool - ابزاری برای دستکاری ساختارهای داده PKCS #15 بر روی کارت‌های هوشمند و توکن‌های امنیتی مشابه

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

ابزار pkcs15-tool برای دستکاری ساختارهای داده PKCS #15 بر روی کارت‌های هوشمند و توکن‌های امنیتی مشابه استفاده می‌شود. کاربران می‌توانند PINها، کلیدها و گواهی‌های ذخیره‌شده بر روی توکن را فهرست کرده و بخوانند. احراز هویت با PIN کاربر برای آن دسته از عملیات‌هایی که به آن نیاز دارند انجام می‌شود.

--version

چاپ نسخه انتشار بسته OpenSC.

--aid aid

مشخص کردن شناسه AID برنامه PKCS#15 روی کارت در قالب هگزادسیمال جهت اتصال به آن.

--auth-id id, -a id

مشخص کردن شناسه احراز هویت (auth id) مربوط به PIN مورد استفاده برای عملیات. این گزینه همراه با عملیات --change-pin سودمند است.

--change-pin

تغییر دادن یک PIN یا PUK ذخیره‌شده روی توکن. برای این عملیات احراز هویت کاربر الزامی است.

--dump, -D

فهرست کردن تمام اشیاء کارت.

--list-info

فهرست کردن اطلاعات اشیاء کارت.

--list-applications

فهرست کردن برنامه‌های کاربردی PKCS#15 روی کارت.

--list-certificates, -c

فهرست کردن تمام گواهی‌های ذخیره‌شده روی توکن.

--list-data-objects, -C

فهرست کردن تمام اشیاء داده ذخیره‌شده روی توکن. برای برخی کارت‌ها، ویژگی‌های PKCS#15 اشیاء داده خصوصی برای خواندن محافظت شده‌اند و نیاز به احراز هویت با PIN کاربر دارند. در چنین حالتی باید از گزینه --verify-pin استفاده شود.

--list-keys, -k

فهرست کردن تمام کلیدهای خصوصی ذخیره‌شده روی توکن. اطلاعات عمومی درباره هر کلید خصوصی فهرست می‌شود (مانند نام کلید، شناسه و الگوریتم). مقادیر واقعی کلید خصوصی نمایش داده نمی‌شوند. برای برخی از کارت‌ها، ویژگی‌های PKCS#15 کلیدهای خصوصی برای خواندن محافظت شده‌اند و نیاز به احراز هویت با PIN کاربر دارند. در چنین حالتی باید از گزینه --verify-pin استفاده شود.

--list-secret-keys

فهرست کردن تمام کلیدهای محرمانه (متقارن) ذخیره‌شده روی توکن. اطلاعات عمومی درباره هر کلید محرمانه فهرست می‌شود (مانند نام کلید، شناسه و الگوریتم). مقادیر واقعی کلیدهای محرمانه نمایش داده نمی‌شوند. برای برخی از کارت‌ها، ویژگی‌های PKCS#15 کلیدهای خصوصی برای خواندن محافظت شده‌اند و نیاز به احراز هویت با PIN کاربر دارند. در چنین حالتی باید از گزینه --verify-pin استفاده شود.

--list-pins

فهرست کردن تمام PINهای ذخیره‌شده روی توکن. اطلاعات عمومی درباره هر PIN فهرست می‌شود (مانند نام PIN). مقادیر واقعی PIN نمایش داده نمی‌شوند.

--list-public-keys

فهرست کردن تمام کلیدهای عمومی ذخیره‌شده روی توکن، شامل اطلاعات نام کلید، شناسه، الگوریتم و طول کلید.

--short, -s

خروجی فهرست‌ها در قالب فشرده.

--no-cache

غیرفعال کردن حافظه موقت (cache) داده‌های توکن.

--clear-cache

حذف دایرکتوری حافظه موقت کاربر. در ویندوز، این گزینه علاوه بر این دایرکتوری حافظه موقت سیستم را نیز حذف می‌کند (نیازمند مجوزهای مدیر سیستم است).

--output filename, -o filename

مشخص کردن محل نوشتن خروجی کلید. اگر filename از قبل وجود داشته باشد، رونویسی خواهد شد. اگر این گزینه ارائه نشود، کلیدها در خروجی استاندارد چاپ خواهند شد.

--raw

تغییر نحوه چاپ محتوا در خروجی استاندارد توسط --read-data-object. به‌طور پیش‌فرض، هنگامی که --raw مشخص نشده باشد، محتوا در نمادگذاری هگز چاپ می‌شود. اگر --raw تنظیم شود، داده‌های باینری را مستقیماً چاپ می‌کند. این بر خروجی نوشته‌شده در فایل مشخص‌شده توسط گزینه --output تأثیری ندارد؛ داده‌های نوشته‌شده در فایل همیشه باینری خام خواهند بود.

--read-certificate cert

خواندن گواهی با شناسه داده‌شده.

--read-data-object data, -R data

خواندن شیء داده با OID، applicationName یا برچسب (label). محتوا در خروجی استاندارد با نمادگذاری هگز چاپ می‌شود، مگر اینکه گزینه --raw مشخص شده باشد. اگر یک فایل خروجی با گزینه --output تعیین شده باشد، محتوا علاوه بر این در آن فایل نیز نوشته می‌شود. خروجی به فایل همیشه در حالت باینری خام نوشته می‌شود؛ گزینه --raw تنها بر رفتار خروجی استاندارد تأثیر می‌گذارد.

--read-public-key id

خواندن کلید عمومی با شناسه id، که به کاربر اجازه استخراج و ذخیره یا استفاده از کلید عمومی را می‌دهد.

--read-ssh-key id

خواندن کلید عمومی با شناسه id، و نوشتن خروجی در قالبی مناسب برای $HOME/.ssh/authorized_keys.

برچسب کلید (در صورت وجود) در فیلد 'Comment' نمایش داده خواهد شد.

--rfc4716

هنگامی که همراه با گزینه --read-ssh-key استفاده شود، قالب خروجی کلید عمومی از rfc4716 پیروی می‌کند.

قالب خروجی پیش‌فرض تک‌خطی (openssh) است.

--test-update, -T

بررسی اینکه آیا کارت نیاز به به‌روزرسانی امنیتی دارد یا خیر

--update, -U

به‌روزرسانی کارت با یک به‌روزرسانی امنیتی

--reader arg

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

--unblock-pin, -u

رفع مسدودی یک PIN ذخیره‌شده روی توکن. برای این عملیات اطلاع داشتن از کلید رفع مسدودی پین (PUK) الزامی است.

--verbose, -v

موجب افزایش جزئیات خروجی pkcs15-tool می‌شود. این فلگ را چندین بار مشخص کنید تا خروجی اشکال‌زدایی در کتابخانه OpenSC فعال گردد.

--pin pin, --new-pin newpin, --puk puk

این گزینه‌ها می‌توانند برای مشخص کردن مقادیر PIN/PUK در خط فرمان استفاده شوند. اگر مقدار روی env:VARIABLE تنظیم شود، مقدار متغیر محیطی مشخص‌شده استفاده می‌شود. به‌طور پیش‌فرض، در صورت نیاز کد در خط فرمان درخواست می‌شود.

توجه داشته باشید که در بیشتر سیستم‌عامل‌ها، هر کاربری می‌تواند با استفاده از ابزارهایی مانند ps(1) خط فرمان هر فرآیندی را در سیستم مشاهده کند. بنابراین در یک سیستم ناامن، باید ارسال کدها را از طریق متغیر محیطی ترجیح دهید.

--new-pin pin

مشخص کردن PIN جدید (هنگام تغییر یا رفع مسدودی)

--verify-pin

اعتبارسنجی PIN پس از اتصال به کارت و پیش از صدور هر فرمانی (بدون 'auth-id'، نخستین PIN غیر SO و غیر Unblock بررسی خواهد شد)

--test-session-pin

معادل با --verify-pin همراه با تولید نشست PIN اضافی

--wait, -w

موجب می‌شود pkcs15-tool برای وارد شدن یک کارت منتظر بماند.

--use-pinpad

از کاربر سوال نشود؛ اگر PIN ارائه نشده باشد، از pinpad استفاده خواهد شد.

pkcs15-init(1), pkcs15-crypt(1)

pkcs15-tool توسط Juha Yrjölä <juha.yrjola@iki.fi> نوشته شده است.

06/02/2026 opensc