package servlets.module;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Locale;
import java.util.ResourceBundle;
import javax.servlet.ServletException;
import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
import org.apache.log4j.Logger;
import org.owasp.esapi.ESAPI;
import org.owasp.esapi.Encoder;
import utils.FeedbackStatus;
import utils.Hash;
import utils.ShepherdLogManager;
import utils.Validate;
import dbProcs.Getter;
import dbProcs.Setter;
/**
* Control class that returns a feedback form for users if they submit the correct solution
*
* 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 SolutionSubmit extends HttpServlet
{
private static final long serialVersionUID = 1L;
private static org.apache.log4j.Logger log = Logger.getLogger(SolutionSubmit.class);
/**
* Initiated by a dynamic form in index.jsp this method checks the existence of the submitted module identifier before ensuring that the submission is correct
* 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 csrfToken
*/
private static Encoder encoder = ESAPI.encoder();
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.SolutionSubmit &&&");
PrintWriter out = response.getWriter();
out.print(getServletInfo());
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
{
log.debug("Getting ApplicationRoot");
String ApplicationRoot = getServletContext().getRealPath("");
log.debug("Servlet root = " + ApplicationRoot );
log.debug("Getting Parameters");
String moduleId = (String)request.getParameter("moduleId");;
log.debug("moduleId = " + moduleId.toString());
String solutionKey = (String)request.getParameter("solutionKey");;
log.debug("solutionKey = " + solutionKey.toString());
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);
}
if(notNull && storedResult != null)
{
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
{
String decryptedKey = new String();
try
{
//Encrypted Solution key, must be decrypted before compare
decryptedKey = Hash.decryptUserSpecificSolution(Validate.validateEncryptionKey(userName), solutionKey);
}
catch(Exception e)
{
log.error("Could not decrypt result key: " + e.toString());
// Key likely could not be decrypted because somebody submitted a string that could not be decrypted.
//This is a bad submission so they should be warned. String will continue from this point as an empty value and will cause the function to run the Bad Submission procedure
}
storedResult += Hash.getCurrentSalt(); //Add server solution salt to base key before compare with decrypted key
validKey = storedResult.compareTo(decryptedKey) == 0;
log.debug("Decrypted Submitted Key: " + decryptedKey);
log.debug("Stored Expected Key : " + storedResult);
}
if(validKey)
{
log.debug("Correct key submitted, checking that module not already completed");
String result = Getter.checkPlayerResult(ApplicationRoot, moduleId, userId);
if(result != null)
{
//If Feedback is enabled, the user must complete another step. This step is continued in FeedbackSubmit.java
if(FeedbackStatus.isEnabled())
{
log.debug("Returning Feedback Form for module: " + result);
out.write("
Solution Submission Success
" +
" You are one step away from completing " +
encoder.encodeForHTML(result) + "! To complete the level please submit your feedback!" +
"
" +
generateFeedbackForm(moduleId, (String)tokenParmeter, solutionKey));
}
else //Feedback is disabled
{
log.debug("Feedback is disabled, Marking as completed");
String htmlOutput = new String();
result = Setter.updatePlayerResult(ApplicationRoot, moduleId, userId, "Feedback is Disabled", 1, 1, 1);
if(result != null)
{
ResourceBundle bundle = ResourceBundle.getBundle("i18n.moduleGenerics.moduleNames", new Locale(Validate.validateLanguage(request.getSession())));
String compltedModuleLocalName = bundle.getString(result);
log.debug("Solution Submission for module " + compltedModuleLocalName + " succeeded");
htmlOutput = new String("Solution Submission Success
" +
"" +
compltedModuleLocalName + " completed! Congratulations.");
htmlOutput += "
";
//Refresh Side Menu
htmlOutput += FeedbackSubmit.refreshMenuScript(encoder.encodeForHTML((String)tokenParmeter), "Refresh Error");
log.debug("Resetting user's Bad Submisison count to 0");
Setter.resetBadSubmission(ApplicationRoot, userId);
out.write(htmlOutput);
}
else
{
htmlOutput = new String("Could not update user result");
out.print("Solution Submission Failure
" +
"" +
"Sorry but an error Occurred!" +
"
");
}
}
}
else
{
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";
}
out.print("Solution Submission Failure
" +
"" +
encoder.encodeForHTML(errorMessage) +
"
");
}
}
catch (Exception e)
{
log.error("Solution Submission Error: " + e.toString());
out.print("
Solution Submission Failure
" +
"" +
"An error Occurred! Please try again." +
"
");
}
}
else
{
log.debug("CSRF Tokens did not match");
out.print("
Solution Submission Failure
" +
"" +
"An error Occurred! Please try again." +
"
");
}
}
else
{
out.print("
Solution Submission Failure
" +
"" +
"An error Occurred! Please Log in!" +
"
");
}
log.debug("&&& END SolutionSubmit &&&");
}
/**
* The method responsible for generating the feedback form based on the valid input submitted by the user when initiating the doPost() method.
* This data will have to be re-assessed when it is used to submit feedback as the user has an opportunity to modify the parameters they are sending.
* @param moduleId The identifier of the module been completed
* @param csrfToken
* @param theKey The submitted and valid solution key for the module been completed
* @return
*/
private static String generateFeedbackForm (String moduleId, String csrfToken, String theKey)
{
return feedbackForm + encoder.encodeForHTML(moduleId) + feedbackForm21 + encoder.encodeForHTML(theKey)
+ feedbackForm22 + encoder.encodeForHTML(csrfToken) + feedbackForm3;
}
//To be written to the user
private static String feedbackForm = "" +
"
\n" +
"\n" +
"\n" +
"