'\" t
.\"     Title: tang
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02/14/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "TANG" "8" "02/14/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)"
tang \- سرور مقیدسازی رمزنگاری مبتنی بر شبکه
.SH "نمای کلی (OVERVIEW)"
.sp
تانگ (\fBTang\fR) سرویسی برای مقیدسازی کلیدهای رمزنگاری به حضور در شبکه است\&. این ابزار جایگزینی امن، بدون وضعیت (stateless) و ناشناس برای سرویس‌های امانت‌داری کلید (key escrow) ارائه می‌دهد\&.
.sp
پروژه تانگ به عنوان ابزاری برای کمک به خودکارسازی فرآیند رمزگشایی پدید آمد\&. سازوکارهای موجود عمدتاً از سیستم‌های امانت‌داری کلید بهره می‌برند که در آن کلاینت داده‌ها را با یک کلید متقارن رمزگذاری کرده و کلید متقارن را برای بازیابی‌های بعدی در یک سرور راه دور ذخیره می‌نماید\&. هدف این ساختار آن است که کلاینت بتواند هنگام برقراری ارتباط با سرور امانت‌داری و واکشی کلید، داده‌ها را به طور خودکار رمزگشایی کند\&.
.sp
با این حال، سرورهای امانت‌داری نیازمندی‌های اضافی بسیاری دارند؛ از جمله احراز هویت (تا کلاینت‌ها نتوانند کلیدهایی را که نباید داشته باشند دریافت کنند) و رمزنگاری لایه انتقال (تا مهاجمانی که ترافیک شبکه را شنود می‌کنند نتوانند کلیدهای در حال عبور را بربایند)\&.
.sp
تانگ از این پیچیدگی‌ها دوری می‌کند\&. کلاینت به جای ذخیره کلید متقارن از راه دور، یک تبادل کلید نامتقارن با سرور تانگ انجام می‌دهد\&. از آنجا که سرور تانگ هیچ کلید متقارنی را ذخیره نکرده و انتقال نمی‌دهد، نه نیازی به احراز هویت است و نه نیازی به رمزنگاری انتقال وجود دارد\&. از این رو، تانگ کاملاً بدون وضعیت و با پیکربندی صفر (zero\-configuration) کار می‌کند\&. علاوه بر این، کلاینت‌ها می‌توانند کاملاً ناشناس باقی بمانند\&.
.sp
تانگ خود کلاینتی ارائه نمی‌دهد، اما یک REST API ساده ارائه می‌دهد و منحصراً اشیای استاندارد JSON Object Signing and Encryption (JOSE) را منتقل می‌کند؛ این امر به شما امکان می‌دهد کلاینت‌های اختصاصی خود را با استفاده از مولفه‌های آماده بسازید\&. برای دسترسی به یک چارچوب رمزگذاری خودکار آماده با پشتیبانی از تانگ، پروژه \fBClevis\fR را مشاهده کنید\&. برای دریافت تمام جزئیات فنی پروتکل تانگ، به وب‌سایت رسمی پروژه تانگ مراجعه فرمایید\&.
.SH "شروع به کار (GETTING STARTED)"
.sp
راه‌اندازی و اجرای سرور تانگ بسیار ساده است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ sudo systemctl enable tangd\&.socket \-\-now
.fi
.if n \{\
.RE
.\}
.sp
همین و بس\&. سرور اکنون با مجموعه‌ای تازه از کلیدهای رمزنگاری در حال اجراست و با راه‌اندازی مجدد سیستم نیز به صورت خودکار شروع به کار خواهد کرد\&.
.SH "پیکربندی (CONFIGURATION)"
.sp
تانگ به گونه‌ای طراحی شده است که یک سرویس شبکه کمینه باشد و در نتیجه هیچ پیکربندی خاصی ندارد\&. برای تنظیم پارامترهای شبکه، می‌توانید با استفاده از سازوکارهای استاندارد systemd، فایل واحد \fBtangd\&.socket\fR را بازنویسی کنید\&. برای اطلاعات بیشتر به \fBsystemd\&.unit\fR(5) و \fBsystemd\&.socket\fR(5) مراجعه کنید\&.
.SH "مستقل یا از طریق SYSTEMD (STANDALONE OR VIA SYSTEMD)"
.sp
سرور تانگ می‌تواند از طریق فعال‌سازی سوکت systemd یا با ارسال گزینه
.B \-l
به صورت مستقل (standalone) اجرا شود\&. پورت پیش‌فرض مورد استفاده 9090 است که می‌توان آن را با گزینه
.B \-p
تغییر داد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
tang \-l \-p 9090
.fi
.if n \{\
.RE
.\}
.SH "نقطه پایانی (ENDPOINT)"
.sp
می‌توان برای سرور تانگ یک نقطه پایانی (endpoint) تعیین کرد\&. این نقطه پایانی به عنوان پیشوند برای نشانی وب (URL) قابل دسترسی توسط کلاینت عمل خواهد کرد\&. این نقطه پایانی را می‌توان با گزینه
.B \-e
مشخص کرد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
tang \-l \-p 9090 \-e this/is/an/endpoint
.fi
.if n \{\
.RE
.\}
.sp
هنگامی که نقطه پایانی تعیین شود، این نقطه پایانی به ابتدای URL معمولی adv/rec اضافه خواهد شد\&. اگر هیچ نقطه پایانی مشخص نشود و با فرض استفاده از پورت 9090، سرور تانگ روی نشانی‌های وب زیر گوش فرا خواهد داد:
.sp
.if n \{\
.RS 4
.\}
.nf
http://localhost:9090/adv (GET)
http://localhost:9090/rec (POST)
.fi
.if n \{\
.RE
.\}
.sp
اگر نقطه پایانی تعیین شود و با فرض اینکه این نقطه پایانی /this/is/an/endpoint/ باشد و همچنین با فرض استفاده از پورت 9090، سرور تانگ روی نشانی‌های وب زیر گوش خواهد داد:
.sp
.if n \{\
.RS 4
.\}
.nf
http://localhost:9090/this/is/an/endpoint/adv (GET)
http://localhost:9090/this/is/an/endpoint/rec (POST)
.fi
.if n \{\
.RE
.\}
.SH "چرخش کلید (KEY ROTATION)"
.sp
به منظور حفظ امنیت سیستم در بلندمدت، لازم است کلیدهای خود را به صورت دوره‌ای بچرخانید (rotate کنید)\&. بازه زمانی دقیق برای چرخش کلید به کاربرد، اندازه کلیدها و خط‌مشی‌های سازمانی شما بستگی دارد\&. برای توصیه‌های متداول به این پیوند مراجعه کنید:
https://www\&.keylength\&.com
.sp
یک اسکریپت کاربردی برای مدیریت این موضوع وجود دارد\&. برای اطلاعات بیشتر به \fBtangd\-rotate\-keys\fR(1) مراجعه کنید\&. این فرآیند همچنین می‌تواند مطابق توضیحات زیر به صورت دستی انجام پذیرد\&.
.sp
برای چرخش کلیدها، ابتدا باید کلیدهای جدیدی در دایرکتوری پایگاه داده کلید ایجاد کنیم\&. این مسیر معمولاً \fB/var/db/tang\fR است\&. به عنوان مثال، می‌توانید کلیدهای امضا و تبادل جدید را با دستورات زیر بسازید:
.sp
.if n \{\
.RS 4
.\}
.nf
# DB=/var/db/tang
# jose jwk gen \-i \*(Aq{"alg":"ES512"}\*(Aq \-o $DB/new_sig\&.jwk
# jose jwk gen \-i \*(Aq{"alg":"ECMR"}\*(Aq \-o $DB/new_exc\&.jwk
.fi
.if n \{\
.RE
.\}
.sp
سپس، نام کلیدهای قدیمی را تغییر دهید تا با یک
.B \&.
آغاز شوند و از تبلیغ و اعلان عمومی پنهان بمانند:
.sp
.if n \{\
.RS 4
.\}
.nf
# mv $DB/old_sig\&.jwk $DB/\&.old_sig\&.jwk
# mv $DB/old_exc\&.jwk $DB/\&.old_exc\&.jwk
.fi
.if n \{\
.RE
.\}
.sp
تانگ بلافاصله تمامی تغییرات را اعمال خواهد کرد\&. نیازی به راه‌اندازی مجدد نیست\&.
.sp
در این مرحله، مقیدسازی‌های کلاینت‌های جدید کلیدهای تازه را به کار خواهند گرفت و کلاینت‌های قدیمی نیز می‌توانند به استفاده از کلیدهای پیشین ادامه دهند\&. هنگامی که اطمینان یافتید همه کلاینت‌های قدیمی به استفاده از کلیدهای جدید مهاجرت کرده‌اند، می‌توانید کلیدهای قدیمی را حذف کنید\&. به یاد داشته باشید که حذف کلیدهای قدیمی در حالی که کلاینت‌ها هنوز در حال استفاده از آن‌ها هستند می‌تواند منجر به از دست رفتن داده‌ها شود؛ این هشدار را جدی بگیرید\&.
.SH "کارایی بالا (HIGH PERFORMANCE)"
.sp
پروتکل تانگ به شدت سریع است\&. با این حال، در راه‌اندازی پیش‌فرض از فعال‌سازی سوکت systemd برای اجرای یک فرایند به ازای هر اتصال استفاده می‌شود\&. این کار سرباری بر کارایی تحمیل می‌کند\&. برای اغلب استقرارها، با توجه به اینکه تانگ بسیار سبک‌وزن است، این روش احتمالاً به اندازه کافی سریع است؛ اما برای استقرارهای بزرگ‌تر، می‌توان به کارایی بالاتری دست یافت\&.
.sp
توصیه ما برای دستیابی به توان عملیاتی بالاتر این است که ترافیک به سمت تانگ را با استفاده از یک استخر اتصال (connection pool) از طریق سرویس‌های وب موجود خود پراکسی کنید\&. از آنجا که به ازای هر اتصال یک فرایند مجزا وجود دارد، باز نگه داشتن تعدادی اتصال در این حالت، به دلیل نبود قفل‌های داخلی در تانگ، همزمانی و موازی‌سازی موثری را به همراه خواهد داشت\&.
.sp
در وب‌سرور آپاچی، این کار با استفاده از دستورالعمل \fBProxyPass\fR در ماژول \fBmod_proxy\fR میسر است\&.
.SH "دسترس‌پذیری بالا (HIGH AVAILABILITY)"
.sp
تانگ دو روش برای راه‌اندازی یک محیط با دسترس‌پذیری بالا فراهم می‌کند\&.
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
افزونگی کلاینت (توصیه‌شده)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
اشتراک‌گذاری کلید با DNS round\-robin
.RE
.sp
اگرچه به اشتراک گذاشتن کلیدها میان چندین سرور تانگ ممکن است وسوسه‌انگیز باشد، اما باید از این روش پرهیز کرد\&. اشتراک‌گذاری کلید خطر افشای کلید را افزایش می‌دهد و نیازمند زیرساخت خودکارسازی اضافه است\&.
.sp
در عوض، کلاینت‌ها باید به گونه‌ای توسعه یابند که امکان مقیدسازی به چندین سرور تانگ را داشته باشند\&. در این حالت، هر سرور تانگ کلیدهای ویژه خود را دارد و کلاینت‌ها با برقراری ارتباط با زیرمجموعه‌ای از این سرورها قادر به رمزگشایی خواهند بود\&.
.sp
ابزار Clevis پیشاپیش از طریق افزونه \fBsss\fR خود از این شیوه کاری پشتیبانی می‌کند\&.
.sp
با این همه، اگر هنوز بر این باورید که اشتراک‌گذاری کلید استراتژی مناسبی برای استقرار شماست، تانگ مانعی سر راهتان قرار نمی‌دهد\&. تنها کافی است تمام محتویات دایرکتوری پایگاه داده را (با رعایت کامل امنیت!) به تمامی سرورهای خود انتقال دهید\&. دقت کنید که کلیدهای اعلان‌نشده (مخفی) را جا نیندازید! سپس توزیع بار DNS round\-robin را تنظیم کنید تا کلاینت‌ها میان سرورهای شما متعادل شوند\&.
.SH "دستورات (COMMANDS)"
.sp
سرور تانگ هیچ دستور عمومی ارائه نمی‌کند\&.
.SH "نویسنده (AUTHOR)"
.sp
Nathaniel McCallum <npmccallum@redhat\&.com>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBsystemd\&.unit\fR(5), \fBsystemd\&.socket\fR(5), \fBjose\-jwk\-gen\fR(1), \fBtang\-show\-keys\fR(1), \fBtangd\-rotate\-keys\fR(1)
.SH "مطالعه بیشتر (FURTHER READING)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Clevis :
https://github\&.com/latchset/clevis
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Tang :
https://github\&.com/latchset/tang
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
JOSE :
https://datatracker\&.ietf\&.org/wg/jose/charter
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mod_proxy :
https://httpd\&.apache\&.org/docs/2\&.4/mod/mod_proxy\&.html
.RE