EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

KB485381: How to enable MicroStrategy SAML log for troubleshooting SAML authentication issues in MicroStrategy JSP Web and Mobile versions 10.6 and above


Yanqing Liu

Cloud Support Expert I • MicroStrategy


This article outlines how to enable MicroStrategy SAML log for troubleshooting SAML authentication issues.

Strategy JSP Web and Mobile 2021 Update 4 and above:

  1. Open the log4j2.properties file under WEB-INF/classes and configure property.filename to an absolute path for forward slash. For example:

property.filename = C:/samlLOG/test.log
 

  1. The log file will be generated under the path defined in the property.filename parameter.

 
Change the level of org.opensaml, that is the logger.d.level property, to debug and leave everything else as the default. This generates a clean log with all SAML messages, along with any errors or exceptions.
logger.d.name = org.opensaml
logger.d.level = debug
 

  1. Restart the Web Server.

Strategy JSP Web and Mobile 2019 – 2021 Update 3:

  1. Open the log4j.properties file under WEB-INF/classes and configure the log4j.appender.SAMLAppender.File to an absolute path with forward slash. For example:

log4j.appender.SAMLAppender.File=C:/samlLOG/test.log
 
The log file will be generated under the path defined in the log4j.appender.SAMLAppender.File parameter.
 

  1. Configure log4j.logger.PROTOCOL_MESSAGE to DEBUG and leave all the other loggers as default. Depending on the specific issue, different loggers can be configured.

log4j.logger.PROTOCOL_MESSAGE=DEBUG
 

  1. Restart the Web Server.

Strategy JSP Web and Mobile 10.6 - 11.0:

  1. Copy the log4j.properties file from WEB-INF/classes/resources/SAML/stage to WEB-INF/classes.


 

  1. Open the log4j.properties file under WEB-INF/classes, and configure log4j.appender.SAMLAppender.File to an absolute path with forward slash, e.g.

log4j.appender.SAMLAppender.File=C:/samlLOG/test.log
The log file will be generated under the path defined in the log4j.appender.SAMLAppender.File parameter.
 

  1. Generally, it is recommended to configure log4j.logger.PROTOCOL_MESSAGE to DEBUG and leave all the other loggers as default. Depending on the specific issue, different loggers could be configured.

log4j.logger.PROTOCOL_MESSAGE=DEBUG
 

  1. The changes will take effect after the web server is restarted.

 


Comment

0 comments

Details

Knowledge Article

Published:

March 1, 2022

Last Updated:

March 1, 2022