þÿ<?xml version="1.0" standalone="no"?>

<!DOCTYPE article SYSTEM "file:/Users/brogniar/nix/Installations/docbook-xml-4.1.2/docbookx.dtd" [
    <!ENTITY my_host "villon">
    <!ENTITY my_user "brogniar">
    <!ENTITY my_home "~">
    <!ENTITY my_workspace "~/src">
    <!ENTITY my_home_prompt "<prompt>[&my_host;:&my_home;] &my_user;&percnt; </prompt>">
    <!ENTITY my_workspace_prompt "<prompt>[&my_host;:&my_workspace;] &my_user;&percnt; </prompt>">
    <!ENTITY my_NIS_domain "domaine-nis">
    <!ENTITY my_NIS_server "nis.domaine.org">
]>
                    
<!--DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                    "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd" [
   <!ENTITY my_host "villon">
    <!ENTITY my_user "brogniar">
    <!ENTITY my_home "~">
    <!ENTITY my_workspace "~/src">
    <!ENTITY my_home_prompt "<prompt>[&my_host;:&my_home;] &my_user;&percnt; </prompt>">
    <!ENTITY my_workspace_prompt "<prompt>[&my_host;:&my_workspace;] &my_user;&percnt; </prompt>">
    <!ENTITY my_NIS_domain "domaine-nis">
    <!ENTITY my_NIS_server "nis.domaine.org">
]-->

<!--
Transformation du document en html

1 - Commenter le DocType PUBLIC et dé-commenter le doctype SYSTEM.

2 - Utiliser les deux commandes suivantes.

2.1 Indiquer au système où se trouvent les outils java.
setenv CLASSPATH /Users/brogniar/nix/bin/xalan.jar:/Users/brogniar/nix/bin/xml-apis.jar:/Users/brogniar/nix/bin/xercesImpl.jar:/Users/brogniar/nix/bin/bsf.jar:/Users/brogniar/nix/Installations/docbook-xsl-1.45/extensions/xalan2.jar

2.2 Transformer le fichier xml en html
java org.apache.xalan.xslt.Process -PARAM xalan.extensions 1 -in /Users/brogniar/Sites/brogniar.nte.univ-lyon2.fr/articles/mosx-nis-apache-install.xml -xsl /Users/brogniar/nix/Installations/docbook-xsl-1.45/html/docbook.xsl -out /Users/brogniar/Sites/brogniar.nte.univ-lyon2.fr/articles/tmp.html

3 - S'il y a des erreurs, les corriger !

4 - Commenter le DocType SYSTEM et dé-commenter le doctype PUBLIC.

5 - Liste le manuel de Project Builder pour automatiser tout ça !

6 - Remplacer les références aux images dans les urls par les bonnes références dans le site
sed 's|src="images/|src="../docbook/images/|g' /Users/brogniar/Sites/brogniar.perso.univ-lyon2.fr/articles/tmp.html > /Users/brogniar/Sites/brogniar.perso.univ-lyon2.fr/articles/mosx-nis-apache-install.html

rm /Users/brogniar/Sites/brogniar.perso.univ-lyon2.fr/articles/tmp.html

-->

<article os="Mac OS X" lang="fr" class="techreport" id="mosx-nis-apache-install" status="draft">

<articleinfo>
  <title>Installation d'un module Apache d'authorisation NIS sous Mac OS X</title>

  <authorgroup>
    <author>
      <firstname>Joël</firstname>
      <surname>Brogniart</surname>
    </author>
  </authorgroup>

  <keywordset>
    <keyword>Mac OS X</keyword>
    <keyword>NIS</keyword>
    <keyword>Yellow page</keyword>
    <keyword>Apache</keyword>
    <keyword>module</keyword>
    <keyword>authentification</keyword>
  </keywordset>

  <date>29 mai 2002</date>
  
  <revhistory>

   <revision>
        <revnumber>1.0.0</revnumber>
        <date>29 mai 2002</date>
        <revremark>Un peu de XML et de texte autour des notes.</revremark>
    </revision>

   <revision>
        <revnumber>0.1</revnumber>
        <date>23 mai 2002</date>
        <revremark>Notes d'installation.</revremark>
    </revision>
  </revhistory>
    

  <abstract>
    <para>Cet article décrit pas à pas les étapes nécessaires à l'installation du module Apache <application>mod_auth_yp.c</application> sous <application>Mac OS X</application>. Ce module permet l'authentification d'utilisateurs répertoriés dans une base NIS (Network Information System).</para>
  </abstract>
</articleinfo>

<sect1>
<title>Introduction</title>
<para>Normalement, avec Mac OS X, il suffit de paramètrer correctement le Service de Répertoire (Directory Service) ou <application>NetInfo</application> pour que les outils d'authentification recherchent automatiquement, si nécessaire, les informations dans des bases NIS (Network Information System) ou LDAP (Lightweight Directory Acces Protocol). Ayant obtenu des résultats peu satisfaisants (temps de réponse parfois un peu long), pour limiter l'accès à certaines parties d'un serveur web Apache j'ai cherché à installer un module Apache s'adressant directement à un serveur NIS. En parcourant le site des modules Apache j'ai trouvé la description du module <application>mod_auth_yp.c</application> à l'url &lt;<ulink url="http://modules.apache.org/search?id=160">http://modules.apache.org/search?id=160</ulink>>. Je vais donc décrire l'installation de ce module sous Mac OS X.</para>

<important>
<para>Pour pouvoir utiliser le module <application>mod_auth_yp.c</application> il faut que les services NIS soit activés (voir le document <ulink url="mosx-nis-install.html">mosx-nis-install.html</ulink>).</para>

<para>L'installation d'un module Apache et la modification de la configuration du serveur <application>Apache</application> nécessitent les droits d'administration sur l'ordinateur. Les commandes administrateur sont lancées par la commande <command>sudo</command>.</para>

<para>Pour compiler le module <application>mod_auth_yp.c</application>, il faut que les outils dévelopeurs Apple soient installés sur la machine.</para>

<para>La procédure décrite ici est constituée d'une série de commandes Unix saisies dans une fenêtre de l'application <application>Terminal</application> de Mac OS X.</para>
</important>
</sect1>

<sect1>
<title>Étapes</title>

<para>Trois étapes sont nécessaires pour utiliser le module <application>mod_auth_yp.c</application>.</para>

<orderedlist inheritnum="ignore" numeration="arabic">
    <listitem><para>Récupérer le code source du module.</para></listitem>
    <listitem><para>Compiler et installer le module.</para></listitem>
    <listitem><para>Modifier la configuration du serveur Apache.</para></listitem>
</orderedlist>
</sect1>

<sect1>
<title>Récupérer le code du module</title>

<para>Le site des modules Apache indique un lien pour récupérer le module qui n'est plus valide. J'ai trouvé une copie du code source en C du module à l'url &lt;<ulink url="http://ftp.rsu.ru/pub/net/www/server/apache/mods/mod_auth_yp.c">http://ftp.rsu.ru/pub/net/www/server/apache/mods/mod_auth_yp.c</ulink>>.</para>

<informalexample><para><screen>
<computeroutput>&my_workspace_prompt;</computeroutput><userinput>curl -O "http://ftp.rsu.ru/pub/net/www/server/apache/mods/mod_auth_yp.c"</userinput>
</screen></para></informalexample>

<para>Une copie de ce fichier est disponible à <ulink url="mod_auth_yp.c">mod_auth_yp.c</ulink>.</para>

<para>Pour que le module se compile correctement sur Mac OS X, il faut rajouter une ligne au fichier <filename>mod_auth_yp.c</filename> original. Le fichier original contient les lignes suivantes.</para>

<programlisting>
#include &lt;rpcsvc/ypclnt.h> 
#include &lt;rpcsvc/yp_prot.h>
</programlisting>

<para>Avec un éditeur de texte, modifiez le fichier <filename>mod_auth_yp.c</filename> pour avoir la ligne manquante.</para>

<programlisting>
#include &lt;rpc/rpc.h>       
#include &lt;rpcsvc/ypclnt.h> 
#include &lt;rpcsvc/yp_prot.h>
</programlisting>
</sect1>

<sect1>
<title>Compilation et installation du module</title>
<para>Compilez le module avec la commande <command>apxs -c mod_auth_yp.c</command>.</para>

<informalexample><para><screen>
<computeroutput>&my_workspace_prompt;</computeroutput><userinput>apxs -c mod_auth_yp.c</userinput>
</screen></para></informalexample>

<para>La compilation va produire un fichier <filename>mod_auth_yp.so</filename>. Ajoutez le module à <application>Apache</application> avec la commande <command>apxs -i mod_auth_yp.so</command>.</para>

<informalexample><para><screen>
<computeroutput>&my_workspace_prompt;</computeroutput><userinput>sudo apxs -i mod_auth_yp.so</userinput>
<computeroutput>cp mod_auth_yp.so /usr/libexec/httpd/mod_auth_yp.so
chmod 755 /usr/libexec/httpd/mod_auth_yp.so</computeroutput>
</screen></para></informalexample>
</sect1>

<sect1>
<title>Modifier la configuration du serveur <application>Apache</application></title>

<para>Vous allez éditer le fichier <filename>/etc/httpd/httpd.conf</filename> pour modifier la configuration du serveur <application>Apache</application>.</para>

<informalexample><para><screen>
<computeroutput>&my_workspace_prompt;</computeroutput><userinput>sudo pico /etc/httpd/httpd.conf</userinput>
</screen></para></informalexample>

<para>Ajoutez les lighes suivantes dans le fichier <filename>httpd.conf</filename>.</para>

<programlisting>
LoadModule auth_yp_module       /usr/libexec/httpd/mod_auth_yp.so
AddModule mod_auth_yp.c
</programlisting>

<para>Vérifiez ensuite que la configuration est correcte.</para>

<informalexample><para><screen>
<computeroutput>&my_workspace_prompt;</computeroutput><userinput>sudo apachectl configtest</userinput>
<computeroutput>[Fri May 24 14:07:56 2002] [warn] module mod_ssl.c is already added, skipping
[Fri May 24 14:07:56 2002] [warn] module mod_dav.c is already added, skipping
[Fri May 24 14:07:56 2002] [warn] module mod_hfs_apple.c is already added, skipping
[Fri May 24 14:07:56 2002] [warn] module mod_redirectacgi_apple.c is already added, skipping
[Fri May 24 14:07:56 2002] [warn] module mod_perl.c is already added, skipping
[Fri May 24 14:07:56 2002] [warn] module mod_php4.c is already added, skipping
Syntax OK
</computeroutput>
</screen></para></informalexample>

<para>Si le résultat de la commande précédente finit par <computeroutput>Syntax OK</computeroutput>, vous pouvez redémarrer le serveur <application>Apache</application>.</para>

<informalexample><para><screen>
<computeroutput>&my_workspace_prompt;</computeroutput><userinput>sudo apachectl graceful</userinput>
<computeroutput>/usr/sbin/apachectl graceful: httpd gracefully restarted</computeroutput>
</screen></para></informalexample>

<para>Sinon, il vous faudra trouver la source des erreurs et les corriger.</para>
</sect1>

<sect1>
<title>Utilisation</title>

<para>Une fois les services NIS activés et le module <application>mod_auth_yp.c</application> installé et activé dans <application>Apache</application> vous allez pouvoir demander une authentification NIS pour protéger certaines parties de votre serveur web. Vous pouvez les protéger soit directement à partir du fichier de configuration <application>Apache</application> soit à l'aide d'un fichier <filename>.htaccess</filename> dans les dossiers où cela est permis. Voici un exemple de fichier <filename>.htaccess</filename>.</para>

<programlisting>
AuthName "Jojo et nis reserved"	<co id="domain"/>
Satisfy any			<co id="satisfaction"/>
Order deny,allow
deny from all
allow from jojo.ma-boite.org	<co id="allow"/>
AuthType Basic
AuthYP On			<co id="yp-auth"/>
Require valid-user		<co id="valid-u"/>
</programlisting>

<calloutlist>

<callout arearefs="domain">
    <para>La première ligne indique un nom associé au dossier à protéger.</para>
</callout>

<callout arearefs="satisfaction">
    <para>Cette directive indique que sont autorisées d'accès les personnes satisfaisant une des conditions qui suivent.</para>
</callout>

<callout arearefs="allow">
    <para>La machine <literal>jojo.ma-boite.org</literal> est autorisée à accéder (quelle que soit la personne travaillant dessus).</para>
</callout>

<callout arearefs="yp-auth">
    <para>L'authentification est effectuée avec les outils NIS.</para>
</callout>

<callout arearefs="valid-u">
    <para>Il faut être un utilisateur correctement identifié (par l'identifiant et le mot de passe) auprès du NIS pour pouvoir entrer.</para>
</callout>

</calloutlist>

</sect1>
</article>