UnlockOS Developers
← 記事一覧に戻る
🔐

デフォルトで最小権限:RLS・監査整合性・スコープ付きトークン

2026年11月2日→2026年11月8日
9 分
175 commits
深度 8/10
securitypostgres-rlsaudit-loggingtypescripttesting

はじめに

スマートロックプラットフォームとは、ソフトウェアのバグが物理的な結果に直結するシステムです。鍵の漏洩、過度に広いデータベースポリシー、本番環境に残されたテスト用バイパス——これらは単にレコードを壊すだけでなく、「ドアを開けてしまう」のです。

本記事では、UnlockOS SDK の直近の開発サイクルで適用した一連のハードニングパターンを紹介します。row-level security(行レベルセキュリティ)の厳格化、監査ログの改ざん検知可能化、サードパーティ資格情報の暗号化、単一機能へのトークンのスコープ限定、そしてセキュリティ関連テストが実際に実行されていることを CI で強制する仕組みです。実装の詳細は一般化可能であり、以下のパターンはすべて、Postgres と edge functions の上に構築されたあらゆるマルチテナントシステムに当てはまります。

1. 認可はクライアントではなくデータベースに押し込む

最も脆弱な認可モデルは、アプリケーションコードの中にしか存在しないものです。クライアントがデータベースと直接対話できるキーを持っているなら、ガードし忘れたすべての select がデータ漏洩になります。

私たちが収束したベースラインのルールはこうです。anonymous および authenticated のクライアントロールには、本当に公開してよいものへの読み取りアクセスのみを与える。それ以外はすべて特権を持つサーバーロールが書き込む。

-- Anonymous clients must never write shared rows directly.
revoke insert, update, delete on public.guest_users from anon;
revoke all on public.integration_credentials from anon, authenticated;
-- Public, read-only surface stays explicitly enumerated.
grant select on public.facility_public_view to anon;

共有の「ゲストモード」行は、リクエスト自体を検証したうえで、service role で動作する edge function が作成します。クライアントが悪用できる書き込み経路は一切与えられず、不変条件はサーバーが所有します。

同じ原則をカレンダーフィードの設定にも適用しました。ical_feeds へのクライアント書き込みは完全に閉じています。フィード URL は事実上、物件の稼働スケジュールに対する長命な読み取りトークンだからです。

2. RLS ポリシーは単純ケースではなく実際の所有関係をモデル化する

マルチテナントシステムで繰り返し現れるバグのクラスがあります。シングルテナントのユーザーでは動作するが、マルチテナントのユーザーでは静かに壊れる——あるいは静かに権限を過剰に与えてしまうポリシーです。

私たちは、複数の施設を所有するオペレーターでこの問題に遭遇しました。単一のメンバーシップ行を選んで「オーナー」を解決するポリシーは、そのオーナーの2つ目の施設での編集を拒否してしまいました。修正方法は、ポリシーをスカラー検索ではなく集合メンバーシップのテストにすることです。

create policy checkin_config_owner_write
  on public.checkin_configs
  for all
  to authenticated
  using (
    exists (
      select 1
      from public.facility_members fm
      where fm.facility_id = checkin_configs.facility_id
        and fm.user_id = auth.uid()
        and fm.role = 'owner'
    )
  )
  with check (
    exists (
      select 1
      from public.facility_members fm
      where fm.facility_id = checkin_configs.facility_id
        and fm.user_id = auth.uid()
        and fm.role = 'owner'
    )
  );

ここで重要な点が2つあります。

  • using だけでなく、必ず with check も書くこと。 using は閲覧・変更できる行をフィルタします。with check は結果として生じる行を検証します。これがないと、ユーザーは自分が所有する行を、自分が所有しない行へと更新できてしまいます——テナント跨ぎの書き込みです。
  • 一対多の関係をスカラーに潰さないこと。 exists (...) は複数施設のオーナーにもスケールしますが、= (select facility_id ... limit 1) はスケールしません。

チェックイン設定におけるドアの割り当て——文字通りゲストがどのロックを開けられるかを決めるフィールド——は、一般的な編集権限よりもさらに狭く、オーナー限定に絞りました。権限の粒度は、テーブルの境界ではなくブラストラジアス(影響範囲)に従うべきです。

3. 監査ログを誰にも静かに編集できないものにする

アプリケーションが書き換えられる監査ログは、証拠として提示できないログです。設計上作り込む価値のある性質が3つあります。

  1. クライアントは直接読めない。 読み取りは独自の認可を適用しフィールドを伏せられる edge function を経由します。audit_logs への直接の select は revoke します。
  2. 書き込めるのはトリガーだけ。 監査テーブルに insert を持つアプリケーションロールは存在せず、行は記述対象の変更の副作用として現れます。
  3. 対象を削除しても履歴は消えない。
revoke select, insert, update, delete on public.feature_flag_audit_log
  from anon, authenticated;
create policy audit_insert_trigger_only
  on public.feature_flag_audit_log
  for insert
  to public
  with check (pg_trigger_depth() > 0);
create or replace function public.log_feature_flag_change()
returns trigger
language plpgsql
security definer
set search_path = public
as $$
begin
  insert into feature_flag_audit_log (flag_key, actor_id, before_value, after_value, action)
  values (
    coalesce(new.key, old.key),
    auth.uid(),
    to_jsonb(old),
    to_jsonb(new),
    tg_op
  );
  return coalesce(new, old);
end;
$$;

pg_trigger_depth() > 0 のチェックは安価で強力な保証です。トリガー実行の外側からテーブルに到達した insert は拒否されます。search_path を固定した security definer 関数は search-path ハイジャック——Postgres における古典的な権限昇格ベクター——を防ぎます。

履歴の保持のためには、監査行が記述対象のエンティティへのカスケード外部キーを持ってはいけません。キーは素の値として保存し、feature flag を削除してもその変更履歴が残るようにします。

拒否もまた監査する

ほとんどのシステムは成功したものを記録します。興味深いセキュリティシグナルは失敗したものです。私たちは、無効な署名・古いタイムスタンプ・不正な資格情報によって拒否された webhook リクエストにも監査の対象を広げました。

type WebhookRejection = 'invalid_signature' | 'stale_timestamp' | 'bad_credentials';
async function verifyWebhook(req: Request): Promise<Result<Payload, WebhookRejection>> {
  const signature = req.headers.get('x-signature');
  const timestamp = Number(req.headers.get('x-timestamp') ?? 0);
  const body = await req.text();
  if (Math.abs(Date.now() / 1000 - timestamp) > 300) {
    await recordAudit({ action: 'webhook.rejected', reason: 'stale_timestamp', source: req.url });
    return { ok: false, error: 'stale_timestamp' };
  }
  if (!signature || !timingSafeEqual(signature, sign(body, timestamp))) {
    await recordAudit({ action: 'webhook.rejected', reason: 'invalid_signature', source: req.url });
    return { ok: false, error: 'invalid_signature' };
  }
  return { ok: true, value: JSON.parse(body) as Payload };
}

invalid_signature による拒否のバーストは攻撃の兆候です。成功だけを記録していると、それは見えません。

4. シークレット:保存時に暗号化し、サーバー側でリフレッシュし、サプライチェーンを固定する

サードパーティ連携の資格情報(PMS システム、決済プロバイダ、ロックベンダーの API)は価値の高い標的です。重要だった変更は3つあります。

  • 保存時に暗号化し、クライアントには絶対に露出しない。 クライアントが目にするのは接続ステータスであって、キーではありません。キーを再入力する必要がある場合、UI はそれを write-only として扱います。
  • リフレッシュトークンはサーバー側のみで扱う。 ブラウザで実行されるリフレッシュフローは、リフレッシュトークンがブラウザにあることを意味します。これを edge function の背後へ移す——即座にロールバックできるよう feature flag の背後にリリースする——ことで、露出のクラスを丸ごと排除できました。
  • サードパーティモジュールのバージョンを固定する。 浮動バージョン指定子で CDN からインポートする edge function はサプライチェーン上の危険要因です。侵害された、あるいは単に壊れた上流リリースが、デプロイなしに本番へ到達します。どこでも厳密に1つのバージョンを固定し、意図的にアップグレードしましょう。
// Bad: floating version, resolved at cold start.
import { createClient } from 'https://esm.sh/@supabase/supabase-js@2';
// Good: one exact version, reviewed on upgrade.
import { createClient } from 'https://esm.sh/@supabase/[email protected]';

資格情報の検証も正直であるべきです。ローカルでパースしたキーの書式から「接続済み」と報告するのではなく、プロバイダを実際に呼び出し、決済が実際に使うモードで接続を判定し、プロバイダが拒否するキーは拒否し、プロバイダ自身のエラーメッセージを記録します。嘘をつく緑のチェックマークは、赤いマークよりも有害です。

5. トークンは1つの機能・1つの瞬間にスコープする

ゲストがリンクから厳密に1つのアクションを実行する必要があるなら、まさにそのアクションだけができるトークンを発行します。

読み取り専用のステータストークン。 自動チェックアウトのレスキューフローでは、ゲストのリンクは滞在ステータスを読むことだけができ、しかも予定終了時刻を過ぎた後にのみ有効であるべきです。

interface StatusToken {
  readonly kind: 'stay_status_read';
  readonly stayId: string;
  readonly notBefore: number;
  readonly exp: number;
}
export function assertStatusReadable(token: StatusToken, now = Date.now()): void {
  if (token.kind !== 'stay_status_read') throw new ForbiddenError('wrong_token_kind');
  if (now < token.notBefore * 1000) throw new ForbiddenError('before_scheduled_end');
  if (now >= token.exp * 1000) throw new ForbiddenError('token_expired');
}

kind の判別子は飾りではありません。ある目的のために発行されたトークンが別のエンドポイントに対してリプレイされることを防ぎます——「すべてを1つの JWT で」という設計を脆くする confused deputy 問題です。

ワンタイムのバインディングトークン。 共有ゲストリンク経由で未所有の予約をクレームする操作は、単回使用であり、アトミックに消費されなければなりません。

update reservation_claim_tokens
   set consumed_at = now(), consumed_by = $2
 where token_hash = digest($1, 'sha256')
   and consumed_at is null
   and expires_at > now()
returning reservation_id;

この文が0行を返した場合、トークンはすでに使用済みか、期限切れか、偽造されたものです——呼び出し側からはこの3つを区別できません。これは意図的な設計です。保存されるのはハッシュのみである点にも注目してください。データベースのダンプから使用可能なリンクが得られてはなりません。

OTP の失敗セマンティクス。 期限切れのコードと誤ったコードを区別することはユーザビリティの改善ですが、システムを弱めてはいけません。私たちが落ち着いたルールは、UI では失敗のカテゴリを区別する、特定のコードが存在したかどうかは絶対に漏らさない、そしてすでに消費済みのコードをゲストに再入力させない——消費済みのコードは再試行プロンプトではなく終端状態を返す、というものです。

6. セッションのスコープと Cookie の分離

影響の大きい小さな変更が2つあります。

  • 管理者セッションのサインアウトは local スコープにする。 管理コンソールからのサインアウトはそのセッションを終了すべきであり、あらゆるデバイス・アプリにまたがるそのユーザーの全セッションを失効させるべきではありません。グローバルサインアウトをデフォルトにすると、日常的なログアウトがサービス拒否に変わります。
  • auth cookie の名前空間をプロジェクト参照から導出する。 複数の環境がドメインを共有している場合、静的な cookie 名は staging のセッションを production の状態と衝突させます。名前空間をプロジェクト識別子から導出すれば、環境をまたぐセッションの漏れは構造的に不可能になります。
export function cookieNamespace(anonKey: string): string {
  const ref = JSON.parse(atob(anonKey.split('.')[1])).ref as string;
  return `sb-${ref}-auth-token`;
}
await supabase.auth.signOut({ scope: 'local' });

7. テスト用バイパスは絶対にリリースしない——そして revert の準備をしておく

このサイクルのある変更では、自動テストが使っていた auth-bypass-otp という抜け道を削除しました。本番コードに存在するバイパスは、どんなゲートがかかっていようと認証のバックドアです。

その変更はその後 revert されました。削除によって、それに依存していた E2E スイートが壊れたからです。これは隠すのではなく率直に述べる価値があります。正しい順序は、まず依存を置き換え、次にバイパスを削除するです。テストは、検証をスキップする本番コードパスに頼るのではなく、別のキーで動作し本番からは到達できないテスト専用の発行経路を通じて、本物の資格情報を取得すべきです。

ここでの健全なエンジニアリングのシグナルは、削除が一発で成功したことではありません。ロールバックが迅速で、意図的で、記録されていたことです。

関連する改善として、index.ts のソースを grep してゲートを確認していたアサーションを、振る舞いを確認するものに書き換えました。

// Brittle: passes if the source string exists, even if the gate is bypassed.
assert.match(readFileSync('index.ts', 'utf8'), /manualCheckoutEnabled/);
// Robust: fails if the gate stops being enforced.
const res = await handler(requestWithoutManualCheckout());
assert.equal(res.status, 403);
assert.equal((await res.json()).code, 'manual_checkout_disabled');

ソーステキストに対するアサーションはセキュリティ劇場です。リファクタリングを生き延びるのは振る舞いのアサーションだけです。

8. セキュリティテストが実際に実行されていないとき CI を失敗させる

最も危険なテストは、リポジトリに存在するのに一度も実行されないテストです。どのワークフローからも参照されていないテストファイルは、カバレッジについて誤った安心感を与えます。

私たちは、すべての integration テストと SQL テストのファイルを列挙し、どれかがワークフローに名前として現れていなければ失敗する CI ゲートを追加しました。

set -euo pipefail
missing=0
while IFS= read -r file; do
  if ! grep -rq "$(basename "$file")" .github/workflows/; then
    echo "::error file=$file::test file is not referenced by any workflow"
    missing=1
  fi
done < <(find tests/integration supabase/tests -name '*.test.ts' -o -name '*.test.sql')
exit "$missing"

これは1画面に収まるスクリプトでありながら、サイレントなカバレッジ喪失という失敗モードを恒久的に塞ぎます。固定されたランナーイメージと固定された Node バージョンと組み合わせれば、「CI では通った」という言葉が再現可能な意味を持つようになります。

9. もう必要のないデータは削除する

リテンションはコンプライアンスのチェックボックスであるだけでなく、セキュリティ管理策です。削除済みのデータは流出しようがありません。定義された期限——私たちのケースでは3年——を過ぎたゲストの個人データを取り除く定期的なスイープは、将来起こりうる侵害の価値に上限をかけます。

create or replace function public.sweep_expired_guest_data()
returns integer
language plpgsql
security definer
set search_path = public
as $$
declare
  removed integer;
begin
  with purged as (
    update guest_profiles
       set email = null, phone = null, full_name = null, purged_at = now()
     where purged_at is null
       and last_activity_at < now() - interval '3 years'
    returning 1
  )
  select count(*) into removed from purged;
  insert into audit_logs (action, detail) values ('retention.sweep', jsonb_build_object('rows', removed));
  return removed;
end;
$$;

このスイープが自身の監査エントリを書いている点に注目してください。静かに実行されるリテンションジョブは、静かに停止したジョブと区別がつきません。

まとめ

セキュリティが重要なあらゆるシステムに持ち込む価値のあるパターンは次のとおりです。

領域 ルール
認可 RLS でデータベース側に強制し、using には必ず with check を併記する
マルチテナンシー 所有関係は集合メンバーシップとしてモデル化し、スカラー検索にしない
監査ログ 書き込みはトリガーのみ、クライアントからの読み取りなし、履歴は削除後も残る
オブザーバビリティ 成功だけでなく拒否も記録する
シークレット 保存時に暗号化、リフレッシュはサーバー側、依存の厳密なバージョンを固定
トークン 1機能・1回使用・時間制限あり・ハッシュで保存
セッション local スコープのサインアウト、環境ごとの cookie 名前空間
テスト 振る舞いをアサートしソーステキストは見ない、未参照のテストで CI を失敗させる
データ 不要になったものは削除し、その削除を監査する

どれ一つとして単体で賢いものはありません。その価値は累積的です。一つひとつが攻撃者の取りうる経路を消し、一つひとつが何年も維持できるほど安価です。物理的なドアを制御するシステムでは、その持続性こそが巧妙さよりも重要なのです。

主要な発見

1
セキュリティ

RLS ポリシーには `using` だけでなく `with check` が必要

`using` 句だけでは、ユーザーが自分の所有する行を別テナントに属する行へ更新できてしまいます。`with check` と組み合わせることで結果として生じる行を検証し、テナント跨ぎの書き込みを塞げます。

2
セキュリティ

所有関係はスカラー検索ではなく集合メンバーシップとしてモデル化する

単一行の検索で「オーナー」を解決するポリシーは、マルチテナントのオペレーターに対して壊れるか、権限を過剰に与えます。メンバーシップテーブルに対する `exists (...)` なら多数の施設を持つオーナーにもスケールします。

3
監査とコンプライアンス

監査行はトリガーからのみ書き込み可能にする

クライアントの権限をすべて revoke し、insert を `pg_trigger_depth() > 0` でゲートすれば、ログは記述対象の変更の副作用となり、アプリケーションコードが履歴を偽造・書き換えできなくなります。

4
オブザーバビリティ

成功だけでなく拒否を記録する

不正な署名・古いタイムスタンプ・不正な資格情報で拒否された webhook リクエストを記録することで、監査ログは変更履歴簿ではなく攻撃検知のシグナルになります。

5
認証

トークンは1つの機能・1回の使用にスコープする

判別子付きのトークン種別はエンドポイント間での confused deputy リプレイを防ぎ、条件付き UPDATE による単回使用クレームトークンのアトミックな消費は共有ゲストリンクでの競合を排除します。

6
テスト

ソーステキストではなく振る舞いをアサートし、未参照テストで CI を失敗させる

ソースファイルへの grep ベースのアサーションは、検証対象のゲートを削除するリファクタリングをそのまま通過してしまいます。どのワークフローにも名前が現れないテストファイルで失敗する CI チェックが、サイレントなカバレッジ喪失を塞ぎます。

7
サプライチェーン

edge functions では依存の厳密なバージョンを固定する

浮動する CDN のバージョン指定子はコールドスタート時に解決されるため、上流のリリースがデプロイなしに本番へ到達します。どこでも厳密に1つのバージョンを固定すれば、アップグレードは意図的でレビュー可能なものになります。