نام (NAME)

pass-otp - افزونه‌ای برای pass(1) جهت مدیریت توکن‌های گذرواژه یک‌بارمصرف (OTP).

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

pass otp [ COMMAND ] [ OPTIONS ]... [ ARGS ]...

توضیحات (DESCRIPTION)

pass-otp ابزار pass(1) را با دستور otp جهت افزودن کلیدهای محرمانه OTP، تولید کدهای OTP، و نمایش نشانی‌های URI کلید محرمانه با استفاده از ساختار استاندارد otpauth:// گسترش می‌دهد.

اگر هیچ COMMAND مشخص نشود، دستور پیش‌فرض code خواهد بود.

دستورها (COMMANDS)

otp code [ --clip, -c ] pass-name

یک کد OTP را از کلید محرمانه ذخیره‌شده در pass-name با استفاده از oathtool(1) تولید کرده و چاپ می‌کند. اگر --clip یا -c مشخص شده باشد، کد را چاپ نکرده بلکه با استفاده از xclip(1) در کلیپ‌بورد کپی می‌کند و پس از ۴۵ ثانیه (یا به میزان PASSWORD_STORE_CLIP_TIME) کلیپ‌بورد را بازیابی می‌کند. نام دیگر این دستور show است.

otp insert [ --force, -f ] [ --echo, -e ] [ [ --secret, -s ] [ --issuer, -i issuer ] [ --account, -a account ] ] [ pass-name ]

درخواست ورود و درج یک کلید محرمانه جدید OTP در مخزن گذرواژه در مسیر pass-name.

اگر --secret مشخص شده باشد، مقدار secret (کلید محرمانه) با فرض الگوریتم SHA1، دوره زمانی ۳۰ ثانیه‌ای و ۶ رقم OTP درخواست می‌شود. همچنین باید یکی از گزینه‌های issuer یا account (یا هر دو) مشخص شود.

اگر --secret مشخص نشده باشد، نشانی اینترنتی (URI) کلید درخواست می‌شود؛ برای مشخصات دقیق URI کلید، مستندات موجود در https://github.com/google/google-authenticator/wiki/Key-Uri-Format را ببینید.

مقدار محرمانه از ورودی استاندارد (stdin) خوانده می‌شود؛ هنگام اجرای تعاملی این دستور، --echo یا -e را برای بازتاب ورودی تعیین کنید. اگر pass-name مشخص نشده باشد، برچسب URI به‌صورت issuer:accountname به مسیری به شکل issuer/accountname تبدیل می‌شود. پیش از بازنویسی روی کلید محرمانه موجود، تأییدیه خواسته می‌شود مگر آنکه --force یا -f مشخص شده باشد. نام دیگر این دستور add است.

otp append [ --force, -f ] [ --echo, -e ] [ [ --secret, -s ] [ --issuer, -i issuer ] [ --account, -a account ] ] pass-name

الحاق یک کلید محرمانه OTP به گذرواژه ذخیره‌شده در pass-name، با حفظ خطوط موجود.

اگر --secret مشخص شده باشد، مقدار secret (کلید محرمانه) با فرض الگوریتم SHA1، دوره زمانی ۳۰ ثانیه‌ای و ۶ رقم OTP درخواست می‌شود. همچنین باید یکی از گزینه‌های issuer یا account (یا هر دو) مشخص شود.

اگر --secret مشخص نشده باشد، نشانی اینترنتی (URI) کلید درخواست می‌شود؛ برای مشخصات دقیق URI کلید، مستندات موجود در https://github.com/google/google-authenticator/wiki/Key-Uri-Format را ببینید.

نشانی URI از ورودی استاندارد (stdin) خوانده می‌شود؛ هنگام اجرای تعاملی این دستور، --echo یا -e را برای بازتاب ورودی تعیین کنید. پیش از بازنویسی روی کلید محرمانه موجود، تأییدیه خواسته می‌شود مگر آنکه --force یا -f مشخص شده باشد.

otp uri [ --clip, -c | --qrcode, -q ] pass-name

چاپ نشانی اینترنتی (URI) کلید ذخیره‌شده در pass-name در خروجی استاندارد (stdout). اگر --clip یا -c مشخص شده باشد، نشانی URI را چاپ نکرده بلکه با استفاده از xclip(1) در کلیپ‌بورد کپی می‌کند و پس از ۴۵ ثانیه (یا به میزان PASSWORD_STORE_CLIP_TIME) کلیپ‌بورد را بازیابی می‌کند. اگر --qrcode یا -q مشخص شده باشد، نشانی URI چاپ نمی‌شود بلکه یک بارکد QR با استفاده از qrencode(1) در ترمینال یا به‌صورت گرافیکی (در صورت پشتیبانی) نمایش داده می‌شود.

otp validate uri

بررسی اعتبار رشته URI مطابق با قالب Key Uri Format. برای اطلاعات بیشتر درباره این قالب، مستندات موجود در https://github.com/google/google-authenticator/wiki/Key-Uri-Format.

گزینه‌ها (OPTIONS)

help, -h, --help

نمایش پیام راهنمای نحوه استفاده.

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

pass(1), qrencode(1), zbarimg(1)

نویسندگان (AUTHORS)

pass-otp توسط Tad Fisher نوشته شده است.

کپی‌رایت و تکثیر (COPYING)

این برنامه یک نرم‌افزار آزاد است: شما می‌توانید تحت شرایط «اجازه‌نامه عمومی همگانی گنو» (GNU General Public License) منتشر شده توسط بنیاد نرم‌افزارهای آزاد، چه نسخه ۳ اجازه‌نامه و چه (به انتخاب خودتان) هر نسخه بعدی دیگری، آن را بازتوزیع کرده یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر «اجازه‌نامه عمومی همگانی گنو» را ببینید.

شما باید یک نسخه از «اجازه‌نامه عمومی همگانی گنو» را به همراه این برنامه دریافت کرده باشید. در غیر این صورت، پیوند http://www.gnu.org/licenses را مشاهده کنید.