حماية الرموز
رمز البوت كلمة مرور. من يملكه يتصرف باسم بوتك في كل سيرفر هو فيه.
القواعد
- أبعد الرمز عن كودك. اقرأه من متغير بيئة أو مخزن أسرار.
- لا تضعه أبدًا في Git أو لقطة شاشة أو محادثة أو طلب دعم.
- لا تسجله أبدًا في السجلات. سجّل معرّف البوت بدلًا منه.
- استخدم
Authenticateفي البوابة لا?token=في العنوان: فالعناوين تنتهي في السجلات. - شغّل البوت برمز خاص به. استخدم بوتًا ثانيًا للاختبار.
أبعده عن Git
echo ".env" >> .gitignore
echo "ZRZUR_BOT_TOKEN=YOUR_BOT_TOKEN" > .env
node --env-file=.env full-bot.mjsnode --env-file مدمج في Node 22.
إذا تسرب الرمز
- افتح تطبيقك في بوابة المطورين، تبويب نظرة عامة، واختر إعادة تعيين الرمز.
- أكّد هويتك. يتوقف الرمز القديم فورًا، وتنتهي الاتصالات المفتوحة.
- ضع الرمز الجديد في مخزن الأسرار وأعد تشغيل البوت.
- اقرأ سجل التدقيق في السيرفر لتعرف ما فعله البوت. تظهر أفعال بوتك والبوت هو الفاعل.
اعتبر الرمز الذي وُضع في مستودع عام مسروقًا، حتى لو أزلته بعد دقيقة.
أسرار أخرى
| السر | مدته | إذا تسرب |
|---|---|---|
| رمز البوت | حتى تعيد تعيينه | أعد تعيينه |
| رمز التفاعل | 15 دقيقة | يعمل على تفاعل واحد. أبعده عن السجلات |
| عنوان الويب هوك | حتى يُستبدل | ينشئ POST /webhooks/{webhook_id}/token عنوانًا جديدًا. يبدأ بـzrzur_wh_ |
| سر التوقيع | حتى يُستبدل | أنشئ سرًا جديدًا في تفاعلات HTTP |
| سر عميل OAuth2 | حتى تعيد تعيينه | أعد تعيينه في تبويب OAuth2 |
| رمز وصول OAuth2 | ساعة واحدة | POST /oauth2/revoke |
| رمز تحديث OAuth2 | 30 يومًا | POST /oauth2/revoke. إعادة استخدامه تنهي السلسلة كلها |
احمِ من يستخدم بوتك
- لا تثق بشيء في رسالة أو
custom_idأو نموذج كأنه منك. من يرى الزر يستطيع إرسال ما يرسله الزر. - قبل أن تتصرف باسم شخص، افحص
user_permissions_string. صلاحيات البوت ليست صلاحياته. - امنع الذكر في مخرجاتك بـ
allowed_mentionsفي الويب هوك، أو بعدم تكرار نص لم تكتبه. - خزّن أقل قدر ممكن. احذف بيانات المستخدم عند
UserPlatformWipe، وبيانات السيرفر عند مغادرة البوت. - لا تطلب إلا نيّات الاتصال والصلاحيات التي تستخدمها.