000025101 - Troubleshooting web services

Document created by RSA Customer Support Employee on Jun 16, 2016Last modified by RSA Customer Support Employee on Apr 22, 2017
Version 2Show Document
  • View in full screen mode

Article Content

Article Number000025101
Applies ToAdaptive authentication web services versions 2.1
Adaptive authentication web services versions 2.2.x
RSA Adaptive authentication web services versions 5.7.x.
IssueTo log web service actions
For *any* issues with Web Services, this *must* be done, then the trouble scenario should be reproduced, then the customer must send us the application logs (set to DEBUG level).
Resolution

For troubleshooting web services in the field, here are the instructions for adding logging of the SOAP XML to our application log.

Use the services.logging.xml file shown below.

1) Install the services.logging.xml in META-INF/xfire
2) In the web.xml file, change to XFire config file to point to services.logging.xml.

Change:
 <param-value>META-INF/xfire/services.xml</param-value>
to:
 <param-value>META-INF/xfire/services.logging.xml</param-value>

3) Make sure logging is at DEBUG level in log4j.properties: log4j.rootCategory=DEBUG, CONSOLE, LOGFILE
4) Restart the application

Notes

services.logging.xml text:

<beans xmlns="http://xfire.codehaus.org/config/1.0">
   <xfire>
    <inHandlers>
      <handler handlerClass="org.codehaus.xfire.util.dom.DOMInHandler">
      </handler>
      <handler handlerClass="org.codehaus.xfire.util.LoggingHandler">
      </handler>
    </inHandlers>
    <outHandlers>
      <handler handlerClass="org.codehaus.xfire.util.dom.DOMOutHandler">
      </handler>
      <handler handlerClass="org.codehaus.xfire.util.LoggingHandler">
      </handler>
    </outHandlers>
   </xfire>
 <service>
  <name>AdminService</name>
  <namespace>http://admin.api.ws.passmarksecurity.com</namespace>
  <serviceClass>com.passmarksecurity.ws.api.admin.AdminService</serviceClass>
  <implementationClass>com.passmarksecurity.ws.impl.AdminServiceImpl</implementationClass>
  <style>wrapped</style>
 </service>
 <service>
  <name>AuthService</name>
  <namespace>http://auth.api.ws.passmarksecurity.com</namespace>
  <serviceClass>com.passmarksecurity.ws.api.auth.AuthService</serviceClass>
  <implementationClass>com.passmarksecurity.ws.impl.AuthServiceImpl</implementationClass>
  <style>wrapped</style>
 </service>
</beans>


The services.logging.xml should not be used for normal production usage, due to the performance overhead.
Use services.xml for normal production usage.
Legacy Article IDa32050

Attachments

    Outcomes