ساخت و بررسی امضای HMAC وبهوکهای GitHub، Stripe و Slack
سرویسهایی مثل GitHub، Stripe و Slack وقتی رخدادی پیش میآید، یک درخواست وبهوک به سرور شما میفرستند و آن را با HMAC و یک رمز مشترک امضا میکنند. سرور شما باید همان امضا را حساب کند و مقایسه کند تا مطمئن شود پیام واقعاً از آن سرویس آمده و در راه تغییر نکرده است. وقتی امضا نمیخواند، پیدا کردن دلیلش سخت است.
این ابزار امضا را به همان شکلی میسازد و میسنجد که هر ارائهدهنده انتظار دارد، با سرآیند درست، و برای Stripe و Slack برچسب زمانی و بازهی مجاز را هم بررسی میکند. رمز و بدنه از مرورگر شما بیرون نمیروند و در تاریخچه ذخیره نمیشوند.
ارائهدهنده را انتخاب کنید
GitHub، Stripe، Slack یا حالت عمومی را بردارید؛ قالب رشتهی امضاشده، سرآیند و الگوریتم مطابق مستندات همان سرویس تنظیم میشود.
رمز و بدنه را بدهید
«رمز مشترک» را همانطور که در تنظیمات ارائهدهنده آمده بنویسید و بدنهی خام درخواست را دقیقاً با همان بایتها بچسبانید.
امضا بسازید
در «ساخت امضا» سرآیند امضا ساخته میشود تا با آن درخواست آزمایشی به سرور خودتان بفرستید.
امضای دریافتی را بسنجید
در «بررسی امضا» مقدار سرآیند دریافتی را بچسبانید. نتیجه یکی از «امضا معتبر»، «امضا نامعتبر»، «امضا درست، ولی قدیمی» یا «امضا خوانا نیست» است.
نمونهی مستندات GitHub
رمز و بدنهی نمونهای که GitHub در راهنمای اعتبارسنجی وبهوک آورده است.
Hello, World!
نتیجه: X-Hub-Signature-256: sha256=757107ea0eb2509fc211221cce984b8a37570b6d7586c22c46f4379c8b043e17
بدنهای که یک نویسه فرق دارد
همان امضا برای بدنهای با یک علامت تعجب بیشتر سنجیده میشود.
Hello, World!!
نتیجه: امضا نمیخواند: رمز اشتباه است، یا بدنه دقیقاً همان بایتهای دریافتی نیست (فاصله، خط جدید یا قالببندی دوبارهی JSON).
رمز همانطور که در تنظیمات ارائهدهنده آمده است.
بدنه را دقیقاً همانطور که رسیده بچسبانید؛ یک فاصله یا خط جدید امضا را عوض میکند.