/// <summary>Sets user's password to a specified value</summary>
/// <param name="userName">User name</param>
/// <param name="newPassword">New password to be set</param>
/// <param name="currentPassword">User's current password (optional if user is *SECADM and has at least *USE authority to the profile)</param>
public void ChangeUserPassword(string userName, string newPassword, string currentPassword = "******")
{
/*
* https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_73/apis/QSYCHGPW.htm
*
* Required Parameter Group:
*
* 1 User ID Input Char(10)
* 2 Current password Input Char(*)
* 3 New password Input Char(*)
* 4 Error code I/O Char(*)
* 5 Length of current password Input Bin(4)
* 6 CCSID of current password Input Bin(4) -> 0
* 7 Length of new password Input Bin(4)
* 8 CCSID of new password Input Bin(4) -> 0
*/
ProgramCallParameters qsychgpwCallParameters =
new ProgramCallParameters(8)
{
[0] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic(userName.ToUpper().PadRight(10))),
[1] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic(currentPassword)),
[2] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic(newPassword)),
[3] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInputOutput,
null,
500),
[4] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.UInt32ToBigEndian((uint)currentPassword.Length)),
[5] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.UInt32ToBigEndian(0)),
[6] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.UInt32ToBigEndian((uint)newPassword.Length)),
[7] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.UInt32ToBigEndian(0))
};
CallMessages qsychgpwCallMessages = new CallMessages();
if (CallProgram("qsychgpw", "QSYS", ref qsychgpwCallParameters, ref qsychgpwCallMessages) != 0)
{
foreach (CallMessage outputMessage in qsychgpwCallMessages)
{
Debug.WriteLine(outputMessage.MessageText);
}
throw new System.InvalidOperationException("The method ChangeUserPassword failed. Check debug information.");
}
}
/// <summary>Sends data over an open stream.</summary>
/// <param name="outputData">Data to be sent</param>
public void Write(byte[] outputData)
{
if (this.bufferedStream.CanWrite)
{
byte[] requestLength = Converters.UInt32ToBigEndian((uint)outputData.Length + 4);
this.bufferedStream.Write(requestLength, 0, requestLength.Length);
this.bufferedStream.Write(outputData, 0, outputData.Length);
this.bufferedStream.Flush();
}
}
public UserProfile GetUserInfo(string userName)
{
/*
* https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_73/apis/qsyrusri.htm
*
* Required Parameter Group:
*
* 1 Receiver variable Output Char(*) - 120000B
* 2 Length of receiver variable Input Binary(4) - 120000
* 3 Format name Input Char(8) - "USRI0300"
* 4 User profile name Input Char(10) - userName
* 5 Error code I/O Char(*)
*/
ProgramCallParameters qsyrusriCallParameters =
new ProgramCallParameters(5)
{
[0] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeOutput,
null,
120000),
[1] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.UInt32ToBigEndian(120000)),
[2] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic("USRI0300")),
[3] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic(userName.ToUpper().PadRight(10))),
[4] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInputOutput,
null,
500)
};
CallMessages qsyrusriCallMessages = new CallMessages();
if (CallProgram("qsyrusri", "QSYS", ref qsyrusriCallParameters, ref qsyrusriCallMessages) != 0)
{
foreach (CallMessage outputMessage in qsyrusriCallMessages)
{
Debug.WriteLine(outputMessage.MessageText);
}
throw new System.InvalidOperationException("The method GetUserInfo failed. Check debug information.");
}
return(new UserProfile(qsyrusriCallParameters[0].ParameterValue));
}
//-----------------------------------------------------------------------
// Class methods
//-----------------------------------------------------------------------
public string[] GetUsersList()
{
/*
* https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_72/apis/qgyolaus.htm
*
* Required Parameter Group:
*
* 1 Receiver variable Output Char(*) - 120000B
* 2 Length of receiver variable Input Binary(4) - 120000
* 3 List information Output Char(80)
* 4 Number of records to return Input Binary(4) - "9999"
* 5 Format name Input Char(8) - "AUTU0100"
* 6 Selection criteria Input Char(10) - "*ALL"
* 7 Group profile name Input Char(10) - "*NONE"
* 8 Error code I/O Char(*)
*/
ProgramCallParameters qgyolausCallParameters =
new ProgramCallParameters(8)
{
[0] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeOutput,
null,
120000),
[1] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.UInt32ToBigEndian(120000)),
[2] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeOutput,
null,
80),
[3] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.UInt32ToBigEndian(9999)),
[4] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic("AUTU0100")),
[5] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic("*ALL ")),
[6] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic("*NONE ")),
[7] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInputOutput,
null,
500)
};
CallMessages qgyolausCallMessages = new CallMessages();
if (CallProgram("QGYOLAUS", "QSYS", ref qgyolausCallParameters, ref qgyolausCallMessages) != 0)
{
foreach (CallMessage outputMessage in qgyolausCallMessages)
{
Debug.WriteLine(outputMessage.MessageText);
}
throw new System.InvalidOperationException("The method GetUserList failed. Check debug information.");
}
uint numEntries = Converters.BigEndianToUInt32(qgyolausCallParameters[2].ParameterValue, 0, 4);
if (numEntries <= 0)
{
return(null);
}
string[] userList = new string[numEntries];
for (int i = 0; i < numEntries; i++)
{
userList[i] = Converters.EbcdicToAsciiString(qgyolausCallParameters[0].ParameterValue, (uint)i * 12, 10);
}
return(userList);
}
//-----------------------------------------------------------------------
// Class methods
//-----------------------------------------------------------------------
/// <summary>Returns password hash of the specified user, in specified format</summary>
/// <param name="system">System to be connected to</param>
/// <param name="userName">User name</param>
/// <param name="hashType">Predefined password hash type (see documentation for details)</param>
/// <returns>Password hash as a hex string</returns>
public string GetEncryptedPassword(string userName, int hashType)
{
/*
* http://publib.boulder.ibm.com/infocenter/iseries/v5r4/index.jsp?topic=%2Fapis%2Fqsyrupwd.htm
*
* Required Parameter Group:
*
* 1 Receiver variable Output Char(*) - 2000B
* 2 Length of receiver variable Input Binary(4)
* 3 Format Input Char(8) - "UPWD0100"
* 4 User profile name Input Char(10) - userName
* 5 Error code I/O Char(*)
*/
ProgramCallParameters qsyrupwdCallParameters =
new ProgramCallParameters(5)
{
[0] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeOutput,
null,
2000),
[1] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.UInt32ToBigEndian(2000)),
[2] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic("UPWD0100")),
[3] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInput,
Converters.AsciiToEbcdic(userName.ToUpper().PadRight(10))),
[4] = new ProgramCallParameter(
ProgramCallParameter.ParameterTypeInputOutput,
null,
500)
};
CallMessages qsyrupwdCallMessages = new CallMessages();
if (CallProgram("QSYRUPWD", "QSYS", ref qsyrupwdCallParameters, ref qsyrupwdCallMessages) != 0)
{
foreach (CallMessage outputMessage in qsyrupwdCallMessages)
{
Debug.WriteLine(outputMessage.MessageText);
}
throw new System.InvalidOperationException("The method GetEncryptedPassword failed. Check debug information.");
}
switch (hashType)
{
case PASSWORD_HASH_ALLDATA: // All data
return(Converters.BigEndianToHexString(qsyrupwdCallParameters[0].ParameterValue, 1, 269));
case PASSWORD_HASH_UNKNOWNHASH: // Unknown (hash?) data
return(Converters.BigEndianToHexString(qsyrupwdCallParameters[0].ParameterValue, 78, 192));
case PASSWORD_HASH_HMACSHA1MC: // HMAC-SHA1 password (mixed case)
return(Converters.BigEndianToHexString(qsyrupwdCallParameters[0].ParameterValue, 35, 20));
case PASSWORD_HASH_HMACSHA1UC: // HMAC-SHA1 password (uppercase)
return(Converters.BigEndianToHexString(qsyrupwdCallParameters[0].ParameterValue, 55, 20));
case PASSWORD_HASH_LMHASH: // LM hash
return(Converters.BigEndianToHexString(qsyrupwdCallParameters[0].ParameterValue, 17, 16));
case PASSWORD_HASH_DES: // Composed DES hash (PW_TOKENa XOR PW_TOKENb):
return(Converters.BigEndianToHexString(Converters.UInt64ToBigEndian(Converters.BigEndianToUInt64(qsyrupwdCallParameters[0].ParameterValue, 1, 8) ^ Converters.BigEndianToUInt64(qsyrupwdCallParameters[0].ParameterValue, 9, 8))));
case PASSWORD_HASH_SECONDDES: // Second DES password token (PW_TOKENb)
return(Converters.BigEndianToHexString(qsyrupwdCallParameters[0].ParameterValue, 9, 8));
case PASSWORD_HASH_FIRSTDES: // First DES password (PW_TOKENa)
default:
return(Converters.BigEndianToHexString(qsyrupwdCallParameters[0].ParameterValue, 1, 8));
}
}