أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info
المؤسسة هي الحاوية ذات المستوى الأعلى في Apigee Edge. وتحتوي على جميع خوادم واجهة برمجة التطبيقات الوكيلة والموارد ذات الصلة. في حين أنّ بقية هذا الموضوع تتناول المؤسسات بمزيد من التفصيل، إليك بعض النقاط العملية:
- يكون اسم مؤسستك تلقائيًا في عنوان URL المستخدَم لاستدعاء خوادم واجهة برمجة التطبيقات الوكيلة، كما
هو موضّح في لمحة عن المضيفين الظاهريين.
على سبيل المثال:
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- يظهر اسم مؤسستك في عنوان URL لواجهة مستخدم إدارة Edge. على سبيل المثال، يعرض عنوان URL التالي خوادم واجهة برمجة التطبيقات الوكيلة لمؤسسة
docs:
- على الرغم من أنّه قد تم إنشاء مؤسسة واحدة فقط، يمكنك الانضمام إلى مؤسسات أخرى كـ مستخدم أو مشرف لديه أذونات معيّنة. في واجهة مستخدم إدارة Edge، إذا كنت عضوًا في أكثر من مؤسسة واحدة، يمكنك التبديل إلى مؤسسة مختلفة كما هو موضّح في التبديل بين مؤسساتك.
- عند إجراء طلبات باستخدام واجهة برمجة التطبيقات للإدارة بصفتك مستخدمًا لديه دور "مشرف المؤسسة"
، تكون المؤسسة جزءًا مطلوبًا من المسار في معظم الطلبات. على سبيل المثال، يعرض طلب cURL التالي لواجهة برمجة التطبيقات للإدارة قائمة بجميع خوادم واجهة برمجة التطبيقات الوكيلة في مؤسسة:
curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address
فيديو: يمكنك مشاهدة فيديو قصير للتعرّف على كيفية دعم المؤسسات لبنية متعددة المستأجرين لإدارة واجهة برمجة التطبيقات.
مكوّنات المؤسسة
عند إنشاء حساب على Edge، ينشئ Edge تلقائيًا مؤسسة لك. بعد الإنشاء، يمكنك إضافة مستخدمين إلى مؤسستك، وإنشاء خوادم واجهة برمجة التطبيقات الوكيلة ومنتجات واجهة برمجة التطبيقات، و تسجيل المطوّرين والتطبيقات.
تعرض الصورة التالية المكوّنات الرئيسية لنموذج المؤسسة في Edge. يحدّد هذا النموذج كيفية ارتباط واجهات برمجة التطبيقات ومنتجات واجهة برمجة التطبيقات والتطبيقات ومطوّري التطبيقات ببعضها في Edge.
لا يعرض هذا النموذج جميع ميزات Apigee Edge. إذا كنت تستخدم ميزة تحقيق الربح، سيحتوي النموذج على مكوّنات إضافية. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على ميزة تحقيق الربح. للحصول على معلومات حول إدارة الشركات والمطوّرين باستخدام ميزة تحقيق الربح، يُرجى الاطّلاع على إدارة الشركات والمطوّرين.
أسماء المؤسسات
اسم المؤسسة هو:
- مؤسسة التقييم:
username-eval - المؤسسة المدفوعة: يحدّدها المستخدم في وقت عملية التزويد الأولية
بعد إنشاء مؤسسة، لا يمكنك إعادة تسميتها.
يصبح اسم المؤسسة جزءًا من عنوان URL لخوادم واجهة برمجة التطبيقات الوكيلة وجزءًا من عنوان URL عند إرسال طلب إلى واجهة برمجة التطبيقات لإدارة Edge. على سبيل المثال، يتّخذ عنوان URL النموذجي المستخدَم للوصول إلى خادم واجهة برمجة التطبيقات الوكيل الشكل التالي:
http://org-name-env.apigee.net/v1/weather/forecastrss
حيث:
- org-name هو اسم مؤسستك.
- env هي بيئة نشر خادم واجهة برمجة التطبيقات الوكيل، وهي إما test أو prod.
على سبيل المثال:
http://myorg-test.apigee.net/v1/weather/forecastrss
مكوّنات المؤسسة
يصف الجدول التالي مكوّنات نموذج المؤسسة بمزيد من التفصيل:
| المكوّن | الوصف |
|---|---|
|
المؤسسة |
يرتبط كل حساب على Apigee بمؤسسة واحدة أو أكثر على Apigee Edge. تحتوي المؤسسة على تمثيل لجميع المكوّنات، بما في ذلك خوادم واجهة برمجة التطبيقات الوكيلة ومنتجات واجهة برمجة التطبيقات وحِزم واجهة برمجة التطبيقات والتطبيقات والمطوّرين. لا يقتصر أصحاب الحسابات على مؤسسة واحدة. قد يحدّد بعض أصحاب الحسابات مؤسسات متعددة أو يكونون أعضاء فيها، وتدعم هذه المؤسسات منتديات مختلفة لمطوّري التطبيقات. |
| البيئة | هي سياق تنفيذ وقت التشغيل لخوادم واجهة برمجة التطبيقات الوكيلة في مؤسسة. يُرجى الاطّلاع على القسم أدناه لمزيد من المعلومات عن البيئات. |
|
المستخدم |
ضمن مؤسسة، يكون الشخص الذي ينشئ الحساب مشرفًا تلقائيًا، ويمكنك إنشاء المزيد من المستخدمين. يشكّل المستخدمون فريق واجهة برمجة التطبيقات في المؤسسة، ويمكن أن يشمل هذا الفريق أشخاصًا مثل المشرفين ومنشئي خوادم واجهة برمجة التطبيقات الوكيلة ومنتجات واجهة برمجة التطبيقات، والمستخدمين الذين يراقبون الإحصاءات والإحصاءات الأخرى وأي مستخدمين آخرين. يمكن أن يكون لدى المستخدمين المختلفين أدوار وامتيازات وصول مختلفة. على سبيل المثال، يمكنك تحديد بعض المستخدمين بصفتهم مشرفي المؤسسة ومشرفي العمليات الذين لديهم امتيازات لتعديل المؤسسة ومكوّناتها. يمكنك تحديد مستخدمين آخرين لديهم أذونات لـ إنشاء خوادم واجهة برمجة التطبيقات الوكيلة ومنتجات واجهة برمجة التطبيقات، ولكن بدون امتيازات لتعديل المستخدمين الآخرين. يمكن أن يكون المستخدمون أعضاء في مؤسسات متعددة. على سبيل المثال، قد تحدّد شركتك مؤسسات متعددة على Apigee Edge لدعم منتديات مختلفة للمطوّرين. على الرغم من ذلك، ينشئ الأشخاص أنفسهم داخليًا جميع خوادم واجهة برمجة التطبيقات الوكيلة ومنتجات واجهة برمجة التطبيقات، وبالتالي يكونون أعضاء في جميع مؤسساتك. لست بحاجة إلى إنشاء حساب على Apigee، أي إنشاء مؤسسة على Apigee لتكون مستخدمًا. يمكن للمشرف إضافتك إلى مؤسسة حالية يُسجّل جميع المستخدمين الدخول إلى Apigee Edge هنا: https://enterprise.apigee.com. |
|
خادم واجهة برمجة التطبيقات الوكيل |
ينشئ المستخدمون في مؤسسة واحدة أو أكثر من خوادم واجهة برمجة التطبيقات الوكيلة. يحدّد خادم واجهة برمجة التطبيقات الوكيل عملية ربط نقطة نهاية HTTP متاحة للجميع بخدمة الخلفية. يمكن أيضًا ضبط خوادم واجهة برمجة التطبيقات الوكيلة لتضمين الأمان (مثل OAuth)، وإجراء تحويل الرسائل (مثل XML إلى JSON)، والحدّ من عدد الزيارات إلى الخدمات في الخلفية، وإجراء عمليات قيّمة أخرى على الطلب والاستجابة واستدعاءات الخدمة. يجمع Edge بيانات للإحصاءات حول خوادم واجهة برمجة التطبيقات الوكيلة. |
|
منتج واجهة برمجة التطبيقات |
ينشئ المستخدمون في مؤسسة واحدة أو أكثر من منتجات واجهة برمجة التطبيقات، حيث يكون منتج واجهة برمجة التطبيقات عبارة عن حزمة من خوادم واجهة برمجة التطبيقات الوكيلة مع خطة خدمة. يمكن أن تضبط خطة الخدمة هذه حدود الوصول إلى خوادم واجهة برمجة التطبيقات الوكيلة، وتوفّر الأمان، وتسمح بالمراقبة والإحصاءات، وتوفّر ميزات إضافية. يجمع Edge بيانات للإحصاءات حول منتجات واجهة برمجة التطبيقات. |
|
المطوّر |
تحتوي المؤسسة على مطوّر واحد أو أكثر ينشئون التطبيقات التي تستخدم واجهات برمجة التطبيقات (المجمّعة في منتجات واجهة برمجة التطبيقات) التي تحدّدها مؤسستك. يستخدم المطوّرون واجهات برمجة التطبيقات ولكن لا يمكنهم إنشاء واجهات برمجة التطبيقات أو إجراء أي إجراءات أخرى في المؤسسة. يمكن أن يكون المطوّرون موظفين في شركتك أو شركاء أو مطوّرين خارجيين يدفعون مقابل الوصول إلى واجهات برمجة التطبيقات. يجب تسجيل المطوّرين في مؤسستك قبل أن يتمكّنوا من تسجيل تطبيق و تلقّي مفتاح واجهة برمجة التطبيقات للوصول إلى واجهات برمجة التطبيقات. بصفتك موفّر واجهة برمجة التطبيقات، يعود إليك تحديد كيفية إضافة المطوّرين أو تعديلهم أو إزالتهم في مؤسستك. يمكنك إضافتهم يدويًا من خلال واجهة مستخدم إدارة Edge، أو إنشاء بوابة مخصّصة للمطوّرين لتسجيلهم من خلال موقع إلكتروني، أو تحديد آلية التسجيل الخاصة بك باستخدام واجهة برمجة التطبيقات لإدارة Edge. ليس مطلوبًا من المطوّر أن يكون لديه حساب على Edge، ولن يحتاج معظم المطوّرين إلى معرفة أي شيء عن Edge. إذا كان لدى المطوّر حساب على Edge، يكون عادةً مستخدمًا في مؤسسة مختلفة أو يستخدم "خدمات واجهة برمجة التطبيقات في Edge". |
|
التطبيق |
ينشئ المطوّرون تطبيقًا واحدًا أو أكثر من تطبيقات العميل التي تستخدم واجهات برمجة التطبيقات. يجب أن يسجّل المطوّرون تطبيقاتهم في مؤسستك. التطبيق في Edge هو تمثيل للتطبيق الفعلي للمطوّر، ويزوّد المطوّر بمفتاح واجهة برمجة التطبيقات لتمريره مع كل طلب إلى واجهات برمجة التطبيقات. بما أنّ جميع التطبيقات مسجّلة في مؤسستك، يمكنك استخدام Edge لمراقبة التطبيق و جمع معلومات إحصائية عنه وعن استخدامه لواجهات برمجة التطبيقات. |
|
مفتاح واجهة برمجة التطبيقات/رمز OAuth المميّز |
استنادًا إلى آلية التفويض التي تحدّدها لواجهات برمجة التطبيقات، يمرّر التطبيق مفتاح واجهة برمجة التطبيقات مع كل طلب إلى واجهات برمجة التطبيقات. إذا كان هذا المفتاح صالحًا، يُسمح بالطلب. تتيح Edge أنواعًا مختلفة من المصادقة، مثل مفتاح واجهة برمجة التطبيقات البسيط، مصادقة OAUTH على مرحلتين، مصادقة OAUTH على ثلاث مراحل، وغيرها. بصفتك موفّر واجهة برمجة التطبيقات، عليك تحديد طريقة لتسجيل المطوّرين لتطبيقاتهم. من خلال تسجيل التطبيق، يمكنك إعادة المفتاح المطلوب للوصول إلى واجهات برمجة التطبيقات إلى المطوّر. في وقت تسجيل التطبيق، يمكن للمطوّر اختيار الوصول إلى منتج واحد لواجهة برمجة التطبيقات أو عدة منتجات لواجهة برمجة التطبيقات. يستخدم التطبيق الفعلي للمطوّر المفتاح نفسه للوصول إلى جميع منتجات واجهة برمجة التطبيقات المرتبطة بالتطبيق (التمثيل المسجّل لتطبيق المطوّر في Edge). في أي وقت، يمكنك إبطال المفتاح حتى لا يتمكّن تطبيق المطوّر من الوصول إلى واجهات برمجة التطبيقات (على الرغم من أنّ التمثيل المسجّل لتطبيق المطوّر لا يزال موجودًا في مؤسستك). يمكنك أيضًا تحديد مهلة لمفتاح حتى يضطر المطوّر إلى إعادة تحميل المفتاح بعد فترة زمنية معيّنة. |
لمحة عن البيئات
الـ بيئة هي سياق تنفيذ وقت التشغيل لخوادم واجهة برمجة التطبيقات الوكيلة في مؤسسة. يجب نشر خادم واجهة برمجة التطبيقات الوكيل في بيئة قبل أن يصبح بإمكانك الوصول إليه. يمكنك نشر خادم واجهة برمجة التطبيقات الوكيل في بيئة واحدة أو في بيئات متعددة.
يمكن أن تحتوي المؤسسة على بيئات متعددة. على سبيل المثال، يمكنك تحديد بيئة dev,
test, و prod في مؤسسة.
توفّر المؤسسة نطاقًا لبعض إمكانات Apigee. على سبيل المثال، يمكن إتاحة بيانات خريطة قيم المفاتيح (KVM) على مستوى المؤسسة، ما يعني أنّ خوادم واجهة برمجة التطبيقات الوكيلة التي يتم نشرها في أي بيئة ستحصل على البيانات نفسها من خريطة قيم المفاتيح. يمكن أن تكون بعض الإمكانات، مثل التخزين المؤقت، ضمن نطاق المؤسسة أو بيئة معيّنة داخل المؤسسة. يتم تقسيم بيانات إحصاءات Apigee حسب مجموعة من المؤسسة والبيئة.
في ما يلي الكيانات الرئيسية التي تديرها داخل مؤسسة، بما في ذلك الكيانات المحدّدة على مستوى العالم في المؤسسة والكيانات المحدّدة لبيئة معيّنة:
