How to Monitor CA Advanced Authentication Server?s UDS component?

Document ID : KB000045671
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction: 

Need to monitor a UDS (Universal Data Service) server to ensure it up and running and being able to connect to underlying DB to provide an expected response.

Question: 

How to Monitor CA Advanced Authentication Server’s UDS?

Environment:  

UDS server deployed under a Web Application Server,

 

Answer: 

1.              1.     Choose a non-invasive call to fetch data as opposed to an Update, Create or Insert since you want to just interact with the server an ensure that it is healthy and responding.

2.     Check in release location <ARCOT_HOME>\wsdls\uds to find out what WebServices calls are exposed.  

3.     Use a tool like SoapUI  to create a SOAP project and load the WSDL by browsing to <ARCOT_HOME>\wsdls\uds\ ArcotOrganizationManagementSvc.wsdl .  In the screen shot below, the Project name is “UDS WebServices” and listed underneath all the exposed WebServices in left pane.  For this demo we have chosen ArcotOrganizationManagementSvc.wsdl and the call “getUserStatus”. 

soap1.jpg

4.     You may want to test the “getUserStatus” call via SOAPUI after providing the required SOAP parameters only.  In this case the getUserStatus call returned user status as ACTIVE as shown below. 

 

soap2.jpg

 

5.  On a unix machine create a file called say “soap.xml” and capture SOAP request as such (also shown in “Request 1” window above in the left column).

===================   SOAP request in a file soap.xml  ================================

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:msgs="http://ws.arcot.com/ArcotUserRegistrySvc/1.0/msgs" xmlns:ns="http://ws.arcot.com/UserSchema/1.0">

   <soap:Header/>

   <soap:Body>

      <msgs:getUserStatusRequest>

         <msgs:userId>

            <!--Optional:-->

            <ns:orgName>defaultorg1</ns:orgName>

            <ns:userName>auser1</ns:userName>

         </msgs:userId>

      </msgs:getUserStatusRequest>

   </soap:Body>

</soap:Envelope>

===================   End of SOAP request ================================

 

 

 

 6. Submit a CURL command as shown below and if you get a valid response as “Organization, Defaultorg1 does not exist” the server is up and running.

 

curl --header"content-type:application/soap+xml" -XPOST --header "SOAPAction:getUserStatus" -d @soap.xml

 

<?xml version='1.0' encoding='UTF-8'?>

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">

<soapenv:Header>

<udsTransactionID xmlns="http://ws.arcot.com/UDSTransaction/1.0">c9641c86-e843-4cb0-b9968b303597ac32

</udsTransactionID>

<authToken xmlns="http://ws.arcot.com/UDSTransaction/1.0">

</authToken>

</soapenv:Header>

<soapenv:Body>

<soapenv:Fault>

<soapenv:Code>

<soapenv:Value>soapenv:Receiver</soapenv:Value>

</soapenv:Code>

<soapenv:Reason>

<soapenv:Text xml:lang="en-US">Organization, DEFAULTORG1 does not exist</soapenv:Text>

</soapenv:Reason>

<soapenv:Detail>

<ns3:userRegistryError xmlns:ns3="http://ws.arcot.com/ArcotUserRegistrySvc/1.0/msgs"><ns1:errorMessage xmlns:ns1="http://ws.arcot.com/UserSchema/1.0">Organization, DEFAULTORG1 does not exist</ns1:errorMessage><ns1:errorNumber xmlns:ns1="http://ws.arcot.com/UserSchema/1.0">31124</ns1:errorNumber></ns3:userRegistryError>

</soapenv:Detail>

</soapenv:Fault></soapenv:Body></soapenv:Envelop