نام (NAME)

doveadm-pw - تولیدکننده و اعتبارسنج هش گذرواژه در Dovecot

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

doveadm [GLOBAL OPTIONS] pw -l

doveadm [GLOBAL OPTIONS] pw [-p password] [-r rounds] [-s scheme] [-u user] [-V]

doveadm [GLOBAL OPTIONS] pw -t hash [-p password] [-u user]

توضیحات (DESCRIPTION)

دستور doveadm pw برای تولید هش‌های گذرواژه برای schemeهای مختلف گذرواژه و به‌طور اختیاری اعتبارسنجی هش تولیدشده به کار می‌رود.

همهٔ هش‌های گذرواژهٔ تولیدشده دارای پیشوند {scheme} هستند، برای نمونه {SHA512-CRYPT.HEX}. تمام passdbها دارای یک طرح‌وارهٔ پیش‌فرض برای گذرواژه‌های ذخیره‌شده بدون پیشوند {scheme} هستند. طرح‌وارهٔ پیش‌فرض را می‌توان با ذخیره کردن گذرواژه به همراه پیشوند طرح‌واره جایگزین (override) کرد.

اگر می‌خواهید بدون نیاز به پیکربندی اولیهٔ Dovecot از این قابلیت برای اعتبارسنجی یا تولید گذرواژه‌ها استفاده کنید، می‌توانید دستور doveadm -O pw را به کار ببرید.

گزینه‌های سراسری (GLOBAL OPTIONS)

گزینه‌های عمومی doveadm(1):

-D

حالت پرگویی (verbosity) و پیام‌های اشکال‌زدایی را فعال می‌کند.

-O

هیچ فایل پیکربندی را نمی‌خواند و تنها از مقادیر پیش‌فرض استفاده می‌کند. تنظیم dovecot_storage_version به‌طور پیش‌فرض روی آخرین نسخه قرار می‌گیرد، اما می‌تواند با -o بازنویسی شود.

-k

تمام محیط را برای doveadm حفظ می‌کند، نه فقط مقدار تنظیم‌شده در import_environment را.

-v

حالت پرگویی (verbosity)، شامل شمارندهٔ پیشرفت را فعال می‌کند.

-i instance-name

در صورت استفاده از چند نمونهٔ (instance) داکوت، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.

برای اطلاعات بیشتر، تنظیم instance_name را ببینید.

-c config-file

پیکربندی را از config-file داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و سپس به /etc/dovecot/dovecot.conf بازمی‌گردد. شما همچنین می‌توانید آن را به سوکت پیکربندی نمونه‌ای با یک نسخهٔ سازگار متصل کنید.

-o setting=value

تنظیم پیکربندی (setting) را از /etc/dovecot/dovecot.conf و از userdb با مقدار داده‌شده (value) جایگزین می‌کند. به منظور بازنویسی چندین تنظیم، می‌توان گزینهٔ -o را چندین بار مشخص کرد.

گزینه‌ها (OPTIONS)

-l

تمام schemeهای گذرواژهٔ پشتیبانی‌شده را فهرست کرده و با موفقیت خارج می‌شود.

حداکثر تا سه scheme اختیاری برای گذرواژه وجود دارد: BLF-CRYPT (رمزنگاری Blowfish)، SHA256-CRYPT و SHA512-CRYPT. در دسترس بودن آن‌ها به libc فعلی مورد استفاده در سیستم بستگی دارد.

-p password

گذرواژهٔ متنی ساده (password) که هش باید برای آن تولید شود. اگر هیچ passwordی مشخص نشود، doveadm(1) به‌صورت تعاملی آن را درخواست خواهد کرد. (توجه داشته باشید که استفاده از این گزینه باعث قرار گرفتن گذرواژهٔ متنی ساده در تاریخچهٔ شل شما می‌شود!)

-r rounds

طرح‌واره‌های (schemeهای) گذرواژهٔ BLF-CRYPT، SHA256-CRYPT و SHA512-CRYPT از تعداد متغیری دور رمزنگاری (rounds) پشتیبانی می‌کنند. جدول زیر کمینه/بیشینهٔ دورهای رمزنگاری (rounds) را برای هر طرح‌واره نشان می‌دهد. در صورت نادیده گرفتن گزینهٔ -r، تعداد دورهای پیش‌فرض رمزنگاری اعمال می‌شود.

طرح‌واره (Scheme)	کمینه	بیشینه	پیش‌فرض
BLF-CRYPT	4	31	5
SHA256-CRYPT	1000	999999999	5000
SHA512-CRYPT	1000	999999999	5000

-s scheme

طرح‌وارهٔ (scheme) گذرواژه‌ای که باید برای تولید گذرواژهٔ هش‌شده استفاده شود. به‌طور پیش‌فرض، طرح‌وارهٔ CRYPT استفاده خواهد شد (با قالب $2y$ در bcrypt). همچنین افزودن یک پسوند کدگذاری به scheme امکان‌پذیر است. پسوندهای کدگذاری پشتیبانی‌شده عبارتند از: .b64، .base64 و .hex.

برای جزئیات بیشتر دربارهٔ طرح‌واره‌های گذرواژه، password_schemes را نیز ببینید.

-t hash

بررسی این‌که آیا هش گذرواژهٔ داده‌شده (hash) با یک گذرواژهٔ متنی سادهٔ داده‌شده مطابقت دارد یا خیر. اگر هش گذرواژه حاوی یک یا چند علامت دلار ($) است، باید آن را درون نقل‌قول تکی قرار دهید. گذرواژهٔ متنی ساده را می‌توان با استفاده از گزینهٔ -p منتقل کرد. در صورتی که گذرواژه‌ای مشخص نشده باشد، doveadm(1) به‌صورت تعاملی آن را درخواست خواهد کرد.

-u user

هنگامی که از طرح‌وارهٔ DIGEST-MD5 استفاده می‌شود، نام کاربری (user) نیز باید مشخص گردد؛ چرا که نام کاربری بخشی از هش تولیدشده است. برای اطلاعات بیشتر دربارهٔ Digest-MD5 لطفاً auth_digest_md5 را نیز بخوانید. برای سایر طرح‌واره‌ها، این مورد الزامی نیست.

-V

هنگامی که این گزینه مشخص شود، گذرواژهٔ هش‌شده به‌صورت داخلی اعتبارسنجی خواهد شد. نتیجهٔ اعتبارسنجی پس از گذرواژهٔ هش‌شده و در پرانتز نمایش داده می‌شود.

مثال‌ها (EXAMPLES)

یک هش ARGON2ID (بالاترین امنیت در زمان نگارش این راهنما، هرچند ممکن است روی یک کارساز شلوغ سنگین باشد):

# doveadm pw -s ARGON2ID
Enter new password:
Retype new password:
{ARGON2ID}$argon2id$v=19$m=65536,t=3,p=1$AOrrkaFmGxCFtX+NCSHFkg$N3rlzYFqyNkCwrOingnDJ/qDQ09yGHgQa8PQfbu7rIE

یا به عنوان جایگزین، یک هش SHA512-CRYPT:

# doveadm pw -s SHA512-CRYPT
Enter new password:
Retype new password:
{SHA512-CRYPT}$6$qAvxfQ2UbA1QTXSg$SB2aMEK76DBObt.KqTjF5.yDMceaD3dkG2UvrKQD0rZ9PKii/VAn.VS0nBsDqJX18kXieMi8AWJr0f7Ae9dAp/

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

گزارش باگ‌ها، از جمله خروجی doveconf -n را به فهرست پستی Dovecot به نشانی ⟨dovecot@dovecot.org⟩ ارسال کنید. اطلاعات دربارهٔ نحوهٔ گزارش باگ‌ها در این نشانی در دسترس است: ⟨https://dovecot.org/bugreport.html⟩

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

doveadm(1)