NETKEY-TOOL(1) OpenSC Tools NETKEY-TOOL(1)

netkey-tool - ابزار مدیریتی برای کارت‌های Netkey E4

netkey-tool [OPTIONS] [COMMAND]

از ابزار netkey-tool می‌توان در خط فرمان برای انجام برخی عملیات‌های کارت هوشمند با کارت‌های NetKey E4 استفاده کرد که با دیگر ابزارهای OpenSC به‌سادگی امکان‌پذیر نیستند؛ از جمله تغییر PINهای محلی، ذخیره گواهی‌ها در فایل‌های گواهی خالی NetKey E4 یا نمایش مقدار اولیه PUK.

--help, -h

پیام راهنمای کوتاهی را نمایش می‌دهد.

--pin pin, -p pin

مقدار کنونی PIN سراسری (global PIN) را مشخص می‌کند.

--puk pin, -u pin

مقدار کنونی PUK سراسری (global PUK) را مشخص می‌کند.

--pin0 pin, -0 pin

مقدار کنونی PIN0 محلی (معروف به PIN محلی) را مشخص می‌کند.

--pin1 pin, -1 pin

مقدار کنونی PIN1 محلی (معروف به PUK محلی) را مشخص می‌کند.

--reader arg, -r arg

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

-v

موجب افزایش جزئیات خروجی netkey-tool می‌شود. این گزینه می‌تواند چندین بار تکرار شود تا سطح پرگویی بالاتر برود.

با گزینه‌های -p، -u، -0 یا -1 می‌توان یکی از pinهای کارت را مشخص کرد. می‌توانید از رشته‌های متنی اسکی (ascii) ساده (مانند 123456) یا رشته‌های هگزادسیمال (مانند 31:32:33:34:35:36) استفاده کنید. یک رشته هگزادسیمال باید دقیقاً از n عدد هگز ۲ رقمی تشکیل شده باشد که با n-1 دونقطه از یکدیگر جدا شده‌اند. در غیر این صورت به عنوان یک رشته ascii تفسیر خواهد شد. برای نمونه :12:34: و 1:2:3:4 هر دو pinهایی با طول ۷ هستند، در حالی که 12:34 و 01:02:03:04 pinهایی به طول ۲ و ۴ می‌باشند.

هنگامی که netkey-tool بدون هیچ گزینه یا دستوری به کار رود، اطلاعاتی در مورد pinها و گواهی‌های کارت هوشمند نمایش می‌دهد. این کار هیچ تغییری در وضعیت کارت شما ایجاد نخواهد کرد (به فرض اینکه نقصی در netkey-tool وجود نداشته باشد). به‌ویژه شمارنده‌های تلاش‌های باقیمانده pinها بدون انجام اعتبارسنجی واقعی بررسی می‌شوند.

اگر PIN سراسری را با گزینه --pin مشخص کنید، netkey-tool مقدار اولیه PUK سراسری کارت را نیز نمایش خواهد داد. اگر PUK سراسری شما تغییر کرده باشد، netkey-tool همچنان مقدار اولیه آن را نمایش می‌دهد. هیچ راهی برای بازیابی یک PUK سراسری گم‌شده پس از تغییر آن وجود ندارد. همچنین هیچ راهی برای نمایش مقدار اولیه PUK سراسری بدون دانستن مقدار کنونی PIN سراسری وجود نخواهد داشت.

برای بیشتر دستورهایی که netkey-tool می‌تواند اجرا کند، باید یک pin را مشخص کنید. یک استثنای قابل توجه دستور nullpin است، اما این دستور فقط یک بار در طول عمر کارت NetKey E4 قابل اجراست.

cert number filename

این دستور یکی از گواهی‌های کارت شما را (همان‌طور که توسط number مشخص شده) می‌خواند و آن را در قالب PEM در فایل filename ذخیره می‌کند. گواهی‌های روی کارت NetKey E4 بدون نیاز به pin خواندنی هستند، بنابراین نیازی به مشخص کردن pin ندارید.

cert filename number

این دستور نخستین گواهی کدگذاری‌شده با PEM را از فایل filename می‌خواند و آن را در فایل گواهی number کارت هوشمند شما ذخیره می‌کند. برخی از فایل‌های گواهی کارت هوشمند شما ممکن است فقط‌خواندنی باشند، بنابراین این عمل با تمام مقادیر number کار نخواهد کرد. اگر یک فایل گواهی قابل نوشتن باشد، برای تغییر آن باید یک pin مشخص کنید. اگر سعی کنید بدون مشخص کردن pin از این دستور استفاده کنید، netkey-tool به شما خواهد گفت که به کدام pin نیاز است.

change {pin | puk | pin0 | pin1} new-pin

این دستور مقدار pin مشخص‌شده را به مقدار جدید داده‌شده تغییر می‌دهد. برای انجام این کار باید یا مقدار کنونی همان pin یا pin دیگری را مشخص کنید، و اگر pin درست را تعیین نکنید، netkey-tool اعلام خواهد کرد که کدام مورد نیاز است.

nullpin initial-pin

این دستور تنها در صورتی قابل اجرا است که PIN سراسری کارت شما در وضعیت nullpin باشد. پس از آنکه PIN سراسری خود را تغییر دادید، هیچ راهی برای بازگشت به وضعیت nullpin وجود ندارد. برای اجرای دستور nullpin نیازی به pin ندارید. پس از اجرای موفقیت‌آمیز دستور nullpin، ابزار netkey-tool مقدار اولیه PUK کارت شما را نمایش خواهد داد.

unblock {pin | pin0 | pin1}

این دستور قفل pin مشخص‌شده را باز می‌کند. برای این کار باید pin دیگری را مشخص کنید و در صورتی که مورد درستی را تعیین نکنید، netkey-tool به شما اعلام می‌کند که کدام pin مورد نیاز است.

opensc-explorer(1)

netkey-tool توسط Peter Koch <pk_opensc@web.de> نوشته شده است.

06/02/2026 opensc