Lorixen.
AR

مفاتيح WooCommerce API لأنظمة البيع والتوصيل: صلاحيات آمنة

باختصار: عندما يطلب منك مزود نظام نقاط بيع، أو تطبيق محاسبة، أو شركة توصيل، «مفاتيح WooCommerce API» لربطها بمتجرك، فلا تنشئ مفتاحاً بصلاحية قراءة وكتابة على حساب المدير وتنسى أمره. توثيق WooCommerce يشرح أن المفاتيح تُنشأ من الإعدادات المتقدمة، وأن لكل مفتاح مستوى وصول: قراءة، أو كتابة، أو قراءة وكتابة، وأن استخدام المفتاح يخضع لأدوار وصلاحيات مستخدم ووردبريس المرتبط به. لذلك اربط كل جهة خارجية بمفتاح خاص بها، على مستخدم مخصص، بأقل صلاحية تكفي لعملها، وألغِ المفتاح عندما ينتهي التعاون.

لماذا يهم هذا لمتجر صغير؟

محل هدايا في إربد له فرع ومتجر إلكتروني على WooCommerce. اشترك المحل في نظام نقاط بيع لمزامنة المخزون بين الفرع والموقع، ثم اشترك في خدمة تقارير مبيعات، ثم ربط المتجر بتطبيق شركة توصيل. كل جهة طلبت مفاتيح، والموظف أنشأ في كل مرة مفتاحاً بأعلى صلاحية على حساب المدير الرئيسي، لأن «هيك أسهل».

بعد سنة، توقف المحل عن استخدام خدمة التقارير، لكن مفتاحها ما زال يعمل. ولا أحد يعرف أي مفتاح يخص أي جهة. وإذا تسرب أحدها، فهو يستطيع تعديل المنتجات والأسعار والطلبات. هذا مثال توضيحي لحالة شائعة.

أين تُنشأ المفاتيح؟

بحسب توثيق الواجهة البرمجية لـ WooCommerce:

  1. اذهب إلى WooCommerce ثم Settings ثم Advanced ثم REST API.
  2. اضغط Add Key.
  3. أضف وصفاً، واختر مستخدم ووردبريس الذي سيُنشأ المفتاح له.
  4. اختر مستوى الوصول: Read أو Write أو Read/Write.
  5. اضغط Generate API Key.

بعدها يظهر مفتاحان: Consumer Key وConsumer Secret، مع رمز QR وزر لإلغاء المفتاح. هذان المفتاحان هما ما تعطيه للجهة الخارجية.

القاعدة الأولى: أقل صلاحية تكفي

اسأل كل جهة: ماذا تحتاج أن تفعل بالضبط؟

  • خدمة تقارير أو لوحة مبيعات: تقرأ الطلبات والمنتجات فقط. مستوى Read يكفي.
  • شركة توصيل تقرأ الطلبات وتحدّث حالتها: تحتاج قراءة وكتابة على الأرجح، لكن اسأل هل يكفي أن تقرأ فقط وتُحدّث الحالة من جهتك.
  • نظام نقاط بيع يزامن المخزون: يحتاج غالباً قراءة وكتابة على المنتجات.

لا تقبل طلب «أعطني صلاحية كاملة» دون شرح. المزود الجاد يستطيع أن يقول لك ما الذي يقرأه وما الذي يعدّله.

القاعدة الثانية: المستخدم المرتبط بالمفتاح مهم

هذه نقطة يغفل عنها كثيرون. التوثيق يذكر أن استخدام الواجهة البرمجية بالمفاتيح المنشأة يخضع لأدوار وصلاحيات مستخدم ووردبريس المرتبط بها. أي أن المفتاح لا يستطيع أكثر مما يستطيعه المستخدم، لكنه يستطيع كل ما يستطيعه ضمن مستوى الوصول المختار.

إذا أنشأت المفتاح على حساب المدير الرئيسي، فقد ورث المفتاح كل صلاحياته في المتجر. الأفضل:

  • إنشاء مستخدم مخصص للتكاملات بدور محدود يناسب عمل المتجر.
  • ربط مفاتيح الجهات الخارجية بهذا المستخدم، لا بحساب شخص.

القاعدة الثالثة: لا تربط المفتاح بموظف قد يغادر

التوثيق يذكر أنه إذا حُذف مستخدم ووردبريس المرتبط بمفتاح، يتوقف المفتاح عن العمل، وأن المفاتيح لا تنتقل إلى مستخدمين آخرين.

تخيل أن الموظف الذي أنشأ مفتاح نظام نقاط البيع على حسابه غادر العمل، فحذفت حسابه كما يجب. في اللحظة نفسها تتوقف مزامنة المخزون، ويبدأ الموقع ببيع منتجات نفدت من الفرع. لهذا السبب أيضاً، المستخدم المخصص للتكاملات أفضل من الحسابات الشخصية.

القاعدة الرابعة: مفتاح لكل جهة، بوصف واضح

لا تعطِ المفتاح نفسه لجهتين. إذا انتهى تعاونك مع إحداهما، تريد أن تلغي مفتاحها وحدها دون أن تتعطل الأخرى. واستخدم حقل الوصف بذكاء، مثل: «نظام نقاط البيع - فرع إربد - أُنشئ تشرين الثاني 2026». بعد سنة، ستعرف من الوصف أي مفتاح يخص من.

القاعدة الخامسة: الاتصال عبر HTTPS

التوثيق يشرح أن المصادقة عبر HTTPS يمكن أن تتم بإرسال Consumer Key كاسم مستخدم وConsumer Secret ككلمة مرور. ويذكر أن بعض الخوادم لا تقرأ ترويسة المصادقة بشكل صحيح، وأنه في هذه الحالة يمكن تمرير المفتاحين كمعاملات في الرابط.

الخيار الثاني يعمل، لكن المفاتيح في الرابط قد تظهر في سجلات الخوادم أو أدوات المراقبة. إذا اضطر المزود لاستخدامه، فاسأل مزود الاستضافة أولاً عن إصلاح قراءة ترويسة المصادقة، وتأكد أن الموقع يعمل بـ HTTPS فقط.

اسأل المزود هذه الأسئلة قبل إنشاء المفتاح

قبل أن تضغط زر الإنشاء، اطلب من الجهة الخارجية إجابات مكتوبة:

  • ما البيانات التي ستقرؤونها من المتجر؟ الطلبات فقط، أم الزبائن والمنتجات أيضاً؟
  • هل ستعدّلون شيئاً؟ إذا نعم، فما هو بالضبط: حالة الطلب، أم المخزون، أم الأسعار؟
  • أين ستُخزن المفاتيح لديكم، ومن يستطيع رؤيتها؟
  • ماذا يحدث عند إنهاء الاشتراك؟ هل تحذفون بيانات متجري؟
  • هل تحتاجون الوصول دائماً، أم لفترة إعداد محددة فقط؟

الإجابات تحدد مستوى الوصول الصحيح، وتعطيك مرجعاً إذا حدثت مشكلة لاحقاً. وإذا رفض المزود شرح ما يحتاجه، فهذه بحد ذاتها إشارة تستحق التفكير.

مراجعة دورية للمفاتيح

مرة كل بضعة أشهر، افتح صفحة REST API في إعدادات WooCommerce وراجع:

  1. هل كل مفتاح له وصف يدل على جهة ما زلت تتعامل معها؟
  2. هل مستوى الوصول ما زال مناسباً، أم يمكن تخفيضه إلى قراءة فقط؟
  3. هل هناك مفاتيح مرتبطة بحسابات أشخاص بدل مستخدم التكاملات؟
  4. هل توقفت عن استخدام أي خدمة؟ ألغِ مفتاحها فوراً بزر الإلغاء.

إذا شككت أن مفتاحاً تسرب

  • ألغِ المفتاح المشبوه.
  • أنشئ مفتاحاً جديداً للجهة المعنية وأعطها إياه بطريقة آمنة، لا في مجموعة واتساب عامة.
  • راجع آخر التعديلات على المنتجات والأسعار والطلبات بحثاً عن تغييرات لا تعرف مصدرها.
  • اسأل الجهة الخارجية كيف تخزن المفاتيح لديها.

طريقة الإرسال للمزود

عندما تعطي المفتاحين لمزود الخدمة، لا ترسلهما في رسالة بريد عادية مع نسخة لعدة أشخاص، ولا تلصقهما في مجموعة دردشة. اتفق مع المزود على قناة واحدة، وأرسلهما مرة واحدة، واطلب منه تأكيد الاستلام ثم حذف الرسالة. وإذا كان المزود يقدم طريقة ربط يوافق فيها صاحب المتجر من داخل لوحة التحكم، فالتوثيق يذكر أن WooCommerce يوفر نقطة مصادقة للتطبيقات تسمح للمستخدم بمنح الوصول لتطبيق عبر رابط، فتُنشأ المفاتيح دون أن تنسخها يدوياً.

أسئلة شائعة

شركة التوصيل طلبت مفاتيح WooCommerce، شو أعطيها؟

أنشئ مفتاحاً خاصاً بها من الإعدادات المتقدمة، على مستخدم مخصص للتكاملات، بأقل مستوى وصول يكفي لعملها.

شو الفرق بين Read وRead/Write؟

القراءة تسمح بجلب البيانات فقط، أما القراءة والكتابة فتسمح أيضاً بالتعديل. اختر القراءة إذا كانت تكفي.

حذفت حساب موظف والربط وقف، ليش؟

لأن المفتاح كان مرتبطاً بحسابه. التوثيق يقول إن المفتاح يتوقف عند حذف المستخدم ولا ينتقل لغيره.

كيف ألغي مفتاح لخدمة ما بستخدمها؟

من صفحة REST API في إعدادات WooCommerce المتقدمة، بزر إلغاء المفتاح.

إذا كنت تربط متجرك بعدة أنظمة ولا تعرف من يملك أي صلاحية، راسلنا ونرتب المفاتيح معك.

المصادر

WhatsAppاحجز مكالمة