'\" t
.\"     Title: jose-jwk-gen
.\"    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\-GEN" "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-gen \- ایجاد کلیدهای رمزنگاری JWK جدید
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBjose jwk gen\fR \-i JWK [\-o JWK]
.SH "نمای کلی (OVERVIEW)"
.sp
دستور \fBjose jwk gen\fR یک کلید از یک یا چند الگوی JWK (یا JWKSet) ایجاد می‌کند\&. اگر یک الگوی تکی به عنوان ورودی داده شود، یک JWK تکی در خروجی تولید خواهد شد\&. با این حال، اگر چندین الگو به عنوان ورودی داده شوند، یک JWKSet تکی حاوی تمام کلیدها در خروجی تولید خواهد شد\&.
.sp
بهترین راه برای ایجاد کلید، مشخص کردن الگوریتم مورد استفاده در ویژگی "alg" از الگوی JWK است\&. این روش ترجیح داده می‌شود زیرا هنگام ایجاد کلید از روی یک الگوریتم، پارامتر مناسب "key_ops" به طور خودکار صادر می‌شود\&. علاوه بر این، داشتن یک JWK با الگوریتم از پیش مشخص‌شده به استنتاج الگوریتم هنگام رمزگذاری یا امضا کمک می‌کند\&.
.sp
به عنوان روش دیگر، می‌توانید با تعیین ویژگی نوع کلید ("kty") در JWK به همراه پارامتر تولید مخصوص آن نوع، یک کلید ایجاد کنید\&. برای مشاهده نحوه انجام این کار برای هر نوع کلید، مثال‌های زیر را ببینید\&. اگر پارامتر تولید مخصوص نوع غیر استاندارد باشد (برای مثال: "bytes" و "bits")، از خروجی حذف خواهد شد\&.
.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(Set) از 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(Set) از 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(Set) از ورودی استاندارد
.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\-s\fR,
\fB\-\-set\fR
: همیشه خروجی را در قالب JWKSet تولید می‌کند
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
ایجاد سه کلید که هر کدام یک الگوریتم متفاوت را هدف قرار می‌دهند:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \-i \*(Aq{"alg":"HS256"}\*(Aq \-o oct\&.jwk
$ jose jwk gen \-i \*(Aq{"alg":"RS256"}\*(Aq \-o rsa\&.jwk
$ jose jwk gen \-i \*(Aq{"alg":"ES256"}\*(Aq \-o ec\&.jwk
.fi
.if n \{\
.RE
.\}
.sp
ایجاد سه کلید با استفاده از پارامترهای کلید به جای الگوریتم‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \-i \*(Aq{"kty":"oct","bytes":32}\*(Aq \-o oct\&.jwk
$ jose jwk gen \-i \*(Aq{"kty":"RSA","bits":4096}\*(Aq \-o rsa\&.jwk
$ jose jwk gen \-i \*(Aq{"kty":"EC","crv":"P\-256"}\*(Aq \-o ec\&.jwk
.fi
.if n \{\
.RE
.\}
.sp
ایجاد همزمان چندین کلید با استفاده از یک الگوی JWKSet:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \e
  \-i \*(Aq{"keys":[{"alg":"HS256"},{"alg":"ES256"}]}\*(Aq \e
  \-o keys\&.jwkset
.fi
.if n \{\
.RE
.\}
.sp
ایجاد همزمان چندین کلید با استفاده از چندین الگوی JWK:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \e
  \-i \*(Aq{"alg":"HS256"}\*(Aq \e
  \-i \*(Aq{"alg":"ES256"}\*(Aq \e
  \-o keys\&.jwkset
.fi
.if n \{\
.RE
.\}
.SH "نویسنده (AUTHOR)"
.sp
Nathaniel McCallum <npmccallum@redhat\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBjose\-alg\fR(1), \fBjose\-jwe\-dec\fR(1), \fBjose\-jwe\-enc\fR(1), \fBjose\-jwk\-exc\fR(1), \fBjose\-jwk\-pub\fR(1), \fBjose\-jwk\-thp\fR(1), \fBjose\-jwk\-use\fR(1), \fBjose\-jws\-sig\fR(1), \fBjose\-jws\-ver\fR(1)