نام (NAME)

softhsm2.conf - فایل پیکربندی SoftHSM

خلاصه دستور (SYNOPSIS)

softhsm2.conf

توضیحات (DESCRIPTION)

این فایل پیکربندی برای SoftHSM است. این فایل در یک مسیر پیش‌فرض قرار دارد، اما می‌توان با استفاده از متغیر محیطی مسیر آن را تغییر داد. هرگونه پیکربندی باید مطابق با قالب فایل توضیح داده شده در این سند انجام شود.

قالب فایل (FILE FORMAT)

هر گزینه پیکربندی یک جفت نام و مقدار است که با علامت مساوی از یکدیگر جدا شده‌اند. هر گزینه پیکربندی باید در یک خط تکی قرار گیرد.

<name> = <value>

همچنین می‌توان با استفاده از علامت هشتگ (#) یادداشت‌ها یا توضیحات را به فایل اضافه کرد. هر چیزی بعد از علامت هشتگ نادیده گرفته خواهد شد.

# A comment

هر خط خالی یا خطوطی که قالب صحیحی ندارند نادیده گرفته خواهند شد.

DIRECTORIES.TOKENDIR

مکانی که SoftHSM می‌تواند توکن‌ها را در آن ذخیره کند.

directories.tokendir = /var/lib/softhsm/tokens/

OBJECTSTORE.BACKEND

بک‌اند (پشتیبان) مورد استفاده توسط SoftHSM برای ذخیره اشیاء توکن. هر یک از گزینه‌های "file" یا "db" پشتیبانی می‌شوند. برای استفاده از بک‌اند "db"، کامپایل و ساخت SoftHSM باید با گزینه "configure --with-objectstore-backend-db" پیکربندی شده باشد.

objectstore.backend = file

OBJECTSTORE.UMASK

ماسک حالت ایجاد فایل (umask) که توسط SoftHSM هنگام ایجاد فایل‌ها یا دایرکتوری‌ها استفاده می‌شود. این مقدار در مبنای هشت (اکتال) است. این مقدار علاوه بر umask فرایند اعمال می‌شود و نمی‌تواند آن را بازنویسی کند.

objectstore.umask = 0077

LOG.LEVEL

سطح ثبت گزارش (لاگ) که می‌تواند روی ERROR، WARNING، INFO یا DEBUG تنظیم شود.

log.level = INFO

SLOTS.REMOVABLE

اگر روی true تنظیم شود، مقدار CKF_REMOVABLE_DEVICE در پرچم‌های بازگردانده شده توسط C_GetSlotInfo قرار می‌گیرد. مقدار پیش‌فرض false است.

slots.removable = true

SLOTS.MECHANISMS

امکان فعال‌سازی و غیرفعال‌سازی هر یک از مکانیزم‌های PKCS#11 گزارش شده در C_GetMechanismList() را فراهم می‌کند. این گزینه یک آرگومان رشته‌ای شامل فهرستی از تمام الگوریتم‌هایی که باید فعال شوند (جدا شده با کاما) را می‌پذیرد (مکانیزم‌های keygen را فراموش نکنید). می‌توان به ابتدای فهرست یک علامت منفی "-" اضافه کرد تا فقط مکانیزم‌های غیرفعال فهرست شوند. علاوه بر این، کلیدواژه ویژه ALL می‌تواند برای فعال کردن تمام مکانیزم‌های شناخته‌شده استفاده شود (پیش‌فرض). مکانیزم‌های ناشناخته نادیده گرفته می‌شوند. این گزینه اولویت بالاتری نسبت به مشخصه CKA_ALLOWED_MECHANISMS روی اشیاء کلید دارد.

slots.mechanisms = ALL

LIBRARY.RESET_ON_FORK

اگر روی true تنظیم شود، کتابخانه وضعیت را هنگام انشعاب فرایند (fork) بازنشانی می‌کند. پیش‌فرض false است.

library.reset_on_fork = true

محیط (ENVIRONMENT)

SOFTHSM2_CONF

هنگامی که تعریف شود، مقدار آن به عنوان مسیر فایل پیکربندی استفاده خواهد شد.

فایل‌ها (FILES)

~/.config/softhsm2/softhsm2.conf

مسیر پیش‌فرض مختص کاربر برای فایل پیکربندی SoftHSM؛ در صورت وجود، پیکربندی سراسری سیستم را نادیده می‌گیرد.

/etc/softhsm2.conf

مسیر پیش‌فرض سراسری سیستم برای فایل پیکربندی SoftHSM

/etc/softhsm2.conf.sample

یک نمونه از فایل پیکربندی SoftHSM

نویسندگان (AUTHORS)

نوشته شده توسط Rickard Bellgrim، Francis Dupont، René Post و Roland van Rijswijk.

همچنین ببینید (SEE ALSO)

softhsm2-keyconv(1), softhsm2-migrate(1), softhsm2-util(1)