# シークレット

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

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

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

<figure><img src="/files/b6cedef34ba1e40a23d5ca35601018a5569f7576" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

<figure><img src="/files/f81b6005e193fa3fa70ada2666eadde382c2759d" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

```
secrets.<alias>
```

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.pushly.com/pushly-ja/integration-1/shkuretto.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
