diff --git a/README.md b/README.md index 0e7d10d..ede7499 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,3 @@ # EasyCTF 2016 -Platform for the EasyCTF 2016 competition. - -## Installation - -If you have Vagrant installed, setting up the platform should be a piece of cake. - -1. Navigate to the root directory of this project in a terminal. -2. Enter the command `vagrant up` to create a virtual machine using the Vagrantfile. -3. Enter the command `vagrant ssh` to SSH into the virtual machine. -4. Once you're inside the virtual machine, run `deploy` to start the server. -5. Open [localhost:8080](http://localhost:8080) on your local machine to see if it works. - -If you have any issues during installation, file an issue. - -## Notes +Problems folder. Make a folder with your problem in it. Format coming soon... \ No newline at end of file diff --git a/problems/programming/dijkstra/description.md b/dijkstra/description.md similarity index 100% rename from problems/programming/dijkstra/description.md rename to dijkstra/description.md diff --git a/problems/programming/dijkstra/dijkstra_map.svg b/dijkstra/dijkstra_map.svg similarity index 100% rename from problems/programming/dijkstra/dijkstra_map.svg rename to dijkstra/dijkstra_map.svg diff --git a/problems/programming/dijkstra/grader.py b/dijkstra/grader.py similarity index 88% rename from problems/programming/dijkstra/grader.py rename to dijkstra/grader.py index 59be45a..abf65e1 100644 --- a/problems/programming/dijkstra/grader.py +++ b/dijkstra/grader.py @@ -1,4 +1,4 @@ -def grade(tid, answer): +def grade(autogen, answer): if answer.find("edsger_wybe_dijkstra_was_a_happy_accident") != -1: return { "correct": True, "message": "Great Job! That's a tough one." } return { "correct": False, "message": "Nope, try again." } \ No newline at end of file diff --git a/dijkstra/problem.yml b/dijkstra/problem.yml new file mode 100644 index 0000000..f851890 --- /dev/null +++ b/dijkstra/problem.yml @@ -0,0 +1,8 @@ +title: Dijkstra +hint: You might consider reading up on shortest-path algorithms. +category: Programming +autogen: false +programming: false +value: 450 +files: + - dijkstra_map.svg \ No newline at end of file diff --git a/problems/misc/survey/README.md b/problems/misc/survey/README.md deleted file mode 100644 index bb3cca5..0000000 --- a/problems/misc/survey/README.md +++ /dev/null @@ -1,129 +0,0 @@ -# Problem Format - -This survey problem serves as an example for future problems. Each problem must be placed in its own directory, under the directory of its category (for organization). For the name of the folder, please use the ID of the problem (`pid`), which should be the name of the problem represented by lowercase words separated by dashes; don't include problem value. The program will automatically load the problems into the database. - -## `problem.json` - -The directory *must* contain a `problem.json`; this information will be loaded into the database. Refer to the following example: - -```javascript -{ - "pid": "survey", // required - "title": "Survey", // required - "hint": "No hint!", // optional - defaults to "" - "category": "Miscellaneous", // required - "autogen": false, // optional - defaults to false - "programming": false, // optional - defaults to false - "value": 20, // required - integer out of 800 - "bonus": 0, // optional - defaults to 0; see below for details - "threshold": 0, // recommended - defaults to 0; see below for details - "weightmap": { } // recommended - defaults to {} -} -``` - -## `description.md` - -The directory *must* contain a `description.md`. Just write your description here in Markdown. If you're using `autogen: true`, you can include `${}` variables to produce dynamic content. - -## `grader.py` - -The directory must *also* contain a `grader.py`; this script must contain a `grade` function that takes in two parameters: `tid`, the team ID and `answer`, their attempted answer. The function must return a dict containing the following keys: - -```python -{ - "correct": True # or False, indicating whether the answer is correct. - "message": "Congratulations!" # a custom message for feedback on the website. -} -``` - -For the most part, checking in flags will simply be a matter of comparing strings. Make sure that the grader accepts the flag with or without `easyctf{}`. Here's an example grader that was taken from last year's Infinity Star problem: - -```python -def grade(tid, answer): - if answer.find("csrf_protection_would_probably_have_been_a_good_idea_:/") != -1: - return { "correct": True, "message": "Indeed." } - return { "correct": False, "message": "Nope, that's not quite right." } -``` - -You can copy-paste the above example into your grader and make any necessary adjustments. If you were wondering why we don't just compare strings, some problems may warrant a more complicated grader, like the problem H4SH3D from last year: - -```python -import binascii - -def compute(uinput): - if len(uinput) > 32: return "" - blen = 32 - n = blen - len(uinput) % blen - if n == 0: - n = blen - pad = chr(n) - ninput = uinput + pad * n - r = "" - for i in range(0, blen, 4): - s = ninput[i:i+4] - h = 0 - for j in range(len(s)): - h = (h << 4) + ord(s[j]) - g = h & 4026531840 - if not(g == 0): - h ^= g >> 24 - h &= ~g - r += chr(h % 256) - h = binascii.hexlify(bytes(r, 'Latin-1')) - return h - -def grade(tid, answer): - if compute(answer) == compute("they_see_me_hashin_they_hatin"): - return { "correct": True, "message": "They see me hashin' they hatin'" } - return { "correct": False, "message": "Nope." } -``` - -## `static` - -The directory *may* contain a `static` folder containing any static files that need to be served. This directory will be transferred to a static folder on the public site, so use `${static_folder}` to reference the static folder in links. For example, if your static folder contains a single `vuln.exe`, you might say - -```html -Here is the vulnerable binary. -``` - -The problem-loading script will expand these when the problems are loaded. - -## Bonus Points - -Bonus points encourage teams to finish solving a problem first. Rather than an array of three values like last year, we're going to have bonus-point templates. Each of the following integers is a code for a certain "template", and bonus points will be assigned accordingly. - -| Code | 3rd | 2nd | 1st | -|------|-----|-----|-----| -| 0 | 0% | 0% | 0% | -| 1 | 1% | 2% | 3% | -| 2 | 1% | 3% | 5% | -| 3 | 3% | 5% | 8% | -| 4 | 6% | 8% | 10% | -| 5 | 8% | 12% | 20% | - -The table indicates how many percent bonus a team should receive if they solve a problem first, second, or third. Low problems such as the survey should not yield bonus points; only high-valued points should have bonus points in order to encourage teams to solve them first. - -## Problem Unlocking - -Problem unlocking is managed through a mechanism that involves a threshold and weightmap. The weightmap is a dictionary mapping problem IDs to weight. The threshold is the minimum amount needed in order to unlock that particular problem. Take, for example, an abridged version of last year's Launch Code problem's JSON: - -```javascript -{ - "pid": "launch-code", - "threshold": 5, - "weightmap": { - "php3": 1, - "faster-math": 1, - "biggerisbetter": 1, - "cave-johnson": 1, - "blackmesa": 1, - "rsa3": 1, - "yandere": 1, - "rsi": 1, - "adoughbee": 1, - "infinity_star": 1 - } -} -``` - -That means in order to unlock Launch Code, a team would have to have solved five of the problems listed, since each problem has weight 1. It's also possible to add higher weights to a particular problem to promote solving that problem. \ No newline at end of file diff --git a/problems/programming/dijkstra/problem.json b/problems/programming/dijkstra/problem.json deleted file mode 100644 index 95b4708..0000000 --- a/problems/programming/dijkstra/problem.json +++ /dev/null @@ -1,12 +0,0 @@ -{ - "pid": "dijkstra", - "title": "Dijkstra", - "hint": "You might consider reading up on shortest-path algorithms.", - "category": "Programming", - "autogen": false, - "programming": true, - "value": 450, - "bonus": 4, - "threshold": 0, - "weightmap": { } -} \ No newline at end of file diff --git a/problems/misc/survey/description.md b/survey/description.md similarity index 100% rename from problems/misc/survey/description.md rename to survey/description.md diff --git a/survey/grader.py b/survey/grader.py new file mode 100644 index 0000000..8594c54 --- /dev/null +++ b/survey/grader.py @@ -0,0 +1,2 @@ +def grade(autogen, answer): + return False, "This problem hasn't been released yet." \ No newline at end of file diff --git a/problems/misc/survey/problem.json b/survey/problem.json similarity index 100% rename from problems/misc/survey/problem.json rename to survey/problem.json