シークレット

背景

シークレットは、暗号化されたテキスト値をWorkerに添付することを可能にするバインディングの一種です。シークレットを設定した後はそれを見ることができず、Wranglerを介して、またはプログラム的にenvパラメータを介してのみアクセスできます。シークレットは、APIキーや認証トークンなどの機密情報を保存するために使用されます。シークレットは、Workerのfetchイベントハンドラーに渡されるenvパラメータで利用可能です。

シークレットを使用したローカル開発

When developing your Worker or Pages Function, create a .dev.vars file in the root of your project to define secrets that will be used when running wrangler dev or wrangler pages dev, as opposed to using environment variables in wrangler.toml. This works both in local and remote development modes.

The .dev.vars file should be formatted like a dotenv file, such as KEY="VALUE":

.dev.vars

SECRET_KEY="value"
API_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"

デプロイされたWorkerのシークレット

プロジェクトにシークレットを追加する

Wranglerを介して

シークレットは、wrangler secret putまたはwrangler versions secret putコマンドを通じて追加できます。

wrangler secret putは、Workerの新しいバージョンを作成し、即座にデプロイします。

npx wrangler secret put <KEY>

段階的デプロイメントを使用している場合は、代わりにwrangler versions secret putコマンドを使用してください。これにより、Workerの新しいバージョンが作成され、その後wrangler versions deployを使用してデプロイできます。

ノート

Wranglerのバージョン3.73.0以前では、--x-versionsフラグを指定する必要があります。 ::

npx wrangler versions secret put <KEY>

ダッシュボードを介して

ダッシュボードを介してシークレットを追加するには：

1. Cloudflareダッシュボード ↗にログインし、アカウントを選択します。
2. Workers & Pagesを選択します。
3. 概要で、Workerを選択し、設定を選択します。
4. 環境変数の下で、変数を追加を選択します。
5. 変数名とその値を入力します。これにより、Workerで利用可能になります。
6. 暗号化を選択して、シークレットの値を保護します。これにより、Wranglerやダッシュボードを介して値が表示されなくなります。
7. （オプション）複数のシークレットを追加するには、変数を追加を選択します。
8. 保存または保存してデプロイを選択して変更を保存します。

プロジェクトからシークレットを削除する

Wranglerを介して

シークレットは、wrangler secret deleteまたはwrangler versions secret deleteコマンドを通じて削除できます。

wrangler secret deleteは、Workerの新しいバージョンを作成し、即座にデプロイします。

npx wrangler secret delete <KEY>

段階的デプロイメントを使用している場合は、代わりにwrangler versions secret deleteコマンドを使用してください。これにより、Workerの新しいバージョンが作成され、その後wrangler versions deployを使用してデプロイできます。

npx wrangler versions secret delete <KEY>

ダッシュボードを介して

ダッシュボードを介してWorkerプロジェクトからシークレットを削除するには：

1. Cloudflareダッシュボード ↗にログインし、アカウントを選択します。
2. Workers & Pagesを選択します。
3. 概要で、Workerを選択し、設定を選択します。
4. 環境変数の下で、変数を編集を選択します。
5. 削除したいシークレットの横にあるXを選択します。
6. 保存または保存してデプロイを選択して変更を保存します。

Compare secrets and environment variables

Use secrets for sensitive information

Do not use plaintext environment variables to store sensitive information. Use secrets instead.

Secrets are environment variables. The difference is secret values are not visible within Wrangler or Cloudflare dashboard after you define them. This means that sensitive data, including passwords or API tokens, should always be encrypted to prevent data leaks. To your Worker, there is no difference between an environment variable and a secret. The secret’s value is passed through as defined.

関連リソース

• Wranglerシークレットコマンド - シークレットを作成、削除、リストするためのWranglerコマンドを確認します。