جدول المحتويات

نظرة عامة إدارة الأسرار أمان الشبكة تحديد معدل الطلبات التشفير و SSL رؤوس الأمان الحماية من هجمات DDoS استجابة للحوادث الامتثال قائمة مراجعة الأمن

توثيق API

أفضل ممارسات أمان API وتأمينها

تنفيذ ممارسات أمان شاملة لدمج Smart Money API. إتقان إدارة الأسرار، أمان الشبكة، تحديد معدل الطلبات، والامتثال.

نُشر في 21 مارس 2026 • 19 دقيقة قراءة • حرج

نظرة عامة على الأمان

يتبع Smart Money API أفضل الممارسات الصناعية للأمان. يغطي هذا الدليل مسؤولياتك في حماية تكاملك وبيانات المستخدم.

طبقات الأمان:

طبقة النقل — تشفير TLS 1.3 لجميع حركة المرور
طبقة المصادقة — مفاتيح API، OAuth 2.0، MFA
طبقة التفويض — التحكم في الوصول بناءً على النطاق
تحديد معدل الطلبات — الحماية من هجمات DDoS والقوة الغاشمة
حماية البيانات — التشفير في حالة السكون وفي أثناء النقل

حرج: لا تقم بتشفير مفاتيح API في الكود مطلقًا. استخدم متغيرات البيئة أو أنظمة إدارة الأسرار.

إدارة الأسرار

أفضل الممارسات

التخزين في متغيرات البيئة، وليس في الكود
استخدم أنظمة إدارة الأسرار (Vault، AWS Secrets Manager)
قم بتدوير المفاتيح على جدول زمني (ربع سنوي على الأقل)
مراجعة سجلات الوصول بانتظام
قم بتدوير المفاتيح المخترقة فورًا
استخدم مفاتيح مختلفة للبيئات المختلفة

التنفيذ

تحميل مفتاح API بشكل آمن
// التحميل من البيئة، وليس مشفرًا
const apiKey = process.env.SMARTMONEY_API_KEY;
if (!apiKey) throw new Error('API key not configured');
// استخدم في الرؤوس، لا تسجل أبدًا
const headers = {
  'Authorization': `Bearer ${apiKey}`
};

احصل على مفتاح API في 30 ثانية

مستعد للبناء؟ احصل على مفتاح API مجاني (100 استدعاء/يوم، بدون بطاقة) وابدأ في سحب بيانات الحيتان، التمويل والبيانات على السلسلة مباشرة.

احصل على مفتاح API →

أمان الشبكة

متطلبات TLS/SSL

الحد الأدنى TLS 1.2 مطلوب (يوصى بـ TLS 1.3)
تحقق من شهادات SSL في الإنتاج
لا تعطِل التحقق من الشهادة أبدًا
استخدم تثبيت الشهادة للتطبيقات المحمولة

القائمة البيضاء لـ IP

إعداد القائمة البيضاء لـ IP
// تقييد وصول API إلى خوادمك
POST /v1/account/ip-whitelist
  -d '{
    "cidr": "203.0.113.0/24",
    "description": "خوادم الإنتاج"
  }'

تحديد معدل الطلبات و DDoS

تنفيذ التراجع

التراجع الأسي
// تنفيذ التراجع الأسي عند 429
async function apiCall(retries = 0) {
  try {
    return await fetch(url, options);
  } catch (err) {
    if (err.status === 429 && retries < 5) {
      const delay = Math.pow(2, retries) * 1000;
      await sleep(delay);
      return apiCall(retries + 1);
    }
    throw err;
  }
}

التشفير و SSL/TLS

التحقق من الشهادة

HTTPS آمن
// Node.js: تحقق من الشهادات (السلوك الافتراضي)
const https = require('https');
const agent = new https.Agent({
  rejectUnauthorized: true,  // لا تعطِل أبدًا!
  minVersion: 'TLSv1.2'
});

رؤوس الأمان

الرؤوس المطلوبة

الرأس	الغرض
X-Request-ID	التتبع والتدقيق
User-Agent	تحديد تطبيقك
Accept	تنسيق الطلب (application/json)
Authorization	بيانات الاعتماد للمصادقة

الحماية من DDoS

حماية Smart Money

حماية Cloudflare من DDoS (الطبقة 3/4 والطبقة 7)
تحديد معدل الطلبات لكل مفتاح API
حدود معدل جغرافية
الكشف التلقائي والتخفيف

مسؤولياتك

تنفيذ مهلة الطلب (30 ثانية)
استخدم تجميع الاتصالات
تنفيذ نمط قاطع الدائرة
راقب النشاط غير المعتاد

استجابة للحوادث

إذا تم اختراق مفتاحك

فورًا — استدعاء نقطة نهاية إبطال مفتاح API
تحقق من السجلات — مراجعة سجلات وصول API للاستخدام غير المصرح به
تدقيق — تحقق من الرصيد، المعاملات للأنشطة المشبوهة
إنشاء — إنشاء مفتاح API جديد
نشر — تحديث التطبيق بمفتاح جديد
مراقبة — مراقبة للوصول غير المصرح به المستمر

الامتثال

الامتثال للمعايير

SOC 2 النوع الثاني — ضوابط أمان معتمدة
ISO 27001 — إدارة أمن المعلومات
GDPR — الامتثال لخصوصية البيانات
PCI DSS — معايير صناعة بطاقات الدفع

قائمة التحقق الأمنية

قبل الإنتاج

مفاتيح API في متغيرات البيئة، وليس في الكود
HTTPS مفعل، والشهادات تم التحقق منها
تم تنفيذ الحد من المعدل والتراجع
تدوير الأسرار مجدول ربع سنويًا
رؤوس الأمان مُهيأة بشكل صحيح
تسجيل السجلات مُهيأ (لا يتم تسجيل بيانات الاعتماد)

الإنتاج المستمر

مراقبة سجلات وصول API يوميًا
تدوير المفاتيح حسب الجدول
إجراء تدقيق أمني ربع سنوي
تحديث التبعيات لمعالجة الثغرات
اختبار إجراءات الاستجابة للحوادث
مراجعة وتحديث سياسات الأمان

أمن تكاملك

أمان على مستوى المؤسسات لـ Smart Money API. نفذ أفضل الممارسات مع وثائق شاملة ودعم.

عرض ميزات الأمان

تتضمن جميع الخطط التشفير، والحد من المعدل، وتسجيل التدقيق.