Sm_AgentApi_UserCredentials_t

This structure is used for passing credentials to the server.
casso126
This structure is used for passing credentials to the server.
The agent supplies only the relevant information as requested by the Policy Server.
Syntax
This structure has the following format:
typedef struct Sm_AgentApi_UserCredentials_s
{
   long nChallengeReason;
   char lpszUsername[SM_AGENTAPI_SIZE_USERINFO];
   char lpszPassword[SM_AGENTAPI_SIZE_USERINFO];
   char lszCertUserDN[SM_AGENTAPI_SIZE_USERINFO];
   char lpszCertIssuerDN[SM_AGENTAPI_SIZE_USERINFO];
   long nCertBinaryLen;
   char* lpszCertBinary;
} Sm_AgentApi_UserCredentials_t;
Parameters
This structure has the following parameters:
  • nChallengeReason
    The original reason code from a previous authentication that has failed or been challenged.
  • lpszUsername
    Name of the user being authenticated.
  • lpszPassword
    Password of the user being authenticated.
  • lpszCertUserDN
    This field should be set to null. Specify the complete certificate data, including the user DN, in lpszCertBinary.Existing agent applications that specify a user DN in this field are not required to change the value to null. A user DN value is supported for backward compatibility.
  • lpszCertIssuerDN
    This field should be set to null. Specify the complete certificate data, including the issuer DN, in lpszCertBinary.Existnnnnning agent applications that specify an issuer DN in this field are not required to change the value to null. An issuer DN value is supported for backward compatibility. If lpszCertUserDN is null, lpszCertIssuerDN is ignored.
  • nCertBinaryLen
    Number of characters in the Binary Certificate.
  • lpszCertBinary
    Pointer to the certificate data.