DisableScoreboardIT.java

package servlets.admin.config;

import static org.junit.jupiter.api.Assertions.fail;

import jakarta.servlet.ServletException;
import java.io.IOException;
import java.sql.SQLException;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.mock.web.MockHttpServletRequest;
import org.springframework.mock.web.MockHttpServletResponse;
import org.springframework.mock.web.MockServletConfig;
import testUtils.TestProperties;
import utils.ScoreboardStatus;

public class DisableScoreboardIT {

  private static final Logger log = LogManager.getLogger(DisableScoreboardIT.class);
  private static String applicationRoot = new String();
  private static String lang = "en_GB";
  private MockHttpServletRequest request;
  private MockHttpServletResponse response;

  /** Creates DB or Restores DB to Factory Defaults before running tests */
  @BeforeAll
  public static void resetDatabase() throws IOException, SQLException {
    TestProperties.setTestPropertiesFileDirectory(log);

    TestProperties.createMysqlResource();

    TestProperties.ensureSchemaReady(log);
    TestProperties.reseedTestData();
  }

  @BeforeEach
  public void setUp() {
    request = new MockHttpServletRequest();
    response = new MockHttpServletResponse();
    // Enable Scoreboard before Each test
    ScoreboardStatus.setScoreboardOpen();
    if (!ScoreboardStatus.isScoreboardEnabled()) {
      String message = "Was Unable to Enable Scoreboard";
      log.fatal(message);
      fail(message);
    }
  }

  /**
   * Method to Simulate the interaction with the disableScoreboard servlet.
   *
   * @param csrfToken The CSRF Token of the User
   * @return The Content of the Response (Which is supposed to be the location of the module)
   * @throws ServletException
   * @throws IOException
   * @throws Exception
   */
  public String doThePost(String csrfToken) throws ServletException, IOException {
    String servletClassName = "DisableScoreboard";
    int expectedResponseCode = 302;

    log.debug("Creating " + servletClassName + " Servlet Instance");
    DisableScoreboard servlet = new DisableScoreboard();
    servlet.init(new MockServletConfig(servletClassName));

    // Adding Correct CSRF Token (Token Submitted)
    request.addParameter("csrfToken", csrfToken);

    log.debug("Running doPost");
    servlet.doPost(request, response);

    if (response.getStatus() != expectedResponseCode) {
      fail(
          servletClassName
              + " Servlet Returned "
              + response.getStatus()
              + " Code. "
              + expectedResponseCode
              + " Expected");
    } else {
      log.debug(expectedResponseCode + " Detected");
      log.debug(
          "Servlet Successful, returning response retrieved: " + response.getContentAsString());
      return (response.getContentAsString());
    }

    return null;
  }

  /**
   * This test checks that non admin users get access errors when disabling the scoreboard
   *
   * @throws SQLException
   * @throws IOException
   * @throws ServletException
   */
  @Test
  public void testUserDisableScoreboardCall() throws SQLException, ServletException, IOException {
    String userName = "configUserTester";
    String password = userName;
    // Verify / Create user in DB

    TestProperties.verifyTestUser(log, applicationRoot, userName, password);
    // Sign in as Normal User
    log.debug("Signing in as User Through LoginServlet");
    TestProperties.loginDoPost(log, request, response, userName, userName, null, lang);
    log.debug("Login Servlet Complete, Getting CSRF Token");
    if (response.getCookie("token") == null) {
      fail("No CSRF Token Was Returned from Login Servlet");
    }
    String csrfToken = response.getCookie("token").getValue();
    if (csrfToken.isEmpty()) {
      String message = new String("No CSRF token returned from Login Servlet");
      log.fatal(message);
      fail(message);
    } else {
      // Add Cookies from Response to outgoing request
      request.setCookies(response.getCookies());
      String responseBody = doThePost(csrfToken);
      if (responseBody.contains("try non administrator functions")) {
        log.debug("No Admin Access Expected Result Received");
        if (!ScoreboardStatus.isScoreboardEnabled()) {
          String message = "Scoreboard was disabled on what should have been a failed request";
          log.fatal(message);
          fail(message);
        }
      } else {
        String message = "Normal user did not get error when performing admin function";
        log.fatal(message);
        fail(message);
      }
    }
  }

  /**
   * This test checks that admin users can disable the scoreboard
   *
   * @throws SQLException
   * @throws IOException
   * @throws ServletException
   */
  @Test
  public void testAdminCompleteDisableScoreabordCall()
      throws SQLException, ServletException, IOException {
    String userName = "configAdminTester";
    String password = userName;
    // Verify / Create user in DB

    TestProperties.verifyTestAdmin(log, applicationRoot, userName, password);
    // Sign in as Admin User
    log.debug("Signing in as User Through LoginServlet");
    TestProperties.loginDoPost(log, request, response, userName, userName, null, lang);
    log.debug("Login Servlet Complete, Getting CSRF Token");
    if (response.getCookie("token") == null) {
      fail("No CSRF Token Was Returned from Login Servlet");
    }
    String csrfToken = response.getCookie("token").getValue();
    if (csrfToken.isEmpty()) {
      String message = new String("No CSRF token returned from Login Servlet");
      log.fatal(message);
      fail(message);
    } else {
      // Add Cookies from Response to outgoing request
      request.setCookies(response.getCookies());
      String responseBody = doThePost(csrfToken);
      if (responseBody.contains("Scoreboard is now disabled and cannot be accessed")) {
        log.debug("Scoreboard was Disabled in message");
        if (ScoreboardStatus.isScoreboardEnabled()) {
          String message = "Scoreboard was not actually disabled";
          log.fatal(message);
          fail(message);
        }
      } else {
        String message = "Admin was unable to disable Scoreboard";
        log.fatal(message);
        fail(message);
      }
    }
  }

  /**
   * Test with Bad CSRF Tokens
   *
   * @throws SQLException
   * @throws IOException
   * @throws ServletException
   */
  @Test
  public void testCsrf() throws SQLException, ServletException, IOException {
    String userName = "configAdminTester";
    String password = userName;
    // Verify / Create user in DB

    TestProperties.verifyTestAdmin(log, applicationRoot, userName, password);
    // Sign in as Admin User
    log.debug("Signing in as User Through LoginServlet");
    TestProperties.loginDoPost(log, request, response, userName, userName, null, lang);
    log.debug("Login Servlet Complete, Getting CSRF Token");
    if (response.getCookie("token") == null) {
      fail("No CSRF Token Was Returned from Login Servlet");
    }
    String csrfToken = response.getCookie("token").getValue();
    if (csrfToken.isEmpty()) {
      String message = new String("No CSRF token returned from Login Servlet");
      log.fatal(message);
      fail(message);
    } else {
      // Add Cookies from Response to outgoing request
      request.setCookies(response.getCookies());
      String responseBody = doThePost("wrongCSRFToken");
      if (responseBody.contains("Scoreboard Configuration Failure")) {
        log.debug("Scoreboard Config Failure Received");
        if (!ScoreboardStatus.isScoreboardEnabled()) {
          String message = "Scoreboard was disabled on what should have been a failed request";
          log.fatal(message);
          fail(message);
        }
      } else {
        String message = "No CSRF Error Detected";
        log.fatal(message);
        fail(message);
      }
    }
  }
}