تخصيص نطاقك

أنت تعرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

عند إنشاء بوابة المطوّرين، يتم تلقائيًا تزويدك بنموذج اسم نطاق في Apigee للوصول إلى البوابة المباشرة بالتنسيق التالي:

https://orgname-portalname.apigee.io

حيث يكون orgname هو اسم المؤسسة ويتم تعريف portalname باستخدام اسم البوابة الذي تم تحويله إلى أحرف صغيرة بالكامل مع إزالة المسافات والشرطات.

قبل إطلاق بوابة مطوّرين، ننصحك بتقديم اسم نطاق مخصّص لك. على سبيل المثال، إليك بديل شائع:

https://developers.example.com

لمعرفة مزيد من المعلومات عن استخدام نطاق خاص مع موفِّر هوية SAML، يُرجى الاطّلاع على استخدام نطاق خاص مع موفِّر SAML.

توضّح الأقسام التالية كيفية تخصيص نطاقك.

تخصيص اسم نطاقك (Apigee Edge)

باستخدام البوابات المدمجة في Apigee Edge، اتّبِع الخطوات التالية لتخصيص اسم نطاقك:

1. سجِّل اسم نطاقك.
2. ضبط بروتوكول أمان طبقة النقل (TLS)
3. إضافة اسم نطاق مخصّص إلى البوابة
4. ضبط إعدادات نظام أسماء النطاقات

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

الخطوة 1: تسجيل اسم نطاقك

إذا كنت بحاجة إلى تسجيل نطاق جديد، تتوفّر العديد من المواقع الإلكترونية الشائعة لتسجيل النطاقات، مثل Google Domains. يمكنك اختيار موقع تسجيل النطاقات الذي تريده.

عند اختيار اسم نطاقك، يجب أن تضع في اعتبارك أنّ عناوين URL السهلة الاستخدام والسهلة للمستخدمين هي عنصر رئيسي في تحسين تحسين محركات البحث، كما هو موضّح في مقالة تنفيذ تحسين محركات البحث (SEO).

الخطوة 2: ضبط بروتوكول طبقة النقل الآمنة (TLS)

لإتاحة بروتوكول HTTPS، عليك ضبط بروتوكول أمان طبقة النقل (TLS) من خلال إنشاء ملفات تخزين مفاتيح وأسماء مستعارة تحتوي على الشهادات الرقمية اللازمة في بيئة البوابة، كما هو موضَّح في الإجراء التالي.

لضبط بروتوكول أمان طبقة النقل (TLS):

1. اشترِ شهادة بروتوكول أمان طبقة النقل (TLS) من مرجع تصديق موثوق به، مثل Google Trust Services. إنّ اختيار هيئة إصدار الشهادات متروك لك.
2. سجِّل الدخول إلى https://apigee.com/edge.
3. اختَر مؤسستك من قائمة الملف الشخصي للمستخدم.
4. اختَر المشرف > البيئة > ملفات تخزين مفاتيح بروتوكول أمان طبقة النقل (TLS) لعرض صفحة ملفات تخزين مفاتيح بروتوكول أمان طبقة النقل (TLS).

5. اختَر بوابة من القائمة المنسدلة للبيئة.

   

6. أنشئ ملف تخزين مفاتيح واسمًا مستعارًا، كما هو موضّح في مقالة إنشاء ملفات تخزين مفاتيح وملف تخزين ثقة باستخدام واجهة مستخدم Edge.

الخطوة 3: إضافة اسم نطاق مخصّص إلى البوابة

عند إضافة اسم نطاق مخصّص إلى منصّتك، ينشئ النظام الموارد التالية نيابةً عنك (باستخدام الوظيفة نفسها المستخدَمة لتطبيق اسم نطاق مخصّص على نقطة نهاية مثل api.example.com):

• مضيف افتراضي يستمع إلى المنفذ 443 باستخدام اسم النطاق المخصّص الذي تحدّده.

• خادم وكيل لواجهة برمجة التطبيقات يستخدم عنوان URL للنطاق الخاص مع ضبط نقطة النهاية المستهدفة على نطاق البوابة التلقائي يتطابق اسم الوكيل لواجهة برمجة التطبيقات مع اسم النطاق المخصّص مع استبدال النقاط بشرطة سفلية. يتم نشر خادم وكيل واجهة برمجة التطبيقات في بيئة البوابة.

لإضافة اسم نطاق مخصّص إلى البوابة، اتّبِع الخطوات التالية:

1. اختَر النشر > البوابات واختَر البوابة.
2. اختَر الإعدادات في القائمة المنسدلة في شريط التنقّل العلوي أو في الصفحة المقصودة.
3. انقر على علامة التبويب النطاقات.
4. ضمن نطاق مخصّص، أكمِل الحقول التالية.
   

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

   بعد إكمال جميع الحقول، سيتم تعديل رمز حالة النطاق الخاص على النحو التالي:

   الحالة	الوصف
   	أن يكون مخبأ المفاتيح والاسم المعرِّف والنطاق المخصّص صالحَين
   	ستنتهي صلاحية الشهادة في غضون 30 يومًا.
   	ملف تخزين المفاتيح والاسم المعرِّف والنطاق المخصّص غير صالحة.

   بالإضافة إلى ذلك، يتم التحقّق من صحة إعدادات نظام أسماء النطاقات وسيتم تعديل رمز حالة "ضبط نظام أسماء النطاقات" على النحو التالي:

   الحالة	الوصف
   	إعدادات نظام أسماء النطاقات صالحة.
   	إعدادات نظام أسماء النطاقات غير صالحة. يجب ضبط إعدادات نظام أسماء النطاقات كما هو موضّح في مقالة ضبط إعدادات نظام أسماء النطاقات.

5. انقر على تفعيل (أو حفظ إذا كنت بصدد التعديل).
   يمكنك تفعيل نطاقك المخصّص حتى إذا كانت إعدادات النطاق المخصّص أو نظام أسماء النطاقات غير صالحة.

الخطوة 4: ضبط نظام أسماء النطاقات

بعد ذلك، عليك إضافة سجلّ اسم أساسي (CNAME) إلى نظام أسماء النطاقات لنطاقك للإشارة إلى {org_name}-portal.apigee.net.

لتأكيد قيمة CNAME:

1. اختَر النشر > البوابات واختَر البوابة.
2. اختَر الإعدادات في القائمة المنسدلة في شريط التنقّل العلوي أو في الصفحة المقصودة.
3. انقر على علامة التبويب النطاقات.
4. اطّلِع على قيمة CNAME لمؤسستك في القسم Configure DNS (ضبط نظام أسماء النطاقات)، كما هو موضَّح في الشكل التالي:

في ما يلي مثال على سجلّ CNAME الذي يمكنك ضبطه للنطاق المخصّص المعروض أعلاه (أي للنطاق المخصّص developers.example.com في المؤسسة myorg):

developers.example.com. CNAME myorg-portal.apigee.net.

تحديد المشاكل وحلّها في نطاقك المخصّص

تقدّم الأقسام التالية اقتراحات لتحديد مشاكل نطاقك الخاص وحلّها.

تحديد المشاكل وحلّها: التحقّق من إعدادات نظام أسماء النطاقات لنطاقك باستخدام dig

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

على سبيل المثال، يُجري الأمر dig التالي طلب بحث من خادم نظام أسماء النطاقات الخاص بنطاقك. في نتيجة الأمر، يحتوي ANSWER SECTION على إدخال سجلّ CNAME.

$ dig @your.domain.dns developer.mycompany.com
; <<>> DiG 9.8.3-P1 <<>> @your.domain.dns developer.mycompany.com
; (1 server found)
;; global options:  cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 41356
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available

;; QUESTION SECTION:
;developer.mycompany.com.       IN  A

;; ANSWER SECTION:
developer.mycompany.com.    29  IN  CNAME   myorg-portal.apigee.net.

;; Query time: 141 msec
;; SERVER: 192.168.1.254#53(192.168.1.254)
;; WHEN: Mon Mar 20 16:41:59 2017
;; MSG SIZE  rcvd: 136

تحديد المشاكل وحلّها: تعذّر تحديد الخادم الوكيل للمضيف

عند إضافة اسم نطاق مخصّص إلى البوابة، يتم إنشاء خادم وكيل لواجهة برمجة التطبيقات تلقائيًا يستخدم عنوان URL للنطاق المخصّص مع ضبط نقطة النهاية المستهدَفة على نطاق البوابة التلقائي. في حال تعديل خادم وكيل واجهة برمجة التطبيقات المرتبط بنطاق مخصّص أو حذفه، سيتم إبطال إعدادات النطاق المخصّص وستظهر لك رسالة خطأ Unable to identify proxy for host عند محاولة الوصول إلى عنوان URL للنطاق المخصّص. على سبيل المثال:

{"fault":{"faultstring":"Unable to identify proxy for host: developers.mycompany.com:443 and url: \/","detail":{"errorcode":"messaging.adaptors.http.flow.ApplicationNotFound"}}}

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

1. اختَر نشر > المداخل، ثم اختَر البوابة.
2. اختَر الإعدادات في القائمة المنسدلة في شريط التنقّل العلوي أو في الصفحة المقصودة.
3. انقر على علامة التبويب النطاقات.
4. انقر على حفظ لاستعادة الوكيل لواجهة برمجة التطبيقات.

تعديل شهادتك

للحصول على معلومات عامة عن تعديل شهادات طبقة النقل الآمنة، يُرجى الاطّلاع على مقالة تعديل شهادة طبقة النقل الآمنة.

1. اتّبِع الخطوات الواردة في الخطوة 2: ضبط بروتوكول أمان طبقة النقل (TLS).
2. اتّبِع الخطوات الواردة في الخطوة 3: إضافة اسم نطاق مخصّص إلى البوابة.