'\" t
.\"     Title: jose-jwe-enc
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/09/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "JOSE\-JWE\-ENC" "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-jwe-enc \- رمزگذاری متن آشکار با استفاده از یک یا چند JWK/گذرواژه
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBjose jwe enc\fR [\-i JWE] \-I PT \-k JWK [\-p] [\-r RCP] [\-o JWE] [\-O CT] [\-c]
.SH "نمای کلی (OVERVIEW)"
.sp
دستور \fBjose jwe enc\fR داده‌ها را با استفاده از یک یا چند JWK (\fB\-k\fR) یا گذرواژه (\fB\-p\fR) رمزگذاری می‌کند\&. هنگام مشخص کردن بیش از یک JWK یا گذرواژه، رمزگشایی با هر یک از کلیدهای ارائه‌شده موفقیت‌آمیز خواهد بود\&.
.sp
با مشخص کردن گزینهٔ \fB\-O\fR می‌توان یک JWE منفصل (detached) ایجاد کرد\&. در این حالت، متن رمزشدهٔ کدگشایی‌شده در خروجی مشخص‌شده نوشته می‌شود و در JWE گنجانده نخواهد شد\&.
.sp
اگر تنها از یک کلید استفاده شود (\fB\-k\fR یا \fB\-p\fR)، JWE حاصل را می‌توان با استفاده از گزینهٔ \fB\-c\fR در قالب سریال‌سازی فشردهٔ JWE (Compact Serialization) خروجی گرفت\&.
.sp
این دستور از یک رویکرد مبتنی بر الگو برای ساخت JWE استفاده می‌کند\&. شما می‌توانید الگوهایی برای خود JWE (\fB\-i\fR) یا برای شیء گیرندهٔ JWE (\fB\-r\fR) مشخص کنید\&. مشخصه‌های تعیین‌شده در هر یک از این الگوها بدون تغییر در خروجی ظاهر خواهند شد\&. یک استثنا برای این قاعده این است که سرآیند محافظت‌شدهٔ JWE (Protected Header) باید به صورت کدگشایی‌شده در الگو مشخص شود\&. این دستور به‌طور خودکار آن را به عنوان بخشی از فرایند رمزگذاری کُدگذاری خواهد کرد\&.
.sp
اگر یک پارامتر سرآیند JOSE را (از طریق گزینه‌های \fB\-i\fR یا \fB\-r\fR) مشخص کنید که بر ساخت JWE تأثیر می‌گذارد، این دستور تلاش خواهد کرد بر اساس این پارامتر به‌گونه‌ای عمل کند که گویی یک پیکربندی است\&. برای نمونه، تعیین پارامتر «zip» در سرآیند محافظت‌شدهٔ JWE باعث می‌شود متن آشکار پیش از رمزگذاری فشرده شود\&. در حال حاضر، \fBjose\fR رفتار خود را برای پارامترهای سرآیند JOSE با نام‌های «alg»، «enc» و «zip» (بخش ۴\&.۱\&.۳ از RFC 7516 را ببینید)، و همچنین پارامترهای مختص الگوریتم برای الگوریتم‌های پشتیبانی‌شده (بخش ۴ از RFC 7518 را ببینید) تغییر می‌دهد\&.
.sp
با این حال، نیازی به ارائهٔ هیچ الگویی نیست: \fBjose jwe enc\fR با استنباط الگوریتم‌های صحیح از کلیدهای ورودی ارائه‌شده (JWK یا گذرواژه)، به‌طور خودکار پارامترهای «alg» و «enc» را پر می‌کند\&. بنابراین، گزینه‌های \fB\-i\fR و \fB\-r\fR عموماً باید برای ارائهٔ فراداده‌های توسعه‌یافتهٔ JWE استفاده شوند\&.
.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
: تجزیهٔ JWE از 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
: خواندن JWE از 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=\-: خواندن JWE از ورودی استاندارد
.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\-r\fR
\fIFILE\fR,
\fB\-\-recipient\fR=\fIFILE\fR
: خواندن الگوی گیرندهٔ JWE از FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-r\fR
\-,
\fB\-\-recipient\fR=\- : خواندن الگوی گیرندهٔ JWE از ورودی استاندارد
.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(Set) از 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(Set) از ورودی استاندارد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-p\fR,
\fB\-\-password\fR
: درخواست گذرواژهٔ رمزگذاری
.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
: نوشتن JWE در 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=\- : نوشتن JWE در stdout (پیش‌فرض)
.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
: جداسازی متن رمزشده (ciphertext) و رمزگشایی در 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=\- : جداسازی متن رمزشده (ciphertext) و رمزگشایی در خروجی استاندارد
.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
: تولید خروجی JWE با استفاده از سریال‌سازی فشرده (compact serialization)
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
رمزنگاری داده‌ها با یک کلید متقارن با استفاده از JWE JSON Serialization:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \-i \*(Aq{"alg":"A128GCM"}\*(Aq \-o key\&.jwk
$ jose jwe enc \-I msg\&.txt \-k key\&.jwk \-o msg\&.jwe
.fi
.if n \{\
.RE
.\}
.sp
رمزنگاری داده‌ها با یک گذرواژه با استفاده از JWE Compact Serialization:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwe enc \-I msg\&.txt \-p \-c \-o msg\&.jwe
Please enter an encryption password:
Please re\-enter the previous password:
.fi
.if n \{\
.RE
.\}
.sp
فشرده‌سازی متن‌آشکار (plaintext) پیش از رمزنگاری:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwe enc \-i \*(Aq{"protected":{"zip":"DEF"}}\*(Aq \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
رمزنگاری با دو کلید و دو گذرواژه:
.sp
.if n \{\
.RS 4
.\}
.nf
$ jose jwk gen \-i \*(Aq{"alg":"ECDH\-ES+A128KW"}\*(Aq \-o ec\&.jwk
$ jose jwk gen \-i \*(Aq{"alg":"RSA1_5"}\*(Aq \-o rsa\&.jwk
$ jose jwe enc \-I msg\&.txt \-p \-k ec\&.jwk \-p \-k rsa\&.jwk \-o msg\&.jwe
Please enter a password:
Please re\-enter the previous password:
Please enter a password:
Please re\-enter the previous password:
.fi
.if n \{\
.RE
.\}.SH "نویسنده (AUTHOR)"
.sp
Nathaniel McCallum <npmccallum@redhat\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBjose\-jwe\-dec\fR(1), \fBjose\-jwe\-fmt\fR(1)