.TH XCA 1 .SH "نام (NAME)" .B xca \- مدیریت گواهی‌ها و کلیدها در سامانه X .br یک رابط گرافیکی کاربر (GUI) برای مدیریت گواهی‌های X509، کلیدهای RSA/DSA/EC، درخواست‌های PKCS#10 و فهرست‌های ابطال گواهی (CRL) به صورت نرم‌افزاری و بر روی کارت‌های هوشمند. .SH "خلاصه دستور (SYNOPSIS)" .B xca .RI [ OPTIONS ] .br .SH "توضیحات (DESCRIPTION)" این برنامه به عنوان یک مرجع صدور گواهی (CA) و مخزن گواهی و کلید طراحی شده است. این ابزار برای ذخیره موارد از یک پایگاه‌داده SQL استفاده می‌کند. به طور پیش‌فرض از SQLite3 استفاده می‌شود، اما MySQL و PostgreSQL نیز آزمایش شده و پشتیبانی می‌شوند. انواع شناخته‌شده عبارتند از درخواست‌های امضای گواهی (PKCS#10)، گواهی‌ها (X509v3)، کلیدهای RSA، DSA و EC و فهرست‌های ابطال گواهی (CRL). امضای درخواست‌ها و ایجاد گواهی‌های خودامضا (self-signed) پشتیبانی می‌شود. هر دو می‌توانند برای سادگی بیشتر از الگوها (templates) استفاده کنند. ساختارهای PKI می‌توانند در قالب‌های گوناگونی مانند PKCS#12، PEM، DER، PKCS#8 و PKCS#7 وارد یا صادر شوند. .br برنامه XCA به کاربران امکان می‌دهد کارت‌های هوشمند را از طریق رابط PKCS#11 مدیریت کنند. .SH "گزینه‌ها (OPTIONS)" .TP .B \-\-crlgen= * ایجاد CRL برای . برای تنظیم نام داخلی CRL جدید از گزینه 'name' استفاده کنید. .TP .B \-\-database= نام فایل (*.xdb) پایگاه‌داده SQLite یا یک توصیف‌کننده پایگاه‌داده دوردست: [user@host/TYPE:dbname#prefix]. .TP .B \-\-exit خروج پس از وارد کردن موارد. .TP .B \-\-help چاپ این راهنما و خروج. .TP .B \-\-hierarchy= * ذخیره سلسله‌مراتب نمایه‌سازی OpenSSL در . .TP .B \-\-index= * ذخیره نمایه OpenSSL در . .TP .B \-\-import * وارد کردن همه موارد ارائه‌شده به پایگاه‌داده. .TP .B \-\-import-names * فهرستی از نام‌ها که با نقطه-ویرگول (;) از هم جدا شده‌اند و به موارد وارد شده به ترتیبی که در فایل PEM و خط فرمان یافت شده‌اند، اختصاص می‌یابند. .TP .B \-\-issuers * چاپ همه گواهی‌های صادرکننده شناخته‌شده که دارای کلید خصوصی مرتبط هستند و قیدهای اساسی (basic constraints) مربوط به CA در آن‌ها روی 'true' تنظیم شده است. .TP .B \-\-keygen= * ایجاد یک کلید جدید و وارد کردن آن به پایگاه‌داده. برای تنظیم نام داخلی کلید جدید از گزینه 'name' استفاده کنید. پارامتر دارای این قالب است: '[RSA|DSA|EC]:[|]. .TP .B \-\-list-curves چاپ تمامی منحنی‌های بیضوی (Elliptic Curves) شناخته‌شده. .TP .B \-\-list-items * فهرست کردن تمام موارد موجود در پایگاه‌داده. .TP .B \-\-name= * تعیین نام موارد ایجاد شده جدید. در صورت حذف، نامی خودکار تولید خواهد شد. .TP .B \-\-no-native-dialogs غیرفعال کردن پنجره‌های گفتگوی بومی سیستم‌عامل برای پیام‌ها و عملیات فایل، و استفاده از پنجره‌های گفتگوی اختصاصی Qt به جای آن. .TP .B \-\-no-gui رابط گرافیکی کاربر اجرا نشود. متناوباً می‌توانید متغیر محیطی XCA_NO_GUI=1 را تنظیم کنید یا xca را از طریق پیوند نمادین 'xca-console' فراخوانی کنید. .TP .B \-\-password= گذرواژه پایگاه‌داده برای باز کردن قفل آن. گزینه‌های قالب گذرواژه را در ادامه ببینید. .TP .B \-\-pem چاپ نمایش PEM از فایل‌های ارائه‌شده. تنها بخش عمومی کلیدهای خصوصی چاپ می‌شود. .TP .B \-\-pem-file تعیین یک نام فایل برای داده‌های PEM. به طور ضمنی شامل '--pem' نیز می‌شود. .TP .B \-\-print چاپ خلاصه مختصری از فایل‌های ارائه‌شده. .TP .B \-\-select= * انتخاب تمام موارد در id-list جدا شده با کاما برای نمایش از طریق 'print'، 'text' یا 'pem'. .TP .B \-\-sqlpass= گذرواژه برای دسترسی به سرور SQL دوردست. گزینه‌های قالب گذرواژه را در ادامه ببینید. .TP .B \-\-text چاپ محتوای فایل‌های ارائه‌شده همانند خروجی OpenSSL. .TP .B \-\-verbose چاپ گزارش اشکال‌زدایی روی stderr. معادل با تنظیم XCA_DEBUG=all. بخش XCA_DEBUG را ببینید. .TP .B \-\-version چاپ اطلاعات نگارش و خروج. .br .TP گزینه‌هایی که با علامت ستاره مشخص شده‌اند نیازمند پایگاه‌داده هستند؛ چه از طریق خط فرمان و چه به عنوان پایگاه‌داده پیش‌فرض. .SH "آرگومان‌های عبارت عبور (PASS PHRASE ARGUMENTS)" گزینه‌های گذرواژه نحوی مشابه با openssl را می‌پذیرند: .TP .B env:var دریافت گذرواژه از متغیر محیطی var. از آنجا که محیط سایر فرایندها در برخی پلتفرم‌ها (مانند دستور ps در برخی سیستم‌عامل‌های مبتنی بر Unix) قابل مشاهده است، این گزینه باید با احتیاط استفاده شود. .TP .B fd:number خواندن گذرواژه از توصیف‌گر فایل با شماره number. برای مثال می‌تواند برای ارسال داده‌ها از طریق یک لوله (pipe) استفاده شود. .TP .B file:pathname خط اول pathname به عنوان گذرواژه در نظر گرفته می‌شود. اگر pathname یکسانی برای آرگومان‌های password و sqlpassword داده شود، خط اول برای هر دو گذرواژه استفاده خواهد شد. نیازی نیست pathname حتماً به یک فایل معمولی ارجاع دهد: برای مثال می‌تواند به یک دستگاه یا لوله نام‌گذاری‌شده اشاره داشته باشد. .TP .B pass:password گذرواژه واقعی همان password است. از آنجا که گذرواژه برای ابزارها (مانند 'ps' در Unix) قابل مشاهده است، این قالب تنها باید در مواردی استفاده شود که امنیت اهمیتی ندارد. .TP .B stdin خواندن گذرواژه از ورودی استاندارد (stdin). .SH "محیط (ENVIRONMENT)" برخی متغیرهای محیطی کم‌وبیش کاربردی توسط xca ارزیابی می‌شوند: .TP .B XCA_NO_GUI=1 عدم اجرای اجباری رابط گرافیکی کاربر. معادل با آرگومان \fB--no-gui\fP. اگر هیچ‌کدام داده نشده باشند، XCA تلاش می‌کند هوشمندانه عمل کرده و با بررسی سایر آرگومان‌ها قضاوت کند که آیا GUI اجرا شود یا خیر. .TP .B XCA_DEBUG= متغیر محیطی .B XCA_DEBUG اشکال‌زدایی پویا را کنترل می‌کند. قالب آن فهرستی از الگوها است که با کاما از هم جدا شده‌اند. هر الگو به این صورت است: \fBall|[-]|[-]:[-]\fP خط تیره در ابتدا تطابق را نادیده می‌گیرد. \fIfirstline\fR و \fIlastline\fR می‌توانند خالی باشند و با خط اول و آخر فایل جایگزین خواهند شد. اگر \fI-\fR حذف شود، تنها شماره خط دقیقِ \fIlastline\fR مطابقت داده می‌شود. .br مثال: \fIXCA_DEBUG=all,-timerEvent\fR همه موارد را ثبت می‌کند به جز پیام‌های مزاحم timerEvent. .br مثال: \fIXCA_DEBUG=pki_base.cpp:100-,-pki_base.cpp:340\fR پیام‌های pki_base را از خط ۱۰۰ تا آخرین خط، به جز خط ۳۴۰ ثبت می‌کند. .TP .B XCA_ABORT_ON_WARNING=1 گزینه‌ای برای توسعه‌دهندگان جهت توقف اضطراری و ورود به اشکال‌زدا در صورت دریافت پیام سطح هشدار (warning). صرفاً جهت تکمیل مستندات ذکر شده و برای افراد غیرتوسعه‌دهنده کاربردی ندارد. .TP .B XCA_PORTABLE=1 اجبار به حالت پرتابل (قابل‌حمل) ویندوز. صرفاً جهت تکمیل مستندات ذکر شده و برای افراد غیرتوسعه‌دهنده کاربردی ندارد. .TP .B XCA_ARGUMENTS= آرگومان‌های خط فرمان را در قالب nroff صفحه مان، rst ابزار sphinx، یا به صورت فهرستی تک‌خطی برای تکمیل خودکار دستور خروجی می‌دهد تا در صورت اضافه شدن آرگومان‌های جدید، مستندات به طور خودکار به‌روزرسانی شوند. .TP .B XCA_QPSQL_OPTIONS XCA_QMYSQL_OPTIONS XCA_QODBC_OPTIONS گزینه‌های اتصال اضافی برای درایورهای پایگاه‌داده SQL همان‌گونه که در شرح داده شده است، مانند \fIQPSQL_OPTIONS=requiressl=1\fR .SH "همچنین ببینید (SEE ALSO)" مستندات HTML با جزئیات بیشتر را می‌توان در دایرکتوری doc، در منوی "Help" برنامه یا در نشانی یافت. .SH "نویسندگان (AUTHORS)" این صفحه راهنما توسط Christian Hohnstaedt نوشته شده است.