.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH signstar-configure-build 1  "signstar-configure-build "
.SH "نام (NAME)"
signstar\-configure\-build \- رابط خط فرمان برای پیکربندی ساخت تصویر Signstar
.SH "خلاصه دستور (SYNOPSIS)"
\fBsignstar\-configure\-build\fR [\fB\-c\fR|\fB\-\-config\fR] [\fB\-v\fR|\fB\-\-version\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH "توضیحات (DESCRIPTION)"
رابط خط فرمان برای پیکربندی ساخت تصویر Signstar
.PP
نکته: این دستور باید به عنوان کاربر ریشه (root) اجرا شود!
.PP
این فایل اجرایی به منظور پیکربندی کاربران سیستمی مرتبط یک سیستم Signstar در طول فرآیند ساخت در نظر گرفته شده است.
.PP
این ابزار کاربران سیستمی و یکپارچه‌سازی آن‌ها را بر اساس یک فایل پیکربندی مرکزی ایجاد می‌کند.
.PP
به طور پیش‌فرض، یکی از فایل‌های پیکربندی زیر در صورت وجود، به ترتیب زیر استفاده می‌شود:
.PP
\- "/usr/local/share/signstar/config.toml"
.PP
\- "/run/signstar/config.toml"
.PP
\- "/etc/signstar/config.toml"
.PP
اگر هیچ‌کدام از موارد بالا یافت نشوند، مسیر پیش‌فرض "/usr/share/signstar/config.toml" استفاده می‌شود.
به عنوان جایگزین می‌توان مسیر سفارشی فایل پیکربندی را با استفاده از گزینه "\-\-config"/ "\-c" مشخص کرد.
.PP
کاربران سیستمی در صورتی که از قبل وجود نداشته باشند، با کمک `useradd` ایجاد می‌شوند.
کاربران بدون عبارت عبور و با پوشه خانگی در زیر مسیر "/var/lib/signstar/home/" راه‌اندازی می‌شوند.
با این حال، پوشه خانگی آن‌ها به طور خودکار ایجاد نمی‌شود.
حساب‌های کاربری سیستمی سپس با کمک `usermod` قفل‌گشایی می‌شوند.
برای هر کاربر سیستمی یک فایل یکپارچه‌سازی tmpfiles.d در زیر مسیر "/usr/lib/tmpfiles.d" ارائه می‌شود تا امکان ایجاد خودکار پوشه خانگی آن‌ها فراهم شود.
.PP
اگر فایل پیکربندی استفاده‌شده کاربر سیستمی را با کلیدهای عمومی SSH مرتبط کند، یک فایل اختصاصی "authorized_keys" حاوی کلیدهای عمومی SSH برای کاربر در زیر مسیر "/etc/ssh/" ایجاد می‌شود.
علاوه بر این، یک پیکربندی الحاقی "sshd_config" در زیر مسیر "/etc/ssh/sshd_config.d/" ایجاد می‌شود.
این پیکربندی الحاقی "sshd_config" استفاده از "authorized_keys" کاربر و استفاده از یک دستور خاص را (یعنی یکی از موارد ["signstar\-download\-backup", "signstar\-download\-key\-certificate", "signstar\-download\-metrics", "signstar\-download\-secret\-share", "signstar\-download\-wireguard", "signstar\-sign", "signstar\-upload\-backup", "signstar\-upload\-secret\-share", "signstar\-upload\-update"]) بسته به نقش کاربر الزامی می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<CONFIG>\fR
مسیر فایل پیکربندی سفارشی

در صورت مشخص شدن، فایل پیکربندی سفارشی به جای مسیر پیش‌فرض فایل پیکربندی استفاده می‌شود.

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

\- "/usr/local/share/signstar/config.toml"

\- "/run/signstar/config.toml"

\- "/etc/signstar/config.toml"

اگر هیچ‌کدام از موارد بالا یافت نشوند، مسیر پیش‌فرض "/usr/share/signstar/config.toml" استفاده می‌شود.
.RS
همچنین می‌توان با متغیر محیطی \fBSIGNSTAR_CONFIG\fR آن را مشخص کرد.
.RE
.TP
\fB\-v\fR, \fB\-\-version\fR
نمایش نام و نسخه برنامه
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)