---
canonical: "https://agi-labo.com/tools/wings/docs/secrets"
title: "Secret"
description: "Handler ごとの秘密の値を安全に渡します。"
section: "主要機能"
order: 12
pageType: "how-to"
lastVerifiedVersion: "1.4.16"
lastVerifiedAt: "2026-10-15"
draft: false
surfaces: ["cli", "console", "api"]
plans: ["free", "member"]
---

Secret は、Handler ごとの秘密の値です。
Webhook の署名検証などに使います。
外部 API に送る認証情報は、[Connection](/tools/wings/docs/connections)に保存してください。

## 値を保存する

値をクリップボードにコピーしてから、次を実行します。

```sh
wings handler secret set <handler-id> WEBHOOK_SECRET
```

標準入力から渡す場合は `--stdin` を使います。
値をコマンド引数、ソース、ログ、チャットに貼らないでください。

## Handler から読む

Handler は `env.WEBHOOK_SECRET` で値を読めます。
値は暗号化して保存します。
ただし、コードが結果やログに書き出した値は隠れません。

## 一覧を見る、削除する

```sh
wings handler secret list <handler-id>
wings handler secret rm <handler-id> WEBHOOK_SECRET
```

一覧に Secret の値は表示しません。
Handler やアカウントを削除すると、その Secret も消えます。

`WINGS_` で始まる名前は予約されています。
この名前での作成・更新は、`invalid_secret_name` で失敗します。