CrackStation, a Decrypter Implementation

A library that cracks password hashes.

version: 1.1.0

Overview

CrackStation is a library capable of cracking unsalted password hashes generated using either SHA-1 or SHA-256 functions. It can crack passwords up to three characters in length, which are the combinations of "A-Z", "a-z", "0-9", "?" and "!".

• Feed in an unsalted hash (Supports: SHA1 and SHA256)
• Receive the actual password
• ✨Voila ✨

Mission Statement

CrackStation aids as an educational/informational tool in understanding the importance of salted hashes. Using unsalted hashes is very insecure as they can be cracked easily. The tool exposes a public API that can be used to play around and realize how unsalted passwords can be insecure and why it is necessary to salt hashes.

Installation

Swift Package Manager

The Swift Package Manager is "a tool for managing the distribution of Swift code. It's integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies."

Once you have your Swift package set up, add CrackStation to the list of dependencies in your Package.swift file:

dependencies: [
  .package(url: "[email protected]:subramanya1702/CrackStation.git", .upToNextMajorVersion(from: "1.1.0"))
]

Usage

The API

CrackStation has two public APIs.

a) An initializer to create an instance of CrackStation

init()

b) A decrypt function that takes in an unsalted SHA hash and gives back the cracked/actual password

decrypt(shaHash: String) -> String?

An Example

import CrackStation

public class yourClass: Decrypter {
  private let crackStationObject: Decrypter

  public init() {
    crackStationObject = CrackStation()
  }

  public func yourFunctionThatWantsThePassword() -> String {
    let crackedPassword = crackStationObject.decrypt(shaHash: "some_sha_hash")
    return crackedPassword
  }
}

Author

Subramanya Keshavamurthy