Web Services Reference › Methods › Authentication and Web Services Management › WSChallenge

WSChallenge

The WSChallenge method sends NTLMSSP_NEGOTIATE message to the manager and receives the NTLMSSP_CHALLENGE message in response. If the SessionID passed is NULL, this method creates a new SessionID when invoked. The NTLMSSP_CHALLENGE message and the SessionID are sent to Web Service client as a response.

Note: Unified logon uses NTLM protocol for authentication.

The WSChallenge method uses the following messages:

NTLMSSP_NEGOTIATE

Includes an authentication request initiated by the browser on the request of the client. This message contains host name and windows domain name of the client.

NTLMSSP_CHALLENGE

Includes the response from the domain controller to the NTLMSSP_NEGOTIATE message. This message contains a nonce (random data), which is used for creating the response at browser.

Parameters

Char * sessionID

Specifies the session id obtained from the WSChallenge method. The Web Service client must authenticate individually to the Client Automation components: common object (CO), asset management (AM) and software delivery (SD) to access their respective functionality. The client must authenticate to CO first and then to AM or SD. Therefore, this parameter can be NULL only when the parameter CompRequiresAuthentication is set to CO_REQUIRES_AUTHENTICATION.

Char * manager

Specifies the host name of the Client Automation manager to which the method must connect to.

enum CompRequiresAuthentication compReqAuthen

Specifies the Client Automation component for which you require authentication.

struct AuthenticationData * negotiateData,

Specifies the authentication data to be sent to domain controller.

Return Values

WSChallengeResponse

Refers to the structure that is sent back to the client as a response.

Remarks

None

More Information:

AuthenticationData

CompRequiresAuthentication

WSChallenge2

The WSChallenge2 method sends NTLMSSP_NEGOTIATE message to the manager and receives the NTLMSSP_CHALLENGE message in response. If the SessionId passed is NULL, this method creates a new SessionId when invoked. The NTLMSSP_CHALLENGE message and the SessionId are sent to Web Service client as a response.

Note: Unified logon uses NTLM protocol for authentication.

The WSChallenge method uses the following messages:

NTLMSSP_NEGOTIATE

Includes an authentication request initiated by the browser on the request of the client. This message contains host name and windows domain name of the client.

NTLMSSP_CHALLENGE

Includes the response from the domain controller to the NTLMSSP_NEGOTIATE message. This message contains a nonce (random data), which is used for creating the response at browser.

Parameters

xsd:string sessionId

Specifies the session id obtained from the WSChallenge method. The Web Service client must authenticate individually to the CA ITCM components: common object (CO), asset management (AM), and software delivery (SD) to access their respective functionality. The client must authenticate to CO first and then to AM or SD. Therefore, this parameter can be NULL only when the parameter CompRequiresAuthentication is set to CO_REQUIRES_AUTHENTICATION.

xsd:string manager

Specifies the host name of the CA ITCM manager to which the method must connect to.

xsd:string locale

Currently the supported locale values are “enu”,”fra”,”deu” and “jpn”. This value is used for returning locale-specific error strings from Webservices. If locale is not provided, the installed machine locale is used

dsm:CompRequiresAuthentication CompRequiresAuthentication

Specifies the CA ITCM component for which you require authentication.

dsm: AuthenticationData negotiateData,

Specifies the authentication data to be sent to domain controller.

Return Values

xsd:string authenticationData

Specifies the authentication data returned by Domain controller

xsd:long size

Specifies the size of the authentication data

xsd:string sessionId

Specifies a unique session ID as an input parameter for all further calls to the web service.

Remarks

None