package servlets.module; import dbProcs.Getter; import dbProcs.Setter; import jakarta.servlet.ServletException; import jakarta.servlet.http.Cookie; import jakarta.servlet.http.HttpServlet; import jakarta.servlet.http.HttpServletRequest; import jakarta.servlet.http.HttpServletResponse; import jakarta.servlet.http.HttpSession; import java.io.IOException; import java.io.PrintWriter; import org.apache.logging.log4j.LogManager; import org.apache.logging.log4j.Logger; import org.jsoup.parser.Parser; import org.owasp.encoder.Encode; import utils.Hash; import utils.ShepherdLogManager; import utils.Validate; /** * Marks modules as completed and stores feedback
*
* This file is part of the Security Shepherd Project. * *

The Security Shepherd project is free software: you can redistribute it and/or modify it under * the terms of the GNU General Public License as published by the Free Software Foundation, either * version 3 of the License, or (at your option) any later version.
* *

The Security Shepherd project is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. See the GNU General Public License for more details.
* *

You should have received a copy of the GNU General Public License along with the Security * Shepherd project. If not, see . * * @author Mark Denihan */ public class FeedbackSubmit extends HttpServlet { private static final long serialVersionUID = 1L; private static final Logger log = LogManager.getLogger(SolutionSubmit.class); /** * Initiated by a dynamic form returned by servlets.module.SolutionSubmit.doPost() this method * checks the existence of the submitted module identifier before ensuring that the submission is * correct. If the module solution submission is found to be valid then the feedback submitted is * stored, marking the module as completed for the user If the submission is found to be valid * then the user is returned with a feedback form. * * @param mouleId The identifier of the module that the solution is been submitted for * @param solutionKey The solution key for the proposed module * @param before The knowledge the user had before completing the module * @param after The knowledge the user had after completing the module * @param difficulty The difficulty the user had completing the module * @param additionalInfo Additional Feedback information * @param csrfToken */ public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // Setting IpAddress To Log and taking header for original IP if forwarded from proxy ShepherdLogManager.setRequestIp(request.getRemoteAddr(), request.getHeader("X-Forwarded-For")); log.debug("&&& servlets.module.FeedbackSubmit &&&"); String htmlOutput = new String(); PrintWriter out = response.getWriter(); out.print(getServletInfo()); request.setCharacterEncoding("UTF-8"); HttpSession ses = request.getSession(true); if (Validate.validateSession(ses)) { ShepherdLogManager.setRequestIp( request.getRemoteAddr(), request.getHeader("X-Forwarded-For"), ses.getAttribute("userName").toString()); log.debug("Current User: " + ses.getAttribute("userName").toString()); Cookie tokenCookie = Validate.getToken(request.getCookies()); Object tokenParmeter = request.getParameter("csrfToken"); if (Validate.validateTokens(tokenCookie, tokenParmeter)) { boolean notNull = false; String storedResult = null; try { String ApplicationRoot = getServletContext().getRealPath(""); log.debug("Getting Parameters"); String moduleId = (String) request.getParameter("moduleId"); ; log.debug("moduleId = " + moduleId.toString()); String solutionKey = Parser.unescapeEntities((String) request.getParameter("solutionKey"), false); log.debug("solutionKey = " + solutionKey.toString()); int before = Integer.parseInt(Validate.validateParameter(request.getParameter("before"), 1)); log.debug("before = " + before); int after = Integer.parseInt(Validate.validateParameter(request.getParameter("after"), 1)); log.debug("after = " + after); int difficulty = Integer.parseInt(Validate.validateParameter(request.getParameter("difficulty"), 1)); log.debug("difficulty = " + difficulty); String additionalInfo = Validate.validateParameter(request.getParameter("extra"), 5012); log.debug("additionalInfo = " + additionalInfo); log.debug("Getting session parameters"); String userId = (String) ses.getAttribute("userStamp"); String userName = (String) ses.getAttribute("userName"); log.debug("userId = " + userId); // Validation notNull = (moduleId != null && solutionKey != null); if (notNull) { storedResult = Getter.getModuleResult(ApplicationRoot, moduleId); } boolean moduleOpen = false; if (notNull && storedResult != null) { moduleOpen = Getter.isModuleOpen(ApplicationRoot, moduleId); } if (notNull && storedResult != null && moduleOpen) { boolean validKey = false; // Identify if solution is a user Specific key (Does it need to be decrypted?) if (Getter.getModuleKeyType(ApplicationRoot, moduleId)) { validKey = storedResult.compareTo(solutionKey) == 0; } else { // User has submitted a string. Lets see if it matches a freshly computed Key storedResult = Hash.generateUserSolutionKeyOnly( Getter.getModuleResult(ApplicationRoot, moduleId), userName); validKey = storedResult.compareTo(solutionKey) == 0; log.debug("Submitted Key: " + solutionKey); log.debug("Expected Key : " + storedResult); } if (validKey) { log.debug("Correct key submitted, checking user has not already completed"); String hasNotCompletedBefore = Getter.checkPlayerResult(ApplicationRoot, moduleId, userId); if (hasNotCompletedBefore != null) { // Marking module complete by user String result = Setter.updatePlayerResult( ApplicationRoot, moduleId, userId, additionalInfo, before, after, difficulty); if (result != null) { log.debug("User Result for module " + result + " succeeded"); htmlOutput = new String( "

Solution Submission Success


" + "

" + Encode.forHtml(result) + " completed! Congratulations."); htmlOutput += "

"; // Refresh Side Menu htmlOutput += refreshMenuScript(Encode.forHtml((String) tokenParmeter), "Refresh Error"); } else { htmlOutput = new String("Could not update user result"); out.print( "

Solution Submission Failure


" + "

" + "Sorry but an error Occurred!" + "

"); } } else // User Has already completed this level { log.error("User has completed this module before. Returning Error"); out.write( "

Haven't You Done This Already?


Our records say" + " you have already completed this module! Go try another one!

"); } } else { log.error("Incorrect key submitted, returning error"); out.print( "

Solution Submission Failure


Incorrect Solution Key Submitted.

You have limited" + " amounts of incorrect key submissions before you will loose 10% of your" + " points. Contact the OWASP Security Shepherd if you think you have found" + " the correct key but it is failing you.

"); log.error("Invoking Bad Submission procedure..."); Setter.incrementBadSubmission(ApplicationRoot, userId); log.error(userName + " has been warned and potentially has lost points"); } } else { // Validation Error Responses String errorMessage = "An Error Occurred: "; if (!notNull) { log.error("Null values detected"); errorMessage += "Invalid Request. Please try again"; } else if (storedResult == null) { log.error("Module not found"); errorMessage += "Module Not Found. Please try again"; } else { log.fatal("Module Not Open"); errorMessage += "Module Not Open. Please try a level that is marked as open. "; } htmlOutput = new String( "

Feedback Submission Failure


" + "

" + Encode.forHtml(errorMessage) + "

"); } } catch (Exception e) { log.error("Feedback Submission Error: " + e.toString()); htmlOutput = new String( "

Feedback Submission Failure


" + "

" + "An error Occurred! Please try again." + "

"); } } else { log.debug("CSRF Tokens did not match"); htmlOutput = new String( "

Feedback Submission Failure


" + "

" + "An error Occurred! Please try again." + "

"); } } else { htmlOutput = new String( "

Feedback Submission Failure


An" + " error Occurred! Please try non administrator functions or Log in!" + "

"); } out.write(htmlOutput); log.debug("&&& END SolutionSubmit &&&"); } public static String refreshMenuScript(String csrfToken, String localError) { return ""; } }