# シークレット

Secrets を使用すると、API トークン、ユーザー名とパスワード、JSON 設定などの認証情報や機密値を、安全に保存し、連携や通知テンプレートで使用できます。シークレット値は暗号化され、安全に保存されます。保存後は値を再度表示することはできず、使用時にのみアクセスできます。

プラットフォームでは、Secrets は **Org Admin** および **ドメイン管理者** ユーザーに対して利用できます。管理するには、 **ドメイン設定** ページに移動し、 **セキュリティ** タブを選択します。 **シークレット** セクションは **APIトークン**.

「 **シークレット** リストの下にあり、次の列が表示されます: **エイリアス**, **種類**, **最終更新日**、および **アクション**.

<figure><img src="https://1832353165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2FonYuOSkmQbxa6WWMyb32%2FScreenshot%202026-03-06%20at%208.12.13%E2%80%AFAM.png?alt=media&#x26;token=941431e1-05f3-4417-b32b-84a3e65143b2" alt=""><figcaption></figcaption></figure>

**新しいシークレットの作成**

から、 **セキュリティ** タブで、 **シークレット** セクションで次をクリックします **シークレットを追加** ボタンをクリックします。 **シークレットを作成** ドロワーが右側から開き、次のフィールドが表示されます:

* **エイリアス** — シークレットの一意の名前（例: `weather_fx`）。エイリアスは大文字小文字を区別せず、小文字、数字、ハイフン、アンダースコアのみを含める必要があります。
* **シークレットの種類** — 保存したいシークレットの種類を選択します:
  * **トークン** — API キーのような単一の文字列値。
  * **ユーザー名とパスワード** — 認証情報のペア。
  * **JSON** — JSON のキーと値の設定オブジェクト。
* **値** — 選択したシークレットの種類に応じて入力フィールドが変わります:
  * **トークン**: 単一のマスクされた入力フィールド。
  * **ユーザー名とパスワード**: ユーザー名のテキストフィールドと、マスクされたパスワードフィールド。
  * **JSON**: JSON 検証付きのコードエディタ。

次をクリックします **送信** ボタンをクリックしてシークレットを保存します。

> ⚠️ シークレット値は書き込み専用です。作成後、保存された値を表示することはできません。送信する前に、認証情報が別の場所にも保存されていることを確認してください。

<figure><img src="https://1832353165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2FPTKhpatdHwrvDbSKV1Vq%2FScreenshot%202026-03-06%20at%208.11.49%E2%80%AFAM.png?alt=media&#x26;token=f8630b7a-0de4-492a-92cc-ae963edfebed" alt=""><figcaption></figcaption></figure>

**シークレットの編集**

既存のシークレットの保存済み値を更新するには、一覧のシークレット行にある **編集** アクションをクリックします。編集ドロワーが表示され、 **エイリアス** および **シークレットの種類** フィールドはロックされています。新しい値を入力し、 **送信** をクリックして保存済みの認証情報をローテーションします。

これは、テンプレートや連携ですでに参照されているエイリアスを変更せずに、API キーのローテーションやパスワードの更新が必要な場合に便利です。

**シークレットのアーカイブ**

シークレットを削除するには、シークレット行にある **アーカイブ** アクションをクリックします。確認ダイアログが表示され、次のメッセージが出ます:

> 「このシークレットをアーカイブしてもよろしいですか？ このシークレットを使用している既存の連携は、今後機能しなくなります。」

クリック **シークレットをアーカイブ** で確定するか、 **キャンセル** で戻ります。アーカイブされたシークレットは一覧から削除され、連携やテンプレートで使用できなくなります。

**テンプレートでシークレットを使用する**

シークレットは、通知テンプレートや連携で **Macro Manager**を使用して参照できます。テンプレートを作成する際は、Macro Manager を開き、 **シークレット** カテゴリを選択します。シークレットを選ぶと、次の形式でテンプレートに参照が挿入されます:

```
secrets.<alias>
```

たとえば、エイリアス `weather_fx`でシークレットを作成した場合、次のように参照します `secrets.weather_fx`。送信時には、プラットフォームがテンプレートエディタに値を表示することなく、シークレット値を安全に解決します。
