Portail des services pour les développeurs v. 4.17.05
Toutes les installations de Private Cloud recommandées par Apigee pour le portail nécessitent que le portail se trouve derrière un équilibreur de charge. Par conséquent, vous configurez TLS sur l'équilibreur de charge lui-même, et non sur le portail. La procédure que vous utilisez pour configurer TLS dépend donc de l'équilibreur de charge.
Toutefois, si nécessaire, vous pouvez configurer TLS sur le serveur Web qui héberge le portail.
Consultez Utiliser TLS sur le portail pour obtenir une présentation de l'utilisation de TLS sur le portail.
Pour le portail exécuté sur Apache
Si votre installation du portail utilise le serveur Web Apache :
- Obtenez votre clé et votre certificat TLS.
- Assurez-vous d'installer mod_ssl :
> yum install mod_ssl - Mettez à jour /etc/httpd/conf/httpd.conf :
- Si vous souhaitez désactiver l'accès HTTP sur le port 80, recherchez Listen 80 et mettez-le en commentaire.
- Ajoutez les lignes suivantes à la fin du fichier :
LoadModule ssl_module modules/mod_ssl.so
Listen 443
- Configurez un hôte virtuel en modifiant /etc/httpd/conf/vhosts/devportal.conf pour ajouter les éléments suivants :
<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>
Mettez également en commentaire la définition VirtualHost existante si vous ne souhaitez pas utiliser HTTP. - Étant donné que TLS est configuré dans httpd.conf, vous n'avez pas besoin de ssl.conf :
> mv /etc/httpd/conf.d/ssl.conf /etc/httpd/conf.d/ssl.conf.orig - Redémarrez Apache :
> service httpd restart
Vous serez peut-être invité à saisir la phrase secrète de votre fichier de clé.
Vous devriez pouvoir accéder au portail via TLS.
Pour le portail exécuté sur Nginx
Par défaut, un portail utilisant le serveur Web Nginx écoute les requêtes HTTP sur le port 8079. Si vous activez TLS, le portail n'écoute que les requêtes HTTPS sur le port 8079. Autrement dit, vous pouvez configurer le portail pour qu'il écoute les requêtes HTTP ou HTTPS, mais pas les deux.
Vous pouvez également modifier le numéro de port comme décrit dans Définir le port HTTP utilisé par le portail.
Si l'installation de votre portail utilise le serveur Web Nginx :
- Obtenez votre clé et votre certificat TLS. Dans cet exemple, le certificat se trouve dans un fichier nommé server.crt et la clé dans server.key.
- Importez votre certificat et votre clé sur le serveur du portail dans /opt/apigee/customer/nginx/ssl.
- Remplacez le propriétaire du certificat et de la clé par l'utilisateur "apigee" :
> chown apigee:apigee /opt/apigee/customer/nginx/ssl/server.crt
> chown apigee:apigee /opt/apigee/customer/nginx/ssl/server.key - Ouvrez /opt/apigee/customer/application/drupal-devportal.properties dans un éditeur. Si le fichier et le répertoire n'existent pas, créez-les.
- Définissez les propriétés suivantes dans 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;
Pour conf_devportal_ssl_block, spécifiez le chemin d'accès aux fichiers de certificat et de clé. Vous n'avez pas besoin de modifier les autres propriétés. - Enregistrez le fichier.
- Redémarrez le portail :
/opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal restart
Vous devriez pouvoir accéder au portail via TLS.