UnlockOS Developers
← 記事一覧に戻る
🔐

RLSポリシーと状態管理によるアクセス制御の保護

2026年1月19日2026年1月25日
6
28 commits
深度 8/10
securityaccess-controldatabasestate-managementauthorization

RLSポリシーと状態管理によるアクセス制御の保護

はじめに

スマートロック管理のようなセキュリティクリティカルなシステムでは、堅牢なアクセス制御メカニズムの実装が最重要です。本記事では、安全なRow Level Security(RLS)ポリシーの設計方法、チェックイン状態遷移の安全な管理、および認証ロジックにおける無限再帰のような一般的なセキュリティの落とし穴を防ぐ方法について説明します。

Row Level Securityポリシー設計

RLSポリシーはデータベースセキュリティの第一線として機能し、ユーザーが認可されたデータのみにアクセスできることを保証します。しかし、設計が不適切なポリシーは、セキュリティの脆弱性やシステム不安定を引き起こす可能性があります。

認証における無限再帰の防止

私たちが遭遇した重要な問題の一つは、プラットフォーム管理者ポリシーにおける無限再帰でした:

-- 無限再帰を引き起こす問題のあるポリシー
CREATE POLICY "platform_admins_select" ON platform_admins
FOR SELECT USING (
  EXISTS (
    SELECT 1 FROM platform_admins pa 
    WHERE pa.user_id = auth.uid()
  )
);

このポリシーは循環依存を作成し、ユーザーがプラットフォーム管理者かどうかを確認するために、同じポリシーを持つ同じテーブルをクエリする必要があります。解決策は、再帰しないベース条件を使用することです:

-- 直接ユーザー検証を使用する安全なポリシー
CREATE POLICY "platform_admins_select" ON platform_admins
FOR SELECT USING (
  auth.uid() IS NOT NULL 
  AND auth.jwt() ->> 'role' = 'platform_admin'
);

階層型アクセス制御

施設管理において、権限の連鎖を尊重する階層型アクセス制御を実装します:

-- 施設管理者がチェックインイベントにアクセスするためのポリシー
CREATE POLICY "checkin_events_facility_manager" ON checkin_events
FOR SELECT USING (
  facility_id IN (
    SELECT f.id FROM facilities f
    JOIN facility_managers fm ON f.id = fm.facility_id
    WHERE fm.user_id = auth.uid()
      AND fm.is_active = true
  )
);

チェックインプロセスの状態管理

スマートロックシステムにおけるチェックインプロセスは、セキュリティを確保し、不正アクセスを防ぐために慎重な状態管理が必要です。

ゲストポリシーとシステム設定の分離

重要なセキュリティ原則は、ユーザーポリシーとシステム設定を分離することです。ゲストポリシーはチェックイン設定と混合すべきではありません:

// 安全なアプローチ - 関心事の分離
interface CheckinConfiguration {
  facilityId: string;
  requiredDocuments: DocumentType[];
  validationRules: ValidationRule[];
  auditSettings: AuditSettings;
}
interface GuestPolicy {
  guestId: string;
  accessLevel: AccessLevel;
  timeRestrictions: TimeWindow[];
  allowedAreas: string[];
}
// 権限昇格を防ぐため、これらを分離して保持
class CheckinService {
  async validateCheckin(config: CheckinConfiguration, guest: GuestPolicy) {
    // ゲストポリシーとは独立して設定を検証
    const configValidation = await this.validateConfig(config);
    if (!configValidation.isValid) {
      throw new SecurityError('Invalid configuration');
    }
    // その後、ゲスト固有のルールを適用
    return this.applyGuestPolicy(guest, configValidation);
  }
}

イベント駆動の状態遷移

信頼性の高いチェックイン状態管理のため、ポリシークエリにすべての関連イベントを含めます:

// 状態検証のための包括的なイベント包含
interface CheckinEventQuery {
  facilityManagerId: string;
  includeEvents: {
    checkinEvents: boolean;
    validationEvents: boolean;
    auditEvents: boolean;
  };
}
class CheckinStateManager {
  async getManagerCheckins(query: CheckinEventQuery) {
    // 完全な状態像のためにすべてのイベントタイプを含める
    const events = await this.db.query(`
      SELECT c.*, ce.event_type, ce.timestamp
      FROM checkins c
      LEFT JOIN checkin_events ce ON c.id = ce.checkin_id
      WHERE c.facility_id IN (
        SELECT facility_id FROM facility_managers 
        WHERE user_id = $1 AND is_active = true
      )
      ORDER BY ce.timestamp DESC
    `, [query.facilityManagerId]);
    return this.buildStateFromEvents(events);
  }
}

デプロイメントセキュリティと環境管理

安全なデプロイメント実践は、環境全体でシステムの整合性を維持するために重要です。

環境変数の検証

適切な環境の読み込みと検証は、設定関連のセキュリティ問題を防ぎます:

// 安全な環境設定
interface SecureConfig {
  apiKey: string;
  databaseUrl: string;
  encryptionKey: string;
  auditLogLevel: 'error' | 'warn' | 'info' | 'debug';
}
function validateEnvironment(): SecureConfig {
  const requiredVars = ['API_KEY', 'DATABASE_URL', 'ENCRYPTION_KEY'];
  const missing = requiredVars.filter(key => !process.env[key]);
  
  if (missing.length > 0) {
    throw new Error(`Missing required environment variables: ${missing.join(', ')}`);
  }
  
  return {
    apiKey: process.env.API_KEY!,
    databaseUrl: process.env.DATABASE_URL!,
    encryptionKey: process.env.ENCRYPTION_KEY!,
    auditLogLevel: (process.env.AUDIT_LOG_LEVEL as any) || 'info'
  };
}

ビルド時セキュリティチェック

ビルドプロセスにセキュリティ検証を統合することで、問題を早期に発見できます:

// セキュリティファーストな環境読み込みを備えたVite設定
export default defineConfig({
  plugins: [
    {
      name: 'security-validation',
      buildStart() {
        try {
          validateEnvironment();
        } catch (error) {
          this.error(`Security validation failed: ${error.message}`);
        }
      }
    }
  ],
  build: {
    rollupOptions: {
      external: ['crypto'] // cryptoモジュールの可用性を確保
    }
  }
});

フィーチャーフラグのセキュリティアーキテクチャ

セキュリティシステムにおけるフィーチャーフラグは、不正な機能アクセスを防ぐために特別な考慮が必要です:

// 安全なフィーチャーフラグ実装
interface FeatureFlag {
  id: string;
  name: string;
  enabled: boolean;
  userGroups: string[];
  securityLevel: 'low' | 'medium' | 'high';
}
class SecureFeatureManager {
  async isFeatureEnabled(flagName: string, userId: string): Promise<boolean> {
    const flag = await this.getFlag(flagName);
    if (!flag) return false;
    
    // セキュリティレベルベースの検証
    if (flag.securityLevel === 'high') {
      const hasPermission = await this.validateHighSecurityAccess(userId);
      if (!hasPermission) {
        await this.auditLog('unauthorized_feature_access', { userId, flagName });
        return false;
      }
    }
    
    return flag.enabled && this.userInGroups(userId, flag.userGroups);
  }
  
  private async ensureFeatureSystemExists(): Promise<void> {
    // 冪等なフィーチャーシステム初期化
    const exists = await this.db.query('SELECT 1 FROM feature_flags LIMIT 1');
    if (exists.length === 0) {
      await this.seedDefaultFlags();
    }
  }
}

まとめ

安全なアクセス制御システムには、ポリシー設計、状態管理、およびデプロイメント実践への細心の注意が必要です。重要な原則には以下があります:

  1. 再帰ポリシーの回避 - 認証で無限ループを引き起こす可能性があります
  2. 関心事の分離 - システム設定とユーザーポリシーを分離します
  3. 包括的なイベントデータの包含 - 正確な状態再構築のため
  4. 環境の検証 - 設定問題を早期に発見するためのビルド時検証
  5. セキュリティ対応フィーチャーフラグの実装 - 適切な監査ログ記録を伴って

これらのパターンに従うことで、スマートロック管理システムは信頼性のあるアクセス制御機能を提供しながら堅牢なセキュリティを維持できます。

主要な発見

1
セキュリティ

RLSポリシーの再帰防止

自己参照クエリの代わりに直接認証チェックを使用して、Row Level Securityポリシーでの無限再帰を回避する

2
アクセス制御

階層型権限設計

組織階層を尊重し、状態検証のための包括的なイベントデータを含む施設管理者権限を構造化する

3
状態管理

イベント駆動チェックイン状態

完全な状態再構築を確保し、セキュリティギャップを防ぐため、チェックイン状態クエリにすべての関連イベントタイプを含める

4
デプロイメントセキュリティ

ビルド時環境検証

本番環境前に問題を発見するため、ビルドプロセス中に重要な環境変数とセキュリティ設定を検証する