「会社のメールアドレスで登録すれば、自動的に同じチームに入る」。on-board typingのこの仕組みは、説明すると一行で終わります。でも実装してみると、素朴に作ると壊れる場面がありました。

素朴に作ると、会社が2つできる

「このドメインの会社がもうあるか確かめる → なければ作る → ユーザーをその会社に入れる」という手順を、画面側から順番に API を呼んで作ったとします。

同じ会社の2人が、ほぼ同時に初めて登録したらどうなるか。2人とも「まだ会社はない」と確かめた直後に、それぞれが新しい会社を作ってしまいます。同じ会社のはずの2人が、別々のチームに分かれます。

これは TOCTOU(Time-of-Check to Time-of-Use:確かめた時点と使う時点の間に、別の処理が割り込める状態)と呼ばれる、よくある落とし穴です。間に割り込む隙がある限り、いつか必ず起きます。

確かめるところから作るところまで、1つの関数に閉じ込める

対策として、確かめる処理と作る処理を画面側で分けるのをやめました。`register_with_domain` という SECURITY DEFINER 関数の中で、確認・作成・紐付けまでを1つのトランザクションとして実行します。データベースの中でまとめて処理されるので、途中に別のリクエストが入り込む隙がなくなります。画面側は、この関数を呼んで結果を受け取るだけです。

SECURITY DEFINER 関数を書くときは、`search_path` を `public` に固定することも必ずやっています。これを忘れると、呼び出す側が `search_path` を細工して、意図しない表や関数を参照させられる、という既知の脆弱性になります。Supabase のセキュリティアドバイザーもこれを警告してくれるので、新しい関数を書くたびに確かめています。

会社の ID を受け取る関数は、もっと慎重に

もうひとつ見落としやすいのが、標準の権限です。PostgREST は public スキーマの関数を、そのまま外から呼べる API として公開します。PostgreSQL は、関数の実行権限を標準ですべてのロール(ログインしていない人を含む)に与えます。

つまり、`company_id` のように会社をまたぐ値を受け取る内部用の関数を何も考えずに書くと、誰でも他社の ID を指定して呼べる状態になりかねません。こうした関数には `REVOKE EXECUTE ... FROM PUBLIC, anon, authenticated` を明示して、意図した経路以外からは呼べないようにしています。

会社メールで登録するだけ、という簡単さを成り立たせるために、見えないところでは競合状態と権限の両方を潰しておく必要がありました。派手さはありませんが、ここが崩れると会社ごとにデータを分けている意味がなくなるので、一番気を抜けないところです。