Installation de Apache SSL

Un article de Diablotins.org.


Image:brush.png

Sommaire

Installation de Apache SSL

ATTENTION : cette documentation n'est pas une documentation sur Apache, mais une documentation sur son implémentation dans FreeBSD.
Elle n'est pas exhaustive sur la configuration du serveur, et ne peut pas vous aider dans des cas très spécifiques. Elle implique une bonne connaisances de base de Apache.

Présentation de Apache

Apache est le serveur HTTP principal du mouvement Open-source, mais c'est aussi le serveur le plus utilisé, y compris propriétaire.
Son nom vient de 'A patchy Server', car sa structure est un ensemble de module qui à présent forme un ensemble unifié et cohérant.
La version que nous allons installer est un version 1.3.X, la version 1 est déja disponible, mais pour des raisons de dépendances, je ne vous conseil pas de l'utiliser.

Installation du port

D'abord un pré-requis, la mise à jour du OpenSSL de base de FreeBSD.
On édite le fichier /etc/make.conf pour y ajouter :

  $ su -
  # vi /etc/make.conf
  --
  [...]
  OPENSSL_OVERWRITE_BASE=YES
  NO_OPENSSL= true
  [...]

La première ligne sert à préciser que le ports doit réécrire la version système. La deusième sert à ne pas recompiler OpenSSL système, lors d'un make world.

Maintenant, on installa apache à proprement dit, on voit qu'il ya plusieur ports de Apache, y compris de Apache + SSL, mais celui qu'il nous faut est :

  # portinstall apache13-modssl

Une fois l'installation finit on doit renommer le script RC de démarrage de Apache :

  # mv /usr/local/etc/rc.d/apache.sh.sample /usr/local/etc/rc.d/apache.sh

Apache se lance donc via :

  # /usr/local/etc/rc.d/apache.sh start

et se stoppe via :

  # /usr/local/etc/rc.d/apache.sh stop

Configuration de base de Apache

Tout d'abord, un pré-requis, valider votre /etc/hosts ou votre DNS pour vous assurer que votre machine peut se résoudre elle même.
De toute façon, entré les lignes suivantes dans votre /etc/hosts.

  # vi /etc/hosts
  --
  [...]
  127.0.0.1 localhost localhost.my.domain
  ..
  [...]

Une fois ceci supprimer les liens symboliques des DocumentROOTS, web et CGI :

  # rm /usr/local/www/data/
  # mv /usr/local/www/data.default /usr/local/www/data
  # rm /usr/local/www/cg-bin/
  # mv /usr/local/www/cgi-bin.default /usr/local/www/cgi-bin

On passe à la configuration proprement dite, on édite le fichier de configuration httpd.conf et on vérifie les lignes suivantes :

  # vi /usr/local/etc/apache/httpd.conf
  --
  [...]
  ServerAdmin root@ma_machine.mon_domaine.tld
  ServerName ma_machine.mon_domaine.tld
  [...]

Le FQDN doit correspondre avec les résolution de /etc/hosts ou de votre domaine. sinon Apache ne démarrera pas. Vous pouvez créer un alias webmaster dans votre /etc/aliases, (voir documentation sur le courrier électronique).

Pour l'execution des CGI on doit ajouter des ExecCGI dans les blocs Directory suivants :

# vi /usr/local/etc/apache/httpd.conf
--
[...]
<Directory />
    Options FollowSymLinks ExecCGI
    AllowOverride None 
</Directory>
<Directory "/usr/local/www/data">
    Options Indexes FollowSymLinks MultiViews ExecCGI
    AllowOverride all
    Order allow,deny   
    Allow from all
</Directory>
<Directory /home/*/public_html>
    AllowOverride FileInfo AuthConfig Limit
    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec ExecCGI
    <Limit GET POST OPTIONS PROPFIND>
        Order allow,deny
        Allow from all 
    </Limit>
    <LimitExcept GET POST OPTIONS PROPFIND>
        Order deny,allow
        Deny from all
    </LimitExcept>
</Directory>
[...]

Et ajouter les lignes suivantes pour les CGI 'c' et Perl :

  # vi /usr/local/etc/apache/httpd.conf
  --
  [...]
  AddHandler cgi-script .cgi
  AddHandler cgi-script .pl
  [...]


Installation du certificats SSL

Nous allons maintenant générer un certificat auto-signé personnel Pour votre domaine, il doit correspondre à la valeur de ServerName dans votre httpd.conf.

$ su -
# cd
# mkdir key
# cd key
# openssl req -new -out server.csr
Using configuration from /etc/ssl/openssl.cnf
Generating a 1024 bit RSA private key
............++++++
......++++++
writing new private key to 'privkey.pem'
Enter PEM pass phrase:
Verifying password - Enter PEM pass phrase:
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]:FR
State or Province Name (full name) [Some-State]:France
Locality Name (eg, city) []:PARIS
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Mon_Organisation
Organizational Unit Name (eg, section) []:mon_domaine.tld
Common Name (eg, YOUR name) []:g!mon_domaine.tld
Email Address []:[email protected]
Please enter the following 'extra' attributes to be sent with your certificate request
A challenge password []:
An optional company name []:
# ls
server.csr privkey.pem
# openssl rsa -in privkey.pem -out server.key
read RSA key
Enter PEM pass phrase:
writing RSA key
#ls
server.csr server.key privkey.pem
# openssl x509 -in server.csr -out server.cert -req -signkey server.key -days 365
Signature ok
subject=/C=FR/ST=France/L=PARIS/O=Mon_Organisation/OU=mon_domaine.tld/CN=mon_doamine.tld/[email protected]
Getting Private key
# ls
server.crt server.csr server.key privkey.pem

Maintenant, il faut le copier dans les répertoires des clefs et certificats :

  # cp server.key /usr/local/etc/apache/ssl.key/
  # cp server.crt /usr/local/etc/apache/ssl.crt/

Installation de mod_PHP4

Pour installer le mod_PHP4, on utilise le ports qui installe à la fois le CGi et le Module :

  # cd /usr/ports/lang/php4
  # make install && make clean
  # pkgdb -F

Ensuite, on édite le fichier de configuration d'Apache et on ajoute les lignes suivantes près des primitives du même type :

  # vi /usr/local/etc/apache/hhtpd.conf
  --
  [...]
  LoadModule php4_module libexec/apache/libphp4.so
  [...]
  AddModule mod_php4.c
  [...]
  AddType application/x-httpd-php .php .php4 .phtml
  AddType application/x-httpd-php-source .phs
  [...]

Installation de mod_ruby

Pour installer Mod_ruby, c'est un peu différent mais guère plus, d'abord on installe le port , il a une dépendance avec Ruby, biensûr, mais aussi Eruby, embedded Ruby:

  # portinstall mod_ruby

Ensuite on édite le fichier de conf de Apache pour y ajouter près des primitives du même genre pour le Loadmodule et après les blocs pour le reste :

# vi /usr/local/etc/apache/httpd.conf
--
[...]
LoadModule ruby_module libexec/apache/mod_ruby.so
[...]
IfModule mod_ruby.c>
  RubyRequire apache/ruby-run
  RubySafeLevel 0
   <Files *.rb>
     SetHandler ruby-object
     RubyHandler Apache::RubyRun.instance
   </Files>
   RubyRequire apache/eruby-run
   <Files *.rhtml>
     SetHandler ruby-object
     RubyHandler Apache::ERubyRun.instance
   </Files>
</IfModule>
[...]


Tests

Pour tester , on vas editer un fichier de chaques formats et faire le test via un browser, puis un test via HTTPS et installer le certificat dans le navigateur, toutes les étapes ne vont pas être décrites ici, seulement l'édition des fichiers :

  # rm -rf /usr/local/www/data/
  # echo "" > /usr/local/www/data/test.php
  # echo "<% put 'Test Eruby' %>" > /usr/local/www/data/test.rhtml
  # echo "put 'Test Ruby'" > /usr/local/www/data/test.rb
  # echo "print 'Test Perl';" > /usr/local/www/data/test.pl
  # echo "Test HTML" > /usr/local/www/data/test.html
  # ln -s /usr/local/www/data/test.html /usr/local/www/data/index.html
Projets :
Boîte à outils