> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# セキュリティとプライバシー

レート制限、シークレット、データエクスポート、監査証跡。

## 初心者向けのウォークスルー

前提条件: 以下の 2 つの初心者向けガイドを読み、Web ローカルのセットアップを完了し、エディターでルートにあるこのモノリポジトリを開きます。 Web 設定は `apps/web/.env.local` に属します。 Next.js はルート `.env` を読み取りません。デフォルトのフェイク モードの `/dashboard` はデータベースなしのデモです。 `/auth` には移行されたデータベースが必要です。

簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダー キーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデル カタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。

1. ユーザー所有のレコードを読み取るサーバー アクションまたはルートで、クエリを実行する前に、サインインしているユーザーのメンバーシップとアクティブな `workspaceId` を解決します。

2. 正確なレコード パスに対して、許可されたメンバーのケースと外部ワークスペースの拒否を 1 つ追加するようエージェントに依頼します。関連する役割とフィールドを提供します。

3. 最初のリクエストは成功し、2 番目のリクエストはレコードを返さず、アクセスが拒否されます。ボタンのみを変更するとアクセスが非表示になり、直接リクエストは引き続き機能する場合は、サーバーの境界が失われています。

カスタム コードの場合は、提供された `prompts/README.md` から始めて、最も近いプロンプト (アプリ画面の場合は `prompts/new-app-screen.md`、パブリック ページの場合は `prompts/new-landing-page.md`) をコピーします。サーバー、データベース、またはプロバイダーの作業については、コーディング エージェントにこのガイドのタスクを与え、`AGENTS.md`、`.ai/PROJECT_CONTEXT.md`、および一致する `.ai/` ミラーを読み取るように依頼します。ここで指定されている正確なソース ファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テスト アカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。

[始める前に](https://supastack.dev/ja/docs/web/before-you-start.md)

【端末の基本】(/docs/web/terminal-basics)

[Webローカル設定](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[エージェント プロンプトとプロジェクト メモリ](https://supastack.dev/ja/docs/web/agents.md)


## データの前にメンバーシップを解決する

セッションはアイデンティティを選択します。サーバーはアクティブなワークスペースを解決し、メンバーシップ/ロールを検証します。すべてのユーザー所有のレコードは `workspaceId` を使用します。クライアント フィールド、URL ID、またはモデルで選択された引数は、その所有権チェックを置き換えることはできません。

プラットフォーム マーケティング資産とプラットフォーム管理者レコードには明示的なプラットフォーム範囲があります。匿名の待機リスト エントリ用のワークスペースを作成しないでください。


## 非同期作業を通じて境界を維持する

タスク、ジョブ、ツール コンテキスト、API キー、コンテンツ、ストレージ、および送信イベントは、認証されたワークスペースを継承します。リソース ID と所有権を確認します。別のワークスペースからの有効な ID を許可しても、承認は失敗します。


## 最初に拒否テストを作成します

成功したすべてのミューテーション/読み取りを、匿名、外部ワークスペース、および不十分なロールのテストと組み合わせます。禁止された結果を診断する際には、決して秘密を暴露しないでください。

[ワークスペース契約](https://supastack.dev/ja/docs/modules/workspaces.md)

[保護されたページのレシピ](https://supastack.dev/ja/docs/web/first-feature.md)

[サーバーが挿入したツールコンテキスト](https://supastack.dev/ja/docs/web/project-structure.md)


## インストールとセットアップ

rate-limit-runtime は、auth、checkout、API、サブミッションのルートに接続された共有リミッターを提供します — ルートごとのカウンターを作るのではなく、乱用に敏感な新しいエンドポイントにもこれを拡張してください。セッション設定、HTTPS 限定 Cookie、プロバイダーシークレットはサーバーサイドに留めます。

ワークスペースの監査レコード(audit-runtime.ts)はセキュリティ上重要な変更(プロバイダー設定、メンバー・ロール更新)を捕捉し、/settings/audit で読み取れます。

```
# Data subject export
src/data-export.ts — assembles a member's
workspace-owned records for account export
```


## 実装ワークフロー

認証情報をログ、エラーペイロード、アナリティクスプロパティ、監査値から遠ざけてください — オブザーバビリティ層は既知のキーをマスクしますが、自由文は作者の責任です。すべての読み書きで認可をサーバーで解決します。UI 状態は表示であり、証明ではありません。

アカウントのデータエクスポートと削除リクエストはアカウント境界を経由し、同じ所有権ルールが適用されます。プロダクトが必要とするデータだけを保存してください。


## 検証とトラブルシューティング

リミッターがリトライ可能な 429 を返すまで試し、監査行がそれを生じるべきミューテーションで現れることを確認し、テストメンバーのデータをエクスポートします。リリースごとにワークスペース間の読み取りを一つプローブしてください — 最も安価で重要な回帰です。


## 次へ

[スパム対策](https://supastack.dev/ja/docs/web/captcha.md)