نام (NAME)

mosquitto_passwd - مدیریت فایل‌های گذرواژه برای mosquitto

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

mosquitto_passwd [-H hash] [-c | -D] passwordfile username

mosquitto_passwd [-H hash] -b passwordfile username password

mosquitto_passwd -U passwordfile

توضیحات (DESCRIPTION)

mosquitto_passwd ابزاری برای مدیریت فایل‌های گذرواژه برای کارگزار MQTT mosquitto است.

نام‌های کاربری نباید شامل «:» باشند. گذرواژه‌ها در قالبی شبیه به crypt(3) ذخیره می‌شوند.

گزینه‌ها (OPTIONS)

-b

اجرا در حالت دسته‌ای (batch mode). این گزینه امکان مشخص کردن گذرواژه را در خط فرمان فراهم می‌کند که می‌تواند راحت باشد، اما باید با احتیاط استفاده شود چرا که گذرواژه در خط فرمان و در تاریخچه دستورات قابل مشاهده خواهد بود.

-c

ایجاد یک فایل گذرواژه جدید. اگر فایل از قبل وجود داشته باشد، بازنویسی خواهد شد. اگر نام فایل با یک خط تیره - مشخص شود، خروجی به stdout ارسال می‌شود. این کار در اصل تنها با گزینه -b معنا دارد.

-D

حذف کاربر مشخص‌شده از فایل گذرواژه.

-H

انتخاب هش مورد استفاده. می‌تواند یکی از argon2id، sha512-pbkdf2، یا sha512 باشد. مقدار پیش‌فرض argon2id است. گزینه sha512 جهت ایجاد فایل‌های گذرواژه برای سازگاری با Mosquitto نسخه 1.6 و قدیمی‌تر ارائه شده است.

-U

از این گزینه می‌توان برای ارتقا/تبدیل یک فایل گذرواژه حاوی گذرواژه‌های متن ساده به فایلی با گذرواژه‌های هش‌شده استفاده کرد. این گزینه فایل مشخص‌شده را تغییر می‌دهد. برنامه بررسی نمی‌کند که آیا گذرواژه‌ها از قبل هش شده‌اند یا خیر، بنابراین اجرای آن روی فایلی که حاوی گذرواژه‌های هش‌شده است، بر اساس هش‌های قبلی هش‌های جدیدی تولید می‌کند و فایل گذرواژه را غیرقابل استفاده خواهد کرد.

passwordfile

فایل گذرواژه‌ای که باید تغییر داده شود.

username

نام کاربری برای افزودن/به‌روزرسانی/حذف.

password

گذرواژه‌ای که در حالت دسته‌ای استفاده می‌شود.

وضعیت خروج (EXIT STATUS)

دستور mosquitto_passwd در صورت موفقیت مقدار صفر و در صورت بروز خطا مقدار غیرصفر بازمی‌گرداند.

مثال‌ها (EXAMPLES)

افزودن کاربر به یک فایل گذرواژه جدید:

•mosquitto_passwd -c /etc/mosquitto/passwd ral

افزودن کاربر به یک فایل گذرواژه موجود:

•mosquitto_passwd /etc/mosquitto/passwd ral

افزودن کاربر به یک فایل گذرواژه موجود با ارسال گذرواژه در خط فرمان:

•mosquitto_passwd -b /etc/mosquitto/passwd ral z2Dr0BsvtZ

به‌روزرسانی گذرواژه یک کاربر در یک فایل گذرواژه موجود:

•mosquitto_passwd /etc/mosquitto/passwd ral

افزودن کاربر به یک فایل گذرواژه موجود با استفاده از هش sha512 برای سازگاری با Mosquitto 1.6:

•mosquitto_passwd -H sha512 /etc/mosquitto/passwd ral

حذف یک کاربر از فایل گذرواژه:

•mosquitto_passwd -D /etc/mosquitto/passwd ral

متغیرهای محیطی (ENVIRONMENT VARIABLES)

MOSQUITTO_UNSAFE_ALLOW_SYMLINKS

به‌طور پیش‌فرض، بارگذاری فایل‌های حساس که مسیر آن‌ها شامل یک پیوند نمادین (symbolic link) باشد رد خواهد شد. این متغیر محیطی را به هر مقداری تنظیم کنید تا بارگذاری فایل‌ها از طریق پیوندهای نمادین مجاز شود. توجه داشته باشید که استفاده از این متغیر می‌تواند شما را در معرض حملات پیوند نمادین قرار دهد و بنابراین فقط باید در مواردی استفاده شود که کاملاً مطمئن هستید این موضوع خطری ندارد.

اشکالات (BUGS)

اطلاعات مربوط به اشکالات mosquitto در نشانی زیر قابل مشاهده است: https://github.com/eclipse-mosquitto/mosquitto/issues

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

mosquitto(7), mosquitto(8), mosquitto.conf(5), mqtt(7)

نویسنده (AUTHOR)

Roger Light <roger@atchoo.org>