Latest 1.3.1
Homepage https://github.com/SwiftyBeaver/AES256CBC
License MIT
Platforms ios 8.0, watchos 2.0, tvos 9.0, osx 10.9
Authors

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.

Language Swift 3 & 4 CircleCI Slack Status

—-

## Unique Feature Set

1. Just **a single file** in pure Swift 2, 3 & 4 source code
2. Runs **natively** on iOS, macOS, tvOS & watchOS & **Linux**
3. No additional dependencies or header files
4. Maximum **convenience** for encrypting / decrypting of strings
5. Built-in generating of compatible 32 character password
6. Automatic string padding
6. Automatic handling & embedding of a **random initialisation vector**

Please **follow [SwiftyBeaver on Twitter](https://twitter.com/SwiftyBeaver)** to stay up-to-date on new versions.

## Requirements

– iOS 8.0+, macOS X 10.9+, tvOS 9+, watchOS 2+, Linux, Docker
– Xcode 7+

## Installation

#### via Carthage

You can use [Carthage](https://github.com/Carthage/Carthage) to install AES256CBC by adding that to your Cartfile:

“` swift
github “SwiftyBeaver/AES256CBC”
“`

#### via CocoaPods

To use [CocoaPods](https://cocoapods.org) just add this to your Podfile:

“` swift
pod ‘AES256CBC’
“`

#### via Swift Package Manager

To use AES256CBC as a [Swift Package Manager](https://swift.org/package-manager/) package just add the following to your Package.swift file’s dependencies.

“` swift
.Package(url: “https://github.com/SwiftyBeaver/AES256CBC.git”)
“`

#### or Download

1. Download the latest release zip from [here](https://github.com/SwiftyBeaver/AES256CBC/releases)
2. Drag & drop the `/sources` folder into your project (make sure “Copy items if needed” is checked)
3. Rename the “sources” group to “AES256CBC” if you’d like

Note: You don’t have to `import AES256CBC` if you install this way.

## Usage

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.

“` swift
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.

## FAQs

### Why do I get nil as result?
If anything goes wrong, most likely due to a password which is not 32 characters long, then `encryptString()` and `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?

The framework is used in multiple projects of [SwiftyBeaver](https://github.com/SwiftyBeaver) and was developed in cooperation with Marcin Krzyżanowski from [CryptoSwift](https://github.com/krzyzanowskim/CryptoSwift).

## Contact & Contribute

If you have questions please contact Sebastian via the dedicated [SwiftyBeaver Twitter account](https://twitter.com/SwiftyBeaver). 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!

## License

AES256CBC is released under the [MIT License](https://github.com/SwiftyBeaver/AES256CBC/blob/master/LICENSE). The core crypto logic is a tailored version of [CryptoSwift](https://github.com/krzyzanowskim/CryptoSwift) written by Marcin Krzyżanowski, please read & respect his license which can be found in the middle of the file [AES256CBC.swift](https://github.com/SwiftyBeaver/AES256CBC/blob/master/sources/AES256CBC.swift), too.

Latest podspec

{
    "name": "AES256CBC",
    "version": "1.3.1",
    "summary": "Most convenient AES256-CBC encryption for Swift 2, 3 & 4",
    "description": "AES256 is the most convenient, simple & leightweight Swift 2 & 3 framework to encrypt & decrypt a string with AES256-CBC encryption. Tag 1.x.x is using Swift 3 and tag 0.1.1 is using Swift 2. The project is actively maintained by SwiftyBeaver (Twitter: @SwiftyBeaver).",
    "homepage": "https://github.com/SwiftyBeaver/AES256CBC",
    "license": "MIT",
    "authors": {
        "Sebastian Kreutzberger": "[email protected]"
    },
    "platforms": {
        "ios": "8.0",
        "watchos": "2.0",
        "tvos": "9.0",
        "osx": "10.9"
    },
    "source": {
        "git": "https://github.com/SwiftyBeaver/AES256CBC.git",
        "tag": "1.3.1"
    },
    "source_files": "sources",
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This