.TH SNMPUSM 1 "11 Dec 2009" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmpusm \- ایجاد و نگهداری کاربران SNMPv3 روی یک موجودیت شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.B snmpusm
[COMMON OPTIONS] [\-Cw] AGENT
.B create
USER [CLONEFROM-USER]
.br
.B snmpusm
[COMMON OPTIONS] AGENT
.B delete
USER
.br
.B snmpusm
[COMMON OPTIONS] AGENT
.B cloneFrom
USER CLONEFROM-USER
.br
.B snmpusm
[COMMON OPTIONS] [\-Ca] [\-Cx] AGENT
.B passwd
OLD-PASSPHRASE NEW-PASSPHRASE [USER]
.br
.B snmpusm
[COMMON OPTIONS] <\-Ca | \-Cx> \-Ck AGENT
.B passwd
OLD-KEY-OR-PASSPHRASE NEW-KEY-OR-PASSPHRASE [USER]
.br
.B snmpusm
[COMMON OPTIONS] [\-Ca] [\-Cx] AGENT
.B changekey
[USER]

.SH "توضیحات (DESCRIPTION)"
دستور
.B snmpusm
یک برنامهٔ SNMP است که می‌تواند برای انجام کارهای نگهداری ساده روی کاربرانی که برای یک کارگزار SNMP شناخته‌شده هستند، از طریق دستکاری جدول «پیمانهٔ امنیتی مبتنی بر کاربر» (USM) کارگزار به کار رود. کاربر به دسترسی نوشتن روی جدول MIB با نام usmUserTable نیاز دارد. از این ابزار می‌توان برای ایجاد، حذف، همتاسازی (clone) و تغییر عبارت عبور کاربران پیکربندی‌شده روی یک کارگزار SNMP در حال اجرا استفاده کرد.

.SH "گزینه‌ها (OPTIONS)"
گزینه‌های مشترک برای همهٔ دستورهای
.BR snmpusm :
.TP
.BI \-CE " ENGINE-ID"
مقدار usmUserEngineID را مشخص می‌کند تا به‌عنوان بخشی از نمایهٔ (index) جدول usmUserTable استفاده شود.
حالت پیش‌فرض، استفاده از contextEngineID (تنظیم‌شده از طریق \-E یا پویش‌شده) به‌عنوان usmUserEngineID است.
.TP
.BI \-Cp " STRING"
مقدار usmUserPublic کاربر (جدید) را برابر با STRING مشخص‌شده قرار می‌دهد.
.PP
گزینه‌های دستورهای
.B passwd 
و
.BR changekey :
.TP
.BI \-Ca
کلید احراز هویت (authentication key) را تغییر می‌دهد.
.TP
.BI \-Cx
کلید حریم خصوصی/رمزنگاری (privacy key) را تغییر می‌دهد.
.TP
.BI \-Ck
امکان استفاده از کلید بومی‌سازی‌شده (localized key - که باید با 0x شروع شود) را به‌جای عبارت عبور فراهم می‌کند.
هنگام استفاده از این گزینه، باید یکی از گزینه‌های \-Ca یا \-Cx (و نه هر دو) نیز استفاده شود.

.SH "ایجاد کاربران (CREATING USERS)"
.PP
یک کاربر SNMPv3 احرازهویت‌نشده را می‌توان با استفاده از دستور زیر ایجاد کرد:
.IP
.B snmpusm
[COMMON OPTIONS] AGENT create USER
.PP
این کار یک مدخل (غیرفعال) در usmUserTable ایجاد می‌کند که هیچ‌گونه تنظیمات احراز هویت یا حریم خصوصی ندارد.
در اصل، این کاربر باید برای درخواست‌های 'noAuthNoPriv' قابل استفاده باشد، اما در عمل کارگزار Net-SNMP اجازه نخواهد داد چنین مدخلی فعال شود. در عوض می‌توان کاربر را با استفاده از پرچم \-Cw از طریق عملیات createAndWait ایجاد کرد. این کار مانع از فعال شناخته شدن کاربر در هر کارگزاری می‌شود تا زمانی که بعداً صراحتاً از طریق دستور activate فعال گردد.

.PP
برای فعال‌سازی این مدخل، لازم است یک کاربر موجود با استفاده از دستور زیر همتاسازی (clone) شود:
.IP
.B snmpusm
[COMMON OPTIONS] AGENT cloneFrom USER CLONEFROM-USER
.PP
سپس مدخل USER همان تنظیمات احراز هویت و حریم خصوصی (شامل عبارت‌های عبور) کاربر CLONEFROM را به ارث می‌برد.

.PP
این دو مرحله را می‌توان با استفاده از دستور زیر در یک مرحله ادغام کرد:
.IP
.B snmpusm
[COMMON OPTIONS] AGENT create USER CLONEFROM-USER

.PP
هر دو شکل زیردستور
.B create
نیازمند این هستند که کاربری که ایجاد می‌شود از قبل وجود نداشته باشد.
زیردستور
.B cloneFrom
نیاز دارد کاربری که به آن همتاسازی می‌شود از قبل وجود
.I داشته باشد\c
\&.

.PP
همتاسازی (Cloning) تنها راه برای مشخص کردن پروتکل‌های احراز هویت و حریم خصوصی مورد استفاده برای یک کاربر مشخص است و این کار تنها یک بار قابل انجام است. تلاش‌های بعدی برای همتاسازی مجدد روی همان کاربر ظاهراً موفقیت‌آمیز به نظر می‌رسند، اما بدون هیچ پیامی نادیده گرفته می‌شوند.
این رفتار (تا حدی غیرمنتظره) توسط مشخصات SNMPv3 USM (سند RFC 3414) الزامی شده است.
برای تغییر تنظیمات احراز هویت و حریم خصوصی یک کاربر مشخص، لازم است مدخل کاربر حذف و دوباره ایجاد شود.
این کار برای تغییر سادهٔ عبارت‌های عبور ضروری
.I نیست
(به بخش زیر مراجعه کنید).
این بدان معناست که کارگزار باید برای هر ترکیب از پروتکل‌های احراز هویت و حریم خصوصی، حداقل با یک کاربر مقداردهی اولیه شود.
برای جزئیات بیشتر دربارهٔ دستورالعمل پیکربندی
.B createUser
به صفحهٔ راهنمای
.I snmpd.conf(5)
مراجعه کنید.

.SH "حذف کاربران (DELETING USERS)"
یک کاربر را می‌توان با استفاده از دستور زیر از usmUserTable حذف کرد:
.IP
.B snmpusm
[COMMON OPTIONS] AGENT delete USER

.SH "تغییر عبارت‌های عبور (CHANGING PASS PHRASES)"
نمایه‌های کاربری شامل کلیدهای خصوصی هستند که هرگز به‌صورت متن خام روی شبکه منتقل نمی‌شوند (صرف نظر از اینکه درخواست‌های مدیریتی رمزنگاری شده باشند یا نه).
برای تغییر کلید محرمانهٔ یک کاربر، مشخص کردن عبارت عبور قدیمی کاربر به همراه عبارت عبور جدید الزامی است.
این کار با دستور زیر انجام می‌شود:
.IP
.B snmpusm
[COMMON OPTIONS] [\-Ca] [\-Cx] AGENT passwd OLD-PASSPHRASE NEW-PASSPHRASE [USER]

.PP
پس از همتاسازی مدخل کاربر جدید از الگوی مناسب، باید فوراً عبارت عبور کاربر جدید را تغییر دهید.

.PP
اگر USER مشخص نشده باشد، این دستور عبارت عبور کاربر (SNMPv3) صادرکنندهٔ دستور را تغییر خواهد داد. اگر گزینه‌های \-Ca یا \-Cx مشخص شده باشند، تنها کلیدهای احراز هویت یا حریم خصوصی تغییر می‌یابند. اگر این گزینه‌ها مشخص نشده باشند، هر دو کلید احراز هویت و حریم خصوصی تغییر داده می‌شوند.

.IP
.B snmpusm
[COMMON OPTIONS] [\-Ca] [\-Cx] AGENT changekey [USER]

.PP
این دستور کلید را به روشی سازگار با رازداری پیشرو (perfect-forward-secrecy) از طریق تبادل دیفی\-هلمن تغییر می‌دهد. کارگزار راه دور باید از SNMP\-USM\-DH\-OBJECTS\-MIB پشتیبانی کند تا این دستور کار کند. کلیدهای حاصل در کنسول چاپ می‌شوند و می‌توان بعداً در فراخوانی‌های بعدی دستورات با استفاده از گزینه‌های \-\-defAuthLocalizedKey و \-\-defPrivLocalizedKey یا در فایل snmp.conf با استفاده از کلیدواژه‌های defAuthLocalizedKey و defPrivLocalizedKey آن‌ها را تنظیم کرد.

.PP
توجه داشته باشید که از آنجا که این کلیدها به‌صورت تصادفی بر پایهٔ تبادل دیفی\-هلمن تولید می‌شوند، دیگر از یک گذرواژه با تایپ آسان‌تر مشتق نشده‌اند. با این حال، امنیت بسیار بالاتری دارند.

.PP
برای تغییر از یک کلید بومی‌سازی‌شده به یک گذرواژه، حالت دیگر زیردستور
.B passwd
به شکل زیر به کار می‌رود:

.IP
.B snmpusm
[COMMON OPTIONS] <\-Ca | \-Cx> \-Ck AGENT passwd OLD-KEY-OR-PASSPHRASE NEW-KEY-OR-PASSPHRASE [USER]

.PP
باید یکی از گزینه‌های \-Ca یا \-Cx مشخص شود. آرگومان‌های OLD-KEY-OR-PASSPHRASE و/یا NEW-KEY-OR-PASSPHRASE می‌توانند یک عبارت عبور یا یک کلید بومی‌سازی‌شده با شروع "0x" باشند (مانند آنچه توسط زیردستور
.B changekey
چاپ می‌شود).

.PP
توجه داشته باشید که
.B snmpusm
همان‌طور که در صفحهٔ راهنمای
.I snmpcmd(1)
شرح داده شده است، به یک آرگومان برای تعیین کارگزار مورد پرس‌وجو
.B نیاز دارد\c
\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
فرض کنید برای مثال‌هایمان، خطوط پیکربندی VACM و USM زیر در فایل snmpd.conf برای یک کارگزار Net-SNMP وجود داشته باشند. این خطوط یک کاربر پیش‌فرض با نام "initial" با عبارت عبور احراز هویت "setup_passphrase" برپا می‌کنند تا بتوانیم راه‌اندازی اولیهٔ یک کارگزار را انجام دهیم:
.PP
.RS
.nf
# VACM configuration entries
rwuser initial
# lets add the new user we'll create too:
rwuser wes
# USM configuration entries
createUser initial MD5 setup_passphrase DES
.fi
.RE
.PP
نکته: تنظیمات کاربر "initial" پس از ایجاد یک کاربر واقعی که به آن امتیازات مدیریتی اعطا می‌کنید (مانند کاربر "wes" که در این مثال ایجاد خواهیم کرد) باید حذف شود.
.PP
نکته: طول عبارت‌های عبور باید
.I حداقل
۸ نویسه باشد.
.SS "ایجاد کاربر جدید (Create a new user)"
.PP
snmpusm \-v3 \-u initial \-n "" \-l authNoPriv \-a MD5 \-A setup_passphrase
localhost create wes initial
.IP
یک کاربر جدید، در اینجا با نام "wes" را با استفاده از کاربر "initial" ایجاد می‌کند. "wes" در این فرایند از "initial" همتاسازی می‌شود، بنابراین عبارت عبور آن کاربر ("setup_passphrase") را به ارث می‌برد.
.SS "تغییر عبارت عبور کاربر (Change the user's passphrase)"
.PP
snmpusm \-v 3 \-u wes \-n "" \-l authNoPriv \-a MD5 \-A setup_passphrase
localhost passwd setup_passphrase new_passphrase
.IP
پس از ایجاد کاربر "wes" با همان عبارت عبور کاربر "initial"، باید عبارت عبور او را تغییر دهیم. دستور فوق آن را از "setup_passphrase" که از کاربر اولیه به ارث رسیده بود، به "new_passphrase" تغییر می‌دهد.
.SS "آزمایش کاربر جدید (Test the new user)"
.PP
snmpget \-v 3 \-u wes \-n "" \-l authNoPriv \-a MD5 \-A new_passphrase
localhost sysUpTime.0
.IP
اگر دستورهای بالا موفقیت‌آمیز بوده باشند، این دستور باید به‌درستی یک درخواست GET احرازهویت‌شدهٔ SNMPv3 را به کارگزار ارسال کرده باشد.
.PP
اکنون، مدخل "group" مربوط به VACM را برای کاربر "initial" از snmpd.conf حذف کنید؛ حال شما یک کاربر معتبر 'wes' دارید که می‌توانید برای تراکنش‌های آینده به جای initial از آن استفاده کنید.

.SH "هشدار (WARNING)"
دستکاری usmUserTable با استفاده از این دستور
.I تنها
با استفاده از SNMPv3 امکان‌پذیر است.
این دستور با نسخه‌های مبتنی بر اجتماع (community-based) کار نخواهد کرد، حتی اگر آن‌ها دسترسی نوشتن به این جدول را داشته باشند.

.SH "همچنین ببینید (SEE ALSO)"
snmpd.conf(5), snmp.conf(5), RFC 3414