com.ibm.mq
Class MQConnectionSecurityParameters

java.lang.Object
  |
  +--com.ibm.mq.MQConnectionSecurityParameters

public class MQConnectionSecurityParameters
extends java.lang.Object

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 WebSphere 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.


Method Summary
 int getAuthenticationType()
          This method returns the authentication method to be used by the Object Authority Manager (OAM).
 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 pass)
          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
 

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 -

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 pass)
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:
pass - The MQCSP password

getCSPPassword

public java.lang.String getCSPPassword()
This method returns the defined MQCSP password.

Returns:
the MQCSP password

(c) Copyright IBM Corp. 2005. All Rights Reserved.