summaryrefslogtreecommitdiff
path: root/docs/source/docs/v3arch/asyncore/oneliner/security-configuration.rst
diff options
context:
space:
mode:
authorelie <elie>2015-09-14 05:39:35 +0000
committerelie <elie>2015-09-14 05:39:35 +0000
commit8a2ab3c327b5d9128577b56e58bb93db396d59ed (patch)
tree982658337a44b1898b97cfd6b302917676f26cba /docs/source/docs/v3arch/asyncore/oneliner/security-configuration.rst
parent2f24177c361ba4d9deba2d7378f84aa96111db80 (diff)
downloadpysnmp-8a2ab3c327b5d9128577b56e58bb93db396d59ed.tar.gz
documentation reworked and converted to Sphinx (in NumPy style)
Diffstat (limited to 'docs/source/docs/v3arch/asyncore/oneliner/security-configuration.rst')
-rw-r--r--docs/source/docs/v3arch/asyncore/oneliner/security-configuration.rst39
1 files changed, 39 insertions, 0 deletions
diff --git a/docs/source/docs/v3arch/asyncore/oneliner/security-configuration.rst b/docs/source/docs/v3arch/asyncore/oneliner/security-configuration.rst
new file mode 100644
index 0000000..86bee25
--- /dev/null
+++ b/docs/source/docs/v3arch/asyncore/oneliner/security-configuration.rst
@@ -0,0 +1,39 @@
+
+Security Parameters
+===================
+
+Calls to oneliner Applications API consume Security Parameters
+configuration object on input. The shortcut classes described in
+this section convey configuration information to SNMP engine's
+Local Configuration Datastore (:RFC:`2271#section-3.4.2`).
+Once committed to LCD, SNMP engine saves its configuration for
+the lifetime of SNMP engine object.
+
+Security Parameters object is Security Model specific.
+:py:class:`~pysnmp.entity.rfc3413.oneliner.auth.UsmUserData` class
+serves SNMPv3 User-Based Security Model configuration, while
+:py:class:`~pysnmp.entity.rfc3413.oneliner.auth.CommunityData`
+class is used for Community-Based Security Model of SNMPv1/SNMPv2c.
+
+.. toctree::
+ :maxdepth: 2
+
+.. autoclass:: pysnmp.entity.rfc3413.oneliner.auth.CommunityData(communityIndex, communityName=None, mpModel=1, contextEngineId=None, contextName='', tag='')
+
+.. autoclass:: pysnmp.entity.rfc3413.oneliner.auth.UsmUserData(userName, authKey=None, privKey=None, authProtocol=usmNoAuthProtocol, privProtocol=usmNoPrivProtocol, securityEngineId=None)
+
+Identification of Authentication and Privacy Protocols is done
+via constant OIDs:
+
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usmNoAuthProtocol
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usmHMACMD5AuthProtocol
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usmHMACSHAAuthProtocol
+
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usmNoPrivProtocol
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usmDESPrivProtocol
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usm3DESEDEPrivProtocol
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usmAesCfb128Protocol
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usmAesCfb192Protocol
+.. autodata:: pysnmp.entity.rfc3413.oneliner.auth.usmAesCfb256Protocol
+
+