.TH AusweisApp 1
.SH "نام (NAME)"
AusweisApp \- برنامه رسمی احراز هویت با کارت‌های شناسایی و مجوزهای اقامت آلمان
.SH "خلاصه دستور (SYNOPSIS)"
AusweisApp [\-h|\-\-help]
.br
AusweisApp [\-\-help\-all]
.br
AusweisApp [\-v|\-\-version]
.br
AusweisApp [\-\-show]
.br
AusweisApp
[\-\-keep]
[\-\-no\-logfile]
[\-\-no\-loghandler]
[\-\-show]
[\-\-no\-proxy]
[\-\-ui { qml|websocket }]
[\-\-port \fI\,PORT\/\fR]
[\-\-address \fI\,ADDRESS\/\fR]

.SH "توضیحات (DESCRIPTION)"
برنامه
.B AusweisApp
به شما امکان می‌دهد تا هویت خود را در وب‌سایت‌ها از طریق کارت شناسایی و مجوزهای اقامت آلمانی (احراز هویت دیجیتال / eID) احراز کنید.
.PP
پیش‌نیازها:
.br
* یک کارت شناسایی (eID) که قابلیت احراز هویت آنلاین آن فعال باشد
.br
* یک دستگاه NFC سازگار (بیشتر کارت‌خوان‌های NFC کار می‌کنند؛ از گوشی‌های مجهز به NFC نیز می‌توان استفاده کرد)
.br
* برنامه AusweisApp
.br
* یک مرورگر وب
.br
* وب‌سایتی که از احراز هویت با کارت شناسایی آلمان پشتیبانی کند
.PP
هنگامی که از چنین وب‌سایتی بازدید می‌کنید،
.B AusweisApp
فعال شده و از شما می‌پرسد که آیا مایلید هویت خود را در وب‌سایت احراز کنید یا خیر.
.PP
این برنامه یک وب‌سرور محلی ایجاد می‌کند تا مرورگر شما با آن تعامل داشته باشد.

.SH "گزینه‌ها (OPTIONS)"

.TP
.BR \-h ", " \-\-help
یک پیام راهنمای کوتاه را نمایش می‌دهد.

.TP
.B \-\-help\-all
راهنما را به همراه گزینه‌های اختصاصی Qt نمایش می‌دهد.

.TP
.BR \-v ", " \-\-version
اطلاعات نسخه را نمایش می‌دهد.

.TP
.B \-\-keep
.br
به‌طور پیش‌فرض،
.B AusweisApp
گزارش وقایع را در فایلی مطابق با
\fI${TMP}/AusweisApp.*.log\fR
می‌نویسد. هنگامی که برنامه خاتمه می‌یابد، این فایل حذف خواهد شد. این گزینه از حذف فایل جلوگیری می‌کند.

.TP
.B \-\-no\-logfile
از نوشتن فایل لاگ در
\fI${TMP}/AusweisApp.*.log\fR
جلوگیری می‌کند. گزارش‌ها همچنان در خروجی استاندارد (STDOUT) نوشته خواهند شد.

.TP
.B \-\-no\-loghandler
گرداننده گزارش (log handler) پیش‌فرض را غیرفعال می‌کند. این کار ثبت گزارش در STDOUT را غیرفعال می‌سازد.

.TP
.B \-\-show
پنجره برنامه را هنگام راه‌اندازی نمایش می‌دهد.

.TP
.B \-\-no\-proxy
پروکسی سیستم را غیرفعال می‌کند.

.TP
.B \-\-ui { qml|webservice|websocket }
این گزینه چندین مقدار را می‌پذیرد:
.br
\- مقدار "qml" برنامه را با یک رابط کاربری بصری اجرا می‌کند.
.br
\- مقدار "websocket" برنامه را در پس‌زمینه به‌عنوان یک SDK اجرا می‌کند. این حالت تنها هنگام ادغام
.B AusweisApp
با برنامه‌های دیگر کاربرد دارد.
.br
\- مقدار "webservice" شنود روی پورت/آدرس مشخص‌شده را آغاز می‌کند.
.PP
مقدار پیش‌فرض "qml,webservice,websocket" است.

.TP
.B \-\-port \fI\,PORT\/\fR
پورت شنود وب‌سوکت (WebSocket) را تغییر می‌دهد. مقدار پیش‌فرض 24727 است. انتخاب "0" یک حالت ویژه است؛ در این حالت
.B AusweisApp
یک پورت تصادفی انتخاب کرده و شماره پورت را در فایلی در
\fI${TMP}/AusweisApp.<PID>.port\fR
می‌نویسد.

.TP
.B \-\-address \fI\,ADDRESS\/\fR
از آدرس‌های ارائه‌شده برای مقیدسازی رابط (interface binding) استفاده می‌کند. به‌طور معمول
.B AusweisApp
به دلایل امنیتی تنها به
\fBlocalhost\fR
متصل می‌شود. این گزینه صرفاً برای مقاصد آزمایشی کاربرد دارد.
این گزینه چندین مقدار را می‌پذیرد.

.SH "مقدار بازگشتی (RETURN VALUE)"
برنامه
.B AusweisApp
در صورت پایان موفقیت‌آمیز مقدار 0 را برمی‌گرداند.

.SH "محیط (ENVIRONMENT)"
.TP
.B QT_QPA_PLATFORM={ wayland|X11 }
می‌توانید نوع نشست را به wayland یا X11 اجبار کنید. این کار تنها برای اهداف اشکال‌زدایی (debugging) لازم است. در محیط گنوم (gnome)، متغیر XDG_SESSION_TYPE نادیده گرفته می‌شود.

.SH "فایل‌ها (FILES)"
\fI~/.config/AusweisApp_CE/AusweisApp2.conf\fR
.br
مسیر فایلی که پیکربندی کاربر در آن ذخیره می‌شود.

.SH "هشدارها (CAVEATS)"
در حال حاضر در محیط گنوم (gnome) روشی برای بستن برنامه وجود ندارد زیرا آیکون سینی سیستم (TrayIcon) الزامی است.

.SH "نویسندگان (AUTHORS)"
این صفحه راهنما توسط Lee Garrett (debian@rocketjump.eu) برای دبیان نوشته شده است (اما دیگران نیز می‌توانند از آن استفاده کنند).

.SH "همچنین ببینید (SEE ALSO)"
https://www.ausweisapp.bund.de/en
.br
https://www.ausweisapp.bund.de/sdk