JohnHammond
/
CTFd
mirror of https://github.com/JohnHammond/CTFd.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Minor docs fix (#1050) 

* Rework scoring formats section
selenium-screenshot-testing
Kevin Chung 2019-07-04 13:49:16 -04:00 committed by GitHub
parent 78fee9667a
commit 56342bedc5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/scoring.rst
View File

@ -5,17 +5,14 @@ Scoring is central to any CTF. CTFd automatically generates a scoreboard that au
Solves Solves
------ ------
Solves are what mark a challenge as solved. Solves do not carry a value and defer to the value of their respective Challenge. Solves are what mark a challenge as solved. Solves do not carry a value and defer to the value of their respective Challenge.
Awards Awards
------ ------
Awards have a value defined by their creator (usually an admin). They can be used to give a user/team arbitrary (positive or negative) points. Awards have a value defined by their creator (usually an admin). They can be used to give a user/team arbitrary (positive or negative) points.
Tie Breaks Tie Breaks
---------- ----------
In CTFd, tie breaks are essentially resolved by time. If two teams have the same score, the team with the lower solve ID in the database will be considered on top. For example Team X and Team Y solve the same challenge five minutes apart and both now have 100 points. In CTFd, tie breaks are essentially resolved by time. If two teams have the same score, the team with the lower solve ID in the database will be considered on top. For example Team X and Team Y solve the same challenge five minutes apart and both now have 100 points.
Team X will have a Solve ID of 1 for their submission and Team Y will have a Solve ID of 2 for their submission. Team X will have a Solve ID of 1 for their submission and Team Y will have a Solve ID of 2 for their submission.
@ -27,14 +24,17 @@ Formats
MajorLeagueCyber MajorLeagueCyber
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
MajorLeagueCyber (MLC) is a cyber security event tracker designed and maintained by the developers of CTFd. It provides polling of the CTFd API and can record and aggregate scores between competitions/events. It supports parsing and processing of CTFd's built in scoreboard API format.
MajorLeagueCyber is a cyber security event tracker designed and maintained by the developers of CTFd. It provides polling of the CTFd API and can record and aggregate scores between competitions/events. It supports parsing and processing of CTFd's built in scoreboard API format. To register your event with MLC:
CTFTime
~~~~~~~
In prior versions CTFd supported a CTFTime compatible scoreboard. This is no longer directly supported because the CTFTime scoreboard format is inherently limiting. However, MajorLeagueCyber (MLC) allows for the polling of any JSON scoreboard API and can translate to the CTFTime scoreboard format. To register your event with MLC:
1. Register an account at https://www.majorleaguecyber.org/ if you don't already have one. 1. Register an account at https://www.majorleaguecyber.org/ if you don't already have one.
2. Create a new event. 2. Create a new event.
3. Edit the event and add the API Scoreboard URL under the Integrations section. For CTFd you should enter ``https://[CTFd Instance URL]/api/v1/scoreboard`` 3. Edit the event and add the API Scoreboard URL under the Integrations section. For CTFd you should enter ``https://[CTFd Instance URL]/api/v1/scoreboard``
4. Access the legacy scoreboard format by going to ``https://www.majorleaguecyber.org/events/[EVENT_ID]/[EVENT_NAME]/scoreboard`` 4. Access the JSON scoreboard API from MajorLeagueCyber by going to ``https://www.majorleaguecyber.org/events/[EVENT_ID]/[EVENT_NAME]/scoreboard.json``
CTFTime
~~~~~~~
In prior versions CTFd supported a CTFTime compatible scoreboard. This is no longer directly supported because the CTFTime scoreboard format is inherently limiting. However, MLC allows for the polling of any JSON scoreboard API and can translate to the CTFTime scoreboard format.
After registering your event on MLC you can access the legacy scoreboard format by going to ``https://www.majorleaguecyber.org/events/[EVENT_ID]/[EVENT_NAME]/scoreboard.json?format=legacy``.