Nexus sous Apache
Cet article présente la configuration mise en place sur un serveur Apache
pour une instance de Nexus
.
Sommaire
Votre avis
Nobody voted on this yet
|
|
Déploiement site sécurisé
La procédure décrite ci dessous permet de mettre à disposition l'application avec un accès sécurisé HTTPS
avec utilisation d'un certificat fourni par Let's Encrypt et un tutoriel très bien réalisé.
L'application sera rendue disponible depuis un sous domaine du domaine principal. Afin de faciliter les configurations, il est important de ne pas déclarer de contexte d'exécution, ce qui s'effectue dans le fichier /var/opt/nexus/sonatype-work/nexus3/etc/nexus.properties
, dans le paramètre nexus-context-path
.
# Jetty section
#application-port=8081
# application-port=8082
# application-host=0.0.0.0
# nexus-args=${jetty.etc}/jetty.xml,${jetty.etc}/jetty-http.xml,${jetty.etc}/jetty-requestlog.xml
# nexus-context-path=/
# Nexus section
# nexus-edition=nexus-pro-edition
# nexus-features=\
# nexus-pro-feature
#----- CUSTOM -----
application-port=8082
#nexus-context-path=/nexus
Pour rappel, l'application est exécutée en service et est disponible sur le port 8082
.
Préparation environnement
Certbot sera utilisé pour demander et renouveler le certificat du site. Dans son fonctionnement, le process essaye d'accéder à un .well-known
à la racine du site. De plus, une bonne pratique consiste à fournir un répertoire racine pour les sites déployés sous Apache
. Le répertoire /var/www/sonar
est alors créé, ainsi que le sous répertoire .well-known
.
#sudo mkdir -p /var/www/nexus/.well-known
Il est recommandé de placer un fichier index.html
, avec un contenu vide, dans le répertoire racine, soit /var/www/nexus
.
<html>
<head>
</head>
<body>
</body>
</html>
De plus, un fichier robots.txt
y est placé avec les directives indiquant aux moteurs de recherche de ne rien indexer.
User-agent: *
Disallow: /
A noter que Nexus
dispose de son propre fichier robots.txt
, à l'emplacement public/robots.txt
avec la configuration suivante.
User-agent: *
Disallow: /repository/
Disallow: /service/
Allow: /
Dans le cadre de cette installation, les restrictions ne sont pas suffisantes et seront surchargées par le fichier spécifique mis en place.
Les permissions mises en place donnent un accès uniquement aux compte du serveur, soit www-data
.
#sudo find /var/www/nexus -type f -exec chmod 0600 {} \; #sudo find /var/www/nexus -type d -exec chmod 0700 {} \; #sudo chown -R www-data:www-data /var/www/nexus
Configuration HTTP
Dans un premier temps, une configuration temporaire est mise en place pour accéder de façon non sécurisé.
Un fichier nexus
est créé dans le répertoire /etc/apache2/sites-available
avec le contenu suivant.
<VirtualHost *:80>
ServerAdmin contact-email@dummy.net
ServerName www.nexus.dummy.net
DocumentRoot /var/www/nexus
DirectoryIndex index.html
LogLevel warn
ErrorLog ${APACHE_LOG_DIR}/nexus_error.log
CustomLog ${APACHE_LOG_DIR}/nexus_access.log combined
<Directory "/var/www/nexus">
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ProxyPass /.well-known !
ProxyPassReverse /.well-known !
ProxyPass /robots.txt !
ProxyPassReverse /robots.txt !
ProxyPass / http://localhost:8082/
ProxyPassReverse / http://localhost:8082/
</VirtualHost>
Les directives sur l'accès à /.well-known
et robots.txt
permettent de servir les éléments depuis la racine /var/www/nexus
.
Cette configuration doit être mise à disposition en plaçant un lien dans /etc/apache2/sites-enabled
.
#sudo ln -s /etc/apache2/sites-available/nexus /etc/apache2/sites-enabled/008-nexus.conf
Le nom du lien, à savoir 008-nexus.conf
, respecte une incrémentation sur la machine utilisée, il peut être remplacé pour tout autre nom valide pour Apache
.
Il suffit de relancer la configuration d'Apache
pour qu'elle soit prise en compte.
#sudo apache2ctl graceful
Certificat
L'application est à présent disponible avec l'URL http://www.nexus.dummy.net. Un certificat va être demandé à l'aide de Certbot.
#sudo certbot certonly --webroot -w /var/www/nexus -d www.nexus.dummy.net --email contact-email@dummy.net Saving debug log to /var/log/letsencrypt/letsencrypt.log Plugins selected: Authenticator webroot, Installer None Obtaining a new certificate Performing the following challenges: http-01 challenge for www.nexus.dummy.net Using the webroot path /var/www/nexus for all unmatched domains. Waiting for verification... Cleaning up challenges IMPORTANT NOTES: - Congratulations! Your certificate and chain have been saved at: /etc/letsencrypt/live/www.nexus.dummy.net/fullchain.pem Your key file has been saved at: /etc/letsencrypt/live/www.nexus.dummy.net/privkey.pem Your cert will expire on 2018-05-17. To obtain a new or tweaked version of this certificate in the future, simply run certbot again. To non-interactively renew *all* of your certificates, run "certbot renew" - If you like Certbot, please consider supporting our work by: Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate Donating to EFF: https://eff.org/donate-le
Le certificat est stocké dans le répertoire /etc/letsencrypt/live/www.nexus.dummy.net/
.
Configuration HTTPS
Le certificat étant disponible, la configuration HTTPS
peut être mise en place.
Un fichier nexus-dummy-ssl
est créé dans le répertoire /etc/apache2/sites-available
avec le contenu suivant.
<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin contact-email@dummy.net
ServerName www.nexus.dummy.net
DocumentRoot /var/www/nexus
DirectoryIndex index.html
LogLevel warn
ErrorLog ${APACHE_LOG_DIR}/nexus_ssl_error.log
CustomLog ${APACHE_LOG_DIR}/nexus_ssl_access.log combined
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/www.nexus.dummy.net/cert.pem
SSLCertificateKeyFile /etc/letsencrypt/live/www.nexus.dummy.net/privkey.pem
SSLCertificateChainFile /etc/letsencrypt/live/www.nexus.dummy.net/chain.pem
SSLProtocol all -SSLv2 -SSLv3
SSLHonorCipherOrder on
SSLCompression off
SSLOptions +StrictRequire
SSLCipherSuite ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA
<Directory "/var/www/nexus">
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ProxyPass /.well-known !
ProxyPassReverse /.well-known !
ProxyPass /robots.txt !
ProxyPassReverse /robots.txt !
ProxyPass / http://localhost:8082/
ProxyPassReverse / http://localhost:8082/
RequestHeader set X-Forwarded-Proto "https"
RequestHeader set X-Forwarded-Port "443"
</VirtualHost>
</IfModule>
A noter les deux directives RequestHeader
pour X-Forwarded-Proto
et X-Forwarded-Port
. Ceci fait suite à la recommandation de la procédure officielle : https://help.sonatype.com/display/NXRM3/Run+Behind+a+Reverse+Proxy, ainsi que des exemples pour d'autres applications.
Cette configuration doit être mise à disposition en plaçant un lien dans /etc/apache2/sites-enabled
.
#sudo ln -s /etc/apache2/sites-available/nexus-dummy-ssl /etc/apache2/sites-enabled/009-nexus-ssl.conf
Le nom du lien, à savoir 009-nexus-ssl.conf
, respecte une incrémentation sur la machine utilisée, il peut être remplacé pour tout autre nom valide pour Apache
.
Enfin la configuration HTTP
, sur le port 80
, est modifiée pour forcer la redirection sur l'accès en HTTPS
. Le précédent fichier sonar
est modifié avec lu contenu suivant.
<VirtualHost *:80>
ServerAdmin contact-email@dummy.net
ServerName www.nexus.dummy.net
DocumentRoot /var/www/nexus
DirectoryIndex index.html
LogLevel warn
ErrorLog ${APACHE_LOG_DIR}/nexus_error.log
CustomLog ${APACHE_LOG_DIR}/nexus_access.log combined
RewriteEngine on
RewriteCond %{HTTPS} !on
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}
</VirtualHost>
Il suffit de relancer la configuration d'Apache
pour que les modifications soient prises en compte.
#sudo apache2ctl graceful
Voir aussi
Documentation officielle: https://help.sonatype.com/display/NXRM3/Run+Behind+a+Reverse+Proxy
Configuration simple
La première configuration mise en place a été réalisée sur un serveur Apache
simple, à savoir qu'il était utilisé pour un seul site. Dans ce cas, et pour une installation sous Ubuntu, les paramètres ont été mis en place dans le fichier /etc/apache2/httpd.conf
.
ProxyPass /nexus http://localhost:8080/nexus
ProxyPassReverse /nexus http://localhost:8080/nexus
<Proxy http://localhost:8080/nexus>
Order allow,deny
Allow from all
</Proxy>
Dans ce cas, toutes requêtes sur /nexus seront redirigées vers l'application Nexus hébergée sur un Tomcat en local.
Configuration pour un domaine spécifique
Au fil du temps, le serveur Apache
a été enrichi sur la machine, afin de servir différents domaine. La première configuration mise en place rendait l'application disponible sur l'ensemble des domaines, chose qui n'était pas souhaitée. La configuration dans le fichier /etc/apache2/httpd.conf
a été déplaçée dans le fichier de configuration du domaine souhaité, à savoir /etc/apache2/sites-enabled/002-dev.conf
, pour le domaine dev.dummy.net
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName www.dev.dummy.net
DocumentRoot /var/www/default
<Directory />
Options FollowSymLinks
AllowOverride None
</Directory>
<Directory /var/www/default>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
# Old configuration for APACHE 2.2
# Order allow,deny
# allow from all
Require all granted
</Directory>
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
AllowOverride None
Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
# Old configuration for APACHE 2.2
# Order allow,deny
# Allow from all
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn
CustomLog ${APACHE_LOG_DIR}/access.log combined
ProxyPass /nexus http://localhost:8080/nexus
ProxyPassReverse /nexus http://localhost:8080/nexus
<Proxy http://localhost:8080/nexus>
Order allow,deny
Allow from all
</Proxy>
</VirtualHost>
Ainsi l'application Nexus ne sera disponible que pour ce domaine.
Nexus en service
Suite à l'installation de la version 2.14.0, où la construction de war est abandonnée, l'application est démarrée dans son propre contexte. N'étant plus sous Tomcat
, la configuration Apache doit être modifiée. Par défaut, le numéro de port est 8081
.
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName www.dev.dummy.net
DocumentRoot /var/www/default
<Directory />
Options FollowSymLinks
AllowOverride None
</Directory>
<Directory /var/www/default>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
# Old configuration for APACHE 2.2
# Order allow,deny
# allow from all
Require all granted
</Directory>
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
AllowOverride None
Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
# Old configuration for APACHE 2.2
# Order allow,deny
# Allow from all
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn
CustomLog ${APACHE_LOG_DIR}/access.log combined
ProxyPass /nexus http://localhost:8081/nexus
ProxyPassReverse /nexus http://localhost:8081/nexus
<Proxy http://localhost:8081/nexus>
Order allow,deny
Allow from all
</Proxy>
</VirtualHost>