.TH TLSMGR 8
.ad
.fi
.SH "نام (NAME)"
tlsmgr \- مدیر کش نشست TLS و استخر PRNG در Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBtlsmgr\fR [\fIگزینه‌های عمومی دیمن Postfix\fR]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
دیمن \fBtlsmgr\fR(8) کش‌های نشست TLS در Postfix را مدیریت می‌کند.
این دیمن به درخواست فرآیندهای
\fBsmtpd\fR(8)
و
\fBsmtp\fR(8)
ورودی‌های کش را ذخیره و بازیابی کرده و ورودی‌هایی را که منقضی شده‌اند به‌صورت دوره‌ای حذف می‌کند.
.PP
دیمن \fBtlsmgr\fR(8) همچنین استخر PRNG (تولیدکننده اعداد شبه‌تصادفی) را مدیریت می‌نماید. این دیمن به پرس‌وجوهای فرآیندهای
\fBsmtpd\fR(8)
و
\fBsmtp\fR(8)
برای دانه‌بندی استخرهای PRNG داخلی آن‌ها پاسخ می‌دهد.
.PP
استخر PRNG در \fBtlsmgr\fR(8) در ابتدا از یک منبع خارجی (مانند EGD،‏ /dev/urandom یا یک فایل معمولی) دانه‌بندی می‌شود. این استخر در فواصل زمانی شبه‌تصادفیِ قابل‌پیکربندی با داده‌های برگرفته از منبع خارجی به‌روزرسانی می‌شود. همچنین به‌طور دوره‌ای با داده‌های ورودی‌های کش نشست TLS و با ساعت سیستم به‌روزرسانی می‌گردد، و هر زمان که فرآیندی درخواست سرویسی از \fBtlsmgr\fR(8) داشته باشد نیز با زمان جاری سیستم به‌روز می‌شود.
.PP
دیمن \fBtlsmgr\fR(8) وضعیت PRNG را به‌صورت دوره‌ای و هنگام پایان فرآیند در یک فایل تبادل ذخیره می‌کند، و هنگام راه‌اندازی و مقداردهی اولیه PRNG خود، این فایل تبادل را می‌خواند.
.SH "امنیت (SECURITY)"
.na
.nf
.ad
.fi
دیمن \fBtlsmgr\fR(8) از نظر امنیتی حساس نیست. کدی که استخرهای PRNG خارجی و داخلی را نگهداری می‌کند، به داده‌هایی که دستکاری می‌نماید «اعتماد» نمی‌کند، و کدی که کش نشست TLS را مدیریت می‌کند به محتویات ورودی‌های کش‌شده دست نمی‌زند، مگر برای دانه‌بندی استخر PRNG داخلی خود.
.PP
دیمن \fBtlsmgr\fR(8) می‌تواند در محیط chroot و با دسترسی‌های کاهش‌یافته اجرا شود. هنگام شروع فرآیند، به منبع آنتروپی و فایل تبادل متصل می‌شود و فایل‌های اختیاری کش نشست TLS را ایجاد کرده یا اندازه آن‌ها را صفر (truncate) می‌کند.
.PP
از Postfix نسخه 2.5 و بالاتر، \fBtlsmgr\fR(8) دیگر هنگام باز کردن فایل‌های کش از دسترسی‌های کاربر ریشه (root) استفاده نمی‌کند. این فایل‌ها اکنون باید تحت پوشه \fBdata_directory\fR متعلق به Postfix ذخیره شوند. به عنوان کمکی برای مهاجرت، تلاش برای باز کردن فایل کش در پوشه‌ای غیر از پوشه Postfix، به \fBdata_directory\fR متعلق به Postfix تغییر مسیر داده شده و یک پیام هشدار ثبت می‌گردد.
.SH "عیب‌یابی (DIAGNOSTICS)"
.ad
.fi
مشکلات و تراکنش‌ها در \fBsyslogd\fR(8) یا \fBpostlogd\fR(8) ثبت می‌شوند.
.SH "اشکالات (BUGS)"
.ad
.fi
هیچ راهکار خودکاری برای محدود کردن تعداد ورودی‌ها در کش‌های نشست TLS و/یا اندازه فایل‌های کش TLS وجود ندارد.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
تغییرات در \fBmain.cf\fR به‌صورت خودکار اعمال نمی‌شوند، زیرا \fBtlsmgr\fR(8) یک فرآیند ماندگار (persistent) است. پس از تغییر پیکربندی از دستور «\fBpostfix reload\fR» استفاده کنید.
.PP
متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر به همراه مثال‌ها به \fBpostconf\fR(5) مراجعه کنید.
.SH "کش نشست TLS (TLS SESSION CACHE)"
.na
.nf
.ad
.fi
.IP "\fBlmtp_tls_loglevel (0)\fR"
نسخه ویژه LMTP از پارامتر پیکربندی smtp_tls_loglevel.
.IP "\fBlmtp_tls_session_cache_database (empty)\fR"
نسخه ویژه LMTP از پارامتر پیکربندی smtp_tls_session_cache_database.
.IP "\fBlmtp_tls_session_cache_timeout (3600s)\fR"
نسخه ویژه LMTP از پارامتر پیکربندی smtp_tls_session_cache_timeout.
.IP "\fBsmtp_tls_loglevel (0)\fR"
فعال‌سازی ثبت وقایع بیشتر برای فعالیت TLS در کلاینت SMTP نرم‌افزار Postfix.
.IP "\fBsmtp_tls_session_cache_database (empty)\fR"
نام فایل حاوی کش اختیاری نشست TLS مربوط به کلاینت SMTP در Postfix.
.IP "\fBsmtp_tls_session_cache_timeout (3600s)\fR"
زمان انقضای اطلاعات کش نشست TLS در کلاینت SMTP نرم‌افزار Postfix.
.IP "\fBsmtpd_tls_loglevel (0)\fR"
فعال‌سازی ثبت وقایع بیشتر برای فعالیت TLS در کارساز SMTP نرم‌افزار Postfix.
.IP "\fBsmtpd_tls_session_cache_database (empty)\fR"
نام فایل حاوی کش اختیاری نشست TLS مربوط به کارساز SMTP در Postfix.
.IP "\fBsmtpd_tls_session_cache_timeout (3600s)\fR"
زمان انقضای اطلاعات کش نشست TLS در کارساز SMTP نرم‌افزار Postfix.
.SH "تولیدکننده اعداد شبه‌تصادفی (PSEUDO RANDOM NUMBER GENERATOR)"
.na
.nf
.ad
.fi
.IP "\fBtls_random_source (see 'postconf -d' output)\fR"
منبع آنتروپی خارجی برای استخر حافظه‌محور تولیدکننده اعداد شبه‌تصادفی (PRNG) در \fBtlsmgr\fR(8).
.IP "\fBtls_random_bytes (32)\fR"
تعداد بایت‌هایی که \fBtlsmgr\fR(8) هنگام دانه‌بندی (مجدد) استخر حافظه‌محور تولیدکننده اعداد شبه‌تصادفی (PRNG) از $tls_random_source می‌خواند.
.IP "\fBtls_random_exchange_name (see 'postconf -d' output)\fR"
نام فایل وضعیت تولیدکننده اعداد شبه‌تصادفی (PRNG) که توسط \fBtlsmgr\fR(8) نگهداری می‌شود.
.IP "\fBtls_random_prng_update_period (3600s)\fR"
فاصله زمانی میان تلاش‌های \fBtlsmgr\fR(8) برای ذخیره وضعیت تولیدکننده اعداد شبه‌تصادفی (PRNG) در فایل مشخص‌شده با $tls_random_exchange_name.
.IP "\fBtls_random_reseed_period (3600s)\fR"
حداکثر زمان میان تلاش‌های \fBtlsmgr\fR(8) برای دانه‌بندی مجدد استخر حافظه‌محور تولیدکننده اعداد شبه‌تصادفی (PRNG) از منابع خارجی.
.SH "کنترل‌های متفرقه (MISCELLANEOUS CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
.IP "\fBdata_directory (see 'postconf -d' output)\fR"
پوشه حاوی فایل‌های داده با دسترسی نوشتن برای Postfix (برای مثال: کش‌ها، اعداد شبه‌تصادفی).
.IP "\fBdaemon_timeout (18000s)\fR"
مدت زمانی که یک فرآیند دیمن Postfix مجاز است صرف رسیدگی به یک درخواست کند پیش از آنکه توسط یک تایمر نظارتی (watchdog) داخلی متوقف شود.
.IP "\fBprocess_id (read\-only)\fR"
شناسه فرآیند (PID) یک دستور یا فرآیند دیمن Postfix.
.IP "\fBprocess_name (read\-only)\fR"
نام فرآیند یک دستور یا فرآیند دیمن Postfix.
.IP "\fBsyslog_facility (mail)\fR"
تسهیلات syslog برای ثبت وقایع Postfix.
.IP "\fBsyslog_name (see 'postconf -d' output)\fR"
پیشوندی که به نام فرآیند در رکوردهای syslog اضافه می‌شود، به‌طوری که برای مثال "smtpd" به "prefix/smtpd" تبدیل می‌شود.
.PP
در Postfix نسخه 3.3 و بالاتر موجود است:
.IP "\fBservice_name (read\-only)\fR"
نام سرویس master.cf مربوط به یک فرآیند دیمن Postfix.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
smtp(8), کلاینت SMTP در Postfix
smtpd(8), کارساز SMTP در Postfix
postconf(5), پارامترهای پیکربندی
master(5), گزینه‌های عمومی دیمن
master(8), مدیر فرآیند
postlogd(8), ثبت وقایع Postfix
syslogd(8), ثبت وقایع سیستم
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
برای یافتن این اطلاعات از "\fBpostconf readme_directory\fR" یا
"\fBpostconf html_directory\fR" استفاده کنید.
.na
.nf
TLS_README, پیکربندی و عملکرد TLS در Postfix
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
این سرویس در Postfix نسخه 2.2 معرفی شد.
.SH "نویسندگان (AUTHORS)"
.na
.nf
Lutz Jaenicke
BTU Cottbus
Allgemeine Elektrotechnik
Universitaetsplatz 3\-4
D\-03044 Cottbus, Germany

تطبیق‌یافته توسط:
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA

Wietse Venema
Google, Inc.
111 8th Avenue
New York, NY 10011, USA