سفارشی‌سازی دامنه

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

وقتی درگاه توسعه‌دهنده ایجاد می‌کنید، به‌طور پیش‌فرض نام دامنه نمونه Apigee برای دسترسی به درگاه زنده شما در قالب زیر ارائه می‌شود:

https://orgname-portalname.apigee.io

که در آن orgname نام سازمان است و portalname بااستفاده از نام درگاه که به حروف کوچک تبدیل شده و فاصله‌ها و خط تیره از آن حذف شده است تعریف می‌شود.

توصیه می‌شود قبل‌از راه‌اندازی کردن درگاه توسعه‌دهندگان، نام دامنه سفارشی خودتان را ارائه دهید. برای مثال، جایگزین پرطرفدار این است:

https://developers.example.com

برای ملاحظات استفاده از دامنه سفارشی با ارائه‌دهنده هویت SAML، به استفاده از دامنه سفارشی با ارائه‌دهنده SAML مراجعه کنید.

بخش‌های زیر نحوه سفارشی‌سازی دامنه را شرح می‌دهد.

سفارشی‌سازی نام دامنه (Apigee Edge)

با پورتال‌های یکپارچه Apigee Edge، برای سفارشی‌سازی نام دامنه خود، مراحل زیر را انجام دهید:

1. نام دامنه‌تان را ثبت کنید.
2. پیکربندی «امنیت لایه انتقال».
3. نام دامنه سفارشی به درگاهتان اضافه کنید.
4. ساناد خود را پیکربندی کنید.

پس‌از افزودن دامنه سفارشی، می‌توانید آن را ویرایش یا غیرفعال کنید. برای دریافت راهنمایی درباره عیب‌یابی مشکلات، عیب‌یابی دامنه سفارشی را ببینید.

مرحله ۱: نام دامنه خود را ثبت کنید

اگر نیاز به ثبت دامنه جدید دارید، سایت‌های ثبت دامنه محبوب زیادی دردسترس هستند، مانند Google Domains. انتخاب سایت ثبت دامنه به خودتان بستگی دارد.

هنگام تصمیم‌گیری درباره نام دامنه، درنظر داشته باشید که نشانی‌های وب کاربرپسند و قابل‌خواندن برای انسان‌ها جزء کلیدی بهبود بهینه‌سازی موتور جستجو هستند، همان‌طور که در پیاده‌سازی بهینه‌سازی موتور جستجو (SEO) توضیح داده شده است.

مرحله ۲: پیکربندی «امنیت لایه انتقال»

برای پشتیبانی از HTTPS، باید TLS را با ایجاد فروشگاه‌های کلید و نام‌های مستعار که حاوی گواهینامه‌های دیجیتال لازم در محیط درگاه هستند، پیکربندی کنید، همان‌طور که در رویه زیر توضیح داده شده است.

برای پیکربندی «امنیت لایه انتقال»:

1. گواهینامه «امنیت لایه انتقال» را از مرجع گواهینامه معتبری مثل خدمات اطمینان Google خریداری کنید. انتخاب مرکز صدور گواهی با خودتان است.
2. به سیستم https://apigee.com/edge وارد شوید.
3. سازمانتان را از منو نمایه کاربر انتخاب کنید.
4. برای نمایش صفحه انبار کلیدهای TLS، گزینه سرپرست > محیط > انبار کلیدهای TLS را انتخاب کنید.

5. درگاه را از منوِ کرکره‌ای محیط انتخاب کنید.

   

6. همان‌طور که در ایجاد keystore و truststore بااستفاده از Edge UI توضیح داده شده است، keystore و نام مستعار ایجاد کنید.

مرحله ۳: افزودن نام دامنه سفارشی به درگاه

وقتی نام دامنه سفارشی را به درگاهتان اضافه می‌کنید، سیستم منابع زیر را برایتان ایجاد می‌کند (بااستفاده از همان کارکردی که برای اعمال نام دامنه سفارشی به نقطه پایانی مثل api.example.com استفاده می‌شود):

• یک میزبان مجازی که در درگاه ۴۴۳ گوش می‌دهد و از نام دامنه سفارشی که مشخص کرده‌اید استفاده می‌کند.

• پراکسی API که از نشانی وب دامنه سفارشی با نقطه پایانی هدف تنظیم‌شده روی دامنه درگاه پیش‌فرض استفاده می‌کند. نام پراکسی API با نام دامنه سفارشی مطابقت دارد و نقطه‌ها با خط زیر جایگزین شده‌اند. کارگزار نیابتی API در محیط درگاه مستقر شده است.

برای افزودن نام دامنه سفارشی به درگاهتان:

1. انتشار > درگاه‌ها را انتخاب کنید و درگاهتان را انتخاب کنید.
2. تنظیمات را در منو کرکره‌ای در نوار پیمایش بالا یا در صفحه مقصد انتخاب کنید.
3. روی برگه دامنه‌ها کلیک کنید.
4. در بخش دامنه سفارشی، فیلدهای زیر را تکمیل کنید.
   

   فیلد	شرح
   Keystore	یک انبار کلید از فهرست کرکره‌ای انتخاب کنید. توجه: فهرست بااستفاده از مخزن‌های کلیدی که در محیط درگاه در مرحله ۲ ایجاد کرده‌اید تکمیل می‌شود. پس‌از انتخاب یک انبار کلید، فیلد نام مستعار نمایش داده می‌شود.
   نام مستعار	نام مستعار معتبری را از فهرست کرکره‌ای انتخاب کنید. توجه: این فهرست بااستفاده از نام‌های مستعاری که برای انبار کلید انتخاب‌شده ایجاد کرده‌اید تکمیل می‌شود. فهرست شامل فروشگاه‌های کلید با زنجیره‌های گواهینامه نامعتبر، دامنه‌های Apigee، یا فروشگاه‌های اعتماد نمی‌شود. برای تعیین زمان انقضای گواهینامه در فهرست: مشاهده نمادها: گواهینامه تا بیش‌از ۳۰ روز دیگر منقضی می‌شود یا دامنه سفارشی انتخابی ممکن است ازقبل درحال استفاده باشد. گواهینامه ظرف ۳۰ روز منقضی می‌شود. گواهینامه منقضی شده است. مکان‌نما را روی نام مستعار قرار دهید تا تعداد روزهای باقی‌مانده از اعتبار گواهینامه نمایش داده شود. پس‌از انتخاب نام مستعار، فیلد دامنه نمایش داده می‌شود.
   دامنه	دامنه‌ای را از فهرست کرکره‌ای انتخاب کنید. اگر نام مستعار گلچین را انتخاب کرده‌اید، زیردامنه را وارد کنید. توجه: فهرست دامنه‌ها بااستفاده از نام‌های رایج و جایگزین برای گواهینامه سطح بالا در زنجیره تعریف‌شده توسط نام مستعار انتخاب‌شده تکمیل می‌شود.

   پس‌از تکمیل همه فیلدها، نماد وضعیت دامنه سفارشی به‌صورت زیر به‌روزرسانی خواهد شد:

   وضعیت	شرح
   	کلیدانبار، نام مستعار، و دامنه سفارشی معتبر هستند.
   	گواهینامه ظرف ۳۰ روز منقضی خواهد شد.
   	انبار کلید، نام مستعار، و دامنه سفارشی نامعتبر است.

   علاوه‌براین، پیکربندی ساناد اعتبارسنجی می‌شود و نماد وضعیت «پیکربندی ساناد» به‌صورت زیر به‌روزرسانی می‌شود:

   وضعیت	شرح
   	پیکربندی ساناد معتبر است.
   	پیکربندی ساناد معتبر نیست. باید ساناد خود را همان‌گونه که در پیکربندی ساناد توضیح داده شده است پیکربندی کنید.

5. روی فعال کردن (یا ذخیره کردن اگر درحال ویرایش هستید) کلیک کنید.
   حتی اگر دامنه سفارشی یا پیکربندی ساناد نامعتبر باشد، می‌توانید دامنه سفارشی‌تان را فعال کنید.

مرحله ۴: پیکربندی ساناد

سپس باید یک سابقه نام متعارف (CNAME) به ساناد دامنه‌تان اضافه کنید تا به {org_name}-portal.apigee.net اشاره کند.

برای تأیید مقدار CNAME:

1. انتشار > درگاه‌ها را انتخاب کنید و درگاهتان را انتخاب کنید.
2. تنظیمات را در منو کرکره‌ای در نوار پیمایش بالا یا در صفحه مقصد انتخاب کنید.
3. روی برگه دامنه‌ها کلیک کنید.
4. مقدار CNAME سازمانتان را در بخش پیکربندی ساناد، همان‌طور که در شکل زیر نشان داده شده است، مشاهده کنید:

در زیر نمونه‌ای از ساختار 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

عیب‌یابی: پراکسی میزبان شناسایی نشد

وقتی نام دامنه سفارشی را به درگاهتان اضافه می‌کنید، به‌طور پیش‌فرض یک پراکسی API تولید می‌شود که از نشانی وب دامنه سفارشی با نقطه پایانی هدف تنظیم‌شده روی دامنه درگاه پیش‌فرض استفاده می‌کند. اگر پراکسی API مرتبط با دامنه سفارشی را اصلاح یا حذف کنید، پیکربندی دامنه سفارشی را نامعتبر خواهید کرد و هنگام تلاش برای دسترسی به نشانی وب دامنه سفارشی، پیام خطای Unable to identify proxy for host دریافت خواهید کرد. برای مثال:

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

برای بازیابی پیکربندی دامنه سفارشی درصورتی‌که پراکسی API اصلاح یا حذف شده باشد:

1. انتشار > درگاه‌ها را انتخاب کنید و درگاهتان را انتخاب کنید.
2. تنظیمات را در منو کرکره‌ای در نوار پیمایش بالا یا در صفحه مقصد انتخاب کنید.
3. روی برگه دامنه‌ها کلیک کنید.
4. برای بازیابی پراکسی API، روی ذخیره کلیک کنید.

به‌روزرسانی گواهینامه

برای اطلاعات کلی درباره به‌روزرسانی گواهینامه‌های «امنیت لایه انتقال»، به به‌روزرسانی گواهینامه «امنیت لایه انتقال» مراجعه کنید.

1. مراحل مرحله ۲: پیکربندی TLS را دنبال کنید.
2. مراحل مرحله ۳: افزودن نام دامنه سفارشی به درگاه را دنبال کنید