ライブラリ依存の認証コードを全削除し、Web標準APIで再構築した記録

著者: ClaudeMix Team |

当時実装され、その後完全に撤去された認証機能について、サードパーティ製ライブラリへのパッチが積み重なったコードを全削除し、Web標準API(Request/Response/Cookie/Crypto)のみで再実装した記録である(現在のClaudeMixにアカウント・認証の概念は存在しない)。

① やったこと

Before: 認証ライブラリを導入していたが、Cloudflare Workers(エッジ)環境ではNode.js前提のAPIを呼び出す内部実装がそのままでは動かず、デプロイのたびにエラーが発生していた。

Error: isSession is not a function
    at ... (node_modules/remix-auth/...)

エラーを消すためのポリフィル・依存バージョン固定・型定義のパッチが、数十のファイルに積み重なっていった。

After: パッチを含む差分をすべて削除し、ライブラリを使わずWeb Crypto APIでCookieの署名・検証を行う実装に置き換えた。

// app/data-io/session/cookie.server.ts(再実装後、抜粋)
export async function sign(value: string, secret: string): Promise<string> {
  const key = await crypto.subtle.importKey(
    'raw',
    new TextEncoder().encode(secret),
    { name: 'HMAC', hash: 'SHA-256' },
    false,
    ['sign']
  );
  const signature = await crypto.subtle.sign('HMAC', key, new TextEncoder().encode(value));
  return `${value}.${btoa(String.fromCharCode(...new Uint8Array(signature)))}`;
}

セッションデータ自体はCloudflare Workers KVに保存し、ブラウザにはセッションIDのみを署名付きCookieとして持たせる構成にした。

② 設計判断

  • 【優先した価値】: ライブラリのバージョンアップに追従し続けるコストではなく、10年単位で変わらないWeb標準API(HTTP・Cookie・Crypto)を基盤に据える安定性
  • 【犠牲にした価値】: ライブラリが提供していた高レベルなヘルパー(CSRF対策など)と、ライブラリの実装が受けていた第三者によるセキュリティレビューの実績。以後の安全性の担保は自前実装の範囲でしか持てなくなった

③ 技術的負債

  • 【解消した負債】: パッチが積み重なっていた数十ファイルにわたる差分。ライブラリの依存関係とそのアップデートに追従するメンテナンスコストがゼロになった
  • 【新たに生まれた負債】: 認証まわりのセキュリティレビューを自前で継続的に行う責任が生まれた。ライブラリが担っていた第三者監査に相当する仕組みは、この再実装には存在しない

④ 経営翻訳

外部の警備会社に建物の入退室管理を委託していたが、委託先のシステムがこの建物の構造と噛み合わず、警備員が現場でその場しのぎの応急処置を繰り返していた状況に相当する。委託契約を打ち切り、汎用的な鍵と台帳だけで自社管理の入退室体制を組み直すことにした。

「動いているコードを全削除して再実装する」という判断は、この認証基盤の再構築だけではない。StripeエージェントがSSoT違反のコードを実装し、Claude Codeが監査で検出した事件でも同じ「引き算の意思決定」パターンが登場する。また、Cloudflare WorkersでのD1・KVを含む全インフラの設計にも「外部状態への依存ゼロ」という同じ思想がある。