پیکربندی درگاه برای استفاده از HTTPS

Developer Services Portal نسخه ۴.۱۷.۰۵

همه نصب‌های Private Cloud توصیه‌شده 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 را در درگاه ۸۰ غیرفعال کنید، «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>

    همچنین، اگر نمی‌خواهید از HTTP استفاده کنید، تعریف VirtualHost موجود را به‌صورت نظر درآورید.
  5. چون «امنیت لایه انتقال» در httpd.conf پیکربندی شده است، به ssl.conf نیاز ندارید:
    > mv /etc/httpd/conf.d/ssl.conf /etc/httpd/conf.d/ssl.conf.orig
  6. Apache را بازراه‌اندازی کنید:
    > service httpd restart
    ممکن است از شما خواسته شود گذرعبارت فایل کلیدتان را وارد کنید.

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

برای درگاهی که روی Nginx اجرا می‌شود

به‌طور پیش‌فرض، درگاهی که از وب‌سرور Nginx استفاده می‌کند، درخواست‌های HTTP را در درگاه ۸۰۷۹ گوش می‌دهد. اگر 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

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