.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "TSGET 1ssl" .TH TSGET 1ssl 2026-08-25 3.6.4 OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" tsget \- دریافت برچسب زمانی از سرور RFC 3161 .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBtsget\fR \&\fB\-h\fR \fIserver_url\fR [\fB\-e\fR \fIextension\fR] [\fB\-o\fR \fIoutput\fR] [\fB\-v\fR] [\fB\-d\fR] [\fB\-k\fR \fIprivate_key.pem\fR] [\fB\-p\fR \fIkey_password\fR] [\fB\-c\fR \fIclient_cert.pem\fR] [\fB\-C\fR \fICA_certs.pem\fR] [\fB\-P\fR \fICA_path\fR] [\fB\-r\fR \fIfiles\fR] [\fB\-g\fR \fIEGD_socket\fR] [\fIrequest\fR ...] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این دستور می‌تواند برای ارسال یک درخواست برچسب زمانی (timestamp)، همان‌طور که در RFC 3161 مشخص شده است، به یک سرور برچسب زمانی از طریق HTTP یا HTTPS و ذخیره پاسخ برچسب زمانی در یک فایل استفاده شود. این دستور نمی‌تواند برای ایجاد درخواست‌ها و اعتبارسنجی پاسخ‌ها استفاده شود؛ برای انجام این کار باید از \fBopenssl\-ts\fR\|(1) استفاده کنید. چنانچه بیش از یک درخواست در خط فرمان مشخص شده باشد، این دستور می‌تواند چندین درخواست را بدون بستن اتصال TCP به سرور ارسال کند. .PP این دستور برای هر درخواست برچسب زمانی، درخواست HTTP زیر را ارسال می‌کند: .PP .Vb 7 \& POST url HTTP/1.1 \& User\-Agent: OpenTSA tsget.pl/ \& Host: : \& Pragma: no\-cache \& Content-Type: application/timestamp\-query \& Accept: application/timestamp\-reply \& Content-Length: length of body \& \& ...binary request specified by the user... .Ve .PP این دستور در انتظار پاسخی از نوع application/timestamp\-reply است که بدون هیچ‌گونه تفسیر مستقیماً در یک فایل نوشته می‌شود. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-h\fR \fIserver_url\fR" 4 .IX Item "-h server_url" نشانی اینترنتی (URL) سرور HTTP/HTTPS که در حال شنود برای درخواست‌های برچسب زمانی است. .IP "\fB\-e\fR \fIextension\fR" 4 .IX Item "-e extension" اگر گزینه .B \-o مشخص نشده باشد، این آرگومان پسوند فایل‌های خروجی را تعیین می‌کند. نام پایه فایل خروجی مشابه نام فایل‌های ورودی خواهد بود. پسوند پیش‌فرض \fI.tsr\fR است. (اختیاری) .IP "\fB\-o\fR \fIoutput\fR" 4 .IX Item "-o output" این گزینه فقط زمانی می‌تواند مشخص شود که تنها یک درخواست به سرور ارسال می‌شود. پاسخ برچسب زمانی در فایل خروجی مشخص‌شده نوشته خواهد شد. \*(Aq\-\*(Aq به معنی خروجی استاندارد است. در صورت وجود چندین درخواست برچسب زمانی یا عدم تعیین این آرگومان، نام فایل‌های خروجی از نام فایل‌های ورودی و پسوند پیش‌فرض یا تعیین‌شده مشتق می‌شود. (اختیاری) .IP \fB\-v\fR 4 .IX Item "-v" نام درخواستی که در حال حاضر پردازش می‌شود روی خطای استاندارد چاپ می‌شود. (اختیاری) .IP \fB\-d\fR 4 .IX Item "-d" حالت پرگویی (verbose) را برای ماژول پرل زیرین WWW::Curl::Easy فعال می‌کند. می‌توانید پیام‌های خطایابی با جزئیات را برای اتصال مشاهده کنید. (اختیاری) .IP "\fB\-k\fR \fIprivate_key.pem\fR" 4 .IX Item "-k private_key.pem" (HTTPS) در صورت احراز هویت کلاینت مبتنی بر گواهی از طریق HTTPS، فایل \fIprivate_key.pem\fR باید شامل کلید خصوصی کاربر باشد. فایل کلید خصوصی می‌تواند به طور اختیاری با یک عبارت عبور (passphrase) محافظت شود. گزینه .B \-c نیز باید مشخص شده باشد. (اختیاری) .IP "\fB\-p\fR \fIkey_password\fR" 4 .IX Item "-p key_password" (HTTPS) عبارت عبور کلید خصوصی تعیین‌شده توسط آرگومان .B \-k را مشخص می‌کند. اگر این گزینه حذف شود و کلید دارای عبارت عبور باشد، از کاربر پرسیده خواهد شد. (اختیاری) .IP "\fB\-c\fR \fIclient_cert.pem\fR" 4 .IX Item "-c client_cert.pem" (HTTPS) در صورت احراز هویت کلاینت مبتنی بر گواهی از طریق HTTPS، فایل \fIclient_cert.pem\fR باید شامل گواهی X.509 کاربر باشد. گزینه .B \-k نیز باید مشخص شده باشد. در صورت عدم تعیین این گزینه، احراز هویت کلاینت بر پایه گواهی انجام نخواهد شد. (اختیاری) .IP "\fB\-C\fR \fICA_certs.pem\fR" 4 .IX Item "-C CA_certs.pem" (HTTPS) مخزن گواهی‌های معتمد CA. زنجیره گواهی طرف مقابل (peer) باید شامل یکی از گواهی‌های CA مشخص‌شده در این فایل باشد. در صورت استفاده از HTTPS باید یکی از گزینه‌های .B \-C یا .B \-P مشخص شود. (اختیاری) .IP "\fB\-P\fR \fICA_path\fR" 4 .IX Item "-P CA_path" (HTTPS) مسیری که حاوی گواهی‌های معتمد CA برای اعتبارسنجی گواهی طرف مقابل است. دایرکتوری باید با \fBopenssl\-rehash\fR\|(1) آماده‌سازی شده باشد. در صورت استفاده از HTTPS باید یکی از گزینه‌های .B \-C یا .B \-P مشخص شود. (اختیاری) .IP "\fB\-r\fR \fIfiles\fR" 4 .IX Item "-r files" برای اطلاعات بیشتر بخش "Random State Options" را در \fBopenssl\fR\|(1) ببینید. .IP "\fB\-g\fR \fIEGD_socket\fR" 4 .IX Item "-g EGD_socket" نام یک سوکت EGD برای دریافت داده‌های تصادفی. (اختیاری) .IP "\fIrequest\fR ..." 4 .IX Item "request ..." فهرستی از فایل‌های حاوی درخواست‌های برچسب زمانی با کدگذاری DER بر اساس RFC 3161. اگر هیچ درخواستی مشخص نشود، تنها یک درخواست به سرور ارسال شده و از ورودی استاندارد خوانده خواهد شد. (اختیاری) .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .IX Header "ENVIRONMENT VARIABLES" متغیر محیطی \fBTSGET\fR می‌تواند به صورت اختیاری شامل آرگومان‌های پیش‌فرض باشد. محتوای این متغیر به فهرست آرگومان‌های خط فرمان اضافه می‌شود. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" مثال‌های زیر فرض می‌کنند که \fIfile1.tsq\fR و \fIfile2.tsq\fR حاوی درخواست‌های برچسب زمانی معتبر هستند، tsa.opentsa.org روی درگاه ۸۰۸۰ به درخواست‌های HTTP و روی درگاه ۸۴۴۳ به درخواست‌های HTTPS گوش می‌دهد، و سرویس TSA در مسیر مطلق /tsa در دسترس است. .PP دریافت پاسخ برچسب زمانی برای \fIfile1.tsq\fR از طریق HTTP، خروجی در \fIfile1.tsr\fR نوشته می‌شود: .PP .Vb 1 \& tsget \-h http://tsa.opentsa.org:8080/tsa file1.tsq .Ve .PP دریافت پاسخ برچسب زمانی برای \fIfile1.tsq\fR و \fIfile2.tsq\fR از طریق HTTP همراه با نمایش پیشرفت؛ خروجی به ترتیب در \fIfile1.reply\fR و \fIfile2.reply\fR نوشته می‌شود: .PP .Vb 2 \& tsget \-h http://tsa.opentsa.org:8080/tsa \-v \-e .reply \e \& file1.tsq file2.tsq .Ve .PP ایجاد یک درخواست برچسب زمانی، نوشتن آن در \fIfile3.tsq\fR، ارسال آن به سرور و نوشتن پاسخ در \fIfile3.tsr\fR: .PP .Vb 3 \& openssl ts \-query \-data file3.txt \-cert | tee file3.tsq \e \& | tsget \-h http://tsa.opentsa.org:8080/tsa \e \& \-o file3.tsr .Ve .PP دریافت پاسخ برچسب زمانی برای \fIfile1.tsq\fR از طریق HTTPS بدون احراز هویت کلاینت: .PP .Vb 2 \& tsget \-h https://tsa.opentsa.org:8443/tsa \e \& \-C cacerts.pem file1.tsq .Ve .PP دریافت پاسخ برچسب زمانی برای \fIfile1.tsq\fR از طریق HTTPS با احراز هویت کلاینت مبتنی بر گواهی (در صورتی که \fIclient_key.pem\fR محافظت شده باشد، عبارت عبور درخواست خواهد شد): .PP .Vb 2 \& tsget \-h https://tsa.opentsa.org:8443/tsa \-C cacerts.pem \e \& \-k client_key.pem \-c client_cert.pem file1.tsq .Ve .PP در صورت استفاده از متغیر محیطی \fBTSGET\fR می‌توانید خط فرمان قبلی را کوتاه‌تر کنید. دستورات زیر همان کار مثال قبلی را انجام می‌دهند: .PP .Vb 4 \& TSGET=\*(Aq\-h https://tsa.opentsa.org:8443/tsa \-C cacerts.pem \e \& \-k client_key.pem \-c client_cert.pem\*(Aq \& export TSGET \& tsget file1.tsq .Ve .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBopenssl\fR\|(1), \&\fBopenssl\-ts\fR\|(1), WWW::Curl::Easy, .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر 2006\-2020 نویسندگان پروژه OpenSSL. تمام حقوق محفوظ است. .PP تحت مجوز آپاچی، نسخه 2.0 ("مجوز") مجوزدهی شده است. شما نمی‌توانید از این فایل استفاده کنید مگر با رعایت مجوز. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE در توزیع مبدا یا در دریافت کنید.