Add support for Axum framework (#32)

* add clerk authorizer

* refactor actix validator to use clerk authorizer

* add axum validator

* add axum example

* bump version

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "clerk-rs"
-version = "0.2.3"
+version = "0.3.0"
 authors = ["DarrenBaldwin07"]
 description = "An unofficial Rust SDK for the Clerk API"
 repository = "https://github.com/Cincinnati-Ventures/clerk-rs"
@@ -21,6 +21,10 @@ path = "examples/api.rs"
 name = "actix"
 path = "examples/actix.rs"
 
+[[example]]
+name = "axum"
+path = "examples/axum.rs"
+
 [lib]
 doctest = false
 
@@ -35,14 +39,19 @@ jsonwebtoken = "8.3.0"
 actix-web = "4.3.1"
 futures-util = "0.3.28"
 actix-rt = "2.9.0"
+axum = "0.7.5"
+axum-extra = { version = "0.9.3", features = ["cookie"] }
+tower = "0.4.13"
 
 [dependencies.reqwest]
 version = "^0.11"
 default-features = false
 features = ["json", "multipart"]
 
 [dev-dependencies]
+base64 = "0.22.1"
 clerk-rs = { path = "../clerk-rs" }
+openssl = "0.10.64"
 tokio = { version = "1.27.0", features = ["full"] }
 
 [features]

README.md

@@ -57,29 +57,48 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
 
 ```rust
 use actix_web::{web, App, HttpServer, Responder};
-use clerk_rs::{ClerkConfiguration, validators::actix::ClerkMiddleware};
+use clerk_rs::{validators::actix::ClerkMiddleware, ClerkConfiguration};
 
 async fn index() -> impl Responder {
     "Hello world!"
 }
 
 #[actix_web::main]
 async fn main() -> std::io::Result<()> {
-
     HttpServer::new(|| {
-        let config = ClerkConfiguration::new(None, None, Some("sk_test_key".to_string()), None);
-        App::new().service(
-            web::scope("/app")
-                .wrap(ClerkMiddleware::new(config, None, false))
-                .route("/index", web::get().to(index)),
-        )
+        let config = ClerkConfiguration::new(None, None, Some("your_secret_key".to_string()), None);
+        App::new()
+            .wrap(ClerkMiddleware::new(config, None, true))
+            .route("/index", web::get().to(index))
     })
     .bind(("127.0.0.1", 8080))?
     .run()
     .await
 }
 ```
 
+### Protecting a axum endpoint with Clerk.dev:
+
+```rust
+use axum::{routing::get, Router};
+use clerk_rs::validators::axum::ClerkLayer;
+use clerk_rs::ClerkConfiguration;
+use std::net::SocketAddr;
+
+async fn index() -> &'static str {
+    "Hello world!"
+}
+
+#[tokio::main]
+async fn main() -> std::io::Result<()> {
+    let config: ClerkConfiguration = ClerkConfiguration::new(None, None, Some("your_secret_key".to_string()), None);
+    let app = Router::new().route("/index", get(index)).layer(ClerkLayer::new(config, None, true));
+    let addr = SocketAddr::from(([0, 0, 0, 0], 8080));
+    let listener = tokio::net::TcpListener::bind(addr).await?;
+    axum::serve(listener, app).await
+}
+```
+
 ## Roadmap
 
 - [ ] Support other http clients along with the default reqwest client (like hyper)

examples/actix.rs

@@ -10,7 +10,7 @@ async fn main() -> std::io::Result<()> {
 	HttpServer::new(|| {
 		let config = ClerkConfiguration::new(None, None, Some("your_secret_key".to_string()), None);
 		App::new()
-			.wrap(ClerkMiddleware::new(config, None, false))
+			.wrap(ClerkMiddleware::new(config, None, true))
 			.route("/index", web::get().to(index))
 	})
 	.bind(("127.0.0.1", 8080))?

examples/axum.rs

@@ -0,0 +1,17 @@
+use axum::{routing::get, Router};
+use clerk_rs::validators::axum::ClerkLayer;
+use clerk_rs::ClerkConfiguration;
+use std::net::SocketAddr;
+
+async fn index() -> &'static str {
+	"Hello world!"
+}
+
+#[tokio::main]
+async fn main() -> std::io::Result<()> {
+	let config: ClerkConfiguration = ClerkConfiguration::new(None, None, Some("your_secret_key".to_string()), None);
+	let app = Router::new().route("/index", get(index)).layer(ClerkLayer::new(config, None, true));
+	let addr = SocketAddr::from(([0, 0, 0, 0], 8080));
+	let listener = tokio::net::TcpListener::bind(addr).await?;
+	axum::serve(listener, app).await
+}

src/clerk.rs

@@ -28,6 +28,7 @@ pub const USER_AGENT: &str = concat!("Clerk/v1 RustBindings/", env!("CARGO_PKG_V
  *
  * NOTE: This SDK is based on the official clerk openAPI spec found here: https://clerk.com/docs/reference/backend-api
  */
+#[derive(Clone)]
 pub struct Clerk {
 	pub config: configuration::ClerkConfiguration,
 }

src/models/email_address_verification.rs

@@ -49,7 +49,7 @@ pub enum Strategy {
 	#[serde(rename = "admin")]
 	Admin,
 	#[serde(other)]
-	Other
+	Other,
 }
 
 impl Default for Strategy {
@@ -115,4 +115,4 @@ mod tests {
 		// Assert that the deserialized object matches the expected object
 		assert_eq!(deserialized, expected);
 	}
-}
+}