<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<?xml-stylesheet href="docbook.xsl" type="text/xsl"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<book lang="pt_BR">
  <bookinfo>
    <title>Debian GNU/Linux autenticando em um servidor OpenLDAP</title>
    <authorgroup>
      <author>
        <firstname>Leonardo</firstname>
        <othername>Serra Maciel de</othername>
        <surname>Campos</surname>
        <affiliation>
          <address>
            <email>linuxbh@brfree.com.br</email>
          </address>
        </affiliation>
      </author>
    </authorgroup>
    <revhistory>
      <revision>
        <revnumber>0.1</revnumber>
        <date>2004-03-13 11:34:12 -0300</date>
        <authorinitials>Leonardo Serra Maciel de Campos</authorinitials>
      </revision>
      <revision>
        <revnumber>0.2</revnumber>
        <date>2004-03-23 23:27:01 -0300</date>
        <authorinitials>Leonardo Serra Maciel de Campos</authorinitials>
      </revision>
      <revision>
        <revnumber>0.3</revnumber>
        <date>2004-03-23 09:49:41 -0300</date>
        <authorinitials>Leonardo Serra Maciel de Campos</authorinitials>
      </revision>
      <revision>
        <revnumber>0.4</revnumber>
        <date>2004-08-22 23:57:14 -0300</date>
        <authorinitials>Leonardo Serra Maciel de Campos</authorinitials>
      </revision>
      <revision>
        <revnumber>0.5</revnumber>
        <date>2004-08-23 00:43:21 -0300</date>
        <authorinitials>Leonardo Serra Maciel de Campos</authorinitials>
      </revision>
      <revision>
        <revnumber>0.6</revnumber>
        <date>2004-12-03 21:06:43 -0300</date>
        <authorinitials>Leonardo Serra Maciel de Campos</authorinitials>
      </revision>
    </revhistory>
    <copyright>
      <year>2004</year>
      <holder>Leonardo Serra Maciel de Campos</holder>
    </copyright>
    <legalnotice>
      <para>Este documento é licenciado sobre a licença de Atribuição-Compartilhamento da Creative Commons. Para ver uma cópia desta licença, visite <ulink url="http://creativecommons.org/licenses/by-sa/2.0/"/> ou envie uma carta para Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.</para>
    </legalnotice>
    <abstract>
      <para>Este documento visa ensinar como autenticar em um servidor OpenLDAP.</para>
    </abstract>
  </bookinfo>
  <dedication>
    <para>Dedico este documento a todas as pessoas que realmente acreditam na filosofia do <glossterm baseform="Logicial">Logicial</glossterm> Livre.</para>
  </dedication>
  <chapter>
    <title>Introdução</title>
    <sect1>
      <title>O que é LDAP?</title>
      <para>LDAP significa Lightweight Directory Access Protocol, ou seja, Protocolo de Leve Acesso a Diretórios. Como o nome sugere, é um protocolo leve para acessar serviços de diretório. O LDAP roda em cima do protocolo TCP/IP ou outras conexões de transferência de serviços.</para>
    </sect1>
    <sect1>
      <title>O que é OpenLDAP?</title>
      <para>O OpenLDAP é um esforço colaborativo da comunidade Open Source para desenvolver um sistema de aplicações LDAP. O fundador por este projeto é o americano Kurt Zeilenga. Hoje existem vários desenvolvedores engajados neste sistema que está se tornando um padrão universal.</para>
    </sect1>
  </chapter>
  <chapter>
    <title>Ambiente</title>
    <para>Será presumido que o seu sistema <glossterm baseform="Debian GNU/Linux">Debian GNU/Linux</glossterm> e o aptitude estão corretamente configurados. Também estaremos acreditando que o servidor OpenLDAP está executando de forma correta e realizando autenticação.</para>
    <warning>
      <para>Todos os comandos deverão ser executados pelo usuário root!</para>
    </warning>
    <para>A tabelo abaixo mostra as versões de cada <glossterm baseform="Logicial">logicial</glossterm> usado.</para>
    <table>
      <title>Versão dos logiciais</title>
      <tgroup cols="2">
        <thead>
          <row>
            <entry>
              <glossterm baseform="Logicial">Logicial</glossterm>
            </entry>
            <entry>Versão</entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry>libpam-ldap</entry>
            <entry>169-1</entry>
          </row>
          <row>
            <entry>libnss-ldap</entry>
            <entry>220-1</entry>
          </row>
          <row>
            <entry>nscd</entry>
            <entry>2.3.2.ds1-16</entry>
          </row>
        </tbody>
      </tgroup>
    </table>
    <para>A tabelo abaixo mostra as principais características do ambiente onde foi feito esta documentação.</para>
    <table>
      <title>Ambiente</title>
      <tgroup cols="2">
        <tbody>
          <row>
            <entry>Distribuição GNU/Linux</entry>
            <entry>Debian Sarge</entry>
          </row>
          <row>
            <entry>Endereço do servidor OpenLDAP</entry>
            <entry>
              <replaceable>ldap.exemplo.com.br</replaceable>
            </entry>
          </row>
          <row>
            <entry>Nome do domínio</entry>
            <entry>
              <replaceable>exemplo.com.br</replaceable>
            </entry>
          </row>
          <row>
            <entry>Sufixo da base do servidor OpenLDAP</entry>
            <entry>
              <replaceable>dc=exemplo,dc=com,dc=br</replaceable>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
    <note>
      <para>Usaremos palavras <replaceable>desta maneira</replaceable> para indicar substituição.</para>
    </note>
  </chapter>
  <chapter>
    <title>Instalação</title>
    <orderedlist numeration="arabic">
      <listitem>
        <para>Execute o seguinte comando para instalar o OpenLDAP:</para>
        <screen><prompt>#</prompt> <userinput>aptitude install libpam-ldap libnss-ldap nscd</userinput></screen>
        <para>O DebConf ira fazer algumas perguntas, responda de acordo com a tabela abaixo.</para>
        <table>
          <title>DebConf</title>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Pacote</entry>
                <entry>Questão</entry>
                <entry>Resposta</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>libpam-ldap/libnss-ldap</entry>
                <entry>LDAP server host address</entry>
                <entry>
                  <replaceable>ldap.exemplo.com.br</replaceable>
                </entry>
              </row>
              <row>
                <entry>libpam-ldap/libnss-ldap</entry>
                <entry>distinguished name of the search base</entry>
                <entry>
                  <replaceable>dc=exemplo,dc=com,dc=br</replaceable>
                </entry>
              </row>
              <row>
                <entry>libpam-ldap/libnss-ldap</entry>
                <entry>LDAP version to use</entry>
                <entry>3</entry>
              </row>
              <row>
                <entry>libpam-ldap/libnss-ldap</entry>
                <entry>Make local root Database admin</entry>
                <entry>no</entry>
              </row>
              <row>
                <entry>libpam-ldap/libnss-ldap</entry>
                <entry>database requires login</entry>
                <entry>no</entry>
              </row>
              <row>
                <entry>libpam-ldap/libnss-ldap</entry>
                <entry>make configuration readable/writeable by owner only</entry>
                <entry>no</entry>
              </row>
              <row>
                <entry>libpam-ldap/libnss-ldap</entry>
                <entry>Local crypt to use when changing passwords.</entry>
                <entry>crypt</entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </listitem>
    </orderedlist>
  </chapter>
  <chapter>
    <title>Configuração</title>
    <orderedlist numeration="arabic">
      <listitem>
        <para>Edite o arquivo <filename>/etc/pam.d/common-account</filename>, altere a linha:</para>
        <screen>
account  required  pam_unix.so
</screen>
        <para>Pelas seguintes linhas:</para>
        <screen>
account  sufficient  pam_unix.so
account  required    pam_ldap.so use_first_pass
</screen>
      </listitem>
      <listitem>
        <para>Edite o arquivo <filename>/etc/pam.d/common-auth</filename>, altere a linha:</para>
        <screen>
auth  required  pam_unix.so
</screen>
        <para>Pelas seguintes linhas:</para>
        <screen>
auth  sufficient  pam_unix.so
auth  required    pam_ldap.so use_first_pass
</screen>
      </listitem>
      <listitem>
        <para>Edite o arquivo <filename>/etc/pam.d/common-password</filename>, altere a linha:</para>
        <screen>
password  required  pam_unix.so nullok obscure min=4 max=8 md5
</screen>
        <para>Pelas seguintes linhas:</para>
        <screen>
password  sufficient  pam_unix.so nullok obscure min=4 max=8 md5
password  required    pam_ldap.so try_first_pass
</screen>
      </listitem>
      <listitem>
        <para>Edite o arquivo <filename>/etc/nsswitch.conf</filename>, altere a linha:</para>
        <screen>
passwd:         compat
group:          compat
shadow:         compat
</screen>
        <para>Pelas seguintes linhas:</para>
        <screen>
passwd:         compat ldap
group:          compat ldap
shadow:         compat ldap
</screen>
      </listitem>
      <listitem>
        <para>É necessário reiniciar o nscd, para isto execute:</para>
        <screen><prompt>#</prompt> <userinput>invoke-rc.d nscd restart</userinput></screen>
      </listitem>
    </orderedlist>
  </chapter>
  <chapter>
    <title>Comandos úteis</title>
    <itemizedlist>
      <listitem>
        <para>Para visualizar o arquivo passwd local com as entradas do servidor OpenLDAP:</para>
        <screen><prompt>#</prompt> <userinput>getent passwd</userinput></screen>
      </listitem>
      <listitem>
        <para>Para visualizar o arquivo group local com as entradas do servidor OpenLDAP:</para>
        <screen><prompt>#</prompt> <userinput>getent group</userinput></screen>
      </listitem>
      <listitem>
        <para>Para reiniciar o nscd:</para>
        <screen><prompt>#</prompt> <userinput>invoke-rc.d nscd restart</userinput></screen>
      </listitem>
    </itemizedlist>
  </chapter>
  <chapter>
    <title>Apêndice</title>
    <sect1>
      <title>Bibliografia</title>
      <para>Os seguintes sítios foram usados como base para a criação desta documentação</para>
      <itemizedlist>
        <listitem>
          <para>
            <ulink url="http://www.openldap.org">Projeto OpenLDAP</ulink>
          </para>
        </listitem>
        <listitem>
          <para>
            <ulink url="http://www.ldap.org.br">Projeto LDAP Brasil</ulink>
          </para>
        </listitem>
        <listitem>
          <para>
            <ulink url="http://people.debian.org/~torsten/ldapnss.html"/>
          </para>
        </listitem>
        <listitem>
          <para>
            <ulink url="http://aqua.subnet.at/~max/ldap/"/>
          </para>
        </listitem>
      </itemizedlist>
    </sect1>
    <sect1>
      <title>Glossário</title>
      <glosslist>
        <glossentry>
          <glossterm>Debian GNU/Linux</glossterm>
          <glossdef>
            <para>O <ulink url="http://www.debian.org">Debian</ulink> é um sistema operacional (SO) livre para seu computador. Um sistema operacional é um conjunto de programas básicos e utilitários que fazem seu computador funcionar. O Debian usa o kernel (núcleo de um sistema operacional), <ulink url="http://www.kernel.org">Linux</ulink>, mas a maior parte das ferramentas do SO vêm do projeto <ulink url="http://www.gnu.org">GNU</ulink>; daí o nome GNU/Linux.</para>
          </glossdef>
        </glossentry>
        <glossentry>
          <glossterm>Logicial</glossterm>
          <glossdef>
            <para>Conjunto de instruções lógicas. Na informática designa um conjunto de instruções lógicas e suas dependências, também conhecido como programa ou sistema de computador.</para>
            <para>Esta palavra é pouco usada no Brasil, onde se usa muito a expressão "Software".</para>
            <para>Origem: <ulink url="http://pt.wikipedia.org/wiki/Logicial">Wikipédia, a enciclopédia livre.</ulink></para>
          </glossdef>
        </glossentry>
      </glosslist>
    </sect1>
  </chapter>
</book>
