JOSE-JWK-USE(1)   JOSE-JWK-USE(1)

jose-jwk-use - اعتبارسنجی یک کلید برای کاربرد(های) مشخص‌شده

jose jwk use -i JWK [-a] [-r] -u OP

دستور jose jwk use یک یا چند ورودی JWK(Set) را برای مجموعه‌ای معین از کاربردها اعتبارسنجی می‌کند. این اعتبارسنجی در برابر مشخصه‌های "use" و "key_ops" متعلق به هر JWK بررسی خواهد شد.

به‌طور پیش‌فرض، اگر یک JWK هیچ محدودیتی نداشته باشد، انجام عملیات مجاز خواهد بود. با این حال، با مشخص کردن گزینهٔ -r می‌توانید اطمینان حاصل کنید که یک JWK مجاز نخواهد بود مگر آنکه صریحاً آن عملیات را مجاز کرده باشد.

در حالت عادی، اگر هر یک از JWKها اعتبارسنجی نشوند، jose jwk use با شکست مواجه می‌شود. اما اگر گزینهٔ -o استفاده شود، jose jwk use در عوض یک JWK(Set) شامل تمام کلیدهای ورودی معتبر را در خروجی می‌نویسد. در صورتی که هیچ JWKای معتبر نباشد، دستور با شکست مواجه خواهد شد.

•-i JSON, --input=JSON : تجزیهٔ JWK(Set) از JSON
•-i FILE, --input=FILE : خواندن JWK(Set) از FILE
•-i -, --input=- : خواندن JWK(Set) از ورودی استاندارد
•-u sign, --use=sign : اعتبارسنجی کلید برای امضا (signing)
•-u verify, --use=verify : اعتبارسنجی کلید برای تأیید امضا (verifying)
•-u encrypt, --use=encrypt : اعتبارسنجی کلید برای رمزگذاری (encrypting)
•-u decrypt, --use=decrypt : اعتبارسنجی کلید برای رمزگشایی (decrypting)
•-u wrapKey, --use=wrapKey : اعتبارسنجی کلید برای بسته‌بندی کلید (wrapping)
•-u unwrapKey, --use=unwrapKey : اعتبارسنجی کلید برای باز کردن بسته‌بندی کلید (unwrapping)
•-u deriveKey, --use=deriveKey : اعتبارسنجی کلید برای مشتق کردن کلیدها (deriving keys)
•-u deriveBits, --use=deriveBits : اعتبارسنجی کلید برای مشتق کردن بیت‌ها (deriving bits)
•-a, --all : تنها در صورتی موفق می‌شود که تمام عملیات مجاز باشند
•-r, --required : عملیات باید به‌طور صریح مجاز شده باشند
•-o FILE, --output=FILE : پالایش کلیدها در FILE به‌صورت JWK(Set)
•-o -, --output=- : پالایش کلیدها در خروجی استاندارد به‌صورت JWK(Set)
•-s, --set : همیشه یک JWKSet را در خروجی تولید می‌کند

نمونه‌هایی از موفقیت و شکست برای یک کلید خصوصی و عمومی:

$ jose jwk gen -i '{"alg":"ES256"}' -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

Nathaniel McCallum <npmccallum@redhat.com>

jose-jwk-gen(1)

06/09/2026