يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
المؤسسة هي حاوية المستوى الأعلى في 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 هي بيئة نشر الخادم الوكيل لواجهة برمجة التطبيقات، والذي يكون إما تجريبيًا أو إنتاجًا.
مثال:
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 API API. |
|
تطبيق |
ينشئ المطوّرون تطبيقًا واحدًا أو أكثر من تطبيقات العميل التي تستخدم واجهات برمجة التطبيقات. على المطوّرين تسجيل تطبيقاتهم في مؤسستك. يمثّل "التطبيق في Edge" التطبيق الفعلي للمطوّر الذي يزوّد المطوّر بمفتاح واجهة برمجة التطبيقات لنقله مع كل طلب إلى واجهات برمجة التطبيقات. ولأنّ جميع التطبيقات يتم تسجيلها في مؤسستك، يمكنك استخدام Edge لرصد وجمع المعلومات التحليلية عن التطبيق وعن استخدامه لواجهات برمجة التطبيقات الخاصة بك. |
|
مفتاح واجهة برمجة التطبيقات/رمز OAuth المميز |
استنادًا إلى آلية التفويض التي تحدّدها لواجهات برمجة التطبيقات، يمرّر التطبيق مفتاح واجهة برمجة التطبيقات مع كل طلب إلى واجهات برمجة التطبيقات. وإذا كان هذا المفتاح صالحًا، سيتم السماح بالطلب. يتيح Edge أنواعًا مختلفة من المصادقة، مثل مفتاح واجهة برمجة تطبيقات بسيط وبروتوكول OAuth الثنائي وبروتوكول OAuth الثلاثي وغيرها. بصفتك موفِّر واجهة برمجة تطبيقات، يجب تحديد طريقة للمطوّرين لتسجيل تطبيقاتهم. ومن خلال تسجيل تطبيقه، تُرجع إلى المطوّر المفتاح المطلوب للوصول إلى واجهات برمجة التطبيقات. وأثناء تسجيل التطبيق، يمكن لمطوِّر البرامج اختيار الوصول إلى منتج واحد لواجهة برمجة التطبيقات أو منتجات متعددة لواجهة برمجة التطبيقات. يستخدم التطبيق الفعلي للمطوّر المفتاح نفسه للوصول إلى جميع منتجات واجهة برمجة التطبيقات المرتبطة بالتطبيق (التمثيل المسجّل لتطبيق المطوّر في Edge). يمكنك في أي وقت إبطال المفتاح حتى لا يتمكن تطبيق المطوّر من الوصول إلى واجهات برمجة التطبيقات الخاصة بك (على الرغم من أنّ التمثيل المسجَّل لتطبيق المطوّر لا يزال موجودًا في مؤسستك). أو يمكنك تحديد فترة زمنية لمفتاح كي يكون على مطوّر البرامج إعادة تحميل المفتاح بعد فترة محدّدة. |
لمحة عن البيئات
البيئة هي سياق تنفيذ وقت التشغيل للخوادم الوكيلة لواجهة برمجة التطبيقات في مؤسسة. يجب عليك نشر خادم وكيل لواجهة برمجة التطبيقات في بيئة قبل التمكن من الوصول إليه. يمكنك نشر خادم وكيل لواجهة برمجة التطبيقات في بيئة واحدة أو في بيئات متعددة.
يمكن أن تحتوي المؤسسة على بيئات متعددة. على سبيل المثال، يمكنك تحديد بيئة dev
وtest وprod في مؤسسة.
توفّر المؤسسة نطاقًا لبعض إمكانيات Apigee. على سبيل المثال، يمكن إتاحة بيانات خارطة القيم الأساسية (KVM) على مستوى المؤسسة، ما يعني أنّ الخوادم الوكيلة لواجهة برمجة التطبيقات المنشورة في أي بيئة ستحصل على البيانات نفسها من KVM. ويمكن تحديد نطاق بعض الإمكانات، مثل التخزين المؤقت، للمؤسسة أو لبيئة معيّنة داخل المؤسسة. يتم تقسيم بيانات Apigee التحليلية من خلال مزيج من التنظيم والبيئة.
في ما يلي الكيانات الرئيسية التي تديرها داخل المؤسسة، بما في ذلك الكيانات المحدّدة عالميًا في المؤسسة، وتلك المحددة في بيئة معيّنة:
