FileDocCategorySizeDatePackage
SnmpUsmKeyHandler.javaAPI DocJava SE 5 API3897Fri Aug 26 14:55:04 BST 2005com.sun.jmx.snmp

SnmpUsmKeyHandler

public interface SnmpUsmKeyHandler
This interface allows you to compute key localization and delta generation. It is useful when adding user in USM MIB. An instance of SnmpUsmKeyHandler is associated to each SnmpEngine object. When computing key, an authentication algorithm is needed. The supported ones are : usmHMACMD5AuthProtocol and usmHMACSHAAuthProtocol.

This API is a Sun Microsystems internal API and is subject to change without notice.

since
1.5

Fields Summary
public static int
DES_KEY_SIZE
DES privacy algorithm key size. To be used when localizing privacy key
public static int
DES_DELTA_SIZE
DES privacy algorithm delta size. To be used when calculing privacy key delta.
Constructors Summary
Methods Summary
public byte[]calculateAuthDelta(java.lang.String algoName, byte[] oldKey, byte[] newKey, byte[] random)
Calculate the delta parameter needed when processing key change. This computation is done by the key change initiator. It MUST be compliant to RFC 2574 description.

param
algoName The authentication algorithm to use.
param
oldKey The old key.
param
newKey The new key.
param
random The random value.
return
The delta.
exception
IllegalArgumentException If the algorithm is unknown.

public byte[]calculatePrivDelta(java.lang.String algoName, byte[] oldKey, byte[] newKey, byte[] random, int deltaSize)
Calculate the delta parameter needed when processing key change for a privacy algorithm. This computation is done by the key change initiator. It MUST be compliant to RFC 2574 description.

param
algoName The authentication algorithm to use.
param
oldKey The old key.
param
newKey The new key.
param
random The random value.
param
deltaSize The algo delta size.
return
The delta.
exception
IllegalArgumentException If the algorithm is unknown.

public byte[]localizeAuthKey(java.lang.String algoName, byte[] key, SnmpEngineId engineId)
Localize the passed key using the passed SnmpEngineId. It MUST be compliant to RFC 2574 description.

param
algoName The authentication algorithm to use.
param
key The key to localize;
param
engineId The Id used to localize the key.
return
The localized key.
exception
IllegalArgumentException If the algorithm is unknown.

public byte[]localizePrivKey(java.lang.String algoName, byte[] key, SnmpEngineId engineId, int keysize)
Localize the passed privacy key using the passed SnmpEngineId. It MUST be compliant to RFC 2574 description.

param
algoName The authentication algorithm to use.
param
key The key to localize;
param
engineId The Id used to localize the key.
param
keysize The privacy algorithm key size.
return
The localized key.
exception
IllegalArgumentException If the algorithm is unknown.

public byte[]password_to_key(java.lang.String algoName, java.lang.String password)
Translate a password to a key. It MUST be compliant to RFC 2574 description.

param
algoName The authentication algorithm to use.
param
password Password to convert.
return
The key.
exception
IllegalArgumentException If the algorithm is unknown.