Skip to content

A fully offline-capable cryptographic ticket and password generation and management platform, built as a responsive Progressive Web App (PWA) using React, utilising EdDSA elliptic curve cryptography.

License

GokulVSD/Crypticket

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Secure and Trustless, with a dash of Elegance

A database-free fully offline-capable cryptographic ticket and password generation and management platform, built as a responsive progressive web app (PWA) using React, utilising EdDSA elliptic curve public key digital signature verification.

Incentive

In an age where privacy and trusting entities with sensitive data is of utmost concern, the importance of safely storing, transmitting and using sensitive information gets elevated. What better way is there to handling such a task than keeping the system completely disconnected from any network, and storing all sensitive data encrypted and local, guaranteeing the ownership of the data to the user. Such feats can now be accomplished using modern advancements in cryptography and recent additions to web browser frameworks.

Crypticket was meant to be a proof of concept implementation of the above, which just so happened to be suitable and ready for commercial use.

The problem, which seems trivial at first glance, is a way of securely storing and creating keys, which can be used for a variety of purposes, like verifying tickets or passes for events, transportation, services, ownership verification, or any other use case where the identity of an individual needs to be verified to be unique and non malicious by an owner.

In the process of solving this problem, we found an elegant way to create and store unique and secure passwords (which can be used for literally anything), and so we incorporated the password generator alongside the the core utility as an additional feature.


Thought Process

Let's start off with the example of a ticket management system for an event, such as a convention. We consider an owner (event organiser) and the attendees.

For the trivial case of the verification of the owner, it's simple for the owner to verify him/her self with a unique secret that only they know.

For the case of an owner and a single attendee, the owner tells a secret to the attendee, which the attendee echoes back when entering the hall. It's essential for no one else to be able to figure out this secret. It's also essential for this secret to be verified only once. Another individual with the same secret should not be let in, so as to prevent the single attendee from profiting by selling duplicates.

Now for the good stuff, a single owner and a plethora of attendees. The owner generates as many secrets as required, and gives each attendee a unique secret. The attendees echo back the secret when entering the hall. This creates a whole host of problems due to the fact that we're limiting ourselves in terms of storage in addition to disconnecting ourselves from a network:

  1. How do we generate such secrets? How can we guarantee their uniqueness? Since we can be tasked to generate an extraordinary number of these secrets in case of very large events, we've gotta come up with some procedure.
  2. How can we be sure that no one else will be able to figure out the procedure we used to generate the secrets and simply generate new ones and sell them for profit?
  3. How can we store these secrets for later verification like when the attendees are entering the hall? We have limited storage.
  4. How can we prevent duplicate verification? Again, we have limited storage, we can't simply remember each secret that has already been verified, that would take too much space.
  5. How do we make this whole process user friendly and elegant? It's not realistic to expect the attendees to stand in a long line to verify their tickets, you can't give them a huge secret that each one of them needs to remember/echo back to the organiser, it needs to be short, and it needs to be verified incredibly fast.

The processes used by Crypticket to overcomes all these difficulties are discussed in the next section.


How Crypticket Works

In a few words: elliptic curve cryptography. In a few more words: We won't bog you down with the ins and outs of elliptic curve cryptography, the features, and the mathematics. These details can we found on the internet. The specific curve we're using is Edward's curve, and the procedure we're using is EdDSA (RFC 8032), more specifically Ed25519 (additional information can be found here and here).

In a nutshell, EdDSA is a public key digital signature creation and verification algorithm. A secret is used to find a generator point G on an elliptic curve. This point can essentially be used to sign any message and create a pseudo-unique signature. Based on the message, elliptic curve arithmetic (trapdoor function) is applied a certain number of times on the point G to jump all around the curve under the constraint of a modulo function, eventually stopping at a new point; this point serves as the signature. It turns out that without knowing G, it's incredibly hard to know what message was signed to create a certain signature, or to know what signature a given message, when signed, will produce. This gives power to the individual who knows the secret, to be able to sign any message that they please, have it be unique for that particular message, and be sure that no one else will be able get the same signature for the same message without using the same generator point G.

To verify that a signature was actually produced by signing a particular message using the point G is as simple as backtracking. Using inverse elliptic curve arithmetic on the point given by the signature S a certain number of times based on the message, If we end up landing on the point G, we can rest easy knowing that G was the generator used to generate the signature S.

This allows us to do some cool things, which solve (or partially solve) the difficulties laid out in the previous section:

  1. We can sign an infinite number of messages, producing hashed signatures which fill a 256 bit bucket. This gives us the ability to generate an infinite number of message-signature pairs, which are essentially Cryptickets given to the attendees.

  2. The generator point is also created by hashing a secret (a single password for the event) into a 256 bit bucket. It's next to impossible with current hardware to figure out the generator based on signed messages, so we can conclude with extremely high certainty that the only individual with the ability to sign new messages is the event organiser.

  3. There is no need to store these message-signature pairs anywhere, we can generate it and give it to the attendee, and forget about it. We can always generate the signature knowing the message anytime later. We can also verify the signature knowing the message using the particular generator point used by the event.

  4. Preventing duplicate verification is simple and takes very little space. All we need to store are the messages that have already been verified, not the entire message-signature pair, this is for the same reason as the above. The messages are tiny and in the worst case, are a few bytes long.

  5. The signatures are truncated to only 12 characters, the attendee simply needs to provide the message (a number) and the 12 characters to verify their identity. This greatly simplifies the verification process. In addition, Cryptickets are appended with hidden meta information such as the name, date and time, associated website and location details for the event that it belongs to, which improves user experience.


Cool Facts

  • This PWA works completely offline. The only dependant server is the web server that serves the HTML, JS, CSS files and other assets, and the web server serves each device only once. Your device will cache all the assets and files locally, only checking with the web server (if you're connected to the internet) to see if all the files that are stored locally are up to date. You just need to visit Crypticket once, all successive visits do not access the internet.

  • All information related to state is stored in browser local storage. This means that If you ever clear browser cache, you essentially lose all your data, and you need to fetch the files and assets once again from the web server. This also means that you're restricted to 10 megabytes worth of generators and passwords (as of writing this). 10 megabytes is plenty for normal scenarios.

  • To combat the first problem, we've incorporated functionality to maintain state, allowing users to backup and restore, as well as factory reset their instance of Crypticket. We recommend you backup your state and store it somewhere safe every now and then. Remember, you ONLY lose data when you manually clear browser cache. As long as you don't do that, everything is safe, even if you restart your browser or your device.

  • In addition, this PWA is a rare instance of partially utilising React. The entire website does not use React, the main structure of the website, which doesn't really need to be stateful, is built using plain HTML and JS. This was actually a bigger pain to do than initially expected, but we managed to do it successfully.

  • As showcased in one of the GIFs, the PWA is fully responsive, and resizes to look correct on almost any modern display size, be it a smartphone or a workstation.

  • Crypticket happens to be the first website we've ever created, and it's built completely from the ground up by us.


Frameworks

Reactjs stateful UI rendering and interaction via hierarchy of components

Bootstrap css framework for modals and dropdowns

jQuery DOM interaction and BootstrapJS animations

elliptic fast elliptic curve cryptography in plain javascript

Nodejs for a few npm modules

FontAwesome open-source svg icons (manually minimised)


APIs

localStorage API maintaining and transfering state across sessions

cacheStorage API offline webcaching of files using service workers

Clipboard API copying strings to clipboard via javascript


External React Components

ReactTooltip provides customisable tooltips for React components


Tools Utilised

Browserify converting Node modules into browser friendly javascript

Assets Photoshop and Premiere

Code VS Code and Sublime 3

Debugging Chromium debug console


A Note on Password Generation

Using a similar procedure to that of Crypticket generation, we can take any string and sign it to produce a unique password. These passwords are not stored anywhere, but are generated dynamically when Crypticket is loaded, which maximises security. You can never lose these passwords, even if your device spontaneously bursts into flames. As long as you remember the global password (which is used to create the generator point G) for the password generator, and you put in the same name that you put in initially for any website or app, you'll get back the same password.

example: If your global password is 123456, and you add a password for "Reddit" as the app name, you will generate a password for Reddit. If you create another password generator with the same global password 123456, and put in "Reddit" as the app name again, you'll generate the same password.

Security

As much as we can guarantee an extremely high degree of security, we frankly do not know if there is some ingenious way to break it. We'd say that you'll be alright using it commercially, because if someone found a way to break it, there would be bigger problems at hand, like the security of the entire internet being compromised, which is built off of elliptic curve cryptography.
Although, we'd like to add that we recommend extremely long secrets (of the order of 10s of thousands of characters) be used when creating generators. We've built in a secure secret generator that generates very long secrets that can be used commercially, you will be prompted to use it before creating a generator.
We've also truncated the signature size to 12 characters. This was done to improve user experience. It may decrease the security, but we believe the trade off was justifiable, as it should still be very secure.
You may fork this repository and increase the size if you please.

Creators

Gokul Vasudeva github.com/gokulvsd

Anusha A github.com/anushab05


The creators give permission to reuse parts of code and components, but publishing a web app with the same or mostly similar source code is prohibited, not to mention, that's a pretty douchy thing to do.

About

A fully offline-capable cryptographic ticket and password generation and management platform, built as a responsive Progressive Web App (PWA) using React, utilising EdDSA elliptic curve cryptography.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published