本文へ移動
Senu English

呼び出し元を認証する

約 4 分で読めます

Senu の認証は 1 つのトレイトです。リクエストのヘッダーを、サーバー側のプリンシパルに変えるか、何も返さないかを決めます。HTML ページと JSON API には、それぞれ別の認証器を付けます。

プリンシパルとは何ですか

Principal は、サーバーから見た「誰が呼んでいるか」です。ログ用の名前、テナント、権限の一覧を持ちます。リクエストがテナントや権限を運ぶことはできません。それらはプリンシパルの中にしかなく、プリンシパルを作るのはあなたの認証器だけです。

pub const VIEW_STOCK: Permission = Permission::new("view_stock");

pub const NORTH_CLERK: Principal =
    Principal::new("north-clerk", TenantId::from_static("north"), &[VIEW_STOCK]);

Principal::new は定数を作ります。サービスアカウント向けです。Principal::owned(name, tenant, permissions) は実行時に作ります。読み込んだばかりのユーザー向けです。保存してあるロールは、あなたのコードで権限の定数に対応づけます。Senu がリクエストからロール名を読むことはありません。

どの認証器が組み込まれていますか

どちらも Authorization ヘッダーがちょうど 1 つのときだけ受け付けます。2 つあれば、無いものとして扱います。秘密は、長さが同じなら定数時間で比較します。資格情報をログに書いたり、返したりしません。Secret は 1〜256 文字の可視 ASCII を持ち、表示すると Secret(<redacted>) になります。

認証器は、状態を組み立てるときに付けます。

    let state = AppState::builder(Inventory::sample())
        .html_auth(Basic::new(
            Secret::new("clerk").map_err(|err| err.to_string())?,
            secret("INVENTORY_WEB_PASSWORD")?,
            NORTH_CLERK,
        ))
        .api_auth(ApiKeys::new(vec![(
            secret("INVENTORY_API_KEY")?,
            NORTH_CLERK,
        )]))
        .build();

自分の認証器はどう書きますか

Authenticate を実装します。次の例は、独自のヘッダーから API キーを読みます。

impl Authenticate for ApiKeys {
    fn authenticate<'a>(&'a self, headers: &'a HeaderMap) -> AuthFuture<'a> {
        Box::pin(async move {
            // Exactly one header, as for `Authorization`.
            let mut values = headers.get_all("x-api-key").iter();
            let (Some(presented), None) = (values.next(), values.next()) else {
                return None;
            };
            // Compare with every key, so the time does not show which one
            // matched.
            let mut found = None;
            for (key, principal) in &self.0 {
                if key.matches(presented.as_bytes()) && found.is_none() {
                    found = Some(principal.clone());
                }
            }
            found
        })
    }

    fn challenge(&self) -> HeaderValue {
        HeaderValue::from_static("ApiKey realm=\"inventory\"")
    }
}

authenticate は非同期なので、データベースやキャッシュに問い合わせられます。渡されるのはヘッダーだけです。パス、クエリ文字列、ボディは渡されないので、URL に入った資格情報を誤って読むことがありません。challenge は、401 と一緒に送る WWW-Authenticate の値です。

本番でよくある形は、同じトレイトで書けます。

認証器がないとどうなりますか

表が拒否されます。html_auth のない HTML ルートや、api_auth のない API ルートがあると、into_router は RouteError::NoAuthenticator を返します。1 行書き忘れても、ルートが開いたままになることはありません。アセットと custom ルートは認証しません。認証が要る custom ハンドラーは、自分で認証します。

Senu は CSRF から守りますか

バージョン 0.2 には書き込み操作がないので、偽造されたリクエストが変えられるものがありません。読み取りにも注意は要ります。Senu は CORS ヘッダーを送らないので、別オリジンのスクリプトはレスポンスを読めません。すべてのレスポンスには Cache-Control: no-store が付きます。あとのバージョンで書き込み操作が入るときは、専用の規則と一緒に入ります。

公開前に何を確かめますか

  1. 秘密は環境変数かシークレットストアから読みます。長くランダムな値を、クライアントごとに変えます。
  2. TLS はルーターの手前で終端します。平文の HTTP はリダイレクトするか閉じます。
  3. 認証器は、ユーザー名が違うときもパスワードが違うときも同じ経路を通ります。資格情報をログに書きません。
  4. 各クライアントのプリンシパルには、必要な権限だけを持たせます。
  5. 契約テストが、あなたの表で通ります。

次のページ: 操作を MCP ツールとして公開する。