اشتراک وضعیت

در پنل ستون امکانی فراهم شده است تا کاربران بتوانند از حوادثی که بر روی هر یک از سرویس‌ها اتفاق می‌افتد و در صفحه وضعیت نمایش داده می‌شود باخبر شوند. در ادامه به توضیح دو مفهوم که در پیکربندی این موضوع با آن روبه‌رو خواهید شد و گام‌های پیکربندی اشتراک وضعیت خواهیم پرداخت.

برای اینکه بتوانید کانال مورد نظر خود را برای خبردار شدن از اتفاقاتی که برای سرویس‌ها می‌افتد انتخاب کنید از قسمت پروفایل، گزینه‌ی «اشتراک وضعیت/ status subscriptions» را انتخاب کنید.

برای پیکربندی، ابتدا از سمت راست صفحه گزینه‌ی «کانال‌های اعلان/ notification channels» را انتخاب کنید. کانال‌های مختلفی برای مطلع شدن از وضعیت سرویس‌ها در نظر گرفته شده است که بسته به نیاز خود می‌توانید یک یا چند کانال را انتخاب کنید. در ادامه به نحوه پیکربندی هر کانال خواهیم پرداخت.

برای اینکه از طریق کانال اسلک با خبر شوید، از قسمت Slack گزینه‌ی «اضافه کردن/ add new» را انتخاب کنید.

در صفحه‌ی باز شده فیلدهای مختلفی وجود دارد که در ادامه به توضیح هریک از آن‌ها خواهیم پرداخت.
نام: یک نام دلخواه برای کانال ارتباطی که در حال پیکربندی آن هستید انتخاب کنید.

URL: در اسلک مفهومی به نام webhook وجود دارد. برای اینکه URL مناسب برای این قسمت را پیدا کنید مراحل گفته شده در این صفحه را طی کنید. سپس فیلد مرتبط با URL را با URL خود پر کنید.

در این صفحه می‌توانید تنظیمات دیگری را نیز پیکربندی کنید:

Mention channel: با انتخاب این گزینه، وقتی که پیامی روی این کانال منتشر می‌شود، کل کانال منشن خواهند شد.

همچنین با استفاده از فیلدهای Groups و Users می‌توانید انتخاب کنید که گروه‌ها یا کاربران خاصی را منشن کند.

Groups: برای انتخاب گروه‌هایی که می‌خواهید منشن شوند، باید ID مرتبط با آن گروه‌ها را در این فیلد وارد کنید. برای دریافت ID گروه‌ها در اسلک به قسمت اطلاعات گروه و سپس about وارد شوید و در آن‌جا ID مرتبط با آن گروه را مشاهده خواهید کرد.

Users: برای انتخاب کاربرانی که می‌خواهید منشن شوند، باید ID مرتبط با آن کاربرها را در این فیلد وارد کنید. برای دریافت ID کاربر در اسلک به قسمت View Profile و سپس more وارد شوید و در آن‌جا ID مرتبط با کاربر را مشاهده خواهید کرد.

توجه: توجه داشته باشید که ID گروه‌ها و همچنین ID کاربران را باید با کاما از یکدیگر جدا شوند.

برای اینکه از طریق webhook از اتفاقات مرتبط با سرویس‌ها باخبر شوید، از قسمت webhook گزینه‌ی «اضافه کردن/ add new» را انتخاب کنید.

در صفحه‌ی باز شده فیلدهای مختلفی وجود دارد که در ادامه به توضیح هریک از آن‌ها خواهیم پرداخت:

نام: یک نام دلخواه برای کانال ارتباطی که در حال پیکربندی آن هستید انتخاب کنید.

URL: زمانی که اتفاقی بر روی سرویس رخ دهد، این آدرس، با داده‌های مربوط به آن اتفاق، فراخوانی (call) خواهد شد.

(معمولا برخی از مشتری‌ها برای اینکه همه‌ی اعلان‌ها (alertها) را بر روی یک سیستم داشته باشند، از یک webhook استفاده می‌کنند که با آن بر روی همه‌ی سرویس‌ها subscribe می‌کنند. این URL با یک شمای خاصی که در ادامه مشاهده می‌کنید، فراخوانی می‌شود.

توجه: اگر کاربر مکانیزمی بر روی URL وب‌هوک خود نداشته باشد ممکن است هرکسی بتواند این URL را فراخوانی کرده و داده‌های اشتباهی را برای آن‌ها ارسال کند. ستون برای جلوگیری از این موضوع به فراخوانی‌های خود یک امضای دیجیتال اضافه می‌کند و محتوای پیام را به صورت متقارن رمز می‌کند و یک کلید در اختیار کاربر قرار می‌دهد که فقط با آن کلید می‌تواند پیام مورد نظر را باز کند و این‌گونه می‌تواند مطمئن باشد که پیام از سمت ستون ارسال شده است.

توجه: پس از ساخت کانال، یک کلید در اختیار کاربران قرار خواهد گرفت که می‌توانند آن را از طریق پنل کپی و استفاده کنند.

همانطور که در ادامه مشاهده خواهید کرد، در پایتون به‌صورت زیر می‌توانید پیام ارسال شده از طرف ستون را رمزگشایی کنید.

هر درخواست ورودی از ستون شامل دو هدر اضافی X-Sotoon-Signature و X-Sotoon-Timestamp است. شما می‌توانید از X-Sotoon_Signature برای تایید پیلود (payload) و از X-Sotoon-Timestamp برای جلوگیری از حملات بازپخش (Replay Attacks) استفاده کنید.

secret key کاربر وب‌هوک: هر کاربر وب‌هوک یک secret key منحصزبه‌فرد دارد. این secret key برای امضای تک‌تک درخواست‌های دریافتی از ستون استفاده می‌شود. شما برای تایید امضای پیلود درخواست به این امضا نیاز دارید.

تایید امضا: برای تایید پیلود درخواست‌های دریافتی، گام‌های زیر را دنبال کنید.

  • هدر X-Sotoon-Timestamp و بدنه‌ی درخواست را دریافت کنید، سپس رشته‌ی پیلود را بسازید.
  • هگز HMAC-SHA256 پیلود را با secret key خود محاسبه کنید. در پایتون می‌توانید از کتابخانه‌ی HMAC استفاده کنید.
  • امضای محاسبه‌شده را با هدر X-Sotoon-Signature دریافت‌شده مقایسه کنید.
  • شما می‌توانید از متدهایی مانند compare_digest برای جلوگیری از حملات زمان‌بندی استفاده کنید.

جلوگیری از حملات بازپخش: تفاوت بین timestamp فعلی و X-Sotoon-Timestamp را محاسبه کنید. سپس تعیین کنید که آیا میزان تفاوت عادی است یا خیر. (تفاوت توصیه‌شده ۵ دقیقه است.)

برای اینکه از طریق چنل کلیک از اتفاقات مرتبط با سرویس‌ها با خبر شوید، از قسمت Cliq گزینه‌ی «اضافه کردن/ add new» را انتخاب کنید.

در صفحه‌ی باز شده فیلدهای مختلفی وجود دارد که در ادامه به توضیح هر یک از آن‌ها خواهیم پرداخت:

نام: یک نام دلخواه برای کانال ارتباطی که در حال پیکربندی آن هستید انتخاب کنید.

URL: برای دریافت URL مرتبط با کانالی که می‌خواهید از آن برای دریافت اخبار اتفاقات باخبر شوید، بر روی پروفایل کانال کلیک کنید و به قسمت Connectors وارد شوید. در این قسمت API Endpoint را مشاهده خواهید کرد که می‌توانید از آن به‌عنوان URL استفاده کنید.

توکن (Token): برای دریافت توکن، در کلیک، به قسمت پروفایل، سپس bots and tools مراجعه کنید. در صفحه‌ی باز شده قسمت webhook Tokens را انتخاب کنید و بر روی Generate new token کلیک کنید.

پس از اینکه کانال‌های ارتباطی مد نظر خود را از قسمت کانال‌های ارتباطی/ Notification channels پیکربندی کردید. وارد قسمت اشتراک وضعیت/ status subscriptions شوید. در این قسمت می‌توانید انتخاب کنید که بر روی چه کانالی از اتفاقات مرتبط با چه سرویس‌هایی باخبر شوید.

برای این کار گزینه‌ی اشتراک جدید/ New subscription را انتخاب کنید. در صفحه‌ی باز شده فیلدهایی وجود دارد که در ادامه به توضیح هریک از آن‌ها خواهیم پرداخت.

نام: یک نام دلخواه برای اشتراکی که در حال پیکربندی آن هستید انتخاب کنید.

کانال: در این قسمت می‌توانید لیست کانال‌های ارتباطی که قبلا پیکربندی کرده‌اید را مشاهد کنید و یکی از آن‌ها را به دلخواه انتخاب کنید.

سرویس‌ها: در این قسمت می‌توانید از لیستی که به شما ارائه می‌شود سرویس‌هایی را که می‌خواهید از وضعیت آن‌ها با خبر شوید را انتخاب کنید.

active: با انتخاب این گزینه اشتراک خود را فعال می‌کنید، همچنین می‌توانید هر زمان که خواستید به جای اینکه آن را حذف کنید از قسمت «ویرایش» این اشتراک را با برداشتن تیک active غیرفعال کنید.

توجه: امکان حذف یا ویرایش هر اشتراکی که ساخته‌اید در پنل موجود است.

آیا این مقاله به شما کمک کرد؟

با نظر دادن به بهبود کیفیت مستندات کمک کنید

sotoon

کلیه حقوق مادی و معنوی محفوظ است. © ۱۴۰۴ ستون/ شرکت رایانش ابری واحد هزاردستان