'\" t
.\"     Title: jose-jwk-exc
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/09/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "JOSE\-JWK\-EXC" "1" "06/09/2026" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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)"
jose-jwk-exc \- انجام تبادل کلید با استفاده از دو کلید ورودی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBjose jwk exc\fR [\-i JWK] \-l JWK \-r JWK [\-o JWK]
.SH "نمای کلی (OVERVIEW)"
.sp
دستور \fBjose jwk exc\fR یک تبادل کلید را با استفاده از دو کلید ورودی انجام می‌دهد و نتیجه تبادل را به عنوان خروجی ارائه می‌کند\&. کاربر می‌تواند یک قالب JWK را به عنوان ورودی مشخص کند و ویژگی‌های مشخص‌شده بدون تغییر در JWK خروجی ظاهر خواهند شد\&.
.sp
تبادل کلید به دو کلید نیاز دارد:
.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
الگوریتم تبادل از ورودی‌ها استنتاج می‌شود\&.
.sp
الگوریتم \fBECDH\fR یک ضرب استاندارد خم بیضوی را انجام می‌دهد به‌طوری که مقدار عمومی \ep rem در مقدار خصوصی \ep ضرب می‌شود\&.
.sp
الگوریتم \fBECMR\fR دارای سه حالت کاری است\&. در صورتی که کلید محلی دارای یک کلید خصوصی (ویژگی "d") باشد، عملکرد آن دقیقاً مانند \fBECDH\fR خواهد بود\&. اگر کلید محلی فاقد کلید خصوصی باشد و کلید راه دور دارای کلید خصوصی باشد، جمع خم بیضوی روی دو مقدار انجام می‌شود\&. در غیر این صورت، اگر نه کلید محلی و نه کلید راه دور دارای کلید خصوصی نباشند، کلید راه دور با استفاده از تفریق خم بیضوی از کلید محلی کم می‌شود\&. هنگام استفاده از ECMR، حتماً محتوای ورودی‌های خود را اعتبارسنجی کنید تا از اجرای عملیات نادرست جلوگیری شود!
.SH "گزینه‌ها (OPTIONS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-i\fR
\fIJSON\fR,
\fB\-\-input\fR=\fIJSON\fR
: تجزیه قالب JWK از JSON
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-i\fR
\fIFILE\fR,
\fB\-\-input\fR=\fIFILE\fR
: خواندن قالب JWK از FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-i\fR
\-,
\fB\-\-input\fR=\- : خواندن قالب JWK از ورودی استاندارد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-o\fR
\fIFILE\fR,
\fB\-\-output\fR=\fIFILE\fR
: نوشتن JWK(Set) در FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-o\fR
\-,
\fB\-\-output\fR=\- : نوشتن JWK(Set) در ورودی استاندارد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-l\fR
\fIFILE\fR,
\fB\-\-local\fR=\fIFILE\fR
: خواندن JWK محلی از FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-l\fR
\-,
\fB\-\-local\fR=\- : خواندن JWK محلی از ورودی استاندارد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-r\fR
\fIFILE\fR,
\fB\-\-remote\fR=\fIFILE\fR
: خواندن JWK راه دور از FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-r\fR
\-,
\fB\-\-remote\fR=\- : خواندن JWK راه دور از ورودی استاندارد
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
انجام یک تبادل کلید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \-i \*(Aq{"alg":"ECDH"}\*(Aq \-o local\&.jwk
$ jose jwk gen \-i \*(Aq{"alg":"ECDH"}\*(Aq | jose jwk pub \-i\- \-o remote\&.jwk
$ jose jwk exc \-l local\&.jwk \-r remote\&.jwk \-o exchanged\&.jwk
.fi
.if n \{\
.RE
.\}
.SH "نویسندگان (AUTHORS)"
.sp
Nathaniel McCallum <npmccallum@redhat\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBjose\-alg\fR(1), \fBjose\-jwk\-exc\fR(1), \fBjose\-jwk\-gen\fR(1), \fBjose\-jwk\-pub\fR(1)