'\" t
.\"     Title: clevis-encrypt-sss
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/23/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "CLEVIS\-ENCRYPT\-SSS" "1" "08/23/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)"
clevis-encrypt-sss \- رمزنگاری با استفاده از خط‌مشی اشتراک راز شامیر (SSS)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBclevis encrypt sss\fR CONFIG [\-y] < PT > JWE
.SH "نمای کلی (OVERVIEW)"
.sp
دستور \fBclevis encrypt sss\fR با استفاده از یک خط‌مشی اشتراک راز شامیر (Shamir\(cqs Secret Sharing) داده‌ها را رمزنگاری می‌کند\&. تنها آرگومان آن شیء پیکربندی JSON است\&.
.sp
اشتراک راز شامیر (SSS) روشی برای ترکیب پین‌ها با یکدیگر جهت ایجاد خط‌مشی‌های پیشرفته قفل‌گشایی و دسترسی‌پذیری بالا فراهم می‌سازد\&. طرح SSS یک طرح مبتنی بر آستانه است؛ به این صورت که کلیدی ایجاد کرده و آن را به تعدادی قطعه تقسیم می‌کند\&. هر قطعه با استفاده از یک پین دیگر رمزنگاری می‌شود (حتی ممکن است به‌صورت بازگشتی از خود SSS استفاده شود)\&. علاوه بر این، شما آستانه \fBt\fR را تعریف می‌کنید\&. اگر حداقل \fBt\fR قطعه قابل رمزگشایی باشند، کلید رمزنگاری بازیابی شده و عملیات رمزگشایی با موفقیت انجام خواهد شد\&.
.sp
برای نمونه، بیایید یک پیکربندی با دسترسی‌پذیری بالا با استفاده از Tang بسازیم:
.sp
.if n \{\
.RS 4
.\}
.nf
$ cfg=\*(Aq{"t":1,"pins":{"tang":[{"url":\&.\&.\&.},{"url":\&.\&.\&.}]}}\*(Aq
$ clevis encrypt sss "$cfg" < PT > JWE
.fi
.if n \{\
.RE
.\}
.sp
در این خط‌مشی، ما اعلام می‌کنیم که آستانه برابر با ۱ است، اما چندین قطعه کلید وجود دارند که با سرورهای مختلف Tang رمزنگاری شده‌اند\&. از آنجا که آستانه ۱ است، تا زمانی که هر یک از سرورهای Tang در دسترس باشند، رمزگشایی با موفقیت انجام خواهد شد\&. مانند همیشه، رمزگشایی به‌سادگی با دستور زیر انجام می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
$ clevis decrypt < JWE > PT
.fi
.if n \{\
.RE
.\}
.SH "پیکربندی (CONFIG)"
.sp
این دستور از ویژگی‌های پیکربندی زیر استفاده می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBt\fR
(عدد صحیح) : تعداد پین‌های موردنیاز برای رمزگشایی (الزامی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpins\fR
(شیء) : پین‌های مورداستفاده برای رمزنگاری قطعات (الزامی)
.RE
.sp
قالب ویژگی \fBpins\fR به‌صورت زیر است:
.sp
.if n \{\
.RS 4
.\}
.nf
{PIN:CFG,\&.\&.\&.} OR {PIN:[CFG,CFG,\&.\&.\&.],\&.\&.\&.}
.fi
.if n \{\
.RE
.\}
.sp
هنگامی که از نگارش فهرستی (لیست) این قالب استفاده شود، چندین پین از آن نوع قطعات کلید را دریافت خواهند کرد\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-y\fR
: پاسخ مثبت خودکار (yes) به تمام پرسش‌ها\&. برای پین
\fItang\fR
این گزینه بررسی اعتبارسنجی و اعتماد به سرور (advertisement trust check) را نادیده می‌گیرد، که در استقرارهای خودکار مفید است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ cfg=\*(Aq{"t":1,"pins":{"tang":[{"url":\&.\&.\&.},{"url":\&.\&.\&.}]}}\*(Aq
$ clevis encrypt sss "$cfg" \-y < PT > JWE
.fi
.if n \{\
.RE
.\}
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBclevis\-encrypt\-tang\fR(1), \fBclevis\-decrypt\fR(1)