Cipher Algorithms

Ciphers allow you to encrypt plaintext data with a key yielding ciphertext. This ciphertext can be later decrypted by the same cipher using the same key.

Read more about ciphers on Wikipedia.

Encrypt

Use the global convenience variables for encrypting data with common algorithms.

let ciphertext = try AES128.encrypt("vapor", key: "secret")
print(ciphertext) /// Data

Decrypt

Decryption works very similarly to encryption. The following snippet shows how to decrypt the ciphertext from our previous example.

let plaintext = try AES128.decrypt(ciphertext, key: "secret")
print(plaintext) /// "vapor"

See the Crypto module’s global variables for a list of all available cipher algorithms.

Streaming

Both encryption and decryption can work in a streaming mode that allows data to be chunked. This is useful for controlling memory usage while encrypting large amounts of data.

let key: Data // 16-bytes
let aes128 = Cipher(algorithm: .aes128ecb)
try aes128.reset(key: key, mode: .encrypt)
var buffer = Data()
try aes128.update(data: "hello", into: &buffer)
try aes128.update(data: "world", into: &buffer)
try aes128.finish(into: &buffer)
print(buffer) // Completed ciphertext