نام (NAME)

ykpamcfg - مدیریت تنظیمات کاربر برای ماژول Yubico PAM

خلاصه دستور (SYNOPSIS)

ykpamcfg [-1 | -2] [-A] [-p] [-i] [-v] [-V] [-h]

گزینه‌ها (OPTIONS)

-1

استفاده از slot 1. این حالت پیش‌فرض است.

-2

استفاده از slot 2.

-A action

انتخاب عملیات برای اجرا. بخش عملیات‌ها (ACTIONS) را در ادامه ببینید.

-p path

تعیین فایل خروجی، پیش‌فرض ~/.yubico/challenge است.

-i iterations

تعداد تکرارها (iterations) برای استفاده در PBKDF2 مربوط به پاسخ مورد انتظار.

-v

فعال‌سازی حالت پرگو (verbose).

-V

نمایش نسخه و خروج.

-h

نمایش راهنما و خروج.

عملیات‌ها (ACTIONS)

add_hmac_chalresp

ماژول PAM می‌تواند از حالت چالش-پاسخ (Challenge-response یا C/R) مبتنی بر HMAC-SHA1 که در YubiKeyها از نسخه 2.2 به بعد موجود است برای احراز هویت آفلاین استفاده کند. این عملیات اطلاعات وضعیت اولیه را به همراه C/R که باید در ورود بعدی صادر شود ایجاد می‌کند.

این ابزار در حال حاضر اطلاعات وضعیت را در فایلی درون دایرکتوری خانگی کاربر جاری ذخیره می‌کند (~/.yubico/challenge-123456 برای یک YubiKey با قابلیت خواندن شماره سریال از طریق API فعال، و ~/.yubico/challenge برای دستگاه فاقد آن).

ماژول PAM از یک دایرکتوری سراسری سیستم برای این فایل‌های وضعیت پشتیبانی می‌کند (در صورتی که دایرکتوری خانگی کاربر رمزنگاری شده باشد)، اما در یک دایرکتوری سراسری سیستم، بخش challenge باید با نام کاربری جایگزین شود. مثال: /var/yubico/challenges/alice-123456

برای استفاده از حالت سراسری سیستم، در حال حاضر باید فایل‌های وضعیت ایجاد شده را به صورت دستی منتقل کرده و ماژول PAM را بر همان اساس پیکربندی کنید.

مثال‌ها (EXAMPLES)

ابتدا، یک YubiKey را برای چالش-پاسخ روی slot 2 برنامه‌ریزی کنید:

$ ykpersonalize -2 -ochal-resp -ochal-hmac -ohmac-lt64 -oserial-api-visible
...
Commit? (y/n) [n]: y

اکنون، کاربر جاری را طوری تنظیم کنید که برای ورود به این YubiKey نیاز داشته باشد:

$ ykpamcfg -2 -v
...
Stored initial challenge and expected response in '/home/alice/.yubico/challenge-123456'.

سپس، احراز هویت با PAM را به عنوان مثال به این صورت پیکربندی کنید (ابتدا یک نسخه پشتیبان تهیه کنید):

/etc/pam.d/common-auth (از اوبونتو 10.10):

auth  required        pam_unix.so nullok_secure try_first_pass
auth  [success=1 new_authtok_reqd=ok ignore=ignore default=die] pam_yubico.so mode=challenge-response
auth  requisite       pam_deny.so
auth  required        pam_permit.so
auth  optional        pam_ecryptfs.so unwrap

گزارش باگ‌ها (BUGS)

گزارش باگ‌های ykpamcfg در سامانه ردیابی اشکالات: https://github.com/Yubico/yubico-pam/issues

همچنین ببینید (SEE ALSO)

pam_yubico(8)

صفحه خانگی yubico-pam: https://developers.yubico.com/yubico-pam

دستگاه‌های YubiKey را می‌توان از Yubico تهیه کرد: http://www.yubico.com