{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"bd6fc801-eee9-45ba-8351-4b5d08bd8fe2"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"3f2c9bdb-c28b-4ca2-8984-f8452e5dbac1"}},{"type":"heading","attrs":{"level":2},"content":[{"type":"hardBreak"},{"text":"Profile Flow Unit Tests","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"idp-conf","type":"text","marks":[{"type":"strong"}]},{"text":" Maven module, which includes most of the as-delivered configuration files that end up in the distribution, includes TestNG unit tests that exercise many of the webflows, but without using a browser (so just programmatically with mock objects).","type":"text"}]},{"type":"paragraph","content":[{"text":"The tests extend AbstractFlowTest, which is responsible for :","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Creating mock objects such as HttpServletRequest, HttpServletResponse, and the Spring Web Flow ExternalContext","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Overriding flows to return the OpenSAML ProfileRequestContext as a Spring Web Flow output attribute","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Tests of SAML flows extract the SAML Response from the OpenSAML ProfileRequestContext and validate the Response using a validator, for example the SAML2TestResponseValidator.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Eclipse Testbed","type":"text"}]},{"type":"paragraph","content":[{"text":"The java-idp-testbed project is a stand-alone project that runs the IdP inside Eclipse (programmatically starting Jetty as the container). The code being run is the code in Eclipse under active development, so it's possible to test changes to all of the libraries or third party extensions in-situ.","type":"text"}]},{"type":"paragraph","content":[{"text":"A very simple mock SP included in the testbed simply displays the messages it receives for diagnostic purposes and it can initiate SAML profiles in various ways.","type":"text"}]},{"type":"paragraph","content":[{"text":"The testbed provides :","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an IdP configured by idp-conf from the classpath (by setting the idp.home and idp.webflows system properties)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a mock SAML SP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a test in-memory LDAP directory server","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/1261765172"}},{"text":" ","type":"text"},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP4/pages/2983559169"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Properties","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that the Jetty WebAppProvider configured in idp-jetty-base's jetty-deploy.xml reads properties from idp-jetty-base's start.d/idp.ini, hence properties used in a deployment descriptor XML file are not overridable via command line arguments or via other start.d/*.ini files.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Logging","type":"text"}]},{"type":"paragraph","content":[{"text":"Jetty will log to ","type":"text"},{"text":"${workspace_loc:idp-jetty-base}/src/main/resources/jetty-base/logs","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The IdP will log to ","type":"text"},{"text":"${workspace_loc:idp-jetty-base}/src/main/resources/jetty-base/classpath/logs","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"To log to the Eclipse console :","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"comment out ","type":"text"},{"text":"--module=logging","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"${workspace_loc:idp-jetty-base}/src/main/resources/jetty-base/start.ini","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" to the end of ","type":"text"},{"text":"${workspace_loc:idp-conf}/src/main/resources/conf/logback.xm","type":"text","marks":[{"type":"code"}]},{"text":"l (this includes ","type":"text"},{"text":"${workspace_loc:idp-conf}/src/test/resources/conf/logback-include-console.xm","type":"text","marks":[{"type":"code"}]},{"text":"l)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Storage","type":"text"}]},{"type":"paragraph","content":[{"text":"To interact with IdP storage services via HTTP, add the following to ","type":"text"},{"text":"idp-war/src/main/webapp/WEB-INF/web.xml","type":"text","marks":[{"type":"code"}]},{"text":" :","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"web.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"expand","attrs":{"title":"web.xml"},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n storage\n org.springframework.web.servlet.DispatcherServlet\n \n contextConfigLocation\n classpath:/system/conf/storage-context.xml\n \n 1\n\n\n storage\n /storage/*\n","type":"text"}]},{"type":"paragraph"}]},{"type":"paragraph","content":[{"text":"See the Javadoc for the testbed ","type":"text"},{"text":"StorageServiceWrapperController","type":"text","marks":[{"type":"link","attrs":{"href":"https://git.shibboleth.net/view/?p=java-idp-testbed.git;a=blob;f=src/main/java/storage/StorageServiceWrapperController.java;h=502facfbf2d8bed13246a12863549e86e7e7985e;hb=ccc33ff3e31ae945aead4e2a080c4461b7ad8818"}}]},{"text":" for usage.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Troubleshooting Eclipse Testbed","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"ClassNotFoundException","type":"text"}]},{"type":"paragraph","content":[{"text":"If Eclipse can not find Jetty classes :","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"WARNING: Nothing to start, exiting ...","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"java.lang.ClassNotFoundException: org.eclipse.jetty.xml.XmlConfiguration","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"make sure that the version of Jetty specified via jetty.home and the testbed POM match.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"-Djetty.home=/opt/jetty/jetty-distribution-9.3.16.v20170120","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"9.3.16.v20170120","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Integration Tests","type":"text"}]},{"type":"paragraph","content":[{"text":"The java-idp-integration-tests project exercises profile flows using a browser via Selenium.","type":"text"}]},{"type":"paragraph","content":[{"text":"The tests configure and run the IdP and testbed web apps. The SAML assertion produced by the IdP and received by the testbed SP is retrieved by the browser and validated using the same validator used by the idp-conf tests.","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"How to Run IdP Browser/Integration Tests","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631878"}}]},{"text":" for further information.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}