AES256CBC Encryption for Swift 2, 3 & 4
The most convenient & lightweight AES256 Encryption Framework for Swift 3 & 4 which even works under Linux. For Swift 2 use tag 0.1.1.
Unique Feature Set
- Just a single file in pure Swift 2, 3 & 4 source code
- Runs natively on iOS, macOS, tvOS & watchOS & Linux
- No additional dependencies or header files
- Maximum convenience for encrypting / decrypting of strings
- Built-in generating of compatible 32 character password
- Automatic string padding
- Automatic handling & embedding of a random initialisation vector
Please follow SwiftyBeaver on Twitter to stay up-to-date on new versions.
- iOS 8.0+, macOS X 10.9+, tvOS 9+, watchOS 2+, Linux, Docker
- Xcode 7+
You can use Carthage to install AES256CBC by adding that to your Cartfile:
To use CocoaPods just add this to your Podfile:
via Swift Package Manager
To use AES256CBC as a Swift Package Manager package just add the following to your Package.swift file’s dependencies.
- Download the latest release zip from here
- Drag & drop the
/sourcesfolder into your project (make sure "Copy items if needed" is checked)
- Rename the "sources" group to "AES256CBC" if you'd like
Note: You don't have to
import AES256CBC if you install this way.
Example which encrypts and decrypts a string using a randomly generated 32 character password. In real-life you would add your own 32 character password instead.
import AES256CBC let str = "My little secret" let password = AES256CBC.generatePassword() // returns random 32 char string // get AES-256 CBC encrypted string let encrypted = AES256CBC.encryptString(str, password: password) // decrypt AES-256 CBC encrypted string let decrypted = AES256CBC.decryptString(encrypted!, password: password)
Run on Ubuntu with Docker
We ❤️ server-side Swift 3 & 4 AES256CBC works under Linux. For Docker you can use the included Dockerfile or simple run
test_in_docker.sh which will create a self-removing docker container and runs test in them.
Why do I get nil as result?
If anything goes wrong, most likely due to a password which is not 32 characters long, then
decryptString() return nil.
What about the initial vector?
You don’t need to worry about the important initial vector which is required to make AES-256 much more secure. AES256CBC automatically generates a random initial vector for you and adds it to the start of the encrypted string. During decryption AES256CBC reads the first 16 characters of the encrypted string and uses them as initial vector to decrypt the remaining encrypted string.
Where is it used?
Contact & Contribute
If you have questions please contact Sebastian via the dedicated SwiftyBeaver Twitter account. Feature requests or bugs are better reported and discussed as Github Issue.
Please contribute back any great stuff, especially bugfixes & security issues! Each new bugfix, feature request or addition/change should be put in a dedicated pull request to simplify discussion and merging.
Thanks for testing, sharing, staring & contributing!
AES256CBC is released under the MIT License. The core crypto logic is a tailored version of CryptoSwift written by Marcin Krzyżanowski, please read & respect his license which can be found in the middle of the file AES256CBC.swift, too.