JSON Web Token

Swift implementation of JSON Web Token.

Installation

CocoaPods is the recommended installation method.

pod 'JSONWebToken'

Usage

import JWT

Encoding a claim

JWT.encode(["my": "payload"], .HS256("secret"))

Decoding a JWT

When decoding a JWT, you must supply one or more algorithms and keys.

JWT.decode("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e30.2_8pWJfyPup0YwOXK7g9Dn0cF1E3pdn299t4hSeJy5w", .HS256("secret"))

When the JWT may be signed with one out of many algorithms or keys:

JWT.decode("eyJh...5w", [.HS256("secret"), .HS256("secret2"), .HS512("secure")])

Supported claims

The library supports validating the following claims:

• Issuer (iss) Claim
• Expiration Time (exp) Claim
• Not Before (nbf) Claim
• Issued At (iat) Claim
• Audience (aud) Claim

Algorithms

This library supports the following algorithms:

• None - Unsecured JWTs
• HS256 - HMAC using SHA-256 hash algorithm (default)

Additional Algorithms

Support for HS384 and HS512 can be found in the algorithms-hs branch which depends on an unreleased version of CryptoSwift. It can be installed via:

pod 'JSONWebToken', :git => 'https://github.com/kylef/JSONWebToken.swift.git', :branch => 'algorithms-hs'
pod 'CryptoSwift', :head

License

JSONWebToken is licensed under the BSD license. See LICENSE for more info.