秘密の設定を登録し、手元と公開先で使い分ける
練習用の秘密値を使い、ローカル設定とCloudflareのsecretが別々であることを、値を表示せずに確認します。
目次
APIキーなどの秘密情報は、プログラムと別に登録できます。この実習では、本物のサービスのキーを使わず、練習用に作った値で登録方法を確かめます。
この実習では、値を画面に出さずに「設定を読み取れたか」を確認します。true は値を読み取れたという意味です。外部のAPIには接続しないため、そのキーで実際にサービスを利用できるかまでは確認しません。
共通教材の準備が済んだフォルダーを使います。Node.js 24.22.1 / Wrangler 4.158.0、macOSで実行確認しました。VS Codeのコマンド入力欄で進めます。Windowsはコマンドプロンプトを選びます。
何を、どこへ入れる?
| 設定の種類 | この教材での置き場所 | 例 |
|---|---|---|
| 公開してよい設定 | wrangler.jsonc の vars | 環境名 LAB_ENV |
| 手元だけの秘密情報 | .dev.vars.staging | 練習用の LAB_API_KEY |
| Cloudflare上の秘密情報 | Workerのsecret | 公開先用の LAB_API_KEY |
secretは、Cloudflare側に値を登録してプログラムから使えるようにする仕組みです。LAB_API_KEY は教材で付けた設定名です。EmDashの標準設定名ではありません。
1. まだ未登録の状態を確認する
教材フォルダーで起動します。
npm run dev:stagingブラウザーで http://127.0.0.1:8788/secret-status を開きます。
{
"environment": "staging",
"configured": false
}false は「値が入っていない」という意味です。公開した検証用URLにも /secret-status を付けて開き、こちらも false であることを確認します。
2. 手元用の秘密値を作る
ローカル起動を Control + C で止めて、次を実行します。
npm run secret:local
npm run dev:staging最初の命令がランダムな練習値を作り、.dev.vars.staging に保存します。既存のファイルがある場合は上書きせず止まります。「すでにある」と言われたら、前に作ったファイルを確認してください。
作成後に開く http://127.0.0.1:8788/secret-status は、次の表示になります。
{
"environment": "staging",
"configured": true
}同時に、公開先の /secret-status がまだ false であることも確かめます。手元のファイルを作っただけでは、Cloudflareには登録されません。
ファイル名の末尾に .staging が付いているため、この値はstaging用です。別の環境へ同じ名前の値を登録したい場合も、その環境の設定を別に用意します。今回は本番役を未登録のままにします。
3. 公開先にも登録する
ローカル起動を止め、次を実行します。
npx wrangler secret put LAB_API_KEY --env staging秘密値の入力を求められたら、VS Codeで .dev.vars.staging を開き、LAB_API_KEY= の右側の値だけをコピーして入力し、Enterを押します。今回は教材が作った練習値です。値をコマンドの引数に付けたり、ガイドの本文へ貼ったりする必要はありません。
この教材では、先にWorkerを公開してあります。secret put が成功すると、新しいWorkerの版が作られて配置されます。設定の登録だけで公開先も更新される点は、通常のファイル保存と異なります。Cloudflareのsecretの説明(別タブで開く)も参照してください。
4. 値を見せずに確かめる
検証用URLの /secret-status を再読み込みします。configured: true なら、公開先でも設定を読み取れています。登録直後は、まだ前の状態が返ることがあります。成功表示が出ていれば、少し待ってから再読み込みします。同じ値を何度も登録する必要はありません。
続いて、本番役URLの /secret-status を開きます。こちらは false のままです。環境名が違うと、秘密情報も自動では共有されません。
登録した設定名は、次の命令でも確認できます。値そのものを表示する命令ではありません。
npx wrangler secret list --env staging
npx wrangler secret list --env production-demo手元では true、公開先では false の場合は、put の成功表示と --env の指定を確認します。どちらも false なら、設定名を LAB_API_KEY と正確に書いたか見直します。
コードでは、どう読み取っている?
src/worker.js の /secret-status の処理には、次の式があります。
configured: Boolean(env.LAB_API_KEY)env.LAB_API_KEY で値を受け取り、Boolean で「ある・ない」の真偽値に変えています。読者へ返すのは true または false です。このURLは実習で設定を確認するために用意したものです。本番サイトに同じ確認用URLを作る必要はありません。
教材の .gitignore は、.dev.vars* と .env* をGitの記録対象から外す設定です。ただし、すでに記録したファイルは消せません。本物のキーを誤って公開した場合は、発行元でそのキーを無効にし、新しいキーを発行する必要があります。
EmDashの暗号鍵は、練習用の値と扱いが違う
EmDashには EMDASH_ENCRYPTION_KEY という、保存した秘密情報を暗号化し、使うときに元の情報へ戻すための鍵があります。既存データがある環境で、この鍵を気軽に作り直すと、保存済みの設定を読めなくなることがあります。
今回の LAB_API_KEY を、そのままEmDashの暗号鍵として使わないでください。新規環境の鍵の生成と、既存環境の鍵の入れ替えは、秘密の設定を入れ替えるガイドとEmDash公式の鍵管理(別タブで開く)に沿って行います。
終了するとき・次回続けるとき
ローカル起動を Control + C で止めます。次回は npm run dev:staging で再開でき、ファイルに保存した練習値も読み込まれます。secret:local を毎回実行する必要はありません。
公開先のsecretも、手元の画面を閉じても残ります。今回登録した状態のまま、次の前のコードに戻す実習へ進めます。