https://github.com/perfectsiderepos/perfectbcrypt
Swift Wrapper of bcrypt (BlowFish)
https://github.com/perfectsiderepos/perfectbcrypt
bcrypt perfect swift
Last synced: 6 days ago
JSON representation
Swift Wrapper of bcrypt (BlowFish)
- Host: GitHub
- URL: https://github.com/perfectsiderepos/perfectbcrypt
- Owner: PerfectSideRepos
- Created: 2017-10-18T15:13:42.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-05-24T16:17:51.000Z (over 3 years ago)
- Last Synced: 2023-09-03T16:30:29.142Z (over 2 years ago)
- Topics: bcrypt, perfect, swift
- Language: C
- Size: 30.3 KB
- Stars: 5
- Watchers: 2
- Forks: 13
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Perfect-BCrypt
## Acknowledgement
Perfect-BCrypt module is a Swift Wrapper of [bcrypt](https://github.com/pyca/bcrypt)
## Issues
We are transitioning to using JIRA for all bugs and support related issues, therefore the GitHub issues has been disabled.
If you find a mistake, bug, or any other helpful suggestion you'd like to make on the docs please head over to [http://jira.perfect.org:8080/servicedesk/customer/portal/1](http://jira.perfect.org:8080/servicedesk/customer/portal/1) and raise it.
A comprehensive list of open issues can be found at [http://jira.perfect.org:8080/projects/ISS/issues](http://jira.perfect.org:8080/projects/ISS/issues)
## Building
Add this project as a dependency in your Package.swift file.
```
.Package(url: "https://github.com/PerfectSideRepos/PerfectBCrypt.git", majorVersion: 3)
```
## Quick Start
### `BCrypt.Salt()`
Generate a "salt" string, for example, `let salt = BCrypt.Salt()` will return something like `$2b$12$yfG5ZTnTjg.HcgcI2o6Nhe`
### `BCrypt.Hash()`
Generate shadow by password and salt. For example:
``` swift
let password = "Kk4DQuMMfZL9o"
let salt = "$2b$04$cVWp4XaNU8a4v1uMRum2SO"
let hashed = try BCrypt.Hash(password, salt: salt)
// the hashed result will be:
// "$2b$04$cVWp4XaNU8a4v1uMRum2SO026BWLIoQMD/TXg5uZV.0P.uO8m3YEm"
```
### `BCrypt.Check()`
Verify a password if matches with the previously generated hash:
``` swift
guard BCrypt.Check(password, hashed: shadow)) else {
// Access Denied.
}
```
### `BCrypt.KDF()`
KDF is used in OpenSSH's newer encrypted private key format:
``` swift
let derived = try BCrypt.KDF("password", salt: "salt",
desiredKeyBytes: 32, rounds: 4, ignoreFewRounds: true)
// derived will be a 32 byte UInt8 array
// 0x5b, 0xbf, 0x0c, 0xc2, 0x93, 0x58, 0x7f, 0x1c,
// 0x36, 0x35, 0x55, 0x5c, 0x27, 0x79, 0x65, 0x98,
// 0xd4, 0x7e, 0x57, 0x90, 0x71, 0xbf, 0x42, 0x7e,
// 0x9d, 0x8f, 0xbe, 0x84, 0x2a, 0xba, 0x34, 0xd9
```
## Further Information
For more documentation, please visit [perfect.org](http://www.perfect.org/docs/crypto.html).