اربط أول بوابة عبور

هذا البدء السريع موجّه إلى المسؤولين الذين يربطون API-dex ببوابة عبور لأول مرة. في النهاية سيكون لديك بيئة واحدة تعمل يمكن لكل مستخدم اختيارها في الترويسة، ومجموعة أذونات واحدة تتحكم في من يجوز له استخدامها.

قبل أن تبدأ، تحتاج إلى:

• حساب API-dex بدور المسؤول.
• حساب خدمة على بوابة العبور بإذن قراءة واجهاتها وتطبيقاتها وبيانات اعتمادها. الحقول الدقيقة لكل بوابة عبور مدرجة تحت حقول اتصال بوابة العبور.
• وصول شبكي من API-dex إلى واجهة إدارة بوابة العبور. إن كانت بوابة العبور خلف جدار حماية أو VPN، فرتّب المسار مع فريق الشبكة أولًا.

سجّل البيئة

1

سجّل الدخول

افتح عنوان API-dex الخاص بك وسجّل الدخول بحساب مؤسستك.

2

افتح Admin → Environments

افتح Admin في التنقّل الرئيسي واختر Environments.

3

أنشئ البيئة

اختر New environment. تُفتح صفحة Create new environment.

4

اختر بوابة العبور

تحت Gateway Provider، اختر Apigee أو Azure أو Gravitee. تتغيّر حقول الاتصال أدناه بحسب هذا الاختيار.

5

سمّها

أدخل Display name يعرفه مستخدموك في مبدّل البيئات، مثل "Production – Apigee"، وEnvironment name يُستخدم معرّفًا لها، مثل prod-gateway.

6

املأ حقول الاتصال

أدخل حقول اتصال تلك البوابة؛ راجع حقول اتصال بوابة العبور. اترك Environment access فارغًا الآن.

7

أرسل

اختر Submit. تحفظ API-dex البيئة وتصبح قابلة للاختيار من عنصر التحكم بالبيئة في ترويسة كل مستخدم. إن رفضت بوابة العبور بيانات الاعتماد، يبقى كتالوج البيئة فارغًا؛ افتح البيئة مجددًا، وصحّح الحقول، ثم Save.

حقول اتصال بوابة العبور

• Authentication method: Service account أو Workload Identity Federation. يستخدم Workload Identity Federation الهوية التي تعمل بها API-dex بدلًا من مفتاح مخزَّن.
• Organization / Region: اسم مؤسسة Apigee لديك أو معرّفها.
• URL of the management API: Global (apigee.googleapis.com)، أو نقطة نهاية إقليمية، أو Custom URL (on prem) لـ Apigee Edge (https://api.enterprise.apigee.com) أو الهجين.
• Token URL: نقطة نهاية رمز OAuth، مملوءة مسبقًا لـ Google Cloud.
• Username وPassword: بريد حساب الخدمة ومفتاحه.

قرّر من يجوز له استخدامها

1

أنشئ مجموعة أذونات أو افتح واحدة

افتح Admin → Permission Groups. اختر New permission group لنمط وصول هذه البيئة، أو افتح مجموعة موجودة.

2

اربط الفرق

في تبويب Linked Teams، اختر Add team واختر فرق المستهلكين أو الخلفية التي ينبغي أن يكون لها وصول. يرث أعضاء تلك الفرق الوصول فورًا. في تبويب API Access، يعرض Add API الواجهات التي تمنحها المجموعة.

3

قيّد الأدوار إن لزم

لحصر بيئة على الحسابات التي تحمل دورًا من مزوّد الهوية لديك، افتح البيئة واملأ Environment access: Entry role الذي يجب أن يحمله المستخدم (مثل brand-b:member) وRole prefix الذي يحدّد أدوار هذه البيئة. هذا مستقل عن أذونات الفرق والتطبيقات.

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

1

بدّل إلى البيئة الجديدة

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

2

افتح APIs

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

ما التالي

• انشر أول واجهة برمجة تطبيقات: أدخل أول مواصفة في كتالوج هذه البيئة.
• المرجع: أدوات المسؤول: كل حقل في شاشتَي Environments وPermission Groups.
• كيف تعمل API-dex: كيف ترتبط البيئات ومجموعات الأذونات والفرق.