シークレット
Secrets を使用すると、API トークン、ユーザー名とパスワード、JSON 設定などの認証情報や機密値を、安全に保存し、連携や通知テンプレートで使用できます。シークレット値は暗号化され、安全に保存されます。保存後は値を再度表示することはできず、使用時にのみアクセスできます。
プラットフォームでは、Secrets は Org Admin および ドメイン管理者 ユーザーに対して利用できます。管理するには、 ドメイン設定 ページに移動し、 セキュリティ タブを選択します。 シークレット セクションは APIトークン.
「 シークレット リストの下にあり、次の列が表示されます: エイリアス, 種類, 最終更新日、および アクション.
新しいシークレットの作成
から、 セキュリティ タブで、 シークレット セクションで次をクリックします シークレットを追加 ボタンをクリックします。 シークレットを作成 ドロワーが右側から開き、次のフィールドが表示されます:
エイリアス — シークレットの一意の名前（例:
weather_fx）。エイリアスは大文字小文字を区別せず、小文字、数字、ハイフン、アンダースコアのみを含める必要があります。シークレットの種類 — 保存したいシークレットの種類を選択します:
トークン — API キーのような単一の文字列値。
ユーザー名とパスワード — 認証情報のペア。
JSON — JSON のキーと値の設定オブジェクト。
値 — 選択したシークレットの種類に応じて入力フィールドが変わります:
トークン: 単一のマスクされた入力フィールド。
ユーザー名とパスワード: ユーザー名のテキストフィールドと、マスクされたパスワードフィールド。
JSON: JSON 検証付きのコードエディタ。
次をクリックします 送信 ボタンをクリックしてシークレットを保存します。
⚠️ シークレット値は書き込み専用です。作成後、保存された値を表示することはできません。送信する前に、認証情報が別の場所にも保存されていることを確認してください。
シークレットの編集
既存のシークレットの保存済み値を更新するには、一覧のシークレット行にある 編集 アクションをクリックします。編集ドロワーが表示され、 エイリアス および シークレットの種類 フィールドはロックされています。新しい値を入力し、 送信 をクリックして保存済みの認証情報をローテーションします。
これは、テンプレートや連携ですでに参照されているエイリアスを変更せずに、API キーのローテーションやパスワードの更新が必要な場合に便利です。
シークレットのアーカイブ
シークレットを削除するには、シークレット行にある アーカイブ アクションをクリックします。確認ダイアログが表示され、次のメッセージが出ます:
「このシークレットをアーカイブしてもよろしいですか？ このシークレットを使用している既存の連携は、今後機能しなくなります。」
クリック シークレットをアーカイブ で確定するか、 キャンセル で戻ります。アーカイブされたシークレットは一覧から削除され、連携やテンプレートで使用できなくなります。
テンプレートでシークレットを使用する
シークレットは、通知テンプレートや連携で Macro Managerを使用して参照できます。テンプレートを作成する際は、Macro Manager を開き、 シークレット カテゴリを選択します。シークレットを選ぶと、次の形式でテンプレートに参照が挿入されます:
たとえば、エイリアス weather_fxでシークレットを作成した場合、次のように参照します secrets.weather_fx。送信時には、プラットフォームがテンプレートエディタに値を表示することなく、シークレット値を安全に解決します。
最終更新