Swift JWE
Swift JWE is a Swift package that provides a convenient way to encrypt and decrypt data using JSON Web Encryption (JWE) RFC7516.
Supported Key Management Algorithms
The package supports the following key management algorithms:
ECDH-ESECDH-ES+A128KWECDH-ES+A192KWECDH-ES+A256KWECDH-1PUdraft-madden-jose-ecdh-1pu-04
Supported Content Encryption Algorithms
The package supports the following content encryption algorithms:
A128GCMA192GCMA256GCM
Supported Elliptic Curves
The package supports the following elliptic curves:
P-256P-384P-521X25519X448secp256k1RFC8812 Section 3.1
Usage
To use Swift JWE, follow these simple steps:
- Load / Generate the recipient's key pair.
- Create a
JWEinstance with the appropriate protected header. - Use the
encryptmethod to encrypt the plaintext using the recipient's public key. - Send the compact serialization of the JWE to the recipient.
- Use the
decryptmethod to decrypt the ciphertext using the recipient's private key.
Here's an example:
// Generate recipient key pair
let recipientPrivateKey = Curve25519.KeyAgreement.PrivateKey()
let recipientPublicKey = recipientPrivateKey.publicKey
// Encrypt plaintext using JWE
let plaintext = "Hello, World!".data(using: .utf8)!
var jwe = JWE(
protectedHeader: .init(
alg: .ecdhESA256KW,
enc: .a256GCM,
zip: .deflate
)
)
try jwe.encrypt(
plaintext: plaintext,
to: recipientPublicKey.jwkRepresentation
)
let compactSerialization = jwe.compactSerialization
// Sender sends JWE compact serialization to recipient...
// ...
// Decrypt ciphertext
let receivedJWE = try JWE(compactSerialization: compactSerialization)
let receivedPlaintext = try receivedJWE.decrypt(
using: recipientPrivateKey.jwkRepresentation
)For more information on how to use Swift JWE, please refer to the documentation.