CTFs as you need them
 
 
 
 
Go to file
Kevin Chung 3b1b82b9a0
Mark 2.1.4 (#1096)
2.1.4 / 2019-08-30
==================

**General**
* Make user pages show the team's score and place information instead of the user's information if in team mode
* Allow admins to search users by IP address
* Require password for email address changes in the user profile
* The place indicator in `Teams Mode` on the team pages and user pages now correctly excludes hidden teams
* Fix scoreboard place ordinalization in Python 3
* Fix for a crash where imports will fail on SQLite due to lack of ALTER command support
* Fix for an issue where files downloaded via S3 would have the folder name in the filename
* Make `Users.get_place()` and `Teams.get_place()` for return None instead of 0 if the account has no rank/place
* Properly redirect users or 403 if the endpoint requires a team but the user isn't in one
* Show affiliation in user and team pages in the admin panel and public and private user and team pages

**Themes**
* Remove invalid `id='submit'` on submit buttons in various theme files
* Set `tabindex` to 0 since we don't really care for forcing tab order
* Rename `statistics.js` to `graphs.js` in the Admin Panel as it was identified that adblockers can sometimes block the file

**API**
* The team profile endpoint (`/api/v1/teams/me`) will now return 403 instead of 400 if the requesting user is not the captain
* The Challenge API will now properly freeze the solve count to freeze time
2019-08-31 14:45:08 -04:00
.github Issue template (#455) 2017-11-14 16:40:36 -05:00
CTFd Mark 2.1.4 (#1096) 2019-08-31 14:45:08 -04:00
docs Mark 2.1.4 (#1096) 2019-08-31 14:45:08 -04:00
migrations Only add team_captain_id foreign key if the db backend isn't SQLite (#1048) 2019-07-03 00:04:50 -04:00
scripts Add Vagrant with docker support (#285) (#355) 2017-08-20 19:31:32 -04:00
tests 1092 fix solve count leak during freeze (#1095) 2019-08-29 23:22:24 -04:00
.codecov.yml Fix admin cannot modify verified status in Edit User (#777) 2018-12-04 00:35:51 -05:00
.dockerignore Adding .dockerignore and making docker-entrypoint consider DATABASE_URL (#312) 2017-07-13 02:43:17 -04:00
.flaskenv 1.2.0 (#627) 2018-05-03 18:04:39 -04:00
.gitignore Format all the things (#991) 2019-05-11 21:09:37 -04:00
.prettierignore Format all the things (#991) 2019-05-11 21:09:37 -04:00
.travis.yml Format all the things (#991) 2019-05-11 21:09:37 -04:00
CHANGELOG.md Mark 2.1.4 (#1096) 2019-08-31 14:45:08 -04:00
CONTRIBUTING.md Documentation improvements (#963) 2019-04-21 12:00:21 -04:00
Dockerfile Revert "Switch Dockerfile from python:2.7-alpine to python:3.7-alpine (#1055)" (#1057) 2019-07-10 22:58:38 -04:00
LICENSE Update LICENSE 2018-07-29 03:16:54 -04:00
Makefile Format all the things (#991) 2019-05-11 21:09:37 -04:00
README.md Reduce default gunicorn worker count to reduce memory usage (#968) 2019-04-25 15:05:20 -04:00
Vagrantfile Vagrant uses mariadb database rather than sqlite - Fixes #648 (#649) 2018-07-29 00:08:05 -07:00
development.txt Improve caching (#1014) 2019-06-15 02:07:24 -04:00
docker-compose.yml Make ctfd user usable for mysql connection (#1028) 2019-06-21 00:55:44 -04:00
docker-entrypoint.sh Use /dev/shm for worker-tmp-dir in gunicorn in Docker (#1003) 2019-05-25 01:25:24 -04:00
export.py 2.0.0 (#741) 2018-11-19 23:16:14 -05:00
import.py 2.0.0 (#741) 2018-11-19 23:16:14 -05:00
manage.py 2.0.0 (#741) 2018-11-19 23:16:14 -05:00
package.json Format all the things (#991) 2019-05-11 21:09:37 -04:00
populate.py Add argparse to populate.py and fix some lints (#1064) 2019-07-21 15:08:37 -04:00
prepare.sh Mark prepare.sh executable 2017-09-27 22:32:01 -04:00
requirements.txt The place indicator on the team page now excludes counting hidden teams (#1094) 2019-08-29 22:04:05 -04:00
serve.py Improve caching (#1014) 2019-06-15 02:07:24 -04:00
setup.cfg Starting to write tests 2017-01-07 02:44:31 -05:00
wsgi.py 2.1.0 (#957) 2019-04-17 01:36:30 -04:00
yarn.lock Format all the things (#991) 2019-05-11 21:09:37 -04:00

README.md

Build Status CTFd Slack Documentation Status

What is CTFd?

CTFd is a Capture The Flag framework focusing on ease of use and customizability. It comes with everything you need to run a CTF and it's easy to customize with plugins and themes.

CTFd is a CTF in a can.

Features

  • Create your own challenges, categories, hints, and flags from the Admin Interface
    • Dynamic Scoring Challenges
    • Unlockable challenge support
    • Challenge plugin architecture to create your own custom challenges
    • Static & Regex based flags
      • Custom flag plugins
    • Unlockable hints
    • File uploads to the server or an Amazon S3-compatible backend
    • Limit challenge attempts & hide challenges
    • Automatic bruteforce protection
  • Individual and Team based competitions
    • Have users play on their own or form teams to play together
  • Scoreboard with automatic tie resolution
    • Hide Scores from the public
    • Freeze Scores at a specific time
  • Scoregraphs comparing the top 10 teams and team progress graphs
  • Markdown content management system
  • SMTP + Mailgun email support
    • Email confirmation support
    • Forgot password support
  • Automatic competition starting and ending
  • Team management, hiding, and banning
  • Customize everything using the plugin and theme interfaces
  • Importing and Exporting of CTF data for archival
  • And a lot more...

Install

  1. Install dependencies: pip install -r requirements.txt
    1. You can also use the prepare.sh script to install system dependencies using apt.
  2. Modify CTFd/config.py to your liking.
  3. Use flask run in a terminal to drop into debug mode.

You can use the auto-generated Docker images with the following command:

docker run -p 8000:8000 -it ctfd/ctfd

Or you can use Docker Compose with the following command from the source repository:

docker-compose up

Check out the wiki for deployment options and the Getting Started guide

Live Demo

https://demo.ctfd.io/

Support

To get basic support, you can join the CTFd Slack Community: CTFd Slack

If you prefer commercial support or have a special project, feel free to contact us.

Managed Hosting

Looking to use CTFd but don't want to deal with managing infrastructure? Check out the CTFd website for managed CTFd deployments.

MajorLeagueCyber

CTFd is heavily integrated with MajorLeagueCyber. MajorLeagueCyber (MLC) is a CTF stats tracker that provides event scheduling, team tracking, and single sign on for events.

By registering your CTF event with MajorLeagueCyber users can automatically login, track their individual and team scores, submit writeups, and get notifications of important events.

To integrate with MajorLeagueCyber, simply register an account, create an event, and install the client ID and client secret in the relevant portion in CTFd/config.py or in the admin panel:

OAUTH_CLIENT_ID = None
OAUTH_CLIENT_SECRET = None

Credits