Developer Services Portal v. 4.17.05
Bei allen von Apigee empfohlenen Private Cloud-Installationen des Portals muss sich das Portal hinter einem Load-Balancer befinden. Daher konfigurieren Sie TLS auf dem Load Balancer selbst und nicht im Portal. Das Verfahren, mit dem Sie TLS konfigurieren, hängt daher vom Load Balancer ab.
Bei Bedarf können Sie TLS jedoch auf dem Webserver konfigurieren, auf dem das Portal gehostet wird.
Eine Übersicht über die Verwendung von TLS im Portal finden Sie unter TLS im Portal verwenden.
Für das auf Apache ausgeführte Portal
Wenn Ihre Portalinstallation den Apache-Webserver verwendet:
- Rufen Sie Ihren TLS-Schlüssel und Ihr Zertifikat ab.
- Installieren Sie mod_ssl:
> yum install mod_ssl - Aktualisieren Sie /etc/httpd/conf/httpd.conf:
- Wenn Sie den HTTP-Zugriff auf Port 80 deaktivieren möchten, suchen Sie nach „Listen 80“ und kommentieren Sie es aus.
- Fügen Sie am Ende der Datei die folgenden Zeilen hinzu:
LoadModule ssl_module modules/mod_ssl.so
Listen 443
- Richten Sie einen virtuellen Host ein, indem Sie /etc/httpd/conf/vhosts/devportal.conf bearbeiten, um Folgendes hinzuzufügen:
<VirtualHost *:443>
ServerName localhost
SSLEngine on
SSLCertificateFile "<public cert path>"
SSLCertificateKeyFile "<privater Schlüssel path>"
DocumentRoot "/var/www/html"
<Directory "/var/www/html">
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
Kommentieren Sie außerdem die vorhandene VirtualHost-Definition aus, wenn Sie HTTP nicht verwenden möchten. - Da TLS in httpd.conf konfiguriert ist, benötigen Sie ssl.conf nicht:
> mv /etc/httpd/conf.d/ssl.conf /etc/httpd/conf.d/ssl.conf.orig - Starten Sie Apache neu:
> service httpd restart
Möglicherweise werden Sie aufgefordert, die Passphrase für Ihre Schlüsseldatei einzugeben.
Sie sollten über TLS auf das Portal zugreifen können.
Für das auf Nginx ausgeführte Portal
Standardmäßig überwacht ein Portal, das den Nginx-Webserver verwendet, HTTP-Anfragen auf Port 8079. Wenn Sie TLS aktivieren, überwacht das Portal nur HTTPS-Anfragen an 8079. Sie können das Portal also entweder so konfigurieren, dass es auf HTTP-Anfragen oder HTTPS-Anfragen reagiert, aber nicht auf beide.
Sie können die Portnummer auch ändern, wie unter Vom Portal verwendeten HTTP-Port festlegen beschrieben.
Wenn Ihre Portalinstallation den Nginx-Webserver verwendet:
- Rufen Sie Ihren TLS-Schlüssel und Ihr Zertifikat ab. In diesem Beispiel befindet sich das Zertifikat in einer Datei namens „server.crt“ und der Schlüssel in „server.key“.
- Laden Sie Ihr Zertifikat und Ihren Schlüssel auf den Portalserver unter /opt/apigee/customer/nginx/ssl hoch.
- Ändern Sie den Inhaber des Zertifikats und des Schlüssels in den Nutzer „apigee“:
> chown apigee:apigee /opt/apigee/customer/nginx/ssl/server.crt
> chown apigee:apigee /opt/apigee/customer/nginx/ssl/server.key - Öffnen Sie /opt/apigee/customer/application/drupal-devportal.properties in einem Editor. Wenn die Datei und das Verzeichnis nicht vorhanden sind, erstellen Sie sie.
- Legen Sie die folgenden Attribute in drupal-devportal.properties fest:
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;
Geben Sie für conf_devportal_ssl_block den Pfad zu den Zertifikats- und Schlüsseldateien an. Die anderen Attribute müssen Sie nicht ändern. - Speichern Sie die Datei.
- Starten Sie das Portal neu:
/opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal restart
Sie sollten über TLS auf das Portal zugreifen können.