AusweisApp(1) General Commands Manual AusweisApp(1)

AusweisApp - برنامه رسمی احراز هویت با کارت‌های شناسایی و مجوزهای اقامت آلمان

AusweisApp [-h|--help]
AusweisApp [--help-all]
AusweisApp [-v|--version]
AusweisApp [--show]
AusweisApp [--keep] [--no-logfile] [--no-loghandler] [--show] [--no-proxy] [--ui { qml|websocket }] [--port PORT] [--address ADDRESS]

برنامه AusweisApp به شما امکان می‌دهد تا هویت خود را در وب‌سایت‌ها از طریق کارت شناسایی و مجوزهای اقامت آلمانی (احراز هویت دیجیتال / eID) احراز کنید.

پیش‌نیازها:
* یک کارت شناسایی (eID) که قابلیت احراز هویت آنلاین آن فعال باشد
* یک دستگاه NFC سازگار (بیشتر کارت‌خوان‌های NFC کار می‌کنند؛ از گوشی‌های مجهز به NFC نیز می‌توان استفاده کرد)
* برنامه AusweisApp
* یک مرورگر وب
* وب‌سایتی که از احراز هویت با کارت شناسایی آلمان پشتیبانی کند

هنگامی که از چنین وب‌سایتی بازدید می‌کنید، AusweisApp فعال شده و از شما می‌پرسد که آیا مایلید هویت خود را در وب‌سایت احراز کنید یا خیر.

این برنامه یک وب‌سرور محلی ایجاد می‌کند تا مرورگر شما با آن تعامل داشته باشد.

یک پیام راهنمای کوتاه را نمایش می‌دهد.
راهنما را به همراه گزینه‌های اختصاصی Qt نمایش می‌دهد.
اطلاعات نسخه را نمایش می‌دهد.

به‌طور پیش‌فرض، AusweisApp گزارش وقایع را در فایلی مطابق با ${TMP}/AusweisApp.*.log می‌نویسد. هنگامی که برنامه خاتمه می‌یابد، این فایل حذف خواهد شد. این گزینه از حذف فایل جلوگیری می‌کند.
از نوشتن فایل لاگ در ${TMP}/AusweisApp.*.log جلوگیری می‌کند. گزارش‌ها همچنان در خروجی استاندارد (STDOUT) نوشته خواهند شد.
گرداننده گزارش (log handler) پیش‌فرض را غیرفعال می‌کند. این کار ثبت گزارش در STDOUT را غیرفعال می‌سازد.
پنجره برنامه را هنگام راه‌اندازی نمایش می‌دهد.
پروکسی سیستم را غیرفعال می‌کند.
این گزینه چندین مقدار را می‌پذیرد:
- مقدار "qml" برنامه را با یک رابط کاربری بصری اجرا می‌کند.
- مقدار "websocket" برنامه را در پس‌زمینه به‌عنوان یک SDK اجرا می‌کند. این حالت تنها هنگام ادغام AusweisApp با برنامه‌های دیگر کاربرد دارد.
- مقدار "webservice" شنود روی پورت/آدرس مشخص‌شده را آغاز می‌کند.

مقدار پیش‌فرض "qml,webservice,websocket" است.

پورت شنود وب‌سوکت (WebSocket) را تغییر می‌دهد. مقدار پیش‌فرض 24727 است. انتخاب "0" یک حالت ویژه است؛ در این حالت AusweisApp یک پورت تصادفی انتخاب کرده و شماره پورت را در فایلی در ${TMP}/AusweisApp.<PID>.port می‌نویسد.
از آدرس‌های ارائه‌شده برای مقیدسازی رابط (interface binding) استفاده می‌کند. به‌طور معمول AusweisApp به دلایل امنیتی تنها به localhost متصل می‌شود. این گزینه صرفاً برای مقاصد آزمایشی کاربرد دارد. این گزینه چندین مقدار را می‌پذیرد.

برنامه AusweisApp در صورت پایان موفقیت‌آمیز مقدار 0 را برمی‌گرداند.

می‌توانید نوع نشست را به wayland یا X11 اجبار کنید. این کار تنها برای اهداف اشکال‌زدایی (debugging) لازم است. در محیط گنوم (gnome)، متغیر XDG_SESSION_TYPE نادیده گرفته می‌شود.

~/.config/AusweisApp_CE/AusweisApp2.conf
مسیر فایلی که پیکربندی کاربر در آن ذخیره می‌شود.

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

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

https://www.ausweisapp.bund.de/en
https://www.ausweisapp.bund.de/sdk