نام (NAME)

openssl-sess_id - مدیریت شناسه نشست SSL/TLS

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

openssl sess_id [-help] [-inform DER|PEM] [-outform DER|PEM|NSS] [-in filename] [-out filename] [-text] [-cert] [-noout] [-context ID]

توضیحات (DESCRIPTION)

این دستور نسخه کدگذاری‌شده ساختار نشست SSL را پردازش می‌کند و در صورت تمایل، جزئیات نشست SSL (به عنوان مثال کلید اصلی نشست SSL) را در قالبی خوانا برای انسان چاپ می‌نماید. از آنجا که این یک ابزار تشخیصی است و استفاده صحیح از آن نیازمند مقداری آگاهی از پروتکل SSL است، اکثر کاربران نیازی به استفاده از آن نخواهند داشت.

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

گزینه‌ها (OPTIONS)

-help: چاپ پیام راهنمای استفاده.
-inform DER|PEM, -outform DER|PEM|NSS: قالب‌های ورودی و خروجی؛ حالت پیش‌فرض PEM است. برای جزئیات بیشتر به openssl-format-options(1) مراجعه کنید.
برای خروجی NSS، شناسه نشست (session ID) و کلید اصلی (master key) در قالب "keylog" مربوط به NSS گزارش می‌شوند.
-in filename: نام فایل ورودی را برای خواندن اطلاعات نشست مشخص می‌کند، یا در صورت مشخص نشدن، به‌طور پیش‌فرض از ورودی استاندارد استفاده می‌شود.
-out filename: نام فایل خروجی را برای نوشتن اطلاعات نشست مشخص می‌کند، یا در صورت مشخص نشدن این گزینه، در خروجی استاندارد نوشته می‌شود.
-text: علاوه بر نسخه کدگذاری‌شده، اجزای مختلف کلید عمومی یا خصوصی را به صورت متن ساده چاپ می‌کند.
-cert: اگر گواهی در نشست وجود داشته باشد، با استفاده از این گزینه در خروجی قرار می‌گیرد؛ در صورتی که گزینه -text نیز ارائه شده باشد، به صورت متنی چاپ خواهد شد.
-noout: این گزینه از چاپ نسخه کدگذاری‌شده نشست در خروجی جلوگیری می‌کند.
-context ID: این گزینه می‌تواند شناسه نشست را تنظیم کند به طوری که اطلاعات خروجی نشست از شناسه ارائه شده استفاده نماید. شناسه می‌تواند هر رشته‌ای از کاراکترها باشد. این گزینه معمولاً استفاده نمی‌شود.

خروجی (OUTPUT)

خروجی نمونه:

SSL-Session:
    Protocol  : TLSv1
    Cipher    : 0016
    Session-ID: 871E62626C554CE95488823752CBD5F3673A3EF3DCE9C67BD916C809914B40ED
    Session-ID-ctx: 01000000
    Master-Key: A7CEFC571974BE02CAC305269DC59F76EA9F0B180CB6642697A68251F2D2BB57E51DBBB4C7885573192AE9AEE220FACD
    Key-Arg   : None
    Start Time: 948459261
    Timeout   : 300 (sec)
    Verify return code 0 (ok)

این موارد در زیر با جزئیات بیشتر شرح داده شده‌اند.

Protocol: این پروتکل مورد استفاده است: TLSv1.3، TLSv1.2، TLSv1.1، TLSv1 یا SSLv3.
Cipher: رمز استفاده‌شده؛ این در واقع کد خام الگوریتم رمزنگاری SSL یا TLS است، برای اطلاعات بیشتر مشخصات فنی SSL یا TLS را ببینید.
Session-ID: شناسه نشست SSL در قالب هگزادسیمال (hex).
Session-ID-ctx: زمینه شناسه نشست در قالب هگزادسیمال (hex).
Master-Key: این کلید اصلی نشست SSL است.
Start Time: این زمان شروع نشست است که به صورت یک عدد صحیح در قالب استاندارد یونیکس نشان داده می‌شود.
Timeout: مدت زمان انقضا (timeout) به ثانیه.
Verify return code: این کد بازگشتی حاصل از اعتبارسنجی گواهی کلاینت SSL است.

نکات (NOTES)

از آنجا که خروجی نشست SSL حاوی کلید اصلی است، خواندن محتویات یک نشست رمزگذاری‌شده با استفاده از این اطلاعات امکان‌پذیر است. بنابراین در صورتی که این اطلاعات توسط یک برنامه «واقعی» در خروجی چاپ می‌شود، باید اقدامات امنیتی مناسب صورت پذیرد. با این حال، انجام این کار اکیداً توصیه نمی‌شود و فقط باید برای اهداف اشکال‌زدایی مورد استفاده قرار گیرد.

اشکالات (BUGS)

الگوریتم رمز و زمان شروع باید در قالبی خوانا برای انسان چاپ شوند.

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

openssl(1), openssl-ciphers(1), openssl-s_server(1)

حق نشر (COPYRIGHT)

حق نشر ۲۰۰۰-۲۰۲۰ نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است.

تحت مجوز آپاچی نسخه ۲.۰ (Apache License 2.0) منتشر شده است. شما نمی‌توانید از این فایل استفاده کنید مگر با رعایت مجوز. می‌توانید یک نسخه از مجوز را در فایل LICENSE در توزیع منبع یا در https://www.openssl.org/source/license.html دریافت کنید.