User guide

3-53
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.2 getEmsPublicKey
Description
This interface enables the NMS to obtain the EmsSession_I object, which contains all managers of the
EMS.
CTM allows 4 to 25 concurrent login sessions and as many user profiles as required for configuring the
number of concurrent login sessions. See B.8 Location of the Naming Service IOR File, page B-6 to
configure the number of concurrent login sessions. The username and password must contain from 1 to
53 characters.
This interface can also accept the encrypted username and password. To enable encryption on the
username and password, check the Enable encryption for username and password check box in the
CTM client Control Panel for the CTM GateWay/CORBA service. CTM then decrypts the username and
password accordingly.
To encrypt the username and password, you must use the RSA algorithm with the public key or the public
key pair provided by CTM. To obtain the CTM public key, use the
emsSessionFactory::EmsSessionFactory_I::getEmsPublicKey API. To obtain the CTM public key pair,
use the emsSessionFactory::EmsSessionFactory_I::getEmsPublicKeyPair API.
Parameters
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of a nonspecific internal EMS failure.
EXCPT_INVALID_INPUT - Raised when the client is invalid or when the length of the username
or password passed is not within the permissible limits (1-53).
EXCPT_ACCESS_DENIED - Raised in the following cases:
When all the eight login sessions are used up.
When the user name specified does not exist.
Or in case of any other security violation.
Compliance
TMF-defined.
3.5.2 getEmsPublicKey
Synopsis
void getEmsPublicKey(out string publicKey)
raises(globaldefs::ProcessingFailureException);
Name Type Input/Output Description
user string In User or application that is trying to access the server.
This user must have a profile created in CTM.
password string In Password for the user application.
client nmsSession::NmsSession_I In Handle to the NMS NmsSession_I object, to which the
returned EmsSession_I object must be associated.
emsSessionInterface emsSession::EmsSession_I Out CORBA Interoperable Object Reference (IOR) for the
EmsSession_I interface.