User guide

3-54
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.5.3 getEmsPublicKeyPair
Description
This interface enables the NMS to obtain the string representation of the RSA public key encoded in the
Base64 encoding scheme. The operation encrypts the username and password from the string
representation of the RSA public key.
The OSS client must use the Base64 decoders to decode the public key and get the byte[] of the public
key from the decoded public key string. The byte[] corresponding to the public key represents the key in
its primary encoded format; in this case, X.509 SubjectPublicKeyInfo.
You can create the RSA public key using this byte array and cryptographic libraries. Use this key to
encrypt the username and password. Bouncy Castle Provider is an example of a security provider that
you can use to create the RSA public key.
The public key is then used to encrypt the username and password. Before passing the encrypted
password to CTM for login, the OSS client must encode the encrypted username and password using the
Base64 encoder to get the string equivalent of the encrypted data.
Parameters
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
Compliance
CTM-defined.
3.5.3 getEmsPublicKeyPair
Synopsis
void getEmsPublicKeyPair(out string publicKeyModulus,
out string publicKeyExponent)
raises(globaldefs::ProcessingFailureException);
Description
This interface enables the NMS to obtain the string representation of the RSA public key pair (in the
modulus and exponent forms) from CTM for encrypting the username and password.
The OSS client must convert the string representation of the public key modulus and public key exponent
into a nonnegative integer and create an RSA public key using cryptographic libraries. Crypto++ is one
of the security providers available.
Before passing the encrypted password to CTM for login, the OSS client must use the Base64 encoder
to encode the encrypted username and password. This provides the string equivalent of the encrypted
data.
Name Type Input/Output Description
publicKey string Out Public key string returned by CTM.