configure snmp access-profile

configure snmp access-profile [ access_profile {readonly | readwrite} | [[add rule ] [first | [[before | after] previous_rule]]] | delete rule | none ]

Description

Configures SNMP to use an ACL policy or ACL rule for access control.

Syntax Description

access_profile Specifies an ACL policy.
readonly Specifies that access granted by the specified policy is read only.
readwrite Specifies that access granted by the specified policy is read/write.
add Specifies that an ACL rule is to be added to the SNMP application.
rule Specifies an ACL rule.
first Specifies that the new rule is to be added before all other rules.
before Specifies that the new rule is to be added before a previous rule.
after Specifies that the new rule is to be added after a previous rule.
previous_rule Specifies an existing rule in the application.
delete Specifies that the named rule is to be deleted.
none Specifies that all the rules or a policy file is to be deleted.

Default

SNMP access is enabled by default, with no ACL policies.

Usage Guidelines

You must be logged in as administrator to configure SNMP parameters. You can restrict SNMP access in the following ways:

Only the following match conditions and actions are copied to the client memory. Others that may be in the rule are not copied.

Match conditions:
  • Source-address—IPv4 and IPv6
  • Actions:
    • Permit
    • Deny

When adding a new rule, use the first, before, and after previous_rule parameters to position it within the existing rules.

If the SNMP traffic does not match any of the rules, the default behavior is deny.

Creating an ACL Policy File

To create an ACL policy file, use the edit policy command. For more information about creating and implementing ACL policy files, see the Policy Manager and ACLs chapters in the Switch Engine 32.2 User Guide .

If you attempt to implement a policy that does not exist, an error message similar to the following appears:

Error: Policy /config/MyAccessProfile.pol does not exist on file system 

If this occurs, make sure the policy you want to implement exists. To confirm the existence of the policies, use the ls command. If the policy does not exist, create the ACL policy file.

Viewing SNMP Information

To display the current management configuration, including SNMP access related information, whether SNMP access is enabled or disabled, and whether any ACL or rules are configured for SNMP, use the following command: show management

Example

The following example applies the ACL policy file MyAccessProfile_2 to SNMP:

configure snmp access-profile MyAccessProfile_2

The following example applies the ACL rule DenyAccess to SNMP as the first rule in the list:

configure snmp access-profile add DenyAccess first

The following example deletes the ACL rule DenyAccess from the SNMP application:

configure snmp access-profile delete DenyAccess

To delete the use of all the ACL rules or a policy file by SNMP, use the following command:

configure snmp access-profile none

History

This command was first available in ExtremeXOS 11.6.

Support for individual ACL rules was added in ExtremeXOS 12.5.

Platform Availability

This command is available on ExtremeSwitching 5320, 5420, 5520, and 5720 series switches.