👋

「actix-web」入門#5 セッション管理v2「actix_redis」

2022/06/06に公開

Rust

Web

actix

tech

初めに

セッションについては前回話しました。
しかし、actix-webの「actix-session」はCookieセッションとイコールであることが判明したので独自セッションが必要であると解説しました。
※Cookieセッションのみの世界線だとセッション（アカウント）乗っ取りし放題なので…

そこで詳しく確認してみると「actix-redis::RedisSession」がセッションとイコールであることがわかりました。

今回はredisを使った「actix-redis」を紹介します。

以下の説明をしていきます。

redisの概念
「actix-redis」の解説
「actix-redis」の具体例

1 redisの概念

redisはメモリ管理サービスです。
シンプルにメモリ内の変数を管理するサービスと考えて差し支えないと思います。

redisは、メモリで管理する変数の使用期限を決められるのでセッションタイムアウトの概念と一致する感じがします。

redisの特殊な機能として、ポートを開放して、slaveを作ることでメモリ情報をほかのユーザからも確認できる状態になります。いわゆる簡易データベース（メモリ上のものなので永続的でない）です。
※このredisのslave（奴隷）ってやつ個人的に命名しなおしてほしい…

redisのインストールはwslを使います。
※以前触ったときはwindows用のインストーラあったのになくなってて焦った(;^_^A

2 「actix-redis」の解説

今回は以下のexampleを解説します。

ソース確認

フォルダ構成はこんな感じ

ざっくりmain.rsだけ説明します。
ソースはこんな感じです。

main.rs

//! Example of login and logout using redis-based sessions
//!
//! Every request gets a session, corresponding to a cache entry and cookie.
//! At login, the session key changes and session state in cache re-assigns.
//! At logout, session state in cache is removed and cookie is invalidated.
//!
use actix_redis::RedisSession;
use actix_session::Session;
use actix_web::{
    middleware, web,
    web::{get, post, resource},
    App, HttpResponse, HttpServer, Result,
};
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize, Debug, PartialEq)]
pub struct IndexResponse {
    user_id: Option<String>,
    counter: i32,
}

async fn index(session: Session) -> Result<HttpResponse> {
    ...
}

async fn do_something(session: Session) -> Result<HttpResponse> {
    ...
}

#[derive(Deserialize)]
struct Identity {
    user_id: String,
}

async fn login(user_id: web::Json<Identity>, session: Session) -> Result<HttpResponse> {
    ...
}

async fn logout(session: Session) -> Result<String> {
    ...
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    ...
}

#[cfg(test)]
mod test {
    ...
    #[actix_web::test]
    async fn test_workflow() {
	...
    }
}

リクエストを行うための関数として「index」「do_something」「login」「logout」があります。
各リクエスト処理はcfg(test)を使ってお試しのために作成されているようです。

test_workflowは以下の通りです。

indexに「GET」処理を送ってcookieセッションを取得。
do_somethingにテスト的に「POST」処理を送ってcounterってcookie情報を0→1にする。
do_somethingにテスト的に「POST」処理を送ってcounterってcookie情報を1→2にする。なお、このときのクッキー情報を「cookie_1」とする。
loginに「POST」処理を送ってuser_id「ferris」でセッション開始する。なお、このときのクッキー情報を「cookie_2」とする。
indexに「GET」処理を送ってcookieセッション「cookie_2」を再取得（ユーザ情報を確認）。
クッキー情報「cookie_2」でdo_somethingにテスト的に「POST」処理を送ってcounterってcookie情報を2→3にする。
indexに「GET」処理を送ってcookieセッション「cookie_1」を再取得（ユーザ情報がないのを確認）。
クッキー情報を「cookie_2」でlogoutに「POST」処理を送ってログアウトする。
indexに「GET」処理を送ってcookieセッション「cookie_2」を再取得（ユーザ情報がないのを確認）。

上記のテストではマクロ「assert_eq」と「assert_ne」を使って、逐一counter、user_id合ってるかっていうのを確認しているようです。