הגדרת הפורטל לשימוש ב-HTTPS

Developer Services Portal גרסה 4.17.05

בכל ההתקנות המומלצות של Apigee לפורטל ב-ענן פרטי, הפורטל צריך להיות מאחורי מאזן עומסים. לכן, מגדירים את TLS במאזן העומסים עצמו, ולא בפורטל. לכן, התהליך שבו משתמשים כדי להגדיר את TLS תלוי במאזן העומסים.

עם זאת, אם צריך, אפשר להגדיר TLS בשרת האינטרנט שמארח את הפורטל.

במאמר שימוש ב-TLS בפורטל מופיעה סקירה כללית על השימוש ב-TLS בפורטל.

בפורטל שפועל ב-Apache

אם התקנת הפורטל משתמשת בשרת האינטרנט של Apache:

1. משיגים את המפתח ואישור ה-TLS.
2. מוודאים שמתקינים את mod_ssl:
   > yum install mod_ssl
3. מעדכנים את /etc/httpd/conf/httpd.conf:
   1. אם רוצים להשבית את הגישה ל-HTTP ביציאה 80, מחפשים את Listen 80 ומסמנים אותה כהערה.
   2. מוסיפים את השורות הבאות בסוף הקובץ:
      LoadModule ssl_module modules/mod_ssl.so
      Listen 443
4. מגדירים מארח וירטואלי על ידי עריכת הקובץ ‎/etc/httpd/conf/vhosts/devportal.conf כדי להוסיף את הפרטים הבאים:
   <VirtualHost *:443>
   ServerName localhost
   SSLEngine on
   SSLCertificateFile "<public cert path>"
   SSLCertificateKeyFile "<private key path>"
   DocumentRoot "/var/www/html"
   <Directory "/var/www/html">
   Options Indexes FollowSymLinks MultiViews
   AllowOverride All
   Order allow,deny
   Allow from all
   </Directory>
   </VirtualHost>
   
   בנוסף, מסמנים כהערה את ההגדרה הקיימת של VirtualHost אם לא רוצים להשתמש ב-HTTP.
5. מכיוון ש-TLS מוגדר ב-httpd.conf, אין צורך ב-ssl.conf:
   > mv /etc/httpd/conf.d/ssl.conf /etc/httpd/conf.d/ssl.conf.orig
6. מפעילים מחדש את Apache:
   > service httpd restart
   יכול להיות שתתבקשו להזין את ביטוי הסיסמה של קובץ המפתח.

אמורה להיות לכם גישה לפורטל דרך TLS.

לפורטל שפועל ב-Nginx

כברירת מחדל, פורטל שמשתמש בשרת האינטרנט Nginx מאזין לבקשות HTTP ביציאה 8079. אם מפעילים את TLS, הפורטל מאזין רק לבקשות HTTPS ביציאה 8079. כלומר, אפשר להגדיר את הפורטל להאזין לבקשות HTTP או לבקשות HTTPS, אבל לא לשניהם.

אפשר גם לשנות את מספר היציאה, כמו שמתואר בקטע הגדרת יציאת ה-HTTP שמשמשת את הפורטל.

אם התקנת הפורטל משתמשת בשרת האינטרנט Nginx:

1. משיגים את המפתח ואישור ה-TLS. בדוגמה הזו, האישור נמצא בקובץ בשם server.crt והמפתח נמצא בקובץ server.key.
2. מעלים את האישור והמפתח לשרת הפורטל אל /opt/apigee/customer/nginx/ssl.
3. משנים את הבעלים של האישור והמפתח למשתמש "apigee":
   > chown apigee:apigee /opt/apigee/customer/nginx/ssl/server.crt
   > chown apigee:apigee /opt/apigee/customer/nginx/ssl/server.key
4. פותחים את הקובץ /opt/apigee/customer/application/drupal-devportal.properties בעורך. אם הקובץ והספרייה לא קיימים, צריך ליצור אותם.
5. מגדירים את המאפיינים הבאים ב-drupal-devportal.properties:
   conf_devportal_ssl_block=ssl on; ssl_certificate /opt/apigee/customer/nginx/ssl/server.crt; ssl_certificate_key /opt/apigee/customer/nginx/ssl/server.key;
   conf_devportal_http_https_redirect=
   conf_devportal_fastcgi_https=fastcgi_param HTTPS on; fastcgi_param HTTP_SCHEME https;
   
   ב- conf_devportal_ssl_block, מציינים את הנתיב לקובצי האישור והמפתח. אין צורך לשנות את המאפיינים האחרים.
6. שומרים את הקובץ.
7. מפעילים מחדש את הפורטל:
   /opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal restart

אמורה להיות לכם גישה לפורטל דרך TLS.