Package org.snmp4j.security
Class SecurityProtocols
java.lang.Object
org.snmp4j.security.SecurityProtocols
- All Implemented Interfaces:
Serializable
The
SecurityProtocols
class holds all authentication and
privacy protocols for a SNMP entity.
To register security protocols other than the default, set the system
property SECURITY_PROTOCOLS_PROPERTIES
to a customized version
of the SecurityProtocols.properties
file. The path has to
be specified relatively to this class.
- Version:
- 2.8.4
- Author:
- Frank Fock, Jochen Katz
- See Also:
-
Nested Class Summary
-
Field Summary
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Add the givenAuthenticationProtocol
.Add the default SecurityProtocols.void
Add the givenPrivacyProtocol
.Get theAuthenticationProtocol
with the given ID.static SecurityProtocols
Get an instance of class SecurityProtocols.int
Gets the maximum authentication key length of the all known authentication protocols.int
Gets the maximum privacy key length of the currently known privacy protocols.Get the PrivacyProtocol with the given ID.getSecurityProtocol
(OID protocolID) Get the security protocol (AuthenticationProtocol
orPrivacyProtocol
) for the specified protocol OID.byte[]
passwordToKey
(OID authProtocolID, OctetString passwordString, byte[] engineID) Generates the localized key for the given password and engine id for the authentication protocol specified by the supplied OID.byte[]
passwordToKey
(OID privProtocolID, OID authProtocolID, OctetString passwordString, byte[] engineID) Generates the localized key for the given password and engine id for the privacy protocol specified by the supplied OID.void
Remove the givenAuthenticationProtocol
.void
Remove the givenPrivacyProtocol
.static void
setSecurityProtocols
(SecurityProtocols securityProtocols) Set theSecurityProtocols
byte[]
truncateKey
(byte[] key, int maxKeyLength) Limits the supplied key value to the specified maximum length
-
Field Details
-
SECURITY_PROTOCOLS_PROPERTIES
- See Also:
-
-
Constructor Details
-
SecurityProtocols
protected SecurityProtocols()
-
-
Method Details
-
getInstance
Get an instance of class SecurityProtocols.- Returns:
- the globally used SecurityProtocols object.
-
setSecurityProtocols
Set theSecurityProtocols
- Parameters:
securityProtocols
- SecurityProtocols
-
getSecurityProtocol
Get the security protocol (AuthenticationProtocol
orPrivacyProtocol
) for the specified protocol OID.- Parameters:
protocolID
- an object identifier of the security protocol to return.- Returns:
- the security protocol or
null
if a protocol with such an ID has not been added yet. - Since:
- 2.6.0
-
addDefaultProtocols
Add the default SecurityProtocols. The names of the SecurityProtocols to add are read from a properties file.- Returns:
- this SecurityProtocols instance for chaining configuration.
- Throws:
InternalError
- ifSNMP4JSettings.isExtensibilityEnabled()
istrue
and corresponding properties file with the security protocols configuration cannot be opened/read.
-
addAuthenticationProtocol
Add the givenAuthenticationProtocol
. If an authentication protocol with the supplied ID already exists, the supplied authentication protocol will not be added and the security protocols will not be unchang.- Parameters:
auth
- the AuthenticationProtocol to add (an existing authentication protcol withauth
's ID remains unchanged).
-
getAuthenticationProtocol
Get theAuthenticationProtocol
with the given ID.- Parameters:
id
- The unique ID (specified asOID
) of the AuthenticationProtocol.- Returns:
- the AuthenticationProtocol object if it was added before, or null if not.
-
removeAuthenticationProtocol
Remove the givenAuthenticationProtocol
.- Parameters:
auth
- The protocol to remove
-
addPrivacyProtocol
Add the givenPrivacyProtocol
. If a privacy protocol with the supplied ID already exists, the supplied privacy protocol will not be added and the security protocols will not be changed.- Parameters:
priv
- the PrivacyProtocol to add (an existing privacy protcol withpriv
's ID remains unchanged).
-
getPrivacyProtocol
Get the PrivacyProtocol with the given ID.- Parameters:
id
- The unique ID (specified asOID
) of the PrivacyProtocol.- Returns:
- the
PrivacyProtocol
object if it was added before, or null if not.
-
removePrivacyProtocol
Remove the givenPrivacyProtocol
.- Parameters:
priv
- The protocol to remove
-
passwordToKey
Generates the localized key for the given password and engine id for the authentication protocol specified by the supplied OID.- Parameters:
authProtocolID
- anOID
identifying the authentication protocol to use.passwordString
- the authentication pass phrase.engineID
- the engine ID of the authoritative engine.- Returns:
- the localized authentication key.
-
passwordToKey
public byte[] passwordToKey(OID privProtocolID, OID authProtocolID, OctetString passwordString, byte[] engineID) Generates the localized key for the given password and engine id for the privacy protocol specified by the supplied OID.- Parameters:
privProtocolID
- anOID
identifying the privacy protocol the key should be created for.authProtocolID
- anOID
identifying the authentication protocol to use.passwordString
- the authentication pass phrase.engineID
- the engine ID of the authoritative engine.- Returns:
- the localized privacy key.
-
getMaxAuthDigestLength
public int getMaxAuthDigestLength()Gets the maximum authentication key length of the all known authentication protocols.- Returns:
- the maximum authentication key length of all authentication protocols
that have been added to this
SecurityProtocols
instance.
-
getMaxPrivDecryptParamsLength
public int getMaxPrivDecryptParamsLength()Gets the maximum privacy key length of the currently known privacy protocols.- Returns:
- the maximum privacy key length of all privacy protocols
that have been added to this
SecurityProtocols
instance.
-
truncateKey
public byte[] truncateKey(byte[] key, int maxKeyLength) Limits the supplied key value to the specified maximum length- Parameters:
key
- the key to truncate.maxKeyLength
- the maximum length of the returned key.- Returns:
- the truncated key with a length of
min(key.length, maxKeyLength)
. - Since:
- 1.9
-