tower-sessions-dynamodb-store

AWS DynamoDB后端的tower-sessions

概述

此创建提供了tower-session会话管理crate的AWS DynamoDB后端，使用Rust AWS-SDK。

用法

设置一个DynamoDBStore需要两个参数

• 一个aws_sdk_dynamodb::Client实例，用于连接到AWS DynamoDB服务。
• 一个DynamoDBStoreProps实例，以告诉会话存储在哪里在dynamo中查找/保存内容。

aws_sdk_dynamodb::客户端

设置aws_sdk_dynamodb::Client有很多可能性，但所有这些都需要一个aws_config::Config实例。如何获取一个aws_sdk_dynamodb::Client实例的最基本示例可以在aws_config rustdocs中找到，以及许多其他示例

use aws_config;
use aws_sdk_dynamodb;
let config = aws_config::load_defaults(aws_config::BehaviorVersion::v2023_11_09()).await;
let client = aws_sdk_dynamodb::Client::new(&config);

DynamoDBStoreProps

DynamoDBStoreProps实现了Default trait，因此可以使用DynamoDBStoreProps::default()获取一个假设DynamoDB表和属性名称的实例，但它更可能需要重写这些设置中的一个或多个；一个更复杂的示例

let store_props = DynamoDBStoreProps {
    table_name: "MyTowerSessions".to_string(),
    sort_key: Some(DynamoDBStoreKey {
        name: "sort_key".to_string(),
        prefix: Some("TOWER_SESSIONS::".to_string()),
        suffix: None,
    }),
    ..Default::default()
};

将创建一个存储属性实例

• 使用名为MyTowerSession的DynamoDB表。
• 使用默认的partition_key名称session_id，并在将其插入到session_id分区键属性之前，在所有tower会话ID前添加前缀SESSIONS::TOWER::
• 使用定义的具有相同名称的 sort_key，在插入到 sort_key 范围键属性之前，将 TOWER_SESSIONS:: 的前缀添加到 session_id。
• 使用 expire_at 的默认 expirey_name 属性名称来存储 tower-sessions 会话将过期时的 Unix 时间戳。
• 使用 data 的默认 data_name 属性名称来存储 tower-sessions 键值会话数据的二进制序列化。

use axum::{response::IntoResponse, routing::get, Router};
use time::Duration;
use tower_sessions::{Expiry, SessionManagerLayer};
use tower_sessions_dynamodb_store::DynamoDBStore;

let session_store = DynamoDBStore::new(client, store_props);
let session_layer = SessionManagerLayer::new(session_store)
    .with_secure(false) // only for local testing !!
    .with_expiry(Expiry::OnInactivity(Duration::seconds(10)));

let app = Router::new().route("/", get(handler)).layer(session_layer);

docker compose up dynamodb_store
cargo run --example counter

aws cloudformation create-stack --stack-name ExampleTowerSessionsStack --template-body file:///$PWD/examples/example-table-cfn.yml

cargo fmt --all --check

cargo clippy --workspace --all-targets --all-features -- -D warnings

RUSTDOCFLAGS="-D rustdoc::broken-intra-doc-links" cargo doc --all-features --no-deps