APIKeyMiddleware
Swift package for adding API Key requirement to vapor backends.
Features
-
✅ Supports an array of keys -
✅ Supports overriding thrown errors -
✅ 100% Test Coverage
Usage
Requests are expected to have the header api-key.
Simple
public func configure(_ app: Application) throws {
app.middleware.use(APIKeyMiddleware(keys: ["123"]))
}
See Vapor Docs if wanting to add to individual routes.
Override Errors
The following errors are used by default:
- Missing API key:
Abort(.badRequest, reason: "Missing api-key.") - Unauthorized API Key:
Abort(.unauthorized, reason: "Unauthorized api-key.")
To override these errors, assign a delegate to the APIKeyMiddleware. Returning nil uses defaults.
class Delegate: APIKeyMiddlewareDelegate {
static let shared = Delegate()
init() {}
func errorForMissingKey(in middleware: APIKeyMiddleware) -> Error? {
Abort(.imATeapot, reason: "Missing api-key was found by teapot.")
}
func errorForUnauthorizedKey(in middleware: APIKeyMiddleware) -> Error? {
Abort(.imATeapot, reason: "Unauthorized api-key was found by teapot.")
}
}
public func configure(_ app: Application) throws {
let middleware = APIKeyMiddleware(keys: ["123"], delegate: Delegate.shared)
app.middleware.use(middleware)
}
Installation
SPM
Add the following to your project:
https://github.com/ptrkstr/APIKeyMiddleware
Possible Future Features
Raise an issue if you need these
- Allow overriding API-Key header name
13.9k Jan 6, 2023
0 Jan 26, 2022
401 Dec 29, 2022
4 Aug 7, 2021
9 Oct 1, 2022
217 Dec 27, 2022
0 Dec 24, 2021
745 Jan 3, 2023
35 Mar 29, 2019
1 Apr 21, 2022
19 Sep 8, 2022
12 Dec 20, 2022
1.3k Dec 26, 2022
45 Sep 8, 2022
0 Nov 3, 2021
0 Jan 8, 2022
4 Apr 9, 2022
2 Aug 7, 2022
3 Dec 30, 2022