منع السحب من مفتاح API يقيد وظيفة مهمة، لكنه لا يجعل المفتاح بلا أثر مالي أو أثر على الخصوصية. قد تظل لديه قدرة على قراءة بيانات الحساب أو إنشاء أوامر أو إلغائها. ابدأ بما يستطيع المفتاح تنفيذه فعلًا، ثم امنحه الحد الذي تحتاجه المهمة بدل الاكتفاء بعبارة «السحب معطل».
جدول المحتويات
ما الذي يمثله مفتاح API؟
يستخدم تطبيق بيانات اعتماد للتواصل مع واجهة الخدمة وتنفيذ الطلبات التي تسمح بها. قد تفصل المنصة بين القراءة والتداول والسحب وغيرها من الوظائف. اقرأ توثيق نوع الحساب والواجهة المستخدمين؛ أسماء الأذونات وحدودها ليست موحدة بين جميع الخدمات.
توضح وثائق Binance مثال الفصل بين مفتاح للتداول ومفتاح لمراقبة بيانات الحساب والأوامر، وتعرض Kraken صلاحيات مفصلة بحسب الوظيفة. الفكرة العملية هي بدء التهيئة بقائمة مهام التطبيق، ثم ربط كل مهمة بأقل وصول لازم، بدل إنشاء مفتاح شامل ثم محاولة تذكر سبب كل إذن لاحقًا.
ولا تخلط سر API الخاص بحساب منصة مع المفتاح الخاص الذي يوقع من عنوان محفظة مستقلة. كلاهما حساس، لكن جهة التحقق وطريقة الإبطال والنطاق تختلف. تسمية دقيقة للمفتاح تمنع اتباع إجراء تغيير لا يمس سلطة البيانات التي خرجت بالفعل.
4 نقاط تشرح لماذا يبقى الخطر دون سحب
1. القراءة قد تكشف معلومات حساسة
قد تتيح صلاحية قراءة بيانات خاصة مثل الأرصدة أو السجل أو تفاصيل أوامر، وفق الواجهة والإذن. عدم القدرة على نقل الأموال لا يجعل هذه البيانات عامة. اسأل ما الذي سيعرفه التطبيق عن نشاطك، وكيف يحتفظ به ومن يستطيع الوصول إليه.
وقد تتغير تغطية واجهة أو صلاحية مع تحديث المنتج، فلا تعتمد على وصف قديم فقط. راجع إشعارات الخدمة والتوثيق عند تغير الواجهات التي يستخدمها التطبيق. جرد المفاتيح ينبغي أن يربط اسم التطبيق بالبيانات التي يقرأها، لا بكلمة «قراءة» مجردة.
2. التداول قد يغير الأصول ويستهلك الرسوم
قد يستطيع مفتاح يملك صلاحية مناسبة إنشاء أوامر شراء أو بيع أو إلغاء أوامر قائمة. حتى دون سحب، يمكن أن ينفذ عمليات لم تقصدها أو يغير تعرض الحساب للسوق. لا تفترض أن بقاء الأموال داخل المنصة يعني أن قيمتها أو تركيبها لا يمكن أن يتغيرا.
وإذا شملت الصلاحيات منتجات ذات اقتراض أو مشتقات أو تحويلات داخلية، فافهم نطاقها من التوثيق بدل تعميم نموذج التداول الفوري. لا يحتاج تطبيق عرض تقارير إلى سلطة تنفيذ أوامر لمجرد أن واجهته تعرض أسعارًا ورسومًا بيانية.
3. اجتماع الأذونات قد يفتح مسارًا أوسع
افحص الأذونات معًا لا كل خانة منفردة. مثلًا توضح Kraken أن صلاحية إضافة عناوين سحب مع صلاحية السحب في المفتاح نفسه ترفع أثر تسربه. هذا مثال محدد لتصميم خدمة، وليس قاعدة تقول إن كل منصة تستخدم الصلاحيات ذاتها.
واسأل هل يستطيع التطبيق إدارة وجهات أو نقل أرصدة بين حسابات أو تغيير إعدادات لها أثر في الاستخدام. إذا لم تكن الوظيفة مطلوبة، فلا تمنحها لتجنب رسالة إعداد مزعجة قبل فهمها. وجود سبب تقني محتمل لا يغني عن شرح المهمة الفعلية.
4. المفتاح قد يظل فعالًا بعد توقف التطبيق
حذف برنامج من جهازك لا يلغي تلقائيًا بيانات اعتماده لدى الخدمة. وكذلك لا تفترض أن تغيير كلمة مرور الدخول يبطل كل مفتاح API؛ اقرأ السياسة وتحقق من حالته. قد تكون له دورة حياة وصلاحيات مستقلة عن جلسة الويب.
عند انتهاء الحاجة أو الاشتباه بتسرب، راجع طريقة الإبطال والسجلات والطلبات والأوامر التي نُفذت. إيقاف الطلبات المستقبلية لا يعكس تلقائيًا أمرًا نُفذ أو بيانات نُسخت. التشخيص يحتاج معرفة ما حصل قبل الإبطال وما بقي فعالًا بعده.
جدول يربط المهمة بالوصول المطلوب
| المهمة | ما تراجعه؟ | ما لا تمنحه تلقائيًا؟ |
|---|---|---|
| عرض بيانات سوق عامة | هل تحتاج مصادقة أصلًا؟ | بيانات حساب خاصة بلا حاجة |
| تقارير حساب | حقول القراءة اللازمة فقط | تداول أو سحب أو إدارة وجهات |
| تنفيذ أوامر | المنتجات والأوامر والقيود المسموحة | كل وظائف التمويل والإدارة |
| مهمة تمويل محددة | السلطة المطلوبة ومسارات تأكيدها | دمج صلاحيات حساسة لمجرد الراحة |
| إيقاف تكامل | إبطال الاعتماد ومراجعة الحالة والسجل | اعتبار إزالة التطبيق إبطالًا مؤكدًا |
اسحب الجدول أفقيًا على الهاتف عند الحاجة.
مثال: مفتاح تقارير يملك إذن تداول
لنفترض أن وائل يريد برنامجًا يجمع أرصدته وأوامره السابقة، لكنه فعّل صلاحية تنفيذ أوامر لأن نموذج الإعداد اقترحها. لم يمنح السحب، فاعتبر المفتاح غير قادر على إحداث ضرر مالي. هذا الاستنتاج يتجاهل ما تسمح به صلاحية التداول نفسها.
يعيد وائل ربط كل إذن بمهمة: قراءة السجل للتقرير، وإنشاء الأوامر لمهمة أخرى لا يستخدمها الآن. إذا دعم المنتج الفصل، ينشئ وصولًا محدودًا مناسبًا ويتحقق من استمرار وظيفة التقرير، ثم يتبع مسار إبطال المفتاح الأوسع عندما لم يعد لازمًا.
ولا يختبر حدود المفتاح بإرسال صفقة غير مرغوبة إلى سوق حقيقي. يمكن فهم الأذونات من التوثيق والإعداد والسجل، واستخدام بيئة اختبار رسمية إن كانت لازمة ومناسبة. المقصود تقليل السلطة غير المطلوبة، لا زيادة العمليات لإثبات أنها كانت متاحة.
ما الذي تضيفه قيود IP والانتهاء؟
قد تتيح الخدمة تقييد مصادر الطلبات أو مدة صلاحية المفتاح. راجع ملاءمة ذلك لبيئة التطبيق، خصوصًا إذا كانت عناوين خوادمه تتغير. القيد الذي لا تفهمه قد يوقف التشغيل، ولا ينبغي معالجة ذلك بفتح وصول أوسع دون مراجعة.
ولا تعتبر القيد ضمانًا إذا تعرضت البيئة المسموح لها نفسها للاختراق. هو جزء من تقليل نطاق الاستخدام، مع حماية الأسرار في التطبيق ومتابعة النشاط. لا تلصق المفتاح أو سره في ملف عام أو لقطة دعم لتفسير سبب رفض الطلب.
كيف تراجع طلب توسيع الصلاحيات؟
إذا توقف تطبيق تقارير وطالبك بتفعيل التداول، فاسأل عن الطلب الذي فشل والبيانات التي يحتاجها والتوثيق الذي يربطها بالإذن الجديد. قد توجد ميزة إضافية اختيارية أو إعداد غير صحيح، فلا تعتبر توسيع السلطة العلاج الوحيد لأي رسالة خطأ.
قارن كذلك إصدار الواجهة ونوع الحساب، ثم قرر هل تحتاج الوظيفة الجديدة أصلًا. ويمكن أن يكون الإبقاء على المهمة محدودة أو إيقاف التكامل أوضح من منح وصول لا تستخدمه. لا ترسل سر المفتاح إلى الدعم لإثبات أن خانة الصلاحية مفعلة؛ وصف الإعداد ورسالة الخطأ غير السرية يكفيان لبدء التشخيص.
جرد مفيد دون تخزين الأسرار فيه
سجل اسمًا غير سري لكل مفتاح والتطبيق والغرض والصلاحيات وتاريخ المراجعة وطريقة إبطاله. لا تضع القيم السرية في الجدول نفسه. هذا يساعد على ربط نشاط غير مألوف بالتكامل المسؤول وتحديد أي وصول لم تعد تحتاج إليه.
وإذا لاحظت نشاطًا غير مصرح به، فاتبع إرشادات الخدمة الرسمية لتقييد الوصول وجمع الأدلة. راجع الأوامر والأرصدة والسجلات بحسب نطاق المفتاح، ولا تكتفِ بتأكيد أن السحب كان معطلًا. هذا التأكيد يصف قيدًا واحدًا ولا يجيب وحده عما حدث.
