RBAC в Rust с Axum
В этом руководстве добавляется управление доступом на основе ролей (RBAC) к REST API, написанному на Rust с использованием Axum и casbin-rs. В итоге три роли (admin, editor, viewer) получают разные права на выполнение HTTP-методов для различных маршрутов, а правила хранятся в файле политики, который можно изменять без правки обработчиков.
Модель и политика такие же, как в версиях этого руководства для Go, Node.js, Python и Java.
1. Установка
cargo new rbac && cd rbac
cargo add casbin axum serde_json
cargo add tokio --features full
Это руководство было протестировано с casbin 2.20 и axum 0.8.
2. Написание модели
Сохраните следующий код как model.conf в корневой папке проекта:
[request_definition]
r = sub, obj, act
[policy_definition]
p = sub, obj, act
[role_definition]
g = _, _
[policy_effect]
e = some(where (p.eft == allow))
[matchers]
m = g(r.sub, p.sub) && keyMatch2(r.obj, p.obj) && regexMatch(r.act, p.act)
r = sub, obj, act: каждый запрос состоит из пользователя, пути URL и HTTP-метода.g = _, _: пользователям могут быть назначены роли.keyMatch2сопоставляет пути вида/api/articles/:id, аregexMatchпозволяет в одном правиле перечислить несколько методов. Другие встроенные матчеры см. в разделе Functions.
3. Напишите политику
Сохраните это как policy.csv:
p, admin, /api/*, (GET)|(POST)|(PUT)|(DELETE)
p, editor, /api/articles, (GET)|(POST)
p, editor, /api/articles/:id, (GET)|(PUT)
p, viewer, /api/articles, GET
p, viewer, /api/articles/:id, GET
g, alice, admin
g, bob, editor
g, carol, viewer
Строки, начинающиеся с p, предоставляют роли доступ к пути и набору методов. Строки, начинающиеся с g, назначают пользователей ролям.
4. Добавьте middleware
Enforcer разделяется между запросами как Arc<RwLock<Enforcer>>: проверки берут блокировку на чтение, поэтому выполняются параллельно, а изменения политики берут блокировку на запись. Middleware подключается через route_layer, поэтому он выполняется только для существующих маршрутов, а неизвестные пути по-прежнему возвращают 404.
use std::sync::Arc;
use axum::{
extract::{OriginalUri, Path, Request, State},
http::StatusCode,
middleware::{self, Next},
response::{IntoResponse, Response},
routing::get,
Json, Router,
};
use casbin::{CoreApi, Enforcer};
use serde_json::{json, Value};
use tokio::sync::RwLock;
type SharedEnforcer = Arc<RwLock<Enforcer>>;
/// Asks Casbin whether the current user may call this route.
async fn authorize(State(enforcer): State<SharedEnforcer>, req: Request, next: Next) -> Response {
// Replace this with the user from your session or JWT.
let user = req
.headers()
.get("x-user")
.and_then(|v| v.to_str().ok())
.unwrap_or("")
.to_string();
// Inside a nested router req.uri() has the /api prefix stripped, so use the original URI.
let path = match req.extensions().get::<OriginalUri>() {
Some(OriginalUri(uri)) => uri.path().to_string(),
None => req.uri().path().to_string(),
};
let method = req.method().as_str().to_string();
match enforcer.read().await.enforce((user, path, method)) {
Ok(true) => next.run(req).await,
Ok(false) => (StatusCode::FORBIDDEN, Json(json!({ "error": "forbidden" }))).into_response(),
Err(e) => (StatusCode::INTERNAL_SERVER_ERROR, Json(json!({ "error": e.to_string() }))).into_response(),
}
}
async fn list_articles() -> Json<Value> {
Json(json!({ "articles": [] }))
}
async fn create_article() -> (StatusCode, Json<Value>) {
(StatusCode::CREATED, Json(json!({ "created": true })))
}
async fn update_article(Path(id): Path<u32>) -> Json<Value> {
Json(json!({ "updated": id }))
}
async fn delete_article(Path(id): Path<u32>) -> Json<Value> {
Json(json!({ "deleted": id }))
}
#[tokio::main]
async fn main() {
let enforcer = Enforcer::new("model.conf", "policy.csv").await.unwrap();
let enforcer: SharedEnforcer = Arc::new(RwLock::new(enforcer));
let api = Router::new()
.route("/articles", get(list_articles).post(create_article))
.route("/articles/{id}", axum::routing::put(update_article).delete(delete_article))
.route_layer(middleware::from_fn_with_state(enforcer.clone(), authorize));
let app = Router::new().nest("/api", api).with_state(enforcer);
let listener = tokio::net::TcpListener::bind("0.0.0.0:8080").await.unwrap();
axum::serve(listener, app).await.unwrap();
}
Внутри роутера, добавленного через nest, у req.uri() удален префикс: запрос к /api/articles приходит как /articles, что не соответствует ни одному правилу политики. Поэтому middleware читает OriginalUri. Если ваш middleware отклоняет все запросы, проверьте, какой путь он передает в Casbin.
Заголовок X-User используется для краткости примера. Casbin отвечает только за авторизацию; в реальном приложении имя пользователя берется из вашего слоя аутентификации, например, из проверенного JWT.
5. Попробуйте это
cargo run
curl -i -X POST -H "X-User: bob" http://localhost:8080/api/articles # 201, editors can create
curl -i -X DELETE -H "X-User: bob" http://localhost:8080/api/articles/1 # 403, editors cannot delete
curl -i -X DELETE -H "X-User: alice" http://localhost:8080/api/articles/1 # 200, admins can
curl -i -X POST -H "X-User: carol" http://localhost:8080/api/articles # 403, viewers are read-only
6. Изменяйте роли во время выполнения
Роли и разрешения — это данные. Чтобы изменить их во время работы сервера, возьмите блокировку на запись:
use casbin::{MgmtApi, RbacApi};
let mut e = enforcer.write().await;
e.add_role_for_user("dave", "editor", None).await?; // dave becomes an editor
e.delete_role_for_user("bob", "editor", None).await?; // bob is no longer an editor
e.add_policy(vec!["editor".into(), "/api/comments".into(), "POST".into()]).await?;
e.get_roles_for_user("alice", None); // ["admin"]
Аргумент None — это домен; передайте Some("tenant1"), если вы используете RBAC with domains.
Следующие шаги
- Храните политику в базе данных. Замените
policy.csvадаптером, таким как sqlx-adapter или diesel-adapter (см. Adapters). Изменения политики, выполненные через API, будут сохраняться автоматически. - Готовые middleware. axum-casbin и плагины Actix перечислены в разде ле Middleware.
- Правила на основе атрибутов. Комбинируйте роли с ABAC, например, «редакторы могут обновлять только свои статьи». В статье Choosing an access control model показана комбинированная модель.
- Сервисы gRPC. Тот же принцип применим к gRPC: см. gRPC authorization, где используется Go, но концепция напрямую переносится на перехватчик tonic.
- Экспериментируйте в браузере. Вставьте модель и политику в online editor, чтобы тестировать запросы без запуска кода.
Comments are powered by giscus and GitHub Discussions. They load from giscus.app and GitHub only after you click the button below.