環境変数

各設定値に、1つの管理主体を割り当てます。 ブラウザー用の接頭辞を持つ変数は、ビルドで公開されます。秘密情報を入れないでください。

ブラウザーが管理する値

一般的なブラウザー設定には、ウォレットとリレーヤーのオリジン、プロジェクト環境の識別情報、公開可能キー、 チェーンのRPC・エクスプローラーURL、ネットワーク識別情報、RP IDの基準値を含みます。 SeamsConfigsInputの構築前に、必須の文字列を検証してください。

設定例

コンパイル対象のブラウザー実装例には、VITE_WALLET_ORIGIN、VITE_RELAYER_URL、VITE_SEAMS_PUBLISHABLE_KEYを使います。 公開可能キーは、プロジェクト環境を識別する公開設定です。 アプリとウォレットiframeのオリジンを、その環境の許可オリジンに含めてください。

ドキュメントのオリジン

公開ドキュメントのビルドは、ベースパスに/を使います。 VITE_DOCS_ORIGINは、正規URLとサイトマップURLを設定します。本番ではhttps://docs.wallet.seams.shを使ってください。 VITE_WALLET_SITE_ORIGINは、親のWalletサイトへのリンクを指定します。 ステージングは、既存のHTTPヘッダーでnoindexを要求する必要があります。 ローカルプレビューの設定を、本番ビルドに含めないでください。

サービスが管理する値

Gatewayやリレーヤーは、リクエスト認証の検証素材、プロバイダーの認証情報、レート制限とストレージのバインディング、 許可オリジン、ネットワーク実行設定を管理します。 SDKに必要な最小限の公開メタデータだけを公開してください。

鍵管理ロールの値

封印用認証情報、サービス間認証情報、手順の署名素材、データベースのバインディング、デプロイトークンは、 それぞれの管理主体の保護環境だけに置きます。 管理上の分離を保証する場合、単一のジョブや運用者に、独立した両Deriverの非公開素材を渡さないでください。

テナントルートの運用シェアは、各Deriverが生成し、ロール専用のD1に暗号化して保存します。 デプロイ全体で手動設定するルート秘密情報ではありません。 管理型バックアップの暗号文は、ロールのR2バケットに置きます。Google KMSのラッピング鍵素材は、KMS内に留まります。 Workerは、鍵の参照と、その鍵の利用を許可するロール限定の認証情報を受け取ります。

鍵の参照と認証用の秘密情報を区別してください。どちらも、ブラウザー用の接頭辞を持つ設定には含めません。 現在の共有鍵と管理上の制約は、テナントルートのバックアップを参照してください。

変更の規則

デプロイレーンごとに、レビュー済みの環境契約を1つ維持してください。 必須値の欠落や別レーンの値を検知した場合は、起動または事前確認を失敗させます。 各秘密情報は、それを管理するサービスでローテーションしてください。 その後、古い値が使えないことを確認します。検証中に秘密の値を出力しないでください。