Webhook署名シークレットをローテーションする

Webhookシークレットのローテーションは即時に切り替わります。dosyaでは古いシークレットと新しいシークレットの併用期間はありません。シークレットをローテーションが成功すると以前の値ではすぐに検証できなくなり、代替値は1回だけ表示されます。

手順

1. dosyaで変更する前に、受信側のシークレットストアとデプロイ方法にアクセスできるよう準備してください。代替値は事前に知ることができないため、無関係な受信側の変更を一時停止し、通信の少ない時間帯を選びます。
2. 連携 → Webhookを開き、エンドポイントURLを照合してシークレットをローテーションを選択します。ワークスペースのロールにmanage_settingsが含まれることを確認してください。API認証情報にはフルアクセスが必要です。
3. 署名シークレットをローテーションでThe old secret stops working immediately - update your receiver before rolling.を読んでください。今すぐ切り替えられる場合にのみシークレットをローテーションを選択します。
4. 署名シークレットで新しいwhsec_…の値をコピーし、安全に保存してください。dosyaはStore it securely - you won't see it again.を表示し、ダイアログを閉じた後は値を取得できません。
5. 受信側を更新してデプロイし、設定から古い値を削除します。保留中の再試行は次の試行時にエンドポイントの現在のシークレットを読み取るため、代替値で署名されて届きます。
6. テストイベントを送信を選択し、配信を開いて、受信側で成功と有効な新しい署名の両方を確認してください。通常の操作を再開する前に、短いローテーション期間中に届いたリクエストを調べてください。

シークレットの更新はユーザーごとに毎時10リクエストに制限されます。監査履歴と連携通知にはエンドポイントと操作した人が示されますが、どちらのシークレットも保存されません。

期待される結果

受信側は1回だけ表示された代替値で署名された配信を受け入れ、廃止されたシークレットを拒否します。新しいテストと後の再試行は現在のシークレットを使用し、サポートされない複数のシークレットの併用期間はありません。

**署名シークレットを更新できませんでした。**は確定した代替値が返されなかったことを意味します。現在の受信側設定を維持し、エンドポイントを再読み込みして、回数制限を確認してから再試行してください。

コピー前にダイアログを閉じました。 値は復元できません。再度ローテーションして新しく発行されたシークレットをコピーし、受信側を速やかに更新してください。途中のシークレットはすでに無効です。

関連ガイド

• Webhookを作成する
• 配信を確認する