com.ibm.mq

Class MQConnectionSecurityParameters

java.lang.Object

com.ibm.mq.jmqi.JmqiObject

com.ibm.mq.MQConnectionSecurityParameters

public class MQConnectionSecurityParameters
extends com.ibm.mq.jmqi.JmqiObject

This class is a representation of the MQCSP structure. It is used to enable the Object Authority Manager (OAM) to authenticate a user and change appropriate identity context fields. In the IBM MQ Java client, this field can be set only from within a Security channel exit. When the exit is invoked, the reference to this class in MQChannelExit will be null. The exit can replace this with an MQConnectionSecurityParameters object defined by the exit. For example:

 public byte[] securityExit(MQChannelExit channelExitParms, MQChannelDefinition channelDefinition,
     byte[] agentBuffer) {
 
   // ... other code ...
 
   MQConnectionSecurityParameters csp = new MQConnectionSecurityParameters();
   csp.setCSPUserId("myID");
   csp.setCSPPassword("myPassword");
   csp.setAuthenticationType(MQC.MQCSP_AUTH_USER_ID_AND_PWD);
 
   channelExitParms.setMQCSP(csp);
 }
 

If the reference is not null when the exit completes, then the information in the MQConnectionSecurityParameters object created by the Exit will be sent to the queue manager.

Data must be in the character set and encoding of the local queue manager; these are given by the CodedCharSetId queue-manager attribute and MQENC_NATIVE, respectively.

Field Summary

Fields inherited from class com.ibm.mq.jmqi.JmqiObject

COMP_JM, COMP_JN, COMP_JO

Constructor Summary

Constructors

Constructor and Description
MQConnectionSecurityParameters()

Method Summary

Modifier and Type	Method and Description
int	getAuthenticationType() This method returns the authentication method to be used by the Object Authority Manager (OAM).It will be either MQCSP_AUTH_NONE or MQCSP_AUTH_USER_ID_AND_PWD.
java.lang.String	getCSPPassword() This method returns the defined MQCSP password.
java.lang.String	getCSPUserId() This method returns the defined MQCSP user ID.
void	setAuthenticationType(int i) Sets the authentication method to be used by the Object Authority Manager (OAM).
void	setCSPPassword(java.lang.String password) Sets a String to be used as the MQCSP password.
void	setCSPUserId(java.lang.String id) Sets a String to be used as the MQCSP user ID.

Methods inherited from class java.lang.Object

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

Constructor Detail

MQConnectionSecurityParameters

public MQConnectionSecurityParameters()

Method Detail

setAuthenticationType

public void setAuthenticationType(int i)

Sets the authentication method to be used by the Object Authority Manager (OAM). It can be either MQCSP_AUTH_NONE or MQCSP_AUTH_USER_ID_AND_PWD. Any other value is interpreted as MQCSP_AUTH_NONE.

The initial value of this field is MQCSP_AUTH_NONE.

Parameters:

i - The authentication type to set

getAuthenticationType

public int getAuthenticationType()

This method returns the authentication method to be used by the Object Authority Manager (OAM).It will be either MQCSP_AUTH_NONE or MQCSP_AUTH_USER_ID_AND_PWD.

The initial value of this field is MQCSP_AUTH_NONE

Returns:

the current authenticationType

setCSPUserId

public void setCSPUserId(java.lang.String id)

Sets a String to be used as the MQCSP user ID. If the authentication type is set to MQCSP_AUTH_USER_ID_AND_PWD then this will be passed to the Object Authority Manager (OAM) for authentication.

The initial value of this field is null.

Parameters:

id - the user ID

getCSPUserId

public java.lang.String getCSPUserId()

This method returns the defined MQCSP user ID.

Returns:

the MQCSP user ID

setCSPPassword

public void setCSPPassword(java.lang.String password)

Sets a String to be used as the MQCSP password. If the authentication type is set to MQCSP_AUTH_USER_ID_AND_PWD then this will be passed to the Object Authority Manager (OAM) for authentication.

The initial value of this field is null.

Parameters:

password - The MQCSP password

getCSPPassword

public java.lang.String getCSPPassword()

This method returns the defined MQCSP password.

Returns:

the MQCSP password