'\" t
.\"     Title: jose-jwk-use
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/09/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "JOSE\-JWK\-USE" "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-use \- اعتبارسنجی یک کلید برای کاربرد(های) مشخص‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBjose jwk use\fR \-i JWK [\-a] [\-r] \-u OP
.SH "نمای کلی (OVERVIEW)"
.sp
دستور \fBjose jwk use\fR یک یا چند ورودی JWK(Set) را برای مجموعه‌ای معین از کاربردها اعتبارسنجی می‌کند\&. این اعتبارسنجی در برابر مشخصه‌های "use" و "key_ops" متعلق به هر JWK بررسی خواهد شد\&.
.sp
به‌طور پیش‌فرض، اگر یک JWK هیچ محدودیتی نداشته باشد، انجام عملیات مجاز خواهد بود\&. با این حال، با مشخص کردن گزینهٔ \fB\-r\fR می‌توانید اطمینان حاصل کنید که یک JWK مجاز نخواهد بود مگر آنکه صریحاً آن عملیات را مجاز کرده باشد\&.
.sp
در حالت عادی، اگر هر یک از JWKها اعتبارسنجی نشوند، \fBjose jwk use\fR با شکست مواجه می‌شود\&. اما اگر گزینهٔ \fB\-o\fR استفاده شود، \fBjose jwk use\fR در عوض یک JWK(Set) شامل تمام کلیدهای ورودی معتبر را در خروجی می‌نویسد\&. در صورتی که هیچ JWKای معتبر نباشد، دستور با شکست مواجه خواهد شد\&.
.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\-u\fR
sign,
\fB\-\-use\fR=sign : اعتبارسنجی کلید برای امضا (signing)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-u\fR
verify,
\fB\-\-use\fR=verify : اعتبارسنجی کلید برای تأیید امضا (verifying)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-u\fR
encrypt,
\fB\-\-use\fR=encrypt : اعتبارسنجی کلید برای رمزگذاری (encrypting)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-u\fR
decrypt,
\fB\-\-use\fR=decrypt : اعتبارسنجی کلید برای رمزگشایی (decrypting)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-u\fR
wrapKey,
\fB\-\-use\fR=wrapKey : اعتبارسنجی کلید برای بسته‌بندی کلید (wrapping)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-u\fR
unwrapKey,
\fB\-\-use\fR=unwrapKey : اعتبارسنجی کلید برای باز کردن بسته‌بندی کلید (unwrapping)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-u\fR
deriveKey,
\fB\-\-use\fR=deriveKey : اعتبارسنجی کلید برای مشتق کردن کلیدها (deriving keys)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-u\fR
deriveBits,
\fB\-\-use\fR=deriveBits : اعتبارسنجی کلید برای مشتق کردن بیت‌ها (deriving bits)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-a\fR,
\fB\-\-all\fR
: تنها در صورتی موفق می‌شود که تمام عملیات مجاز باشند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-r\fR,
\fB\-\-required\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
: پالایش کلیدها در FILE به‌صورت JWK(Set)
.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":"ES256"}\*(Aq \-o prv\&.jwk
$ jose jwk pub \-i prv\&.jwk \-o pub\&.jwk
$ jose jwk use \-i prv\&.jwk \-u sign
$ echo $?
0
$ jose jwk use \-i pub\&.jwk \-u sign
$ echo $?
1
.fi
.if n \{\
.RE
.\}
.SH "نویسندگان (AUTHORS)"
.sp
Nathaniel McCallum <npmccallum@redhat\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBjose\-jwk\-gen\fR(1)