Dev -> Val (#6)

.codeclimate.yml

@@ -0,0 +1,30 @@
+version: "2" # required to adjust maintainability checks
+checks:
+  argument-count:
+    enabled: false
+  complex-logic:
+    enabled: false
+  method-lines:
+    config:
+      threshold: 300
+  file-lines:
+    config:
+      threshold: 1000
+  method-complexity:
+    config:
+      threshold: 20
+  return-statements:
+    enabled: false
+  similar-code:
+    enabled: false
+  identical-code:
+    enabled: true
+exclude_patterns:
+  - "**/node_modules/"
+  - ".github/"
+  - ".images/"
+  - "**/*.test.tsx"
+  - "**/*.scss"
+  - "**/*.sh"
+  - "**/*.lock"
+  - "**/*.json"

.env.tpl

@@ -0,0 +1,35 @@
+API_URL=http://localhost:3030/local
+BANNER_TABLE_NAME=local-banners
+COGNITO_USER_POOL_CLIENT_ID=op://mdct_devs/hcbs_secrets/COGNITO_USER_POOL_CLIENT_ID
+COGNITO_USER_POOL_ID=op://mdct_devs/hcbs_secrets/COGNITO_USER_POOL_ID
+POST_SIGNOUT_REDIRECT=http://localhost:3000/
+DISABLE_ESLINT_PLUGIN=true
+DYNAMODB_URL=http://localhost:8000
+IAM_PATH=/
+IAM_PERMISSIONS_BOUNDARY="bound"
+LOCAL_LOGIN=true
+LOGGING_BUCKET=log-bucket
+S3_LOCAL_ENDPOINT=http://localhost:4569
+SAR_REPORT_TABLE_NAME=local-sar-reports
+SKIP_PREFLIGHT_CHECK=true
+
+# Values used for short-circuiting ssm: lookups, most likely won't need locally
+VPC_ID=local-nonsense
+VPC_SUBNET_A=local-nonsense
+VPC_SUBNET_B=local-nonsense
+VPC_SUBNET_C=local-nonsense
+BROKER_STRINGS=local-nonsense
+
+# needed for e2e tests
+CYPRESS_ADMIN_USER_EMAIL=op://mdct_devs/hcbs_secrets/CYPRESS_ADMIN_USER_EMAIL
+CYPRESS_ADMIN_USER_PASSWORD=op://mdct_devs/hcbs_secrets/CYPRESS_ADMIN_USER_PASSWORD # pragma: allowlist secret
+CYPRESS_STATE_USER_EMAIL=op://mdct_devs/hcbs_secrets/CYPRESS_STATE_USER_EMAIL
+CYPRESS_STATE_USER_PASSWORD=op://mdct_devs/hcbs_secrets/CYPRESS_STATE_USER_PASSWORD # pragma: allowlist secret
+
+# db:seed
+SEED_ADMIN_USER_EMAIL=op://mdct_devs/hcbs_secrets/SEED_ADMIN_USER_EMAIL
+SEED_ADMIN_USER_PASSWORD=op://mdct_devs/hcbs_secrets/SEED_ADMIN_USER_PASSWORD # pragma: allowlist secret
+SEED_STATE_USER_EMAIL=op://mdct_devs/hcbs_secrets/SEED_STATE_USER_EMAIL
+SEED_STATE_USER_PASSWORD=op://mdct_devs/hcbs_secrets/SEED_STATE_USER_PASSWORD # pragma: allowlist secret
+SEED_STATE=op://mdct_devs/hcbs_secrets/SEED_STATE
+SEED_STATE_NAME=op://mdct_devs/hcbs_secrets/SEED_STATE_NAME

.eslintignore

@@ -0,0 +1,2 @@
+cypress/plugins/**/*
+tests/cypress/plugins/**/*

.eslintrc.yaml

@@ -0,0 +1,33 @@
+env:
+  browser: true
+  es6: true
+  node: true
+  jest/globals: true
+  cypress/globals: true
+parser: '@typescript-eslint/parser'
+plugins:
+  - '@typescript-eslint'
+  - 'jest'
+  - 'cypress'
+parserOptions:
+  ecmaVersion: 6
+  sourceType: module
+  ecmaFeatures:
+    modules: true
+extends:
+  - 'eslint:recommended'
+
+rules:
+  no-const-assign: error
+  no-duplicate-imports: error
+  no-unreachable: error
+  no-unused-vars: off
+  '@typescript-eslint/no-unused-vars': 
+    - error
+    - argsIgnorePattern: "^_"
+  no-console: error
+  no-empty: error
+  no-extra-semi: error
+  multiline-comment-style:
+    - error
+    - starred-block

.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default repo owners
+*       @BearHanded @braxex

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,30 @@
+### Description
+<!-- Detailed description of changes and related context -->
+
+
+### Related ticket(s)
+<!-- Link to related ticket(s) or issue(s) -->
+<!-- Hint: Type CMDCT-<ticket-number> for autolinking -->
+CMDCT-
+
+---
+### How to test
+<!-- Step-by-step instructions on how to test, if necessary -->
+
+
+### Important updates
+<!-- Changed dependencies, .env files, configs, etc. -->
+<!-- Instructions for local dev, e.g. requires new installs in directories -->
+
+
+---
+### Author checklist
+<!-- Complete the following steps before opening for review -->
+
+- [ ] I have performed a self-review of my code
+- [ ] I have added [thorough](https://shorturl.at/aejkF) tests, if necessary
+- [ ] I have updated relevant documentation, if necessary
+---
+
+<!-- If deploying to val or prod, click 'Preview' and select template -->
+_convert to a different template: [test → val](?expand=1&template=test-to-val-deployment.md)_ | _[val → prod](?expand=1&template=val-to-prod-deployment.md)_

.github/PULL_REQUEST_TEMPLATE/test-to-val-deployment.md

@@ -0,0 +1,7 @@
+## test → val
+---
+### In this deployment:
+<!-- List all work that is part of this deployment -->
+<!-- - Description of work (CMDCT-<ticket-number>) -->
+
+- Description of work (CMDCT-)

.github/PULL_REQUEST_TEMPLATE/val-to-prod-deployment.md

@@ -0,0 +1,7 @@
+## val → prod
+---
+### In this deployment:
+<!-- List all work that is part of this deployment -->
+<!-- - Description of work (CMDCT-<ticket-number>) -->
+
+- Description of work (CMDCT-)

.github/branch-name-validation.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+set -e
+
+local_branch=${1}
+
+valid_branch='^[a-z][a-z0-9-]*$'
+
+reserved_words=(
+    cognito
+)
+
+join_by() { local IFS='|'; echo "$*"; }
+
+#creates glob match to check for reserved words used in branch names which would trigger failures
+glob=$(join_by $(for i in ${reserved_words[@]}; do echo "^$i-|-$i$|-$i-|^$i$"; done;))
+
+if [[ ! $local_branch =~ $valid_branch ]] || [[ $local_branch =~ $glob ]] || [[ ${#local_branch} -gt 64 ]]; then
+    echo """
+     ------------------------------------------------------------------------------------------------------------------------------
+     ERROR:  Please read below
+     ------------------------------------------------------------------------------------------------------------------------------
+    Bad branch name detected; cannot continue.  $local_branch
+
+    The Serverless Application Framework has a concept of stages that facilitate multiple deployments of the same service.
+    In this setup, the git branch name gets passed to Serverless to serve as the stage name.
+    The stage name (branch name in this case) is tacked onto the end of the service name by Serverless.
+    Therefore, the branch name must be a valid service name. Branch name must be all lower case with no spaces and no underscores.
+
+    From Serverless:
+        A service name should only contain alphanumeric (case sensitive) and hyphens. It should start with an alphabetic character and shouldnt exceed 128 characters.
+        For Github Actions support, please push your code to a new branch with a name that meets Serverless' service name requirements.
+        So, make a new branch with a name that begins with a letter and is made up of only letters, numbers, and hyphens... then delete this branch.
+        ------------------------------------------------------------------------------------------------------------------------------
+    """
+    exit 1
+fi
+
+exit 0

.github/build-vars.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+
+var_list=(
+  'AWS_OIDC_ROLE_TO_ASSUME'
+  'AWS_DEFAULT_REGION'
+  'STAGE_PREFIX'
+  'SLACK_WEBHOOK_URL'
+  'CODE_CLIMATE_ID'
+)
+
+set_value() {
+  varname=${1}
+  if [ ! -z "${!varname}" ]; then
+    echo "Setting $varname"
+    echo "${varname}=${!varname}" >> $GITHUB_ENV
+    echo "${varname}=${!varname}" >> $GITHUB_OUTPUT
+  fi
+}
+
+set_name() {
+  varname=${1}
+  echo "BRANCH_SPECIFIC_VARNAME_$varname=${branch_name//-/_}_$varname" >> $GITHUB_ENV
+  echo "BRANCH_SPECIFIC_VARNAME_$varname=${branch_name//-/_}_$varname" >> $GITHUB_OUTPUT
+}
+
+action=${1}
+
+case "$1" in
+set_names)
+  for i in "${var_list[@]}"
+  do
+    set_name $i
+  done
+  ;;
+set_values)
+  for i in "${var_list[@]}"
+  do
+  	set_value $i
+  done
+  ;;
+esac

.github/setBranchName.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+
+set -e
+
+GITHUB_REFNAME="${1}"
+
+[ -z "${GITHUB_REFNAME}" ] && echo "Error setting branch name.  No input given." && exit 1
+
+case ${GITHUB_REFNAME} in
+  $([[ "$GITHUB_REFNAME" =~ ^snyk-* ]] && echo ${GITHUB_REFNAME}))
+    echo ${GITHUB_REFNAME##*-} | head -c 10 | sed 's/^/s/'
+    ;;
+  *)
+    echo ${GITHUB_REFNAME}
+    ;;
+esac

.github/waf-controller.sh

@@ -0,0 +1,134 @@
+#!/usr/bin/env bash
+
+CIRCUIT_BREAKER=10
+AWS_RETRY_ERROR=254
+AWS_THROTTLING_EXCEPTION=252
+#0, 1, 2 are the levels of debug, with 0 being off
+DEBUG=1
+
+set -o pipefail -o nounset -u
+
+case ${1-} in
+  append)
+    OP=append
+    ;;
+  set)
+    OP=set
+    ;;
+  *)
+    echo "Error:  unkown operation"
+    echo "Usage: ${0} [append|set] [ip_set name] [ip_set id] [list of CIDR blocks]" && exit 1
+    ;;
+esac
+
+shift
+NAME="${1-}"
+ID="${2-}"
+shift; shift
+RUNNER_CIDRS="${@-}"
+
+[[ $DEBUG -ge 1 ]] && echo "Inputs:  NAME \"${NAME}\", ID \"${ID}\", RUNNER_CIDRS \"${RUNNER_CIDRS}\""
+
+[[ -z "${NAME}" ]] || [[ -z "${ID}" ]] || [[ -z "${RUNNER_CIDRS}" ]] && echo "Error:  one or more inputs are missing" && exit 1
+
+#Exponential backoff with jitter
+jitter() {
+  #.5 seconds
+  SHORTEST=50
+  #10 seconds
+  LONGEST=1000
+  DIV=100
+  EXP=$(perl -e "use bigint; print $SHORTEST**$1")
+  MIN=$(($EXP>$LONGEST ? $LONGEST : $EXP))
+  RND=$(shuf -i$SHORTEST-$MIN -n1)
+  perl -e "print $RND/$DIV"
+}
+
+#Attempt to avoid resource contention from the start
+sleep $(jitter $(shuf -i1-10 -n1))
+
+for ((i=1; i <= $CIRCUIT_BREAKER; i++)); do
+  #This loop is ONLY for retrying if the retries exceeded exception is thrown
+  for ((j=1; j <= $CIRCUIT_BREAKER; j++)); do
+    #Read WAF configuration from AWS
+    WAF_CONFIG=$(aws wafv2 get-ip-set --scope CLOUDFRONT --id ${ID} --name ${NAME} 2>&1)
+    CMD_CD=$?
+    [[ $DEBUG -ge 1 ]] && echo "AWS CLI Read Response Code:  ${CMD_CD}"
+    [[ $DEBUG -ge 2 ]] && echo "AWS CLI Read Response:  ${WAF_CONFIG}"
+
+    #If the retries exceeded error code is returned, try again, otherwise exit the loop
+    [[ $CMD_CD -eq $AWS_RETRY_ERROR ]] || break
+
+    SLEEP_FOR=$(jitter ${j})
+    echo "CLI retries exceed.  Waiting for ${SLEEP_FOR} seconds to execute read again...(${j})"
+    sleep ${SLEEP_FOR}
+  done
+
+  #Unable to get the lock tocken and IP set so there isn't any point in attempting the write op
+  [[ $j -ge $CIRCUIT_BREAKER ]] && echo “Attempts to read WAF IPSet exceeded” && sleep $(jitter ${i}) && continue
+
+  #The loop was short circuited with an error code other than 0, so something is wrong
+  [[ $CMD_CD -eq 0 ]] || ( echo "An unexpected read error occurred:  ${CMD_CD}" && exit 2 )
+
+  echo "Read was successful."
+
+  if [ ${OP} == "append" ]; then
+    ##If this is used to whitelist individual ips or cidrs, using an additive approach is what is required
+    #Parse out IP set addresses to array
+    IP_ADDRESSES=($(jq -r '.IPSet.Addresses | .[]' <<< ${WAF_CONFIG}))
+
+    #If CIDR is already present in IP set, eject
+    grep -q $RUNNER_CIDRS <<< ${IP_ADDRESSES}
+    [[ $? -ne 0 ]] || ( echo "CIDR is present in IP Set." && exit 0 )
+
+    #Add runner CIDR to array
+    IP_ADDRESSES+=("$RUNNER_CIDRS")
+  else 
+    ##If this is used to hard set the IP set, just clobber it
+    IP_ADDRESSES=("$RUNNER_CIDRS")
+  fi
+
+  #Stringify IPs
+  STRINGIFIED=$(echo $(IFS=" " ; echo "${IP_ADDRESSES[*]}"))
+  [[ $DEBUG -ge 2 ]] && echo "Ip Addresses:  ${STRINGIFIED}"
+
+  #Parse out optimistic concurrency control token
+  OCC_TOKEN=$(jq -r '.LockToken' <<< ${WAF_CONFIG})
+  [[ $DEBUG -ge 2 ]] && echo "LockToken:  ${OCC_TOKEN}"
+
+  #This loop is ONLY for retrying if the retries exceeded exception is thrown
+  for ((k=1; k <= $CIRCUIT_BREAKER; k++)); do
+    #Write updated WAF configuration to AWS
+    OUTPUT=$(aws wafv2 update-ip-set --scope CLOUDFRONT --id ${ID} --name ${NAME} --lock-token ${OCC_TOKEN} --addresses ${STRINGIFIED} 2>&1)
+    CMD_CD=$?
+    [[ $DEBUG -ge 1 ]] && echo "AWS CLI Write Response Code:  ${CMD_CD}"
+    [[ $DEBUG -ge 2 ]] && echo "AWS CLI Write Response:  ${OUTPUT}"
+
+    #If the retries exceeded error code is returned, try again, otherwise exit the loop
+    [[ $CMD_CD -eq $AWS_RETRY_ERROR ]] || break
+    #If WAFOptimisticLockException error code is returned, exit the loop
+    [[ "$OUTPUT" =~ "WAFOptimisticLockException" ]] && break
+
+    SLEEP_FOR=$(jitter ${k})
+    echo "CLI retries exceed.  Waiting for ${SLEEP_FOR} seconds to execute write again...(${k})"
+    sleep ${SLEEP_FOR}
+  done
+
+  [[ $CMD_CD -ne 0 ]] || break
+  #Still not having success, so try again
+
+  echo "Exit Code:  ${CMD_CD}"
+
+  SLEEP_FOR=$(jitter ${i})
+  echo "Waiting for ${SLEEP_FOR} seconds to execute main loop again...(${i})"
+  sleep ${SLEEP_FOR}
+done
+
+[[ $DEBUG -ge 1 ]] && echo "Attempts to update ip set:  $i"
+
+[[ $i -gt $CIRCUIT_BREAKER ]] && echo “Attempts to update WAF IPSet exceeded, exiting.” && exit 2
+
+echo "Applied the IP Set successfully."
+
+#Things should not have made it this far without being able to successfully write the IP Set
+exit $CMD_CD