'\" t
.\"     Title: opensc.conf
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/02/2026
.\"    Manual: OpenSC File Formats
.\"    Source: opensc
.\"  Language: Persian
.\"
.TH "OPENSC\&.CONF" "5" "06/02/2026" "opensc" "OpenSC File Formats"
.\" -----------------------------------------------------------------
.\" * 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)"
opensc.conf \- فایل پیکربندی برای OpenSC
.SH "توضیحات (DESCRIPTION)"
.PP
OpenSC داده‌های پیکربندی را از منابع زیر و به ترتیب زیر به دست می‌آورد:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
گزینه‌های خط فرمان
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
متغیرهای محیطی
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
کلید رجیستری ویندوز در
HKEY_CURRENT_USER
(در صورت وجود)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
کلید رجیستری ویندوز در
HKEY_LOCAL_MACHINE
(در صورت وجود)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
فایل پیکربندی سراسری سیستم (/etc/opensc\&.conf)
.RE
.PP
فایل پیکربندی،
opensc\&.conf، از
\fIبلوک‌ها (blocks)\fR
تشکیل شده است که به‌طور کلی قالب زیر را دارند:
.sp
.if n \{\
.RS 4
.\}
.nf
\fIkey\fR [,\ \fIname\fR...] {
	\fIblock_contents\fR
}

.fi
.if n \{\
.RE
.\}
.sp

\fIblock_contents\fR
یک یا چند
\fIblock_item\fR
است که در آن هر
\fIblock_item\fR
یکی از موارد زیر می‌باشد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
#
\fIرشته توضیح (comment string)\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIkey\fR[,\ \fIname\fR...]
=
\fIvalue\fR;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIبلوک (block)\fR
.RE
.PP
در سطح ریشه (root level)،
opensc\&.conf
باید شامل یک یا چند بلوک پیکربندی مختص به برنامه باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
app \fIapplication\fR {
	\fIblock_contents\fR
}

.fi
.if n \{\
.RE
.\}
.sp

\fIapplication\fR
یکی از موارد زیر را مشخص می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIfilename\fR: بلوک پیکربندی برای برنامه‌ای با مسیر فایل مشخص‌شده\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
default: بلوک پیکربندی جایگزین (fall\-back) برای تمامی برنامه‌ها
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
opensc\-pkcs11: بلوک پیکربندی برای ماژول PKCS#11 (opensc\-pkcs11\&.so)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
onepin\-opensc\-pkcs11: بلوک پیکربندی برای ماژول تک‌پین PKCS#11 (onepin\-opensc\-pkcs11\&.so)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
cardmod: بلوک پیکربندی برای مینی‌درایور ویندوز (opensc\-minidriver\&.dll)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
cardos\-tool,
cryptoflex\-tool,
dnie\-tool,
egk\-tool,
eidenv,
gids\-tool,
iasecc\-tool,
netkey\-tool,
npa\-tool,
openpgp\-tool,
opensc\-asn1,
opensc\-explorer,
opensc\-notify,
opensc\-tool,
piv\-tool,
pkcs11\-tool,
pkcs15\-crypt,
pkcs15\-init,
pkcs15\-tool,
sc\-hsm\-tool,
westcos\-tool: بلوک پیکربندی برای ابزارهای OpenSC
.RE
.sp
.SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)"
.PP
\fBdebug = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
میزان اطلاعات اشکال‌زدایی برای چاپ (پیش‌فرض:
0)\&. مقدار بزرگ‌تر به معنای اطلاعات اشکال‌زدایی بیشتر است\&.
.sp
متغیر محیطی
\fBOPENSC_DEBUG\fR
این تنظیم را بازنویسی می‌کند\&.
.RE
.PP
\fBdebug_file = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
فایلی که خروجی اشکال‌زدایی در آن نوشته خواهد شد (پیش‌فرض:
stderr)\&. مقادیر ویژه
stdout
و
stderr
شناسایی می‌شوند\&.
.RE
.PP
\fBprofile_dir = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
دایرکتوری پروفایل‌های مقداردهی اولیه/شخصی‌سازی PKCS#15 برای
\fBpkcs15-init\fR(1)
(پیش‌فرض:
/usr/share/opensc)\&.
.sp
در صورتی که این مقدار پیکربندی در ویندوز یافت نشود، کلید رجیستری
Software\eOpenSC Project\eOpenSC\eProfileDir
بررسی می‌شود\&.
.RE
.PP
\fBdisable_colors = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
غیرفعال‌سازی رنگ‌های پیام‌های گزارش (پیش‌فرض:
false
در صورت اتصال به کنسول،
true
در غیر این صورت)\&.
.RE
.PP
\fBdisable_popups = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
غیرفعال‌سازی پنجره‌های بازشو واسط کاربری گرافیکی توکار (پیش‌فرض:
false)\&.
.RE
.PP
\fBenable_default_driver = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
فعال‌سازی درایور پیش‌فرض کارت (پیش‌فرض:
false)\&. درایور پیش‌فرض کارت به‌طور صریح برای
\fBopensc-explorer\fR(1)
و
\fBopensc-tool\fR(1)
فعال است\&.
.RE
.PP
\fBcard_drivers = \fR\fB\fIname\fR...\fR\fB;\fR
.RS 4
فهرست مجاز درایورهای کارت برای بارگذاری در زمان راه‌اندازی\&. مقدار ویژه
internal
(پیش‌فرض) تمام درایورهای پیوندشده به‌صورت ایستا را بارگذاری می‌کند\&.
.sp
اگر درایور ناشناخته‌ای (یعنی غیر از internal یا old) ارائه شود، باید یک بلوک پیکربندی جداگانه برای آن درایور نوشته شود\&. مقدار ویژه
old
تمام درایورهای پیوندشده به‌صورت ایستا را که ممکن است در آینده حذف شوند بارگذاری می‌کند\&.
.sp
فهرست نام‌های درایورهای پشتیبانی‌شده کارت را می‌توان از خروجی
\fBopensc\-tool \-\-list\-drivers\fR
به دست آورد\&.
.sp
متغیر محیطی
\fBOPENSC_DRIVER\fR
این تنظیم را بازنویسی می‌کند\&.
.RE
.PP
\fBignored_readers = \fR\fB\fIname\fR...\fR\fB;\fR
.RS 4
فهرست کارت‌خوان‌هایی که باید نادیده گرفته شوند (پیش‌فرض: خالی)\&. اگر هر یک از رشته‌های جداشده با کاما در نام کارت‌خوان مطابقت داشته باشد (حساس به بزرگی و کوچکی حروف، تطبیق جزئی امکان‌پذیر است)، کارت‌خوان توسط OpenSC نادیده گرفته می‌شود\&. از
\fBopensc\-tool \-\-list\-readers\fR
برای مشاهده تمام کارت‌خوان‌های متصل فعلی استفاده کنید\&.
.RE
.PP
\fBreader_driver \fR\fB\fIname\fR\fR\fB { \fR\fB\fIblock_contents\fR\fR\fB } \fR
.RS 4
پیکربندی درایور کارت‌خوان هوشمند که در آن
\fIname\fR
یکی از موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ctapi: بخش
\(lqپیکربندی کارت‌خوان‌های CT\-API\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pcsc: بخش
\(lqپیکربندی کارت‌خوان‌های PC/SC\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
openct: بخش
\(lqپیکربندی کارت‌خوان‌های OpenCT\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
cryptotokenkit: بلوک پیکربندی برای کارت‌خوان‌های CryptoTokenKit
.RE
.sp
بخش
\(lqپیکربندی درایور کارت‌خوان هوشمند (Configuration of Smart Card Reader Driver)\(rq
را ببینید\&.
.RE
.PP
\fBcard_driver \fR\fB\fIname\fR\fR\fB { \fR\fB\fIblock_contents\fR\fR\fB } \fR
.RS 4
پیکربندی درایور کارت که در آن
\fIname\fR
یکی از موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
npa: بخش
\(lqگزینه‌های پیکربندی برای کارت شناسایی آلمان (Configuration Options for German ID Card)\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
dnie: بخش
\(lqگزینه‌های پیکربندی برای DNIe (Configuration Options for DNIe)\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
edo: بخش
\(lqگزینه‌های پیکربندی برای کارت eID لهستان (Configuration Options for Polish eID Card)\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
eoi: بخش
\(lqگزینه‌های پیکربندی برای کارت eID اسلوونی (Configuration Options for Slovenian eID Card)\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
myeid: بخش
\(lqگزینه‌های پیکربندی برای کارت MyEID (Configuration Options for MyEID Card)\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
dtrust: بخش
\(lqگزینه‌های پیکربندی برای کارت‌های امضای D\-Trust (Configuration Options for D\-Trust Signature Cards)\(rq
را ببینید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هر مقدار دیگر: بلوک پیکربندی برای یک درایور کارت بارگذاری‌شده به‌صورت خارجی
.RE
.sp
.RE
.PP
\fBcard_atr \fR\fB\fIhexstring\fR\fR\fB { \fR\fB\fIblock_contents\fR\fR\fB } \fR
.RS 4
علاوه بر فهرست توکار کارت‌های شناخته‌شده در درایور کارت، می‌توانید کارت جدیدی را با استفاده از بلوک
\fBcard_atr\fR
برای درایور پیکربندی کنید\&.
.sp
برای جزئیات، بخش
\(lqپیکربندی بر اساس ATR (Configuration based on ATR)\(rq
را ببینید\&.
.RE
.PP
\fBdisable_hw_pkcs1_padding = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
غیرفعال‌سازی فاصله‌گذاری (padding) سخت‌افزاری PKCS#1 v1\&.5 زمانی که کارت از عملیات خام RSA پشتیبانی می‌کند\&. پارامترهای شناخته‌شده:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
no: فاصله‌گذاری PKCS#1 v1\&.5 در سخت‌افزار در صورت پشتیبانی کارت فعال است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
sign: فاصله‌گذاری PKCS#1 v1\&.5 فقط برای امضاها (PKCS#1 v1\&.5 نوع ۱) غیرفعال است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
decipher: فاصله‌گذاری PKCS#1 v1\&.5 فقط برای رمزگشایی (PKCS#1 v1\&.5 نوع ۲) غیرفعال است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
both: فاصله‌گذاری PKCS#1 v1\&.5 هم برای امضاها و هم برای رمزگشایی (PKCS#1 v1\&.5 نوع ۱ و ۲) غیرفعال است\&.
.RE
.sp
(پیش‌فرض:
decipher)\&.
.RE
.PP
\fBopenssl_config = \fR\fB\fIpath\fR\fR\fB;\fR
.RS 4
مشخص کردن یک فایل پیکربندی OpenSSL جهت بارگذاری در بافت کتابخانه OpenSC\&. این گزینه برای عملکرد عمومی لازم نیست، اما در صورتی نیاز است که بخواهید ویژگی‌های خاصی از OpenSSL را بدون نیاز به کامپایل مجدد OpenSC پیکربندی کنید (برای مثال، پیکربندی و بارگذاری ارائه‌دهنده FIPS)\&. برای اطلاعات بیشتر درباره پیکربندی OpenSSL، به
\fBconfig\fR(5)
و
\fBfips_config\fR(5)
مراجعه کنید\&. (پیش‌فرض:
خالی)\&.
.RE
.PP
\fBsecure_messaging \fR\fB\fIname\fR\fR\fB { \fR\fB\fIblock_contents\fR\fR\fB } \fR
.RS 4
گزینه‌های پیکربندی برای نمایه پیام‌رسانی امن (secure messaging) با نام
\fIname\fR:
.PP
\fBmodule_name = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
نام ماژول پیام‌رسانی امن خارجی (پیش‌فرض: libsmm\-local\&.so)\&.
.RE
.PP
\fBmodule_path = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
دایرکتوری حاوی ماژول پیام‌رسانی امن خارجی (پیش‌فرض: /usr/lib)\&.
.sp
در صورتی که این مقدار پیکربندی در ویندوز یافت نشود، کلید رجیستری
Software\eOpenSC Project\eOpenSC\eSmDir
بررسی می‌شود\&.
.RE
.PP
\fBmodule_data = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
داده‌های مشخص برای تنظیم مقداردهی اولیه ماژول\&.
.RE
.PP
\fBmode = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
حالت پیام‌رسانی امن\&. پارامترهای شناخته‌شده:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
transmit: در این حالت روال امن‌سازی یک APDU توسط روال عمومی ارسال APDU در OpenSC فراخوانی می‌شود\&. در این حالت همه APDUها، به‌جز مواردی که توسط روال ویژه کارت فیلتر شده‌اند، امن‌سازی می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
acl: در این حالت APDUها تنها در صورت نیاز بر اساس ACLهای دستور در حال اجرا امن‌سازی می‌شوند\&.
.RE
.sp
.RE
.PP
\fBflags = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
فلگ‌های مختص به نوع پیام‌رسانی امن\&.
.RE
.PP
\fBkmc = \fR\fB\fIhexstring\fR\fR\fB;\fR
.RS 4
مقدار پیش‌فرض KMC متعلق به GP Card Manager برای کارت‌های جاوای Oberthur\&.
.RE
.PP
\fBifd_serial = \fR\fB\fIhexstring\fR\fR\fB;\fR
.RS 4
.RE
.PP
\fBkeyset[_\fR\fB\fIaid\fR\fR\fB]_\fR\fB\fInum\fR\fR\fB_enc = \fR\fB\fIvalue\fR\fR\fB;\fR \fBkeyset[_\fR\fB\fIaid\fR\fR\fB]_\fR\fB\fInum\fR\fR\fB_mac = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
مقادیر مجموعه‌کلید (keyset) از نمایه‌های IAM کارت‌های Gemalto IAS/ECC همراه با شناسه اختیاری برنامه (aid)\&.
.RE
.RE
.PP
\fBframework \fR\fB\fIname\fR\fR\fB { \fR\fB\fIblock_contents\fR\fR\fB } \fR
.RS 4
گزینه‌های پیکربندی داخلی که در آن
\fIname\fR
یکی از موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pkcs15: بخش
\(lqپیکربندی چارچوب PKCS#15 (Configuration of PKCS#15 Framework)\(rq
را ببینید
.RE
.sp
.RE
.PP
\fBpkcs11 { \fR\fB\fIblock_contents\fR\fR\fB } \fR
.RS 4
پارامترهای ماژول PKCS11 در OpenSC\&.
.sp
برای جزئیات، بخش
\(lqپیکربندی PKCS#11 (Configuration of PKCS#11)\(rq
را ببینید\&.
.RE
.SS "پیکربندی درایور کارت‌خوان هوشمند (Configuration of Smart Card Reader Driver)"
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBگزینه‌های پیکربندی برای تمامی درایورهای کارت‌خوان (Configuration Options for all Reader Drivers)\fR
.RS 4
.PP
\fBmax_send_size = \fR\fB\fInum\fR\fR\fB;\fR \fBmax_recv_size = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
محدود کردن اندازه‌های دستور و پاسخ (پیش‌فرض:
\fBmax_send_size\fR
=
255,
\fBmax_recv_size\fR
=
256)\&. برخی کارت‌خوان‌ها قابلیت‌های ارسال و دریافت خود را به‌درستی منتشر نمی‌کنند\&. گزینه‌های max_send_size و max_recv_size امکان تنظیم دستی این محدودیت‌ها را فراهم می‌کنند، برای مثال جهت فعال‌سازی قابلیت‌های طول گسترش‌یافته (extended length)\&.
.RE
.PP
\fBenable_escape \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
تشخیص قابلیت‌های کارت‌خوان با دستورات گریز (دستورات APDU بسته‌بندی‌شده با CLA=0xFF طبق تعریف در بخش ۳ استاندارد PC/SC و BSI TR\-03119، مانند دریافت UID، دستورات گریزدار PIN و نسخه سفت‌افزار کارت‌خوان، پیش‌فرض:
false)
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBپیکربندی کارت‌خوان‌های CT-API (Configuration of CT-API Readers)\fR
.RS 4
.PP
\fBmodule \fR\fB\fIfilename\fR\fR\fB { ports = \fR\fB\fInums\fR\fR\fB; } \fR
.RS 4
بارگذاری ماژول مشخص‌شده CT\-API با تعداد پورت‌های تعیین‌شده\&.
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBپیکربندی کارت‌خوان‌های PC/SC (Configuration of PC/SC Readers)\fR
.RS 4
.PP
\fBconnect_exclusive = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
اتصال به کارت‌خوان در حالت انحصاری (پیش‌فرض:
false)؟ این گزینه در مینی‌درایور ویندوز تاثیری ندارد\&.
.RE
.PP
\fBdisconnect_action = \fR\fB\fIaction\fR\fR\fB;\fR
.RS 4
اقدام لازم هنگام قطع اتصال از کارت (SCardDisconnect)\&. مقادیر معتبر عبارتند از
leave,
reset,
unpower
(پیش‌فرض:
leave)\&. این گزینه در مینی‌درایور ویندوز تاثیری ندارد\&.
.RE
.PP
\fBtransaction_end_action = \fR\fB\fIaction\fR\fR\fB;\fR
.RS 4
اقدام لازم در پایان تراکنش (SCardEndTransaction)\&. مقادیر معتبر عبارتند از
leave,
reset,
unpower
(پیش‌فرض:
leave)\&. این گزینه در مینی‌درایور ویندوز تاثیری ندارد\&.
.RE
.PP
\fBreconnect_action = \fR\fB\fIaction\fR\fR\fB;\fR
.RS 4
اقدام لازم هنگام اتصال مجدد به کارت (SCardReconnect)\&. مقادیر معتبر عبارتند از
leave,
reset,
unpower
(پیش‌فرض:
leave)\&. این گزینه در مینی‌درایور ویندوز تاثیری ندارد\&.
.RE
.PP
\fBenable_pinpad = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
فعال‌سازی صفحه‌کلید پین (pinpad) در صورت شناسایی (PC/SC v2\&.0\&.2 بخش ۱۰، پیش‌فرض:
true)
.RE
.PP
\fBfixed_pinlength = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
برخی کارت‌خوان‌های پین‌پد تنها می‌توانند یک طول دقیق از PIN را پردازش کنند\&.
\fBfixed_pinlength\fR
این مقدار را تعیین می‌کند تا OpenSC فاصله‌گذاری را به این طول گسترش دهد (پیش‌فرض:
0، یعنی ثابت نیست)\&.
.RE
.PP
\fBprovider_library = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
استفاده از ارائه‌دهنده مشخص PC/SC (پیش‌فرض:
libpcsclite\&.so\&.1)\&.
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBپیکربندی کارت‌خوان‌های OpenCT (Configuration of OpenCT Readers)\fR
.RS 4
.PP
\fBreaders = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
کارت‌خوان‌های مجازی برای تخصیص (پیش‌فرض:
2)\&.
.RE
.RE
.SS "گزینه‌های پیکربندی برای کارت MyEID (Configuration Options for MyEID Card)"
.PP
\fBdisable_hw_pkcs1_padding = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
کارت MyEID می‌تواند داده‌ها (کد هش) را بر اساس الگوریتم هش انتخاب‌شده (در حال حاضر تنها برای SHA1) به‌طور داخلی در ساختار DigestInfo ASN\&.1 کپسوله‌سازی کند\&. این ساختار طبق PKCS#1 v1\&.5، نوع بلوک 01h تا طول مدولوس کلید RSA فاصله‌گذاری (pad) می‌شود\&. اندازه DigestInfo نباید از ۴۰٪ طول مدولوس کلید RSA فراتر رود\&. اگر این محدودیت رضایت‌بخش نباشد (برای مثال شخصی به RSA 1024 با SHA512 نیاز داشته باشد)، کاربر می‌تواند این ویژگی را غیرفعال کند\&. در این حالت، درایور کارت تمام اقدامات لازم را پیش از ارسال داده‌ها (کد هش) به کارت انجام خواهد داد\&.
.sp
فاصله‌گذاری PKCS#1 v1\&.5 در سخت‌افزار می‌تواند به‌صورت سراسری با گزینه
disable_hw_pkcs1_padding
غیرفعال شود\&. هنگامی که از گزینه سراسری برای غیرفعال‌سازی فاصله‌گذاری استفاده شود، فاصله‌گذاری غیرفعال خواهد شد حتی اگر گزینه مختص به MyEID آن را خاموش نکرده باشد\&.
.RE
.SS "گزینه‌های پیکربندی برای کارت شناسایی آلمان (Configuration Options for German ID Card)"
.PP
\fBcan = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
کارت شناسایی آلمان نیاز دارد که CAN قبل از QES PIN اعتبارسنجی شود\&. با این حال، این بخش جزو نمایه PKCS#15 کارت نیست\&. بنابراین برای اعتبارسنجی QES PIN در واقع به هر دوی آن‌ها نیاز داریم\&. مقدار CAN ممکن است در اینجا داده شود\&. اگر CAN در اینجا داده نشود، در خط فرمان یا روی کارت‌خوان (بسته به قابلیت‌های کارت‌خوان) درخواست خواهد شد\&.
.RE
.PP
\fBst_dv_certificate = \fR\fB\fIfilename\fR\fR\fB;\fR \fBst_certificate = \fR\fB\fIfilename\fR\fR\fB;\fR \fBst_key = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
قابلیت QES تنها با یک کارت‌خوان کامفورت (CAT\-K) امکان‌پذیر است که دارای یک کلید رمزنگاری برای احراز هویت خود به‌عنوان پایانه امضا (ST) می‌باشد\&. ما معمولاً از قابلیت کارت‌خوان برای امضای داده‌ها استفاده خواهیم کرد\&. با این حال، در طول فرایند توسعه می‌توانید گواهی‌ها و کلیدهای نرم‌افزاری را برای یک ST مشخص کنید\&.
.sp
یک نمونه PKI را می‌توان در داده‌های نمونه برای
\m[blue]\fBشبیه‌ساز کارت شناسایی آلمان\fR\m[]\&\s-2\u[1]\d\s+2
یافت\&.
.RE
.SS "گزینه‌های پیکربندی برای DNIe (Configuration Options for DNIe)"
.PP
\fBuser_consent_enabled = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
پیکربندی پیام هشدار هنگام انجام عملیات امضا با DNIe\&. تنها در صورت کامپایل با
\fB\-\-enable\-dnie\-ui\fR
استفاده می‌شود\&.
.RE
.PP
\fBuser_consent_app = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
مشخص کردن برنامه pinentry مورد استفاده در صورتی که هشدار برای نمایش با استفاده از pinentry پیکربندی شده باشد (پیش‌فرض:
/usr/bin/pinentry)\&. تنها در صورت کامپایل با
\fB\-\-enable\-dnie\-ui\fR
استفاده می‌شود\&.
.RE
.SS "گزینه‌های پیکربندی برای کارت eID لهستان (Configuration Options for Polish eID Card)"
.PP
\fBcan = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
مقدار CAN (شماره دسترسی به کارت \(en عدد ۶ رقمی چاپ‌شده در گوشه پایین سمت راست روی مدرک) برای برقراری ارتباط با کارت الزامی است\&. این مقدار ممکن است توسط متغیر محیطی
EDO_CAN
بازنویسی شود\&. در حال حاضر امکان تنظیم آن به هیچ روش دیگری وجود ندارد\&.
.RE
.SS "گزینه‌های پیکربندی برای کارت eID اسلوونی (Configuration Options for Slovenian eID Card)"
.PP
\fBcan = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
مقدار CAN (شماره دسترسی به کارت \(en عدد ۶ رقمی چاپ‌شده در گوشه پایین سمت راست روی مدرک) برای برقراری ارتباط با کارت الزامی است\&. این مقدار ممکن است توسط متغیر محیطی
EOI_CAN
بازنویسی شود\&. از آنجا که CAN روی کارت نیز ذخیره شده است (به‌صورت رمزگذاری‌شده)، می‌توان از آن برای برقراری خودکار ارتباط امن استفاده کرد، اما فقط در صورتی که به کارت از طریق رابط تماسی دسترسی پیدا شود\&.
.RE
.SS "گزینه‌های پیکربندی برای کارت‌های امضای D\-Trust (Configuration Options for D\-Trust Signature Cards)"
.PP
\fBcan = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
مقدار CAN (شماره دسترسی به کارت \(en عدد ۶ رقمی چاپ‌شده روی کارت) برای برقراری ارتباط با کارت الزامی است\&. این مقدار ممکن است توسط متغیر محیطی
DTRUST_CAN
بازنویسی شود\&. اگر در اینجا مشخص نشود، مقدار CAN از حافظه موقت (کش) ویژه کارت خوانده می‌شود، روی صفحه‌کلید پین کارت‌خوان درخواست می‌شود، یا به‌صورت تعاملی و به ترتیب زیر دریافت خواهد شد:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
متغیر محیطی
DTRUST_CAN
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
گزینه موجود در این فایل پیکربندی
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
حافظه موقت ویژه کارت در PKCS#15
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
صفحه‌کلید پین یک کارت‌خوان با قابلیت PACE
.RE
.RE
.PP
\fBcan_use_cache = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
ذخیره شماره CAN کارت در حافظه موقت پس از ارائه آن توسط کاربر در دایرکتوری
file_cache_dir\&. شماره CAN ذخیره‌شده بعداً برای جلوگیری از درخواست تعاملی CAN استفاده می‌شود\&. این ویژگی به‌طور پیش‌فرض فعال است\&.
.RE
.SS "گزینه‌های پیکربندی برای کارت PIV (Configuration Options for PIV Card)"
.SS "پیکربندی بر اساس ATR (Configuration based on ATR)"
.PP
.PP
\fBatrmask = \fR\fB\fIhexstring\fR\fR\fB;\fR
.RS 4
این ماسک پیش از مقایسه با مقدار مرجع ATR در بالا، به‌صورت منطقی با ATR کارت AND می‌شود\&. استفاده از این ماسک امکان شناسایی و پیکربندی چندین ATR را به‌عنوان یک مدل کارت مشابه فراهم می‌کند\&.
.RE
.PP
\fBdriver = \fR\fB\fIname\fR\fR\fB;\fR
.RS 4
در صورت فعال بودن، تمام تنظیمات احتمالی موجود در فهرست پیکربندی داخلی درایور کارت را بازنویسی می‌کند\&.
.RE
.PP
\fBname = \fR\fB\fIname\fR\fR\fB;\fR
.RS 4
تنظیم نام کارت برای درایورهای کارتی که این امکان را می‌دهند\&.
.RE
.PP
\fBtype = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
امکان تنظیم نوع دقیق کارت که به‌صورت داخلی توسط درایور کارت استفاده می‌شود\&. مقادیر مجاز را می‌توان در کد منبع
cards\&.h
یافت\&.
.RE
.PP
\fBflags = \fR\fB\fIvalue\fR...\fR\fB;\fR
.RS 4
فلگ‌های کارت به‌صورت یک مقدار هگزادسیمال\&. چند مقدار مختلف با یکدیگر OR منطقی می‌شوند\&. بسته به درایور کارت، این گزینه امکان تنظیم دقیق قابلیت‌های درایور کارت را برای کارت شما فراهم می‌سازد\&.
.sp
به‌صورت اختیاری، برخی پارامترهای شناخته‌شده را می‌توان به‌صورت رشته مشخص کرد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
rng: منبع تولید عدد تصادفی روی خود کارت
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
keep_alive: درخواست از درایور کارت برای ارسال یک دستور «زنده نگه‌داشتن» قبل از هر تراکنش، جهت اطمینان از اینکه اپلت مورد نظر همچنان در حالت انتخاب قرار دارد\&.
.RE
.sp
.RE
.PP
\fBpkcs15emu = \fR\fB\fIname\fR\fR\fB;\fR
.RS 4
هنگام استفاده از شبیه‌سازی PKCS#15، تحمیل درایور شبیه‌سازی برای کارت‌های خاص\&. برای درایورهای خارجی الزامی است، اما برای درایورهای توکار نیز قابل استفاده می‌باشد\&.
.RE
.PP
\fBforce_protocol = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
تحمیل انتخاب پروتکل برای کارت‌های خاص\&. پارامترهای شناخته‌شده:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
t0
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
t1
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
raw
.RE
.sp
.RE
.PP
\fBread_only = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
علامت‌گذاری کارت به‌عنوان فقط‌خواندنی در رابط‌های PKCS#11/Minidriver/BaseCSP (پیش‌فرض:
false)\&.
.RE
.PP
\fBmd_supports_X509_enrollment = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
مشخص کردن پشتیبانی از ثبت‌نام X509 در رابط Minidriver/BaseCSP (پیش‌فرض:
false)\&.
.RE
.PP
\fBmd_guid_as_id = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
استفاده از GUID تولیدشده برای کلید به‌عنوان شناسه (id) در ساختار PKCS#15 (پیش‌فرض:
false، یعنی تولید خودکار)
.RE
.PP
\fBmd_guid_as_label = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
استفاده از GUID تولیدشده برای کلید به‌عنوان برچسب (label) در ساختار PKCS#15 (پیش‌فرض:
false، یعنی بدون برچسب)\&.
.RE
.PP
\fBmd_supports_container_key_gen = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
کارت امکان تولید جفت‌کلید روی خود کارت را می‌دهد (پیش‌فرض:
false)\&.
.RE
.PP
\fBmd_supports_container_key_import = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
کارت امکان وارد کردن کلیدهای خصوصی را می‌دهد (پیش‌فرض:
false)\&.
.RE
.PP
\fBmd_pinpad_dlg_title = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
عنوان پنجره کادر گفتگوی پین‌پد (پیش‌فرض:
"Windows Security")\&.
.RE
.PP
\fBmd_pinpad_dlg_icon = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
نام فایل آیکون برای کادر گفتگوی پین‌پد؛ از
""
برای حالت بدون آیکون استفاده کنید (پیش‌فرض: آیکون کارت هوشمند توکار)\&.
.RE
.PP
\fBmd_pinpad_dlg_main = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
دستورالعمل اصلی کادر گفتگوی پین‌پد (پیش‌فرض:
"OpenSC Smart Card Provider")\&.
.RE
.PP
\fBmd_pinpad_dlg_content_user = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
محتوای کادر گفتگوی پین‌پد برای نقش "user" (پیش‌فرض:
"Please enter your PIN on the PIN pad\&.")\&.
.RE
.PP
\fBmd_pinpad_dlg_content_user_sign = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
محتوای کادر گفتگوی پین‌پد برای نقش "user+signature" (پیش‌فرض:
"Please enter your digital signature PIN on the PIN pad\&.")\&.
.RE
.PP
\fBmd_pinpad_dlg_content_admin = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
محتوای کادر گفتگوی پین‌پد برای نقش "admin" (پیش‌فرض:
"Please enter your PIN to unblock the user PIN on the PIN pad\&.")
.RE
.PP
\fBmd_pinpad_dlg_expanded = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
اطلاعات گسترش‌یافته کادر گفتگوی پین‌پد (پیش‌فرض:
"This window will be closed automatically after the PIN has been submitted on the PIN pad (timeout typically after 30 seconds)\&.")
.RE
.PP
\fBmd_pinpad_dlg_enable_cancel = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
اجازه دادن به کاربر برای لغو کادر گفتگوی پین‌پد (پیش‌فرض:
false)\&. اگر این مقدار روی
true
تنظیم شود، کاربر باید روی "OK" کلیک کند تا اعتبارسنجی PIN روی پین‌پد شروع شود\&. کاربر می‌تواند با فعال یا غیرفعال کردن جعبه انتخاب در کادر گفتگو، رفتار پیش‌فرض را برگزیند\&. این تنظیم بر اساس مسیر کامل برنامه‌ای (\fIprogram_path\fR) که از OpenSC استفاده می‌کند ذخیره می‌شود\&.
.sp
کلید رجیستری
HKCU\eSoftware\eOpenSC Project\eOpenSC\emd_pinpad_dlg_enable_cancel\e\fIprogram_path\fR
این تنظیم را با یک
DWORD
تنظیم‌شده روی
1
(فعال) یا
0
(غیرفعال) بازنویسی می‌کند\&.
.RE
.PP
\fBmd_pinpad_dlg_timeout = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
زمان بر حسب ثانیه برای پیشروی نوار پیشرفت کادر گفتگوی پین‌پد\&. مقدار
0
نوار پیشرفت را حذف می‌کند (پیش‌فرض:
30)\&.
.RE
.PP
\fBnotify_card_inserted = \fR\fB\fIvalue\fR\fR\fB;\fR \fBnotify_card_inserted_text = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
عنوان و متن اعلان هنگام وارد شدن کارت (پیش‌فرض:
"Smart card detected"، ATR کارت)\&.
.RE
.PP
\fBnotify_card_removed = \fR\fB\fIvalue\fR\fR\fB;\fR \fBnotify_card_removed_text = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
عنوان و متن اعلان هنگام خارج شدن کارت (پیش‌فرض:
"Smart card removed"، نام کارت‌خوان هوشمند)\&.
.RE
.PP
\fBnotify_pin_good = \fR\fB\fIvalue\fR\fR\fB;\fR \fBnotify_pin_good_text = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
عنوان و متن اعلان هنگام تایید PIN (پیش‌فرض:
"PIN verified",
"Smart card is unlocked")\&.
.RE
.PP
\fBnotify_pin_bad = \fR\fB\fIvalue\fR\fR\fB;\fR \fBnotify_pin_bad_text = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
عنوان و متن اعلان هنگام نادرست بودن PIN (پیش‌فرض:
"PIN not verified",
"Smart card is locked")\&.
.RE
.SS "پیکربندی چارچوب PKCS#15 (Configuration of PKCS#15 Framework)"
.PP
\fBuse_file_caching = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
تعیین اینکه آیا فایل‌های کارت (مانند گواهی‌ها) روی دیسک در
\fBfile_cache_dir\fR
ذخیره موقت (کش) شوند یا خیر\&. پارامترهای ممکن:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
yes: ذخیره موقت تمام فایل‌ها (عمومی و خصوصی)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
public: ذخیره موقت تنها فایل‌های عمومی\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
no: غیرفعال بودن ذخیره موقت فایل‌ها\&.
.RE
.sp
(پیش‌فرض:
public
برای درایورهای کارت زیر
atrust\-acos
(درایور غیرفعال‌شده)،
belpic,
cac1,
cac,
coolkey,
dnie,
edo,
esteid2018,
esteid2025,
flex
(درایور غیرفعال‌شده)،
cyberflex
(درایور غیرفعال‌شده)،
gemsafeV1,
idprime,
itacns,
jpki,
MaskTech,
mcrd
(درایور غیرفعال‌شده)،
npa,
nqapplet,
tcos,
dtrust
و در غیر این صورت
no)\&.
.sp
اگر ذخیره‌سازی موقت توسط یک فرایند سیستمی انجام شود، ممکن است فایل‌های کش‌شده از حساب کاربری غیرقابل‌دسترس شوند\&. اگر می‌خواهید اطلاعات کش‌شده را به اشتراک بگذارید، از یک مکان خواندنی و نوشتنی به‌صورت سراسری استفاده کنید\&. توجه داشته باشید که فایل‌های کش‌شده ممکن است حاوی داده‌های شخصی مانند نام و نشانی ایمیل باشند\&.
.RE
.PP
\fBfile_cache_dir = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
محل ذخیره موقت فایل‌های کارت\&. مقادیر پیش‌فرض عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB$XDG_CACHE_HOME\fR/opensc/
(اگر
\fB$XDG_CACHE_HOME\fR
تعریف شده باشد)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB$HOME\fR/\&.cache/opensc/
(یونیکس)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB$USERPROFILE\fR\e\&.eid\-cache\e
(ویندوز)
.RE
.sp
اگر ذخیره‌سازی موقت توسط یک فرایند سیستمی انجام شود، ممکن است فایل‌های کش‌شده از حساب کاربری غیرقابل‌دسترس شوند\&. اگر می‌خواهید اطلاعات کش‌شده را به اشتراک بگذارید، از یک مکان خواندنی و نوشتنی به‌صورت سراسری استفاده کنید\&. توجه داشته باشید که فایل‌های کش‌شده ممکن است حاوی داده‌های شخصی مانند نام و نشانی ایمیل باشند\&.
.sp
درایور کارت PIV\-II از فهرست اشیای پیشینه کلیدها و گواهی‌های بازنشسته‌شده در صورتی که در دایرکتوری کش فایل قابل خواندن باشند پشتیبانی می‌کند\&. اگر نشانی (URL) شیء مشخص‌شده به‌صورت
"http://"\fIDNS name\fR"/"\fIASCII\-HEX OffCardKeyHistoryFile\fR
باشد، آنگاه برای نام فایل
\fIOffCardKeyHistoryFile\fR
در دایرکتوری کش جستجو می‌کند\&.
.RE
.PP
\fBuse_pin_caching = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
استفاده از ذخیره‌سازی موقت (کش) PIN (پیش‌فرض:
true)؟
.RE
.PP
\fBpin_cache_counter = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
چندین بار استفاده از یک PIN از حافظه موقت پیش از اعتبارسنجی مجدد آن (پیش‌فرض:
10)؟
.RE
.PP
\fBpin_cache_ignore_user_consent = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
برنامه‌های قدیمی‌تر PKCS#11 که از
CKA_ALWAYS_AUTHENTICATE
پشتیبانی نمی‌کنند ممکن است نیاز به فعال کردن این گزینه داشته باشند تا امضاها با برخی کارت‌ها کار کنند (پیش‌فرض:
false)\&.
.sp
توصیه می‌شود گزینه ذخیره موقت PIN را نیز با استفاده از
use_pin_caching
فعال کنید تا OpenSC بتواند در زمان نیاز PIN را در اختیار کارت قرار دهد\&.
.RE
.PP
\fBpin_protected_certificate = \fR\fB\fIvalue\fR\fR\fB;\fR
.RS 4
نحوه مدیریت یک گواهی محافظت‌شده با PIN\&. پارامترهای شناخته‌شده:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
protect: گواهی همچنان محافظت‌شده با PIN باقی می‌ماند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
declassify: اجازه خواندن گواهی بدون اجبار به اعتبارسنجی PIN داده می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ignore: نادیده گرفتن گواهی‌های محافظت‌شده با PIN\&.
.RE
.sp
(پیش‌فرض:
protect\&.
.RE
.PP
\fBenable_pkcs15_emulation = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
فعال‌سازی شبیه‌سازی pkcs15 (پیش‌فرض:
true)\&.
.RE
.PP
\fBtry_emulation_first = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
اولویت دادن به کد شبیه‌سازی pkcs15 پیش از پردازش عادی pkcs15 (پیش‌فرض:
no)\&. برخی کارت‌ها فقط در حالت شبیه‌سازی کار می‌کنند و به این گزینه وابسته نیستند\&.
.RE
.PP
\fBenable_builtin_emulation = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
فعال‌سازی شبیه‌سازهای توکار (پیش‌فرض:
true)\&.
.RE
.PP
\fBbuiltin_emulators = \fR\fB\fIemulators\fR\fR\fB;\fR
.RS 4
فهرست شبیه‌سازهای توکار pkcs15 جهت بررسی (پیش‌فرض:
internal)
.sp
مقدار ویژه
internal
تمامی شبیه‌سازهای غیرفعال‌نشده توکار pkcs15 را بررسی می‌کند\&.
.sp
مقدار ویژه
old
تمامی شبیه‌سازهای غیرفعال‌شده pkcs15 را بررسی می‌کند\&.
.RE
.PP
\fBpkcs11_enable_InitToken = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
فعال‌سازی مقداردهی اولیه و شناسایی کارت (پیش‌فرض:
false)\&.
.RE
.PP
\fBemulate \fR\fB\fIname\fR\fR\fB { \fR\fB\fIblock_contents\fR\fR\fB } \fR
.RS 4
گزینه‌های پیکربندی برای یک شبیه‌ساز PKCS#15 که در آن
\fIname\fR
یک نام کوتاه برای درایور کارت خارجی است\&.
.PP
\fBmodule = \fR\fB\fIfilename\fR\fR\fB;\fR
.RS 4
برای شبیه‌سازهای pkcs15 که از یک کتابخانه اشتراکی/DLL خارجی بارگذاری می‌شوند، باید مسیر ماژول را مشخص کرده و نمونه card_atr را در بالا به‌درستی سفارشی کنید\&.
.RE
.PP
\fBfunction = \fR\fB\fIname\fR\fR\fB;\fR
.RS 4
دریافت نام تابع مقداردهی اولیه شبیه‌ساز (پیش‌فرض:
sc_pkcs15_init_func_ex)
.RE
.RE
.PP
\fBapplication \fR\fB\fIhexstring\fR\fR\fB { \fR\fB\fIblock_contents\fR\fR\fB } \fR
.RS 4
پیکربندی برنامه روی کارت که در آن
\fIhexstring\fR
شناسه برنامه (AID) است\&.
.PP
\fBtype = \fR\fB\fIname\fR\fR\fB;\fR
.RS 4
نوع برنامه که در آن
\fIname\fR
یکی از موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
generic
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
protected
.RE
.sp
برای تمایز بین برنامه دسترسی مشترک و برنامه‌ای که در آن احراز هویت برای انجام برخی عملیات‌ها با رویه‌های مشترک به دست نمی‌آید (مانند ایجاد شیء محافظت‌شده با پیام‌رسانی امن) استفاده می‌شود\&. توسط ماژول PKCS#11 که برای ارائه تعداد محدودی از اسلات‌ها پیکربندی شده استفاده می‌گردد (مثلاً پیکربندی‌شده برای ارائه تنها اسلات User PIN، اسلات‌های User و Sign PINs، و غیره)\&.
.RE
.PP
\fBmodel = \fR\fB\fIname\fR\fR\fB;\fR
.RS 4
.RE
.PP
\fBdisable = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
عدم نمایش برنامه در چارچوب PKCS#15 (پیش‌فرض:
false)
.RE
.PP
\fBuser_pin = \fR\fB\fIname\fR\fR\fB;\fR
.RS 4
نام شیء User PIN که به‌عنوان PIN اصلی استفاده خواهد شد\&.
.RE
.PP
\fBsign_pin = \fR\fB\fIname\fR\fR\fB;\fR
.RS 4
نام شیء PIN که برای امضا استفاده خواهد شد\&.
.RE
.RE
.SS "پیکربندی PKCS#11 (Configuration of PKCS#11)"
.PP
\fBmax_virtual_slots = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
حداکثر تعداد اسلات‌های مجازی (پیش‌فرض:
16)\&. اگر اسلات‌های بیشتری نسبت به مقدار تعریف‌شده در اینجا وجود داشته باشد، اسلات‌های باقی‌مانده از دید PKCS#11 پنهان خواهند شد\&.
.RE
.PP
\fBslots_per_card = \fR\fB\fInum\fR\fR\fB;\fR
.RS 4
حداکثر تعداد اسلات‌های PIN به ازای هر کارت هوشمند (پیش‌فرض:
4)\&. اگر کارت تعداد PINهای کمتری نسبت به مقدار تعریف‌شده در اینجا داشته باشد، اسلات‌های باقی‌مانده خالی خواهند بود\&. برای فایرفاکس، کروم و کرومیوم، مقدار
\fBslots_per_card\fR
روی
1
تنظیم می‌شود تا از درخواست PINهای نامرتبط جلوگیری شود\&. معمولاً این کار در عمل کلیدها و PINهای امضا را غیرفعال می‌کند\&.
.RE
.PP
\fBlock_login = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
به‌طور پیش‌فرض، ماژول PKCS#11 در OpenSC پس از اینکه از طریق
C_Login
احراز هویت کردید، کارت شما را قفل نمی‌کند (پیش‌فرض:
false)\&. بنابراین کاربران یا برنامه‌های دیگر از اتصال به کارت و انجام عملیات رمزنگاری منع نمی‌شوند (که ممکن است به دلیل احراز هویت قبلی شما در کارت امکان‌پذیر باشد)\&. این تنظیم چندان امن نیست\&.
.sp
همچنین اگر کارت شما قفل نشود، ممکن است به دلیل محدودیت‌های چارچوب OpenSC که هنوز در محیط چندنخی به‌طور کامل آزمایش نشده است، با مشکلاتی روبرو شوید\&.
.sp
در صورتی که قفل کردن کارت را برگزینید، تنظیمات شما امن‌تر خواهد بود\&. با این وجود این رفتار یک نقض شناخته‌شده از مشخصات PKCS#11 محسوب می‌شود\&. اکنون هنگامی که یک برنامه با
C_Login
استفاده از کارت شما را آغاز کند، هیچ برنامه دیگری نمی‌تواند از آن استفاده نماید تا زمانی که برنامه اول کارش پایان یابد و
C_Logout
یا
C_Finalize
را فراخوانی کند\&. در مورد بسیاری از برنامه‌های PKCS#11 این اتفاق تا زمان خروج از برنامه رخ نمی‌دهد\&.
.sp
بنابراین استفاده همزمان از چندین برنامه که از کارت هوشمند آگاهی دارند غیرممکن است؛ برای مثال نمی‌توانید هم‌زمان
Firefox
و
Thunderbird
را اجرا کنید اگر هر دو برای استفاده از کارت هوشمند شما پیکربندی شده باشند\&.
.RE
.PP
\fBatomic = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
به‌طور پیش‌فرض، تعامل با ماژول PKCS#11 در OpenSC ممکن است وضعیت توکن را تغییر دهد، مانند اینکه آیا کاربری وارد شده است یا خیر (پیش‌فرض:
false)\&.
.sp
بنابراین سایر کاربران یا برنامه‌ها ممکن است ناخواسته وضعیت توکن را تغییر داده یا از آن استفاده کنند\&. برنامه‌های دیگر ممکن است با سوءاستفاده از یک ورود فعال، امضا ایجاد کنند یا بدون جلب توجه خارج شوند\&.
.sp
با فعال‌سازی این تنظیم، وضعیت ورود توکن ردیابی و ذخیره موقت (کش) می‌شود (شامل PIN)\&. پیش از هر تراکنش، وضعیت ورود بازیابی می‌شود\&. پس از هر تراکنش، خروج انجام می‌گیرد\&. این تنظیم به‌طور پیش‌فرض گزینه
\fBlock_login\fR
را نیز فعال می‌کند تا دسترسی سایر برنامه‌ها در طول تراکنش‌های اتمیک قطع شود\&.
.sp
لطفاً توجه داشته باشید که هرگونه پین‌پد باید غیرفعال شود (به
\fBenable_pinpad\fR
مراجعه کنید)، زیرا کاربر مجبور خواهد بود برای هر تراکنش PIN خود را وارد کند\&.
.RE
.PP
\fBinit_sloppy = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
با غیرفعال بودن این تنظیم، ماژول PKCS#11 در OpenSC اسلات‌های موجود را زمانی مقداردهی اولیه می‌کند که برنامه
C_GetSlotList
را فراخوانی کند\&. با فعال بودن این تنظیم، اسلات‌ها هنگام فراخوانی
C_GetSlotInfo
نیز مقداردهی اولیه خواهند شد (پیش‌فرض:
true)\&.
.sp
این تنظیم یک راهکار جایگزین برای
Java
است که در صورت پیکربندی با
slot
ایستا به‌جای
slotListIndex،
تابع
C_GetSlotList
را فراخوانی نمی‌کند\&.
.RE
.PP
\fBuser_pin_unblock_style = \fR\fB\fImode\fR\fR\fB;\fR
.RS 4
سبک رفع مسدودی User PIN با حالت
\fImode\fR
که یکی از موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
none
(پیش‌فرض): رفع مسدودی PIN از طریق API در PKCS#11 امکان‌پذیر نیست
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
set_pin_in_unlogged_session:
تابع
C_SetPIN
در نشست بدون ورود: مقدار PUK به‌عنوان آرگومان
OldPin
در فراخوانی
C_SetPIN
ارسال می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
set_pin_in_specific_context:
تابع
C_SetPIN
در نشست واردشده با
CKU_SPECIFIC_CONTEXT:
مقدار PUK به‌عنوان آرگومان
OldPin
در فراخوانی
C_SetPIN
ارسال می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
init_pin_in_so_session:
تابع
C_InitPIN
در نشست واردشده با
CKU_SO:
رفع مسدودی پین کاربر (\*(AqUNBLOCK\*(Aq) با SOPIN محافظت می‌شود\&. (PUK == SOPIN)\&.
.RE
.sp
.RE
.PP
\fBcreate_puk_slot = \fR\fB\fIbool\fR\fR\fB;\fR
.RS 4
ایجاد اسلات برای رفع مسدودی PIN با استفاده از PUK (پیش‌فرض:
false)\&. به این ترتیب می‌توان از API در PKCS#11 برای ورود با PUK و تغییر یک PIN استفاده کرد\&. ممکن است با برخی برنامه‌ها مانند
Firefox
و
Thunderbird
مشکلاتی ایجاد کند\&.
.RE
.PP
\fBcreate_slots_for_pins = \fR\fB\fImode\fR...\fR\fB;\fR
.RS 4
نام‌های نمادین PINهایی که اسلات‌ها برای آن‌ها ایجاد می‌شوند که در آن
\fImode\fR
فهرستی از موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
all
(پیش‌فرض): تمام PINهای غیر SO\-PIN و غیر رفع‌مسدودی
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
user: اولین PIN عمومی یا اولین PIN محلی
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
sign: دومین PIN (اولین محلی، دومین عمومی یا دومین محلی)
.RE
.sp
کارت می‌تواند شامل بیش از یک PIN یا بیش از یک برنامه روی کارت همراه با PINهای ویژه خود باشد\&. به‌طور معمول، برای دسترسی به همه آن‌ها با رابط برنامه‌نویسی PKCS#11 باید برای هر کدام یک اسلات ایجاد شود\&. اسلات‌های متعدد می‌تواند برای برخی برنامه‌های پرکاربرد مانند Firefox آزاردهنده باشد\&. این پارامتر پیکربندی امکان انتخاب PIN(هایی) را فراهم می‌کند که اسلات PKCS#11 برای آن‌ها ساخته خواهد شد\&.
.sp
تنها PINهای مقداردهی‌شده، غیر از SO\-PIN و غیر از رفع‌مسدودی با یک نام نمادین مرتبط می‌شوند\&.
.sp
برای اینکه ماژول، رفتار ماژول opensc\-onepin را شبیه‌سازی کند، گزینه زیر استفاده می‌شود:
\fBcreate_slots_for_pins = "user";\fR
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fBOPENSC_CONF\fR
.RS 4
نام فایل برای یک فایل پیکربندی تعریف‌شده توسط کاربر
.sp
اگر این متغیر محیطی در ویندوز یافت نشود، کلید رجیستری
Software\eOpenSC Project\eOpenSC\eConfigFile
بررسی می‌شود\&.
.RE
.PP
\fBOPENSC_DEBUG\fR
.RS 4
ببینید
\fBdebug = \fR\fB\fInum\fR\fR\fB;\fR
.RE
.PP
\fBOPENSC_DRIVER\fR
.RS 4
ببینید
\fBcard_drivers = \fR\fB\fIname\fR...\fR\fB;\fR
.RE
.PP
\fBCARDMOD_LOW_LEVEL_DEBUG\fR
.RS 4
نوشتن اطلاعات اشکال‌زدایی مینی‌درایور در
C:\etmp\emd\&.log، در صورتی که روی
1
تنظیم شده باشد\&.
.sp
اگر این متغیر محیطی در ویندوز یافت نشود، کلید رجیستری
Software\eOpenSC Project\eOpenSC\eMiniDriverDebug
بررسی می‌شود\&.
.RE
.PP
\fBPIV_EXT_AUTH_KEY\fR, \fBPIV_9A_KEY\fR, \fBPIV_9C_KEY\fR, \fBPIV_9D_KEY\fR, \fBPIV_9E_KEY\fR
.RS 4
پیکربندی PIV در طول مقداردهی اولیه با
piv\-tool\&.
.RE
.PP
\fBPIV_USE_SM\fR, \fBPIV_PAIRING_CODE\fR
.RS 4
پیکربندی PIV در طول مقداردهی اولیه؛ بخش «گزینه‌های پیکربندی برای کارت PIV (Configuration Options for PIV Card)» را ببینید\&.
.RE
.SH "فایل‌ها (FILES)"
.PP
/etc/opensc\&.conf
.RS 4
فایل پیکربندی سراسری سیستم
.RE
.PP
/usr/share/doc/opensc/opensc\&.conf
.RS 4
فایل نمونه گسترش‌یافته پیکربندی
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
شبیه‌ساز کارت شناسایی آلمان (German ID card emulator)
.RS 4
\%https://github.com/frankmorgner/vsmartcard/tree/master/virtualsmartcard/npa-example-data
.RE