إدارة واجهات API · Kong Konnect

منصة إدارة واجهات برمجة التطبيقات في السعودية: ما الذي تشمله وكيف تقدّمها Kong Konnect

منصة إدارة واجهات برمجة التطبيقات (API) هي مجموعة الأدوات التي تتيح للجهة أن تنشر واجهاتها وتحميها وتراقبها وتوقفها من مكان واحد: بوابة تمر بها كل الطلبات، وبوابة للمطورين يجد فيها المستهلكون الواجهات ويسجّلون للوصول إليها، وسياسات أمن، وتحليلات للحركة، وقواعد لدورة حياة كل واجهة. وتطبّق إنتركي هذه المنصة على Kong، مع Kong Konnect مستوى للتحكم حين يناسب ذلك، وتشغّل البوابة بالشكل الذي تسمح به بياناتكم: على بنية تحتية تديرونها داخل المملكة، أو مع إدارة الإعدادات كخدمة.

الخلاصة للإدارة

  • ما هي: منصة واحدة لكل الواجهات التي تتيحونها: البوابة، وبوابة المطورين، والأمن، والتحليلات، وقواعد دورة الحياة.
  • ما تطبّقه إنتركي: Kong Gateway، تُدار من Kong Konnect أو من مستوى تحكم تديرونه بأنفسكم. وشركة Kong Inc. من الشركاء التقنيين لإنتركي.
  • أين تعمل: يمكن أن يبقى المستوى الذي يحمل الحركة على بنية تحتية تديرونها في السعودية في كل الخيارات، أما مكان الإعدادات فقرار يعود إلى تصنيف بياناتكم.
  • التكلفة: ترخيص Kong بشروط الشركة، ثم عمل إنتركي في التطبيق والتشغيل إن طلبتموه، كلٌّ في بند مستقل.
  • ما لا تفعله: لا تجعل الخدمة غير الآمنة آمنة، فالخدمات خلف المنصة تحتاج إلى عمل أمني خاص بها.

نظرة سريعة

منصة إدارة واجهات برمجة التطبيقات على Kong في نظرة سريعة
السؤالالجواب
ما الذي تشملهالبوابة، وبوابة المطورين، وسياسات الأمن، وتحليلات الحركة، ودورة حياة الواجهات
المنتج الذي تطبّقه إنتركيKong Gateway مع Kong Konnect أو مع مستوى تحكم تديرونه بأنفسكم
أين تُعالَج الحركةمستويات البيانات على خوادمكم، أو في حساب سحابي تتحكمون فيه، أو على Kubernetes
أين تُحفظ الإعداداتمستوى تحكم تديرونه داخل المملكة، أو Konnect، وهو مستوى التحكم الذي تستضيفه Kong
كيف يكون الترخيصبشروط Kong، وبعض الميزات تتطلب إصدار Enterprise
من إنتركيحصر الواجهات، والتصميم، والنشر، ونقل المستهلكين، والدعم من الرياض، والتشغيل

ما الذي تشمله منصة إدارة واجهات برمجة التطبيقات الكاملة

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

الأجزاء الخمسة لمنصة إدارة واجهات برمجة التطبيقات وكيف تقدّم Kong كلًّا منها
الجزءما الذي يفعلهكيف تقدّمه Kong
البوابةتوجّه كل طلب إلى الخدمة الصحيحة وتطبّق القواعد نفسها على كل طلبKong Gateway بنشر تقليدي، أو دون قاعدة بيانات، أو بمستوى تحكم منفصل عن مستويات البيانات
بوابة المطورينتتيح للفرق الداخلية والشركاء إيجاد الواجهات وقراءة توثيقها والتسجيل للوصول إليهابوابة المطورين في Kong Konnect، ومنها التسجيل الديناميكي للعملاء (Dynamic Client Registration)، كما تصفها Kong
الأمنتتحقق من هوية المتصل، وما يحق له استدعاؤه، وعدد المراتإضافات مثل Key Auth وJWT وOAuth 2.0 وACL وRate Limiting، وOpenID Connect وMutual TLS في إصدار Enterprise
التحليلاتتعرض الحركة والأخطاء وزمن الاستجابة لكل واجهة ولكل مستهلكسجلات البوابة ومقاييسها، تُرسل إلى منصة المراقبة لديكم
دورة الحياةتنقل كل واجهة من التصميم إلى الإصدارات ثم الإيقاف دون أن تتعطل أنظمة المستهلكينالإعدادات على هيئة شيفرة بأداة decK من Kong، والتحقق من الطلبات مقابل مواصفة الواجهة (OAS Validation في Enterprise)

تتغير الميزات التي تتطلب إصدار Enterprise من وقت لآخر، لذلك نراجع شروط Kong الحالية مقابل قائمة متطلباتكم قبل تقديم عرض السعر.

منصة إدارة الواجهات وبوابة API وAPIM: معنى كل مصطلح

تتداخل هذه المصطلحات، وتستخدمها العروض بلا دقة. بوابة API هي طبقة التشغيل التي يمر بها كل طلب، وتشرحها بالتفصيل صفحة بوابة API. أما إدارة واجهات API، وتُختصر غالبًا إلى APIM، فهي الممارسة المحيطة بها: حصر الواجهات، والسياسة المكتوبة، وضم المستهلكين، وإيقاف الإصدارات القديمة. وتوضّح صفحة إدارة واجهات البرمجة لماذا يأتي الحصر والسياسة قبل أي منتج.

ومنصة إدارة واجهات برمجة التطبيقات هي مجموعة المنتجات التي تحمل هذه الممارسة: البوابة ومعها بوابة المطورين والتحليلات وأدوات دورة الحياة. وهذه الصفحة عن اختيار هذه المنصة وتشغيلها. فإن غابت الممارسة، فلن تفعل المنصة إلا أن تُسرّع ظهور الثغرات.

أين تعمل Kong Konnect والبوابة

تفصل Kong بين مستوى التحكم الذي يحفظ الإعدادات، ومستويات البيانات التي تحمل الحركة. وتوثّق Kong منصة Konnect على أنها مستوى التحكم لديها، وتتوفر في عدة مناطق جغرافية منها منطقة باسم الشرق الأوسط، مع تشغيل عقد مستوى البيانات في بيئتكم.

خيارات نشر منصة إدارة الواجهات على Kong، وما يحسمه كل خيار
الخيارمستوى التحكممستويات البياناتيناسب
إدارة ذاتية داخل المملكةعلى بنية تحتية تديرونها في السعوديةعلى خوادمكم أو أجهزتكم الافتراضية في السعوديةحين لا يجوز أن تخرج البيانات ولا الإعدادات من المملكة، ولدى الجهة فريق سيتولى المنصة لسنوات
Konnect مع مستويات بيانات في مركز بياناتكمKonnect، تستضيفه Kong كخدمةفي مركز بياناتكمحين يجب أن تبقى البيانات، ويجوز أن تخرج بيانات الإعدادات الوصفية، وفريق التشغيل صغير
Konnect مع مستويات بيانات سحابيةKonnect، تستضيفه Kong كخدمةفي حساب سحابي تتحكمون فيه، مثل منطقة لمزوّد سحابي داخل المملكةحين تعمل الأنظمة أصلًا في منطقة سحابية وتخدمها الواجهات في المنطقة نفسها
مدخل Kubernetesأيٌّ من الخيارين السابقينداخل العنقود عبر Kong Ingress Controllerحين تكون الخدمات على Kubernetes، ويُجمع مع أي خيار أعلاه

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

إدارة دورة حياة الواجهات، من التصميم إلى الإيقاف

معظم مشكلات الواجهات مشكلات في دورة حياتها: واجهة بلا مالك، أو إصدار تغيّر دون إشعار، أو مسار قديم يبقى مفتوحًا سنوات بعد استبداله. ولا تنفع المنصة إلا حين تُكتب دورة الحياة وتفرضها الأدوات.

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

الأمن والتحليلات على المنصة

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

وينبغي أن تجيب التحليلات عن أسئلة واضحة: أي مستهلك يستدعي أي واجهة، وبأي تكرار، وبأي أخطاء، وبأي سرعة. ونرسل سجلات البوابة ومقاييسها إلى منصة المراقبة التي تستخدمونها، مثل Datadog، مع تنبيه ومسؤول لكل مستهلك يبلغ حده.

أين تستخدم الجهات في المملكة منصة للواجهات، ومن يدعمها

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

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

ما الذي يحدد تكلفة منصة إدارة الواجهات

يُسعَّر ترخيص Kong، حين تحتاجون إلى إصدار Enterprise أو إلى Konnect، بشروط Kong. ولا نذكر أسعارًا في هذه الصفحة، لأن الرقم يتوقف على قرارات تتخذونها أولًا:

  • الميزات. هل تحتاجون إلى إضافات خاصة بإصدار Enterprise مثل OpenID Connect وMutual TLS وRate Limiting Advanced.
  • خيار النشر. الإدارة الذاتية تعني تشغيل مستوى التحكم وقاعدة بياناته، أما Konnect فينقل هذا العمل إلى Kong.
  • البيئات والمواقع. كل بيئة للإنتاج أو الاختبار أو التعافي تضيف بوابات تحتاج إلى نشر وصيانة.
  • الواجهات والمستهلكون المطلوب نقلهم. يزيد جهد النقل بعدد المستهلكين والمسارات المباشرة التي يجب إغلاقها.
  • التشغيل. مساندة فريقكم، أو تشغيل كامل من إنتركي.

ويعرض عرض السعر من إنتركي الترخيص والتطبيق ونطاق التشغيل في بنود مستقلة، فترون تكلفة كل جزء.

كيف تنفّذ إنتركي منصة إدارة الواجهات

  1. الحصر والسياسة.

    قائمة بالواجهات ومالكيها ومستهلكيها، ثم كتابة القواعد التي ستفرضها المنصة.

  2. اختيار الخيار.

    إدارة ذاتية أو Konnect، وأين يعمل كل مستوى، وهل يدخل مدخل Kubernetes في التصميم.

  3. البناء على هيئة إعدادات.

    البوابات والإضافات وبوابة المطورين والمراقبة معرّفة في إعدادات بنظام لإدارة الإصدارات، ومختبرة في بيئة غير إنتاجية.

  4. نقل المستهلكين.

    ضم كل مستهلك عبر البوابة وإغلاق مساره المباشر.

  5. التشغيل والتسليم.

    دعم من الرياض، أو خدمة مُدارة إن أردتم، أو أدلة تشغيل وتدريب لفريقكم.

أسئلة يطرحها العملاء

ما الذي تشمله منصة إدارة الواجهات غير البوابة؟

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

هل تُبقي Kong Konnect حركة واجهاتنا داخل السعودية؟

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

كيف يُرخَّص Kong، وما الذي يحدد تكلفة منصة الواجهات في المملكة؟

يُسعَّر ترخيص Kong بشروط الشركة، ويتوقف على الإصدار والميزات التي تحتاجونها، مثل الإضافات الخاصة بإصدار Enterprise. وتأتي بقية التكلفة من خيار النشر، وعدد البيئات، وعدد المستهلكين المطلوب نقلهم، ونطاق التشغيل. ونقدّم سعر الترخيص وسعر عملنا في بنود مستقلة.

كم يستغرق إطلاق منصة لإدارة الواجهات؟

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

هل نحتاج إلى بوابة للمطورين إن كانت واجهاتنا داخلية فقط؟

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

من يدعم منصة Kong لدينا بعد تشغيلها، وبأي لغة؟

تدعم Kong المنتج ضمن ترخيصها. وتدعم إنتركي منصتكم من الرياض بالعربية والإنجليزية: الإعدادات، والترقيات، وضم المستهلكين، والأعطال، إما مساندةً لفريقكم أو تشغيلًا للبوابة بنطاق خدمات مُدارة مكتوب.

الخطوة التالية

خططوا لمنصة إدارة الواجهات لديكم

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

خانة إلزامية

بإرسالك هذا النموذج، فأنت توافق على سياسة الخصوصية.

أو مباشرةً

+966-11-2180999 [email protected]

أبراج التعاونية، البرج الشمالي، الطابق السابع، طريق الملك فهد، العليا، ص.ب. ٥٦٨٣٥، الرياض ١١٥٦٤، المملكة العربية السعودية

أو أين يعمل كل جزء

نشرته إنتركي. آخر تحديث . إنتركي مسجلة في الرياض بالسجل التجاري رقم 1010156897.