گزارش رخدادها
همه اقدام‌های حیاتی فضای کاری خود را دنبال کنید
گزارش رخدادها
گزارش رخدادها یک مسیر امنیتی جامع از تمام اقدام‌های مهمی که در فضای کاری شما انجام می‌شود ارائه می‌دهد.
گزارش رخدادها چیست؟
گزارش رخدادها مشخص می‌کنند چه کسی، چه کاری، چه زمانی و کجا در فضای کاری شما انجام داده است:
اطلاعات ثبت‌شده:
- انجام‌دهنده: چه کسی این اقدام را انجام داده (نام + ایمیل)
- اقدام: چه کاری انجام شده است
- منبع: چه چیزی تحت تأثیر قرار گرفته (کلید API، عضو، کیف پول)
- زمان: تاریخ و ساعت دقیق
- آدرس IP: محل انجام اقدام (در صورت وجود)
- User Agent: اطلاعات مرورگر/دستگاه
- فراداده: جزئیات بیشتر مختص هر اقدام
هدف:
- پایش امنیتی
- الزامات انطباق
- اشکال‌زدایی مشکلات
- پاسخگویی
- بررسی‌های قانونی و فنی
چه کسی به گزارش رخدادها دسترسی دارد؟
| نقش | دسترسی |
|---|---|
| عضو | ❌ بدون دسترسی |
| مدیر | ✅ دسترسی کامل |
| مالک | ✅ دسترسی کامل |
دسترسی مدیر و مالک:
- مشاهده تمام گزارش رخدادهای فضای کاری
- مشاهده اقدام‌های همه اعضا
- خروجی گرفتن از گزارش‌ها (به‌زودی)
- جست‌وجو و فیلتر کردن
اقدام‌های ثبت‌شده
اقدام‌های مربوط به اعضا
دعوت‌ها:
MEMBER_INVITED- عضو جدید به فضای کاری دعوت شدINVITATION_ACCEPTED- عضو دعوت‌نامه را پذیرفتINVITATION_REVOKED- دعوت‌نامه لغو شدINVITATION_EXPIRED- دعوت‌نامه منقضی شد (72 ساعت)
تغییرات نقش:
MEMBER_ROLE_CHANGED- نقش عضو به‌روزرسانی شد (OWNER/ADMIN/MEMBER)MEMBER_PROMOTED- عضو به نقش بالاتری ارتقا یافتMEMBER_DEMOTED- عضو به نقش پایین‌تری تنزل یافت
حذف:
MEMBER_REMOVED- عضو از فضای کاری حذف شد
اقدام‌های کلید API
ایجاد:
API_KEY_CREATED- کلید API جدید ساخته شد- ثبت می‌شود: برچسب کلید، محدوده (PERSONAL/TEAM)، سازنده
مدیریت:
API_KEY_BLOCKED- کلید به‌طور موقت غیرفعال شدAPI_KEY_UNBLOCKED- کلید دوباره فعال شدAPI_KEY_REVOKED- کلید برای همیشه حذف شدAPI_KEY_LIMIT_UPDATED- سقف ماهانه تغییر کرد
اقدام‌های کیف پول
افزایش اعتبار:
FUNDS_DEPOSITED- پرداخت ارز دیجیتال دریافت شد- ثبت می‌شود: مبلغ، ارز، شناسه تراکنش
تغییرات وضعیت:
WALLET_FROZEN- کیف پول مسدود شد (موجودی = $0 یا اقدام مدیر)WALLET_UNFROZEN- کیف پول دوباره فعال شدLOW_BALANCE_ALERT- موجودی به زیر آستانه افت کرد
تعدیل‌های دستی:
FUNDS_REFUNDED- مدیر بازپرداخت صادر کردBALANCE_ADJUSTED- مدیر موجودی را به‌صورت دستی تعدیل کرد
اقدام‌های فضای کاری
تنظیمات:
ORG_SETTINGS_UPDATED- نام یا تنظیمات فضای کاری تغییر کردORG_TIER_CHANGED- سطح اشتراک ارتقا/تنزل یافتORG_LOW_BALANCE_THRESHOLD_UPDATED- آستانه هشدار تغییر کرد
چرخه عمر:
ORG_CREATED- فضای کاری برای اولین بار ایجاد شدORG_FROZEN- مدیر فضای کاری را مسدود کردORG_UNFROZEN- مسدودی فضای کاری رفع شدORG_DELETED- فضای کاری برای همیشه حذف شد
اقدام‌های احراز هویت
ورود:
USER_SIGNED_IN- عضو وارد شدUSER_SIGNED_OUT- عضو خارج شدFAILED_SIGN_IN_ATTEMPT- ورود ناموفق (امنیتی)
اقدام‌های امنیتی
فعالیت مشکوک:
SUSPICIOUS_ACTIVITY_DETECTED- الگوی غیرعادی شناسایی شدRATE_LIMIT_EXCEEDED- تعداد درخواست‌ها بیش از حد مجازUNAUTHORIZED_ACCESS_ATTEMPT- دسترسی رد شد
جزئیات رکورد گزارش
اطلاعات پایه
هر رکورد گزارش شامل موارد زیر است:
زمان:
2024-01-15 14:32:47 UTC- تاریخ و ساعت دقیق
- منطقه زمانی: UTC
- دقت در حد میلی‌ثانیه
انجام‌دهنده:
John Smith (john@example.com)- نام کامل
- آدرس ایمیل
- شناسه کاربر (ارجاع داخلی)
اقدام:
API_KEY_CREATED- کد اقدام استاندارد
- توضیح قابل‌فهم برای انسان
- دسته‌بندی (MEMBER، API_KEY، WALLET، ORG)
اطلاعات تفصیلی
منبع:
Resource Type: API_KEY
Resource ID: key_abc123
Resource Name: "Production API Key"فراداده (بسته به نوع اقدام متفاوت است):
برای API_KEY_CREATED:
{
"keyLabel": "Production API Key",
"scope": "TEAM",
"scopes": ["gpt-4", "claude-3"],
"monthlyLimit": 100.00,
"createdBy": "john@example.com"
}برای MEMBER_ROLE_CHANGED:
{
"memberEmail": "jane@example.com",
"oldRole": "MEMBER",
"newRole": "ADMIN",
"changedBy": "john@example.com",
"reason": "Promoted to team lead"
}برای FUNDS_DEPOSITED:
{
"amount": 100.00,
"currency": "USD",
"paymentMethod": "USDT_TRC20",
"transactionId": "0x123abc...",
"providerReference": "nowpayments_12345"
}آدرس IP:
203.0.113.1- IP مبدأ اقدام
- مفید برای تحلیل امنیتی
- تشخیص موقعیت‌های غیرعادی
User Agent:
Mozilla/5.0 (Windows NT 10.0; Win64; x64)
AppleWebKit/537.36 Chrome/120.0.0.0- اطلاعات مرورگر و دستگاه
- تشخیص کلاینت‌های مشکوک
- درک الگوهای دسترسی
استفاده از گزارش رخدادها
مشاهده گزارش‌ها
- به صفحه گزارش رخدادها بروید
- جدیدترین گزارش‌ها ابتدا نمایش داده می‌شوند
- در فهرست زمانی پیمایش کنید
- برای نمایش جزئیات روی هر رکورد کلیک کنید
صفحه‌بندی
- 50 گزارش در هر صفحه (پیش‌فرض)
- برای بارگذاری گزارش‌های قدیمی‌تر روی «بعدی» کلیک کنید
- برای بازگشت روی «قبلی» کلیک کنید
- شماره صفحات در پایین نمایش داده می‌شود
خواندن رکوردهای گزارش
نمای گسترش‌یافته نشان می‌دهد:
- زمان کامل به همراه منطقه زمانی
- نام و ایمیل انجام‌دهنده
- اقدام انجام‌شده
- منبع تحت تأثیر
- فراداده کامل
- آدرس IP
- User Agent
- شناسه‌های داخلی برای ارجاع
موارد استفاده رایج
بررسی امنیتی
سناریو: مصرف مشکوک یک کلید API شناسایی شده است
مراحل بررسی:
- به گزارش رخدادها بروید
- رکوردهای API_KEY_CREATED را جست‌وجو کنید
- بررسی کنید چه کسی کلید مشکوک را ساخته است
- زمان ایجاد را مشاهده کنید
- آدرس IP را بررسی کنید (از موقعیت متفاوتی؟)
- اقدام‌های مرتبط دیگر همان انجام‌دهنده را بررسی کنید
- بررسی کنید آیا کلید لغو شده است
- الگو را شناسایی کنید
یافته‌های نمونه:
2024-01-15 03:00:00 - API_KEY_CREATED
Actor: john@example.com
IP: 103.45.67.89 (Vietnam)
Usual IP: 203.0.113.1 (USA)
Action: Created key with no monthly limitاقدام: احتمالاً کلید توسط یک حساب هک‌شده ساخته شده است ← رمز عبور را بازنشانی کنید، کلید را لغو کنید، بررسی بیشتری انجام دهید
بازرسی انطباق
سناریو: بازبینی امنیتی فصلی
مراحل:
- گزارش رخدادها را برای بازه موردنظر خروجی بگیرید (به‌زودی)
- بر اساس نوع اقدام فیلتر کنید:
- MEMBER_INVITED، MEMBER_REMOVED
- API_KEY_CREATED، API_KEY_REVOKED
- MEMBER_ROLE_CHANGED
- تأیید کنید تمام اقدام‌ها مجاز بوده‌اند
- الگوهای غیرعادی را بررسی کنید
- یافته‌ها را مستند کنید
الزامات انطباق برآورده‌شده:
- ✅ ردیابی تمام تغییرات دسترسی
- ✅ پایش اقدام‌های ممتاز
- ✅ مسیر رخدادهای تغییرناپذیر
- ✅ ثبت زمان تمام رویدادها
- ✅ شناسایی طرف‌های مسئول
عیب‌یابی
سناریو: عضوی می‌گوید کلید API را حذف نکرده است
بررسی:
- گزارش‌ها را برای API_KEY_REVOKED جست‌وجو کنید
- رکورد لغو کلید را پیدا کنید
- انجام‌دهنده را بررسی کنید (چه کسی این کار را کرده)
- زمان را بررسی کنید (چه زمانی)
- IP/User Agent را بررسی کنید
- تأیید کنید که واقعاً همان عضو بوده است
یافته‌های محتمل:
Actor: admin@example.com (Admin)
Time: 2024-01-14 18:00:00
Action: API_KEY_REVOKED
Reason: "Monthly limit exceeded, key disabled"نتیجه: مدیر کلید را لغو کرده، نه عضو. دلیل توضیح داده شد.
تخصیص هزینه
سناریو: مصرف بالای غیرمنتظره
بررسی:
- گزارش فراخوانی‌های API را برای مصرف بالا بررسی کنید
- کلید API مسئول را شناسایی کنید
- به گزارش رخدادها بروید
- رکورد API_KEY_CREATED آن کلید را پیدا کنید
- ببینید چه کسی آن را ساخته است
- اگر عضو جدیدی است، MEMBER_INVITED را بررسی کنید
- هزینه را به طرف مسئول نسبت دهید
مثال:
Key: "Test Key 123"
Created by: contractor@example.com
Created: 2024-01-10
Usage: $500 in 3 days
Issue: No monthly limit setاقدام: سقف ماهانه تعیین کنید، درباره مصرف با پیمانکار صحبت کنید
بهترین شیوه‌های امنیتی
پایش منظم
روزانه:
- بررسی افزودن اعضای غیرمنتظره
- بررسی ایجاد کلیدهای API
- بررسی تغییرات نقش
هفتگی:
- بررسی کامل گزارش رخدادها
- بررسی IPهای مشکوک
- تأیید مجاز بودن تمام اقدام‌ها
ماهانه:
- گزارش انطباق
- خروجی گرفتن از گزارش‌ها برای بایگانی
- بررسی الگوهای دسترسی
نشانه‌های هشدار برای توجه
اقدام‌های اعضا:
- 🚩 عضوی خارج از ساعات کاری دعوت شده است
- 🚩 چند تغییر نقش در بازه زمانی کوتاه
- 🚩 عضوی حذف و سپس دوباره اضافه شده است
- 🚩 دعوت از IP غیرعادی
اقدام‌های کلید API:
- 🚩 کلیدهایی بدون سقف ماهانه ساخته شده‌اند
- 🚩 تعداد زیادی کلید به‌سرعت ساخته شده‌اند
- 🚩 کلیدها خارج از ساعات کاری ساخته شده‌اند
- 🚩 کلید بلافاصله پس از ایجاد لغو شده است
اقدام‌های کیف پول:
- 🚩 افزایش اعتبار با مبلغ بالا از IP ناشناس
- 🚩 رفع مسدودی کیف پول توسط فردی غیر از مالک
- 🚩 چند تلاش پیاپی برای افزایش اعتبار
اقدام‌های فضای کاری:
- 🚩 تنظیمات به‌طور غیرمنتظره تغییر کرده‌اند
- 🚩 آستانه موجودی کم روی $0 تنظیم شده است
- 🚩 نام فضای کاری تغییر کرده است
واکنش به فعالیت مشکوک
اقدام‌های فوری:
- کلیدهای API مشکوک را مسدود کنید
- رمز عبور اعضای هک‌شده را تغییر دهید
- اعضای غیرمجاز را حذف کنید
- در صورت نیاز کیف پول را مسدود کنید (جلوگیری از ضرر مالی)
- همه چیز را مستند کنید
بررسی:
- مسیر کامل رخدادها را بازبینی کنید
- اقدام‌های مرتبط را بررسی کنید
- نقطه ورود را شناسایی کنید
- میزان خسارت را ارزیابی کنید
- علت اصلی را تعیین کنید
اصلاح:
- رخنه امنیتی را برطرف کنید
- اعتبارنامه‌های تحت تأثیر را بازنشانی کنید
- کنترل‌های اضافی اعمال کنید
- تیم را از یافته‌ها مطلع کنید
- برای تکرار احتمالی پایش کنید
نگهداری داده
دوره نگهداری:
- گزارش رخدادها برای همیشه نگهداری می‌شوند
- هرگز به‌طور خودکار حذف نمی‌شوند
- الزامات انطباق را پشتیبانی می‌کنند
- در طول عمر فضای کاری در دسترس هستند
تغییرناپذیری:
- گزارش‌ها قابل ویرایش نیستند
- گزارش‌ها قابل حذف نیستند (توسط هیچ‌کس)
- رکورد دائمی
- غیرقابل دستکاری
دسترسی:
- فقط مدیران و مالکان
- بدون دسترسی برای عضو
- خروجی گرفتن به‌زودی
- دسترسی از طریق API در برنامه آینده
محدودیت‌ها
محدودیت‌های فعلی:
- ❌ هنوز امکان جست‌وجو بر اساس کلیدواژه وجود ندارد
- ❌ امکان فیلتر بر اساس نوع اقدام وجود ندارد
- ❌ امکان خروجی گرفتن به CSV/JSON وجود ندارد
- ❌ هشداردهی برای اقدام‌های خاص وجود ندارد
- ❌ اعلان لحظه‌ای وجود ندارد
به‌زودی:
- ✅ جست‌وجوی پیشرفته
- ✅ گزینه‌های فیلتر
- ✅ خروجی CSV/JSON
- ✅ اعلان‌های وب‌هوک
- ✅ قوانین هشدار سفارشی
- ✅ یکپارچه‌سازی با سامانه‌های SIEM
ویژگی‌های مرتبط
گزارش فراخوانی‌های API:
- مشاهده مصرف واقعی API
- متفاوت از گزارش رخدادها
- نمایش فعالیت فنی
- مشاهدهٔ گزارش فراخوانی‌های API
مصرف و تحلیل:
- الگوهای مصرف
- روند هزینه
- معیارهای عملکرد
- مشاهده مصرف و تحلیل
تراکنش‌های کیف پول:
- سابقه رخدادهای مالی
- افزایش اعتبار و کسری‌ها
- تاریخچه موجودی
- مشاهده کیف پول
سوالات متداول
آیا گزارش رخدادها قابل حذف است؟
خیر. گزارش رخدادها دائمی و تغییرناپذیر هستند.
چرا؟
- الزام امنیتی
- ضرورت انطباق
- شواهد قانونی و فنی
- پاسخگویی
آیا کسی می‌تواند گزارش رخدادها را تغییر دهد؟
خیر. حتی مدیران پلتفرم هم نمی‌توانند گزارش‌ها را تغییر دهند.
یکپارچگی از این طریق تضمین می‌شود:
- پایگاه داده فقط-افزایشی (append-only)
- هش رمزنگاری‌شده (به‌زودی)
- ذخیره‌سازی تغییرناپذیر
- ثبت رخدادهای خودِ رخدادها (اقدام‌های مدیر جداگانه ثبت می‌شوند)
گزارش‌ها چقدر به عقب برمی‌گردند؟
تا ابتدا. تمام گزارش‌ها از زمان ایجاد فضای کاری نگهداری می‌شوند.
سیاست نگهداری:
- بدون حذف خودکار
- در طول عمر فضای کاری در دسترس
- حتی پس از خروج عضو
- حتی پس از لغو کلید
آیا می‌توانم برای اقدام‌های خاص هشدار دریافت کنم؟
هنوز نه، اما به‌زودی اضافه می‌شود.
ویژگی‌های برنامه‌ریزی‌شده:
- هشدارهای ایمیلی برای اقدام‌های حیاتی
- اعلان‌های وب‌هوک
- یکپارچه‌سازی با Slack/Discord
- قوانین هشدار سفارشی
آیا می‌توانم از گزارش رخدادها خروجی بگیرم؟
به‌زودی. ویژگی‌های خروجی گرفتن در حال توسعه هستند.
قالب‌های برنامه‌ریزی‌شده:
- CSV برای صفحات‌گسترده
- JSON برای دسترسی برنامه‌نویسی‌شده
- PDF برای گزارش‌های انطباق
- دسترسی از طریق API برای خودکارسازی