Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
SSL Certificate Authentication
Clone this wiki locally
(This page pertains only to HackThisSite version 5.)
Certificate authentication allows you to login to your account faster than ever, and keeps your account more secure than any password system out there. HackThisSite's PKI is based off of the paper Public key encryption for web site authentication and identification by David Pacheco.
First, users must generate a private key and certificate signing request. On most Unix systems this can be done by:
openssl genrsa -out client.key 1024 openssl req -new -key client.key -out client.cs
Then you must paste the contents of client.csr into the Request Certificate text box on your Settings page. You will then be given a certificate which you should save to the file client.crt. After that, you can generate the PKCS #12 file for your browser by running the command:
openssl pkcs12 -export -clcerts -in client.crt -inkey client.key -out client.p12
Once that has finished, you can import the PKCS #12 file into your browser and login to HackThisSite by any of the methods described below.
In increasing order of security:
- Password Authentication - Typical method of authentication; user must enter a username and password in order to start a session.
- Automatic Authentication - You will be automatically authenticated if you are found to have a valid certificate. Note: This makes it impossible to logout! Also, if this is your only method of authentication, it makes it impossible for us to tell you that you are banned.
- Certificate Authentication - Requires the user to have a valid certificate to use. To login with this method, connect to the site over SSL with your PCKCS #12 file and click the login button. You will be automatically authenticated.
- Certificate and Password Authentication - This is a combination of two of the methods above. Instead of using a blank login like Certificate Authentication, the user needs to type in their username and password as well as have a valid certificate.
Important: Should you ever loose access to your account due to certificate errors, your account can be automatically restored by going through the Password Recovery process.
In the future we hope to add the ability to create certificates through HTML5's
<keygen> element, however support for this element is so sparse in browsers and programming APIs, we're unable to at this point in time.