.TH SNMPVACM 1 "05 Sep 2006" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmpvacm \- ایجاد و نگهداری مدخل‌های کنترل دسترسی مبتنی بر نما (VACM) برای SNMPv3 در یک موجودیت شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.B snmpvacm
[COMMON OPTIONS] AGENT
.B createSec2Group
MODEL SECURITYNAME  GROUPNAME
.br
.B snmpvacm
[COMMON OPTIONS] AGENT
.B deleteSec2Group
MODEL SECURITYNAME
.br
.B snmpvacm
[COMMON OPTIONS] AGENT
.B createView
[\-Ce] NAME SUBTREE MASK
.br
.B snmpvacm
[COMMON OPTIONS] AGENT
.B deleteView
NAME SUBTREE
.br
.B snmpvacm
[COMMON OPTIONS]  AGENT
.B createAccess
GROUPNAME [CONTEXTPREFIX] MODEL LEVEL CONTEXTMATCH READVIEW WRITEVIEW NOTIFYVIEW
.br
.B snmpvacm
[COMMON OPTIONS]  AGENT
.B deleteAccess
GROUPNAME [CONTEXTPREFIX] MODEL LEVEL
.br
.B snmpvacm
[COMMON OPTIONS]  AGENT
.B createAuth
GROUPNAME [CONTEXTPREFIX] MODEL LEVEL AUTHTYPE CONTEXTMATCH VIEW 
.br
.B snmpvacm
[COMMON OPTIONS]  AGENT
.B deleteAuth
GROUPNAME [CONTEXTPREFIX] MODEL LEVEL AUTHTYPE

.SH "توضیحات (DESCRIPTION)"
دستور
.B snmpvacm
یک برنامهٔ کاربردی SNMP است که می‌تواند برای انجام نگهداری‌های ساده روی جدول‌های ماژول کنترل دسترسی مبتنی بر نما (VACM) در یک کارگزار SNMP استفاده شود.
مشخصات VACM در پروتکل SNMPv3 (ببینید RFC2575) جدول‌های گوناگونی را برای تعیین گروه‌های کاربری، نماهای MIB و تنظیمات دسترسی مجاز تعریف می‌کند.
این دستورهای
.BR snmpvacm
عملاً سطرهایی را در جدول مناسب ایجاد یا حذف می‌کنند و با دستورالعمل‌های پیکربندی معادل که در صفحهٔ راهنمای
.I snmpd.conf(5)
مستند شده‌اند، مطابقت دارند.
.PP
توضیحات کامل‌تر دربارهٔ نحوهٔ عملکرد این موارد را می‌توان در بخش سؤالات متداول (FAQ) پروژه یافت.
.SH "زیردستورها (SUB-COMMANDS)"

.SS createSec2Group \fRMODEL SECURITYNAME GROUPNAME\fP
.PP
یک مدخل در جدول نام امنیتی به گروه در SNMPv3 ایجاد می‌کند. این جدول اجازه می‌دهد یک مدخل کنترل دسترسی منفرد به چندین کاربر (یا «اصیل»ها / principals) اعمال شود و با مقادیر مدل امنیتی و نام امنیتی نمایه‌گذاری می‌شود.
.PP
MODEL
.IP
یک عدد صحیح که بیانگر مدل امنیتی است و یکی از مقادیر زیر را می‌پذیرد:
.br
1 - رزرو شده برای SNMPv1
.br
2 - رزرو شده برای SNMPv2c
.br
3 - مدل امنیتی مبتنی بر کاربر (USM)

.PP
SECURITYNAME
.IP
رشته‌ای که نام امنیتی یک اصیل را نشان می‌دهد (در قالبی مستقل از مدل امنیتی ارائه می‌شود). برای درخواست‌های مبتنی بر USM، نام امنیتی همان نام کاربری است.

.PP
GROUPNAME
.IP
رشته‌ای که گروهی را مشخص می‌کند که این مدخل (یعنی جفت نام امنیتی/مدل) باید به آن تعلق داشته باشد. سپس در جدول دسترسی به این نام گروه ارجاع داده خواهد شد (ببینید
.B createAccess
در زیر).
.PP
.SS deleteSec2Group \fRMODEL SECURITYNAME\fP
.PP
یک مدخل را از جدول نام امنیتی به گروه در SNMPv3 حذف می‌کند و بدین ترتیب تنظیمات کنترل دسترسی را برای اصیل موردنظر پاک می‌نماید. مدخلی که باید حذف شود با مقادیر MODEL و SECURITYNAME نمایه‌گذاری می‌شود که باید با مقادیر استفاده‌شده در دستور متناظر
.B createSec2Group
(یا معادل آن) مطابقت داشته باشند.

.SS createView \fR[\-Ce] NAME SUBTREE MASK\fP
.PP
یک مدخل در جدول نمای MIB در SNMPv3 ایجاد می‌کند.
یک نمای MIB شامل خانواده‌ای از زیردرخت‌های نما است که ممکن است به صورت جداگانه در نما گنجانده شده یا (گاهی اوقات) از آن مستثنی شوند. هر زیردرخت نما با ترکیبی از یک زیردرخت OID به همراه یک ماسک رشته بیتی تعریف می‌شود.
جدول نما بر اساس نام نما و مقادیر OID زیردرخت نمایه‌گذاری می‌شود.
.PP
[\-Ce]
.IP
یک فلگ اختیاری برای مشخص کردن اینکه این زیردرخت نما باید از نمای نام‌گذاری‌شده مستثنی شود.
اگر مشخص نشود، حالت پیش‌فرض گنجاندن زیردرخت در نما است.
هنگام ساخت یک نما از ترکیبی از زیردرخت‌های گنجانده‌شده و مستثنی‌شده، زیردرخت‌های مستثنی‌شده باید ابتدا تعریف شوند - به‌ویژه اگر نمای نام‌گذاری‌شده قبلاً در یک یا چند مدخل دسترسی ارجاع داده شده باشد.
.PP
NAME
.IP
رشته‌ای برای شناسایی یک نمای MIB خاص، که این زیردرخت OID/ماسک بخشی از آن (یا احتمالاً تنها بخش آن) را تشکیل می‌دهد.
.PP
SUBTREE
.IP
شناسه OID که ریشه زیردرخت را برای افزودن به (یا مستثنی کردن از) نمای نام‌گذاری‌شده تعریف می‌کند.
.PP
MASK
.IP
یک ماسک بیتی که مشخص می‌کند کدام زیرشناسه‌های OID زیردرخت مرتبط باید معنادار در نظر گرفته شوند.

.SS deleteView \fRNAME SUBTREE\fP
یک مدخل را از جدول نمای SNMPv3 حذف می‌کند و بدین ترتیب زیردرخت را از نمای MIB داده‌شده برمی‌دارد.
حذف آخرین (یا تنها) زیردرخت منجر به حذف کل نما خواهد شد.
مدخلی که باید حذف شود با مقادیر NAME و SUBTREE نمایه‌گذاری می‌شود که باید با مقادیر استفاده‌شده در دستور متناظر
.B createView
(یا معادل آن) مطابقت داشته باشند.
.PP
هنگام حذف زیردرخت‌ها از یک نمای ترکیبی (یعنی شامل هر دو نوع زیردرخت‌های گنجانده‌شده و مستثنی‌شده)، زیردرخت‌های گنجانده‌شده باید ابتدا حذف شوند.

.SS createAccess \fRGROUPNAME [CONTEXTPREFIX] MODEL LEVEL CONTEXTMATCH READVIEW WRITEVIEW NOTIFYVIEW\fP
یک مدخل در جدول دسترسی SNMPv3 ایجاد می‌کند و به این ترتیب سطح مشخصی از دسترسی به نماهای خاص MIB را برای اصیل‌های موجود در گروه تعیین‌شده (با فرض ارائه مدل و سطوح امنیتی مناسب در درخواست) مجاز می‌سازد.
جدول دسترسی بر اساس مقادیر نام گروه، پیشوند بافت (context prefix)، مدل امنیتی و سطح امنیتی نمایه‌گذاری می‌شود.
.PP
GROUPNAME
.IP
نام گروهی که این مدخل دسترسی به آن اعمال می‌شود
(همان‌طور که توسط دستور
.B createSec2Group
یا معادل آن تنظیم شده است)
.PP
CONTEXTPREFIX
.IP
رشته‌ای که نمایانگر نام یک بافت (یا مجموعه‌ای از نام‌های بافت) است که این مدخل دسترسی به آن اعمال می‌شود.
تفسیر این رشته به مقدار فیلد CONTEXTMATCH بستگی دارد (زیر را ببینید).
.IP
در صورت حذف، مقدار پیش‌فرض آن بافت تهی "" خواهد بود.
.PP
MODEL
.IP
یک عدد صحیح که بیانگر مدل امنیتی است و یکی از مقادیر زیر را می‌پذیرد:
.br
1 - رزرو شده برای SNMPv1
.br
2 - رزرو شده برای SNMPv2c
.br
3 - مدل امنیتی مبتنی بر کاربر (USM)
.PP
LEVEL
.IP
یک عدد صحیح که بیانگر حداقل سطح امنیتی است و یکی از مقادیر زیر را می‌پذیرد:
.br
1 - noAuthNoPriv
.br
2 - authNoPriv
.br
3 - authPriv
.IP
این مدخل دسترسی به درخواست‌های با این سطح یا بالاتر اعمال خواهد شد
(که در آن authPriv بالاتر از authNoPriv است و آن نیز به نوبه خود بالاتر از noAuthNoPriv قرار دارد).
.PP
CONTEXTMATCH
.IP
نحوه تفسیر مقدار CONTEXTPREFIX را مشخص می‌کند.
اگر این فیلد مقدار '1' (به معنی 'exact' یا دقیق) داشته باشد، نام بافت یک درخواست باید دقیقاً با مقدار CONTEXTPREFIX مطابقت داشته باشد تا این مدخل دسترسی برای آن درخواست قابل اعمال باشد.
.IP
اگر این فیلد دارای مقدار '2' (به معنی 'prefix' یا پیشوند) باشد، زیررشته ابتدایی نام بافتِ درخواست باید با مقدار CONTEXTPREFIX مطابقت داشته باشد تا این مدخل دسترسی برای آن درخواست اعمال شود.
این یک شکل ساده از نویسه عمومی (wildcarding) را فراهم می‌کند.
.PP
READVIEW
.IP
نام نمای MIB
(همان‌طور که توسط
.B createView
یا معادل آن تنظیم شده است)
که اشیای MIB را تعریف می‌کند که این درخواست ممکن است مقادیر فعلی آن‌ها را بخواند.
.IP
اگر نمایی با این نام وجود نداشته باشد، دسترسی خواندن داده نمی‌شود.
.PP
WRITEVIEW
.IP
نام نمای MIB
(همان‌طور که توسط
.B createView
یا معادل آن تنظیم شده است)
که اشیای MIB را تعریف می‌کند که این درخواست ممکن است مقادیر جدیدی را برای آن‌ها مقداردهی (SET) کند.
.IP
اگر نمایی با این نام وجود نداشته باشد، دسترسی خواندن داده نمی‌شود.
.PP
NOTIFYVIEW
.IP
نام نمای MIB
(همان‌طور که توسط
.B createView
یا معادل آن تنظیم شده است)
که اشیای MIB مجاز برای گنجانده شدن در درخواست اعلان را تعریف می‌کند.
.IP
توجه داشته باشید که این جنبه از کنترل دسترسی در حال حاضر پشتیبانی نمی‌شود.

.SS deleteAccess \fRGROUPNAME [CONTEXTPREFIX] MODEL LEVEL\fP
یک مدخل را از جدول دسترسی SNMPv3 حذف می‌کند و در نتیجه تنظیمات کنترل دسترسی مشخص‌شده را پاک می‌نماید.
مدخلی که باید حذف شود با مقادیر نام گروه، پیشوند بافت، مدل امنیتی و سطح امنیتی نمایه‌گذاری می‌شود که باید با مقادیر استفاده‌شده در دستور متناظر
.B createAccess
(یا معادل آن) مطابقت داشته باشند.

.SS createAuth \fRGROUPNAME [CONTEXTPREFIX] MODEL LEVEL AUTHTYPE CONTEXTMATCH VIEW\fP
یک مدخل در افزونه Net-SNMP برای جدول دسترسی استاندارد ایجاد می‌کند و بدین ترتیب نوع خاصی از دسترسی به نمای MIB را برای اصیل‌های موجود در گروه مشخص‌شده مجاز می‌سازد.
تفسیر GROUPNAME، CONTEXTPREFIX، MODEL، LEVEL و CONTEXTMATCH همانند دستورالعمل
.B createAccess
است.
جدول دسترسی افزونه بر اساس مقادیر نام گروه، پیشوند بافت، مدل امنیتی، سطح امنیتی و authtype نمایه‌گذاری می‌شود.
.PP
AUTHTYPE
.IP
نوع دسترسی که این مدخل باید به آن اعمال شود.
برای جزئیات نشانه‌های معتبر به
.I "snmpd.conf(5)"
و
.I "snmptrapd.conf(5)"
مراجعه کنید.
.PP
VIEW
.IP
نام نمای MIB
(همان‌طور که توسط
.B createView
یا معادل آن تنظیم شده است)
که اشیای MIB مجاز برای این نوع دسترسی را تعریف می‌کند.

.SS deleteAuth \fRGROUPNAME [CONTEXTPREFIX] MODEL LEVEL AUTHTYPE\fP
یک مدخل را از جدول دسترسی افزونه حذف می‌کند و در نتیجه تنظیمات کنترل دسترسی مشخص‌شده را پاک می‌نماید.
مدخلی که باید حذف شود با مقادیر نام گروه، پیشوند بافت، مدل امنیتی، سطح امنیتی و authtype نمایه‌گذاری می‌شود که باید با مقادیر استفاده‌شده در دستور متناظر
.B createAuth
(یا معادل آن) مطابقت داشته باشند.

.PP
توجه داشته باشید که
.B snmpget
نیازمند یک آرگومان برای تعیین کارگزار مورد پرس‌وجو است، همان‌طور که در صفحهٔ راهنمای
.I snmpcmd(1)
توضیح داده شده است.

.SH "مثال‌ها (EXAMPLES)"
.PP
با فرض وجود کاربری از قبل به نام
.I dave
(که می‌توان آن را با دستور
.I snmpusm(1)
تنظیم کرد)،
می‌توانیم دسترسی کامل خواندن و نوشتن به کل درخت OID را با استفاده از دستورهای زیر پیکربندی کنیم:

.IP
snmpvacm localhost createSec2Group 3 dave RWGroup
.IP
snmpvacm localhost createView   all .1 80
.IP
snmpvacm localhost createAccess  RWGroup 3 1 1 all all none
.PP
این دستورات یک گروه امنیتی جدید به نام «RWGroup» شامل کاربر SNMPv3 به نام «dave» ایجاد می‌کنند، یک نمای جدید «all» شامل کل درخت OID مبتنی بر
.I .iso(1)
ایجاد می‌نمایند و سپس به کاربران گروه «RWGroup» (یعنی «dave») هر دو دسترسی خواندن و نوشتن را به نمای «all» (یعنی کل درخت OID) هنگام استفاده از درخواست‌های احراز هویت‌شدهٔ SNMPv3 اعطا می‌کنند.

.PP
به عنوان مثال دوم، می‌توانیم دسترسی فقط-خواندنی به بخشی از درخت OID را با استفاده از دستورهای زیر برقرار کنیم:

.IP
snmpvacm localhost createSec2Group 3 wes ROGroup
.IP
snmpvacm localhost createView   sysView  system fe
.IP
snmpvacm localhost createAccess  ROGroup 3 0 1 sysView none none
.PP
این دستورات یک گروه امنیتی جدید به نام «ROGroup» شامل کاربر (از قبل موجودِ) «wes» ایجاد می‌کنند، یک نمای جدید «sysView» شامل بخش درخت OID مبتنی بر
.I .iso(1).org(3).dod(6).inet(1).mgmt(2).mib\-2(1).system(1)
ایجاد می‌نمایند و سپس به کاربران این گروه «ROGroup» (یعنی «wes») دسترسی خواندن، اما نه دسترسی نوشتن، به نمای «sysView» (یعنی گروه system) می‌دهند.

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

.PP
مقادیر خروج زیر بازگردانده می‌شوند:
.PP
0 - اتمام موفقیت‌آمیز
.PP
1 - خطای نحوی در استفاده (که پیام استفادهٔ مناسب را نمایش می‌دهد) یا اتمام مهلت زمانی (timeout) درخواست.
.PP
2 - رخ دادن خطا هنگام اجرای دستور (که پیام خطای مناسبی را نیز نمایش می‌دهد).

.SH "محدودیت‌ها (LIMITATIONS)"

این ابزار از پیکربندی رشته‌های اجتماع (community strings) جدید پشتیبانی نمی‌کند، بنابراین فقط برای برپایی کنترل دسترسی جدید برای درخواست‌های SNMPv3 کاربرد دارد. می‌توان از آن برای اصلاح تنظیمات دسترسیِ رشته‌های اجتماع موجود استفاده کرد، اما نه برای ایجاد موارد جدید.

.PP
استفاده از پارامترهای عددی برای پارامترهای
.B secLevel
و
.B contextMatch
چندان شهودی و سرراست نیست. این دستورها انعطاف‌پذیری کامل دستورالعمل‌های معادل فایل پیکربندی را ارائه نمی‌دهند.

.PP
در حال حاضر هیچ معادلی برای دستورالعمل‌های پیکربندی یک‌بارهٔ
.I rouser
و
.I rwuser
وجود ندارد.

.SH "همچنین ببینید (SEE ALSO)"
snmpcmd(1), snmpusm(1),
snmpd.conf(5), snmp.conf(5), RFC 2575, Net-SNMP project FAQ