Project-Scoped

​

Web3 Actions

trigger:
  type: alert
  alert: {}

​

Webhooks

​

webhook की आवश्यकताएँ:

• इसे webhook URI के साथ एक GET method अवश्य उजागर करना चाहिए, जो तुरंत HTTP 200 लौटाता है। Tenderly यह सत्यापित करने के लिए इस method से एक request करता है कि webhook पहुंच योग्य है।
• इसे उसी webhook URI के साथ एक POST method अवश्य उजागर करना चाहिए। Webhook को नीचे वर्णित payload प्राप्त होगा।
• जब तक कोई HTTP 200 5 सेकंड के भीतर प्रतिक्रिया नहीं देता है, Tenderly इसे विफल webhook निष्पादन मानता है।
• webhook URL को HTTPS का उपयोग करना चाहिए।

• Success - इंगित करता है कि webhook सफलतापूर्वक निष्पादित किया गया था और event को निर्दिष्ट URL पर वितरित किया गया था
• Failed - इंगित करता है कि किसी error के कारण webhook को निष्पादित नहीं किया जा सका, जैसे कि connectivity समस्या, URL के साथ समस्या, या कुछ और (यह देखने के लिए कि error का कारण क्या था, response content जांचें या हमारे support से संपर्क करें)
• Pending - इंगित करता है कि webhook निष्पादित होने की प्रक्रिया में है और अभी तक पूरा नहीं हुआ है
• Retry - इंगित करता है कि webhook निष्पादन विफल हो गया लेकिन Success या Failed status में बदलने तक 5 से अधिक बार पुनः प्रयास नहीं किया जाएगा
• Skipped - इंगित करता है कि webhook निष्पादित नहीं किया गया था क्योंकि यह disabled था

​

Webhook payload

• id: String - सभी delivered alert events में अद्वितीय ID (UUID)।
• event_type: TEST | ALERT - webhook event type का प्रकार।
• transaction: Object - एक un-decoded transaction का प्रतिनिधित्व करने वाला object जिसने alert और webhook निष्पादन को ट्रिगर किया।

​

Webhook को सुरक्षित करना

1. signing secret,
2. संपूर्ण webhook request payload,
3. timestamp (payload का)।

func isValidSignature(
  signature string,
  payload []byte,
  timestamp string,
) bool {
  h := hmac.New(sha256.New, []byte(signingKey))
  h.Write(payload)
  h.Write([]byte(timestamp))
  digest := hex.EncodeToString(h.Sum(nil))
  return digest == signature
}

function isValidSignature(signature, payload, timestamp) {
  // Create a HMAC SHA256 hash using the signing key
  const hmac = crypto.createHmac("sha256", signingKey);

  // Update the hash with the request body using utf8
  hmac.update(payload.toString(), 'utf8');

  // Update the hash with the request timestamp
  hmac.update(timestamp);
  const digest = hmac.digest("hex");
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(digest))
}

def isValidSignature(signature: string, payload: bytes, timestamp: string):
    h = hmac.new(str.encode(signingKey), payload, hashlib.sha256)
    h.update(str.encode(timestamp))
    digest = h.hexdigest()
    return hmac.compare_digest(signature, digest)

​

Webhook निष्पादनों का Debugging