'\" t
.\"     Title: jose-jws-sig
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/09/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "JOSE\-JWS\-SIG" "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-jws-sig \- امضا کردن داده‌ها با استفاده از یک یا چند کلید JWK در فرمت JWS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBjose jws sig\fR [\-i JWS] [\-I PAY] [\-s SIG] \-k JWK [\-o JWS] [\-O PAY] [\-c]
.SH "نمای کلی (OVERVIEW)"
.sp
دستور \fBjose jws sig\fR یک پی‌لود (بار داده) را با استفاده از یک یا چند کلید JWK امضا می‌کند\&. پی‌لود می‌تواند به صورت رمزگشایی‌شده (\fB\-I\fR) یا تعبیه‌شده در یک JWS موجود (\fB\-i\fR) ارائه شود\&.
.sp
با مشخص کردن گزینه \fB\-O\fR می‌توان یک JWS جداشده (detached) ایجاد کرد\&. در این حالت، پی‌لود رمزگشایی‌شده در خروجی مشخص‌شده نوشته می‌شود و درون JWS گنجانده نخواهد شد\&.
.sp
اگر تنها از یک کلید استفاده شود (\fB\-k\fR)، می‌توان JWS حاصل را با استفاده از گزینه \fB\-c\fR در قالب سریال‌سازی فشرده JWS (JWS Compact Serialization) خروجی داد\&.
.sp
این دستور از یک رویکرد مبتنی بر الگو برای ساخت JWS استفاده می‌کند\&. شما می‌توانید الگوهایی برای خود JWS (\fB\-i\fR) یا برای شیء امضای JWS (\fB\-s\fR) مشخص کنید\&. ویژگی‌های مشخص‌شده در هر یک از این الگوها بدون تغییر در خروجی ظاهر می‌شوند\&. یک استثنا در این قاعده این است که هدر محافظت‌شده JWS (JWS Protected Header) باید به شکل رمزگشایی‌شده در الگوی شیء امضای JWS مشخص شود\&. این دستور به طور خودکار آن را به عنوان بخشی از فرایند امضا کدگذاری می‌کند\&.
.sp
اگر یک پارامتر هدر JOSE (از طریق گزینه‌های \fB\-i\fR یا \fB\-s\fR) مشخص کنید که بر ساخت تأثیر بگذارد، این دستور تلاش می‌کند بر اساس این پارامتر همانند یک پیکربندی رفتار کند\&. در حال حاضر، \fBjose\fR رفتار خود را برای پارامتر هدر JOSE با عنوان "alg" تغییر می‌دهد (به بخش 4\&.1\&.1 از RFC 7515 مراجعه کنید)\&.
.sp
با این حال، نیازی به ارائه هیچ الگویی نیست: \fBjose jws sig\fR به طور خودکار پارامتر "alg" را با استنتاج الگوریتم مناسب از کلیدهای JWK ورودی پر می‌کند\&. بنابراین، گزینه‌های \fB\-i\fR و \fB\-s\fR معمولاً باید برای ارائه فراداده‌های توسعه‌یافته استفاده شوند\&.
.sp
امکان مشخص کردن یک JWS موجود به عنوان الگوی ورودی JWS (\fB\-i\fR) وجود دارد\&. این کار امکان افزودن امضاهای جدید به یک JWS موجود را فراهم می‌کند\&.
.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
: تجزیه الگوی JWS از رشته 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
: خواندن الگوی JWS از 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=\- : خواندن الگوی JWS از ورودی استاندارد
.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\-\-detached\fR=\fIFILE\fR
: خواندن پی‌لود رمزگشایی‌شده از FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-I\fR
\-,
\fB\-\-detached\fR=\- : خواندن پی‌لود رمزگشایی‌شده از ورودی استاندارد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-s\fR
\fIJSON\fR,
\fB\-\-signature\fR=\fIJSON\fR
: تجزیه الگوی امضای JWS از رشته JSON
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-s\fR
\fIFILE\fR,
\fB\-\-signature\fR=\fIFILE\fR
: خواندن الگوی امضای JWS از FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-s\fR
\-,
\fB\-\-signature\fR=\- : خواندن الگوی امضای JWS از ورودی استاندارد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-k\fR
\fIFILE\fR,
\fB\-\-key\fR=\fIFILE\fR
: خواندن JWK (یا مجموعه‌کلید JWKSet) از FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-k\fR
\-,
\fB\-\-key\fR=\- : خواندن JWK (یا مجموعه‌کلید JWKSet) از ورودی استاندارد
.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
: نوشتن JWS در 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=\- : نوشتن JWS در خروجی استاندارد (پیش‌فرض)
.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\-\-detach\fR=\fIFILE\fR
: جدا کردن پی‌لود و رمزگشایی در FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-O\fR
\-,
\fB\-\-detach\fR=\- : جدا کردن پی‌لود و رمزگشایی در خروجی استاندارد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-c\fR,
\fB\-\-compact\fR
: خروجی دادن JWS با استفاده از سریال‌سازی فشرده
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
امضا کردن داده‌ها با یک کلید متقارن با استفاده از سریال‌سازی JSON در JWS:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \-i \*(Aq{"alg":"HS256"}\*(Aq \-o key\&.jwk
$ jose jws sig \-I msg\&.txt \-k key\&.jwk \-o msg\&.jws
.fi
.if n \{\
.RE
.\}
.sp
امضا کردن داده‌ها با استفاده از سریال‌سازی فشرده JWS به صورت جداشده (detached):
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jws sig \-I msg\&.txt \-k key\&.jwk \-O /dev/null \-c \-o msg\&.jws
.fi
.if n \{\
.RE
.\}
.sp
امضا کردن با دو کلید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \-i \*(Aq{"alg":"ES256"}\*(Aq \-o ec\&.jwk
$ jose jwk gen \-i \*(Aq{"alg":"RS256"}\*(Aq \-o rsa\&.jwk
$ jose jws sig \-I msg\&.txt \-k ec\&.jwk \-k rsa\&.jwk \-o msg\&.jws
.fi
.if n \{\
.RE
.\}
.SH "نویسنده (AUTHOR)"
.sp
Nathaniel McCallum <npmccallum@redhat\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBjose\-jws\-sig\fR(1), \fBjose\-jws\-ver\fR(1)