NVME-TLS-KEY(1) NVMe Manual NVME-TLS-KEY(1)

nvme-tls-key - مدیریت و تولید کلیدهای امنیتی TLS برای NVMe-oF

nvme tls-key [--keyring=<name> | -k <name>]
                        [--keytype=<type> | -t <type>]
                        [--keyfile=<file> | -f <file>]
                        [--import | -i] [--export | -e]
                        [--revoke=<description>| -r <description>]
                        [--verbose | -v]

وارد کردن (Import)، صادر کردن (Export) یا حذف کلیدهای از پیش به اشتراک گذاشته شده (PSK) مربوط به NVMe TLS از جاکلیدی (keystore) سیستم. زمانی که گزینه --export مشخص شود، تمام کلیدهای NVMe TLS PSK در قالب زیر صادر می‌شوند:

<descriptions> <psk>

که در آن <description> توضیحات کلید صادرشده و <psk> داده‌های کلید در قالب تبادل PSK به صورت NVMeTLSkey-1:01:<base64 encoded data>: است. هر کلید در یک خط جداگانه صادر می‌شود. زمانی که گزینه --import مشخص شود، داده‌های کلید با همین قالب خوانده شده و به جاکلیدی هسته (kernel keystore) وارد می‌شوند.

-k <name>, --keyring=<name>

نام جاکلیدی (keyring) که کلید TLS نگهداری‌شده (retained) باید در آن ذخیره شود. مقدار پیش‌فرض .nvme است.

-t <type>, --keytype=<type>

نوع کلید برای کلید TLS حاصل. مقدار پیش‌فرض psk است.

-f <file>, --keyfile=<file>

فایلی که باید کلیدها از آن خوانده یا در آن نوشته شوند به‌جای ورودی استاندارد (stdin) / خروجی استاندارد (stdout).

-i, --import

خواندن داده‌های کلید از فایل تعیین‌شده توسط --keyfile یا ورودی استاندارد (stdin) در صورت عدم تعیین فایل.

-e, --export

نوشتن داده‌های کلید در فایل تعیین‌شده توسط --keyfile یا خروجی استاندارد (stdout) در صورت عدم تعیین فایل.

-r <description>, --revoke=<description>

ابطال یک کلید از جاکلیدی (keyring).

-v, --verbose

افزایش سطح جزئیات اطلاعات در خروجی.

•ایجاد یک کلید TLS جدید و درج مستقیم آن در جاکلیدی .nvme:
# nvme gen-tls-key -i -n hostnqn0 -c subsys0
NVMeTLSkey-1:01:/b9tVz2OXJVISnoFgrPAygyS86XYJWkAapQeULns6PMpM8wv:
Inserted TLS key 26b3260e
•صادر کردن کلید قبلاً ایجاد شده از جاکلیدی هسته و ذخیره آن در یک فایل:
# nvme tls-key -e -f nvme-tls-keys.txt
•صادر کردن/فهرست کردن همه کلیدها از جاکلیدی .nvme با استفاده از nvme و keyctl:
# nvme tls-key --export
NVMe0R01 hostnqn0 subsys0 NVMeTLSkey-1:01:/b9tVz2OXJVISnoFgrPAygyS86XYJWkAapQeULns6PMpM8wv:
# keyctl show
Session Keyring
 573249525 --alswrv      0     0  keyring: _ses
 353599402 --alswrv      0 65534   \_ keyring: _uid.0
 475911922 ---lswrv      0     0   \_ keyring: .nvme
 649274894 --als-rv      0     0       \_ psk: NVMe0R01 hostnqn0 subsys0
•ابطال یک کلید با استفاده از توضیحات آن و اعتبارسنجی عملیات با keyctl:
# nvme tls-key --revoke="NVMe0R01 hostnqn0 subsys0"
# keyctl show
Session Keyring
 573249525 --alswrv      0     0  keyring: _ses
 353599402 --alswrv      0 65534   \_ keyring: _uid.0
 475911922 ---lswrv      0     0   \_ keyring: .nvme
649274894: key inaccessible (Key has been revoked)
•وارد کردن مجدد کلید قبلاً ایجادشده از فایل و اعتبارسنجی با keyctl:
# nvme tls-key --import -f nvme-tls-keys.txt
# keyctl show
Session Keyring
 573249525 --alswrv      0     0  keyring: _ses
 353599402 --alswrv      0 65534   \_ keyring: _uid.0
 475911922 ---lswrv      0     0   \_ keyring: .nvme
 734343968 --als-rv      0     0       \_ psk: NVMe0R01 hostnqn0 subsys0

بخشی از مجموعه ابزارهای nvme-user

02/16/2026 NVMe