org.snmp4j.security.nonstandard

Class PrivAESWith3DESKeyExtension

java.lang.Object

org.snmp4j.security.PrivAES

org.snmp4j.security.nonstandard.PrivAESWith3DESKeyExtension

All Implemented Interfaces:

Serializable, PrivacyProtocol, SecurityProtocol

Direct Known Subclasses:

PrivAES192With3DESKeyExtension, PrivAES256With3DESKeyExtension

public abstract class PrivAESWith3DESKeyExtension
extends PrivAES

This class is provided for interoperability with some broken AES implementations of major network device manufactures which use a key extension algorithm that was specified for Priv3DES but was never specified for AES 192 and 256 bit. Note: DO NOT USE THIS CLASS IF YOU WANT TO COMPLY WITH draft-blumenthal-aes-usm-04.txt!

Since:

2.2.3

Version:

2.2.3

Author:

Frank Fock

See Also:

Serialized Form

Field Summary

Fields inherited from class org.snmp4j.security.PrivAES

cipherPool, salt

Constructor Summary

Constructors

Constructor and Description
PrivAESWith3DESKeyExtension(int keyBytes) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	extendShortKey(byte[] shortKey, OctetString password, byte[] engineID, AuthenticationProtocol authProtocol) Extend a localized key that is too short.

Methods inherited from class org.snmp4j.security.PrivAES

asHex, decrypt, encrypt, getDecryptParamsLength, getEncryptedLength, getMaxKeyLength, getMinKeyLength

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.snmp4j.security.PrivacyProtocol

getID

Constructor Detail

PrivAESWith3DESKeyExtension

public PrivAESWith3DESKeyExtension(int keyBytes)

Constructor.

Parameters:

keyBytes - Length of key, must be 16, 24 or 32.

Throws:

IllegalArgumentException - if keyBytes is illegal

Method Detail

extendShortKey

public byte[] extendShortKey(byte[] shortKey,
                    OctetString password,
                    byte[] engineID,
                    AuthenticationProtocol authProtocol)

Description copied from interface: PrivacyProtocol

Extend a localized key that is too short. Some privacy protocols require a key that is longer than the key generated by the password-to-key algorithm of the authentication protocol. This function extends a short key to the required length.

Specified by:

extendShortKey in interface PrivacyProtocol

Overrides:

extendShortKey in class PrivAES

Parameters:

shortKey - the short key that was generated using AuthenticationProtocol.passwordToKey(org.snmp4j.smi.OctetString, byte[]) function.

password - the password to use for key extension.

engineID - the SNMP engine ID of the authoritative engine.

authProtocol - the authentication protocol that should be used.

Returns:

the extended key or shortKey if no extension is needed.