0 - en to pt-BR translation catalogue (536 entries)

en: Network Services: Postfix, Apache, NFS, Samba, Squid, LDAP, SIP, XMPP, TURN
pt-BR: Serviços de Rede: Postfix, Apache, NFS, Samba, Squid, LDAP, SIP, XMPP, TURN

en: Network services are the programs that users interact with directly in their daily work. They are the tip of the information system iceberg, and this chapter focuses on them; the hidden parts they rely on are the infrastructure we already described. They usually require the encryption technology described in <xref linkend="sect.x509-cert" />.
pt-BR: Serviços de rede são programas que os usuários interagem diretamente no seu dia-a-dia. Eles são a ponta do icebergue da informação, e este capítulo foca neles; as partes escondidas nas quais eles dependem são a infraestrutura que nós já descrevemos. Normalmente eles precisam da tecnologia de criptografia descrita em <xref linkend="sect.x509-cert" />.

en: Mail Server
pt-BR: Servidor de Correio Eletrônico

en: The Falcot Corp administrators selected Postfix for the electronic mail server, due to its reliability and its ease of configuration. Indeed, its design enforces that each task is implemented in a process with the minimum set of required permissions, which is a great mitigation measure against security problems.
pt-BR: Os administradores da Falcot Corp selecionaram o Postfiz como servidor de correio eletrônico, devido a sua confiabilidade e fácil configuração. De fato, seu projeto reforça que cada tarefa é implementada em um processo com um conjunto mínimo de permissões, que é uma medida de mitigação contra problemas de segurança.

en: <primary>email</primary><secondary>server</secondary>
pt-BR: <primary>correio</primary><secondary>servidor de</secondary>

en: <primary>server</primary><secondary>email</secondary>
pt-BR: <primary>servidor</primary><secondary>email</secondary>

en: <primary>mail server</primary>
pt-BR: <primary>servidor de correio eletrônico</primary>

en: <emphasis>ALTERNATIVE</emphasis> The Exim4 server
pt-BR: <emphasis>ALTERNATIVA</emphasis> O servidor Exim4

en: Debian uses Exim4 as the default email server (which is why the initial installation includes Exim4). The configuration is provided by a separate package, <emphasis role="pkg">exim4-config</emphasis>, and automatically customized based on the answers to a set of Debconf questions very similar to the questions asked by the <emphasis role="pkg">postfix</emphasis> package.
pt-BR: O Debian utiliza os Exim4 como o servidor de e-mail padrão (eis o porque da instalação inicial incluir o Exim4). A configuração é provida por um pacote diferente, <emphasis role="pkg">exim4-config</emphasis>, e automaticamente customizado baseado nas respostas de um conjunto de questões no Debconf muito similar as questões feitas pelo pacote <emphasis role="pkg">postfix</emphasis>.

en: The configuration can be either in one single file (<filename>/etc/exim4/exim4.conf.template</filename>) or split across a number of configuration snippets stored under <filename>/etc/exim4/conf.d/</filename>. In both cases, the files are used by <command>update-exim4.conf</command> as templates to generate <filename>/var/lib/exim4/config.autogenerated</filename>. The latter is the file used by Exim4. Thanks to this mechanism, values obtained through Exim's debconf configuration — which are stored in <filename>/etc/exim4/update-exim4.conf.conf</filename> — can be injected in Exim's configuration file, even when the administrator or another package has altered the default Exim configuration.
pt-BR: A configuração pode ser tanto em um único arquivo (<filename>/etc/exim4/exim4.conf.template</filename>) ou divido em alguns trechos de configuração armazenados em <filename>/etc/exim4/conf.d/</filename>. Em ambos os casos, os arquivos são usados pelo <command>update-exim4.conf</command> como modelo para gerar o <filename>/var/lib/exim4/config.autogenerated</filename>. Este último é utilizado pelo Exim4. Graças ao seu mecanismo, os valores obtidos através da configuração debconf do Exim - que é armazenado em <filename>/etc/exim4/update-exim4.conf.conf</filename> - pode ser injetado no arquivo de configuração do Exim, mesmo quando o administrador ou outro pacote alterou a configuração padrão do Exim.

en: The Exim4 configuration file syntax has its peculiarities and its learning curve; however, once these peculiarities are understood, Exim4 is a very complete and powerful email server, as evidenced by the tens of pages of documentation. <ulink type="block" url="https://www.exim.org/docs.html" />
pt-BR: A sintaxe do arquivo de configuração do Exim4 tem suas particularidades e sua curva de aprendizado; contudo, uma vez que essas particularidades são compreendidas, o Exim4 se torna um servidor de e-mail muito completo e poderoso, como evidenciado pelas suas muitas páginas de documentação. <ulink type="block" url="https://www.exim.org/docs.html" />

en: Installing Postfix
pt-BR: Instalando o Postfix

en: <primary>Postfix</primary><secondary>installation</secondary>
pt-BR: <primary>Postfix</primary><secondary>instalação do </secondary>

en: The <emphasis role="pkg">postfix</emphasis> package includes the main <acronym>SMTP</acronym> daemon. Other packages (such as <emphasis role="pkg">postfix-ldap</emphasis> and <emphasis role="pkg">postfix-pgsql</emphasis>) add extra functionality to Postfix, including access to mapping databases. You should only install them if you know that you need them.
pt-BR: O pacote <emphasis role="pkg">postfix</emphasis> inclui o daemon <acronym>SMTP</acronym> principal. Outros pacotes (como o <emphasis role="pkg">postfix-ldap</emphasis> e o <emphasis role="pkg">postfix-pgsql</emphasis>) adicionam funcionalidades extras ao Postfix, incluindo acesso a bancos de dados. Você só deve instalá-los se souber que precisa deles.

en: <emphasis>BACK TO BASICS</emphasis> SMTP
pt-BR: <emphasis>DE VOLTA AO BÁSICO</emphasis> SMTP

en: <acronym>SMTP</acronym> (<emphasis>Simple Mail Transfer Protocol</emphasis>, RFC 5321) is the protocol used by mail servers to exchange and route emails.
pt-BR: <acronym>SMTP</acronym> (<emphasis>Protocolo Simples para Transferência de Correio</emphasis>, RFC 5321) é um protocolo usado por servidores de e-mail para intercambiar e rotear e-mails.

en: Several Debconf questions are asked during the installation of the package. The answers allow generating a first version of the <filename>/etc/postfix/main.cf</filename> configuration file.
pt-BR: Diversas questões Debconf são feitas durante o processo de instalação do pacote. As respostas permitem gerar a primeira versão do arquivo de configuração <filename>/etc/postfix/main.cf</filename>.

en: The first question deals with the type of setup. Only two of the proposed answers are relevant in case of an Internet-connected server, “Internet site” and “Internet with smarthost”. The former is appropriate for a server that receives incoming email and sends outgoing email directly to its recipients, and is therefore well-adapted to the Falcot Corp case. The latter is appropriate for a server receiving incoming email normally, but that sends outgoing email through an intermediate SMTP server — the “smarthost” — rather than directly to the recipient's server. This is mostly useful for individuals with a dynamic IP address, since many email servers reject messages coming straight from such an IP address. In this case, the smarthost will usually be the ISP's SMTP server, which is always configured to accept email coming from the ISP's customers and forward it appropriately. This setup (with a smarthost) is also relevant for servers that are not permanently connected to the internet, since it avoids having to manage a queue of undeliverable messages that need to be retried later.
pt-BR: A primeira pergunta é sobre qual o tipo de instalação. Apenas duas das respostas propostas são relevantes no caso de um servidor conectado à internet , "site de internet" e "internet com smarthost". O primeiro é apropriado para um servidor que recebe e-mails entrantes e envia e-mails saintes diretamente aos seus destinatários, e portanto é se adapta bem ao caso da Falcot Corp . o último é apropriado para um servidor que recebe e-mails recebidos normalmente, mas que envia e-mails saintes através de um servidor SMTP intermediário - o "smarthost" - ao invés de diretamente para o servidor do destinatário . Isto é útil para os indivíduos com um endereço IP dinâmico , uma vez que muitos servidores de e-mail rejeitam mensagens diretas de endereços IP dinâmicos. Neste caso, o smarthost será geralmente o servidor SMTP do ISP, que é sempre configurado para aceitar e-mail proveniente de clientes do ISP e transmiti-los de forma adequada. Esta configuração (com um smarthost) também é relevante para os servidores que não estão permanentemente conectados à internet, uma vez que se evita ter de gerenciar uma fila de mensagens não entregues que precisa ser repetida mais tarde.

en: <emphasis>VOCABULARY</emphasis> ISP
pt-BR: <emphasis>VOCABULÁRIO</emphasis> ISP

en: <acronym>ISP</acronym> is the acronym for “Internet Service Provider”. It covers an entity, often a commercial company, that provides Internet connections and the associated basic services (email, news and so on).
pt-BR: <acronym>ISP</acronym> é a sigla para "Internet Service Provider" (Provedor de Serviços de Internet). Isto cobre uma entidade, normalmente uma empresa, que provê conexões a internet e seus serviços básicos associados (e-mail, notícias e assim por diante).

en: The second question deals with the full name of the machine, used to generate email addresses from a local user name; the full name of the machine ends up as the part after the at-sign (“@”). In the case of Falcot, the answer should be <literal>mail.falcot.com</literal>. This is the only question asked by default, but the configuration it leads to is not complete enough for the needs of Falcot, which is why the administrators run <command>dpkg-reconfigure postfix</command> so as to be able to customize more parameters.
pt-BR: A segunda questão diz respeito ao nome completo da máquina, utilizada para gerar os endereços de e-mail a partir de um nome de usuário local; o nome completo da máquina acaba como a parte após o arroba ("@"). No caso da Falcot, a resposta deveria ser <literal>mail.falcot.com</literal>. Esta é a única pergunta feita por padrão, mas a configuração gerada não é completa o suficiente para as necessidades de Falcot, razão pela qual os administradores executam o <command>dpkg-reconfigure postfix</command>, para personalizar mais parâmetros.

en: One of the extra questions asks for all the domain names related to this machine. The default list includes its full name as well as a few synonyms for <literal>localhost</literal>, but the main <literal>falcot.com</literal> domain needs to be added by hand. More generally, this question should usually be answered with all the domain names for which this machine should serve as an MX server; in other words, all the domain names for which the DNS says that this machine will accept email. This information ends up in the <literal>mydestination</literal> variable of the main Postfix configuration file — <filename>/etc/postfix/main.cf</filename>.
pt-BR: Uma das questões extras pede para todos os nomes de domínio relacionados com esta máquina. A lista padrão inclui o seu nome completo, bem como alguns sinônimos para <literal>localhost</literal>, mas o principal domínio <literal>falcot.com</literal> precisa ser adicionado manualmente. De modo geral, esta questão deve ser respondida normalmente com todos os nomes de domínio para que esta máquina deve servir como um servidor MX; em outras palavras, todos os nomes de domínio para o qual o DNS diz que esta máquina vai aceitar e-mail. Esta informação acaba na variável <literal>mydestination</literal> do principal arquivo de configuração do Postfix - <filename>/etc/postfix/main.cf</filename>.

en: <primary>server</primary><secondary>MX</secondary>
pt-BR: <primary>servidor</primary><secondary>MX</secondary>

en: <primary>MX</primary><secondary>server</secondary>
pt-BR: <primary>MX</primary><secondary>servidor</secondary>

en: Role of the DNS <emphasis>MX</emphasis> record while sending a mail
pt-BR: Papel do registro <emphasis>MX</emphasis> no DNS ao enviar um e-mail

en: <emphasis>EXTRA</emphasis> Querying the MX records
pt-BR: <emphasis>EXTRA</emphasis> Consultando os registros MX

en: When the DNS does not have an MX record for a domain, the email server will try sending the messages to the host itself, by using the matching A record (or AAAA in IPv6).
pt-BR: Quando o DNS não contém um registro MX para o domínio, o servidor e-mail tentará enviar as mensagens para o hospedeiro em si, usando o registro correspondente A (ou AAAA em IPv6).

en: In some cases, the installation can also ask what networks should be allowed to send email via the machine. In its default configuration, Postfix only accepts emails coming from the machine itself; the local network will usually be added. The Falcot Corp administrators added <literal>192.168.0.0/16</literal> to the default answer. If the question is not asked, the relevant variable in the configuration file is <literal>mynetworks</literal>, as seen in the example below.
pt-BR: Em alguns casos, a instalação pode perguntar quais redes devem ser permitidas a enviar e-mail usando a máquina. Em sua configuração padrão, o Postfix somente aceita e-mails vindo da máquina em si, a rede local normalmente será adicionada. Os administradores da Falcot Corp adicionaram <literal>192.168.0.0/16</literal> na pergunta padrão. Se a questão não é feita, a variável relevante no arquivo de configuração é <literal>mynetworks</literal>, como visto no exemplo abaixo.

en: Local email can also be delivered through <command>procmail</command>. This tool allows users to sort their incoming email according to rules stored in their <filename>~/.procmailrc</filename> file. Both Postfix and Exim4 suggest <emphasis role="pkg">procmail</emphasis> by default, but there are alternatives like <emphasis role="pkg">maildrop</emphasis> or Sieve filters.
pt-BR: E-mails locais podem ser enviados através do comando <command>procmail</command>. Esta ferramenta permite aos usuários organizarem seus e-mail de entrada de acordo com a regras armazenadas em seu arquivo <filename>~/.procmailrc</filename>. Tanto o Postfix quanto o Exim4 sugerem <emphasis role="pkg">procmail</emphasis> por padrão, mas existem alternativas, como o <emphasis role="pkg">maildrop</emphasis> ou Sieve filters.

en: <primary>email</primary><secondary>filtering</secondary>
pt-BR: <primary>e-mail</primary><secondary>filtrando</secondary>

en: <primary>filtering email</primary>
pt-BR: <primary>filtrando e-mails</primary>

en: After this first step, the administrators got the following configuration file; it will be used as a starting point for adding some extra functionality in the next sections.
pt-BR: Após este primeiro passo, os administradores conseguiram o seguinte arquivo de configuração; ele será usado como ponto de partida para adicionarmos funcionalidades extras nas próximas seções.

en: Initial <filename>/etc/postfix/main.cf</filename> file
pt-BR: Arquivo inicial <filename>/etc/postfix/main.cf</filename>

en: <emphasis>SECURITY</emphasis> <emphasis>Snake oil</emphasis> SSL certificates
pt-BR: <emphasis>SEGURANÇA</emphasis> Certificados SSL <emphasis>Snake oil</emphasis>

en: The <emphasis>snake oil</emphasis> certificates, like the <emphasis>snake oil</emphasis> “medicine” sold by unscrupulous quacks in old times, have absolutely no value: you cannot rely on them to authenticate the server since they are automatically generated self-signed certificates. However, they are useful to improve the privacy of the exchanges.
pt-BR: Os certificados <emphasis>snake oil</emphasis> (ou remédio do homem da cobra), como o "remédio" vendido pelos <emphasis>homens da cobra</emphasis>, charlatães sem escrúpulos dos velhos tempos, não tem absolutamente nenhum valor, você não pode se basear neles para autenticar o servidor já que eles são certificados auto-assinados automaticamente gerados. Contudo, eles são úteis para aprimorar a privacidade de intercâmbios.

en: In general they should only be used for testing purposes, and normal service must use real certificates. The <link linkend="sidebar.letsencrypt">Let's encrypt</link> initiative offers free and trusted SSL/TLS certificates, which can be generated using the <emphasis role="pkg">certbot</emphasis> package as described in <xref linkend="sect.apache-ssl" /> and then used in <command>postfix</command> like this:
pt-BR: Em geral eles só devem ser usados para testes, enquanto que um serviço normal deve usar certificados reais. A iniciativa <link linkend="sidebar.letsencrypt">Let's encrypt</link> fornece certificados SSL/TLS livres e confiáveis, que podem ser gerados usando o pacote <emphasis role="pkg">certbot</emphasis> como descrito em <xref linkend="sect.apache-ssl" /> e então usados no <command>postfix</command> desta forma:

en: <primary>Postfix</primary><secondary>trusted certificates</secondary>
pt-BR: <primary>Postfix</primary><secondary>certificados confiáveis</secondary>

en: Configuring Virtual Domains
pt-BR: Configurando Domínios Virtuais

en: <primary>Postfix</primary><secondary>virtual domain</secondary>
pt-BR: <primary>Postfix</primary><secondary>domínio virtual</secondary>

en: <primary>domain</primary><secondary>virtual</secondary>
pt-BR: <primary>domínio</primary><secondary>virtual</secondary>

en: <emphasis>CAUTION</emphasis> Virtual domains and canonical domains
pt-BR: <emphasis>ATENÇÃO</emphasis> Domínios virtuais e domínios canônicos

en: None of the virtual domains must be referenced in the <literal>mydestination</literal> variable; this variable only contains the names of the “canonical” domains directly associated to the machine and its local users.
pt-BR: Nenhum dos domínios virtuais deve ser referenciado na variável <literal>mydestination</literal>; está variável somente contém os nomes "canônicos" dos domínios diretamente associados a máquina e seus usuários locais.

en: Virtual Alias Domains
pt-BR: Alias de domínios virtuais

en: <primary>alias</primary><secondary>virtual alias domain</secondary>
pt-BR: <primary>aliás</primary><secondary>alias de domínio virtual</secondary>

en: A virtual alias domain only contains aliases, i.e. addresses that only forward emails to other addresses.
pt-BR: Um alias de domínio virtual contém somente aliases, isto é, endereços que encaminham unicamente os e-mails para outros endereços.

en: Such a domain is enabled by adding its name to the <literal>virtual_alias_domains</literal> variable, and referencing an address mapping file in the <literal>virtual_alias_maps</literal> variable.
pt-BR: Tal domínio é ativado ao se adicionar seu nome a variável <literal>virtual_alias_domains</literal>, e referenciar um arquivo de mapa de endereços a variável <literal>virtual_alias_maps</literal>.

en: The <filename>/etc/postfix/virtual</filename> file describes a mapping with a rather straightforward syntax: each line contains two fields separated by whitespace; the first field is the alias name, the second field is a list of email addresses where it redirects. The special <literal>@domain.com</literal> syntax covers all remaining aliases in a domain.
pt-BR: O arquivo <filename>/etc/postfix/virtual</filename> descreve o mapeamento com uma sintaxe bastante simples: cada linha contém dois campos separados por espaços em branco; o primeiro campo é o nome do alias, o segundo campo é uma lista de endereços de e-mail onde ele redireciona. A sintaxe especial <literal>@domain.com</literal> abrange todos os aliases restantes em um domínio.

en: After changing <filename>/etc/postfix/virtual</filename> the postfix table <filename>/etc/postfix/virtual.db</filename> needs to be updated using <command>sudo postmap /etc/postfix/virtual</command>.
pt-BR: Depois de alterar o <filename>/etc/postfix/virtual</filename>, a tabela postfix <filename>/etc/postfix/virtual.db</filename> precisa ser atualizada usando o <command>sudo postmap /etc/postfix/virtual</command>.

en: Virtual Mailbox Domains
pt-BR: Domínios Virtuais de Caixa de Correio

en: <primary>mailbox, virtual domain</primary>
pt-BR: <primary>domínio virtual de caixas de correio</primary>

en: <emphasis>CAUTION</emphasis> Combined virtual domain?
pt-BR: <emphasis>ATENÇÃO</emphasis> Domínio virtual combinado?

en: Postfix does not allow using the same domain in both <literal>virtual_alias_domains</literal> and <literal>virtual_mailbox_domains</literal>. However, every domain of <literal>virtual_mailbox_domains</literal> is implicitly included in <literal>virtual_alias_domains</literal>, which makes it possible to mix aliases and mailboxes within a virtual domain.
pt-BR: O Postfix não permitir o uso do mesmo domínio, tanto <literal>virtual_alias_domains</literal> e <literal>virtual_mailbox_domains</literal>. No entanto, todos os domínios da <literal>virtual_mailbox_domains</literal> está implicitamente incluído no <literal>virtual_alias_domains</literal>, o que torna possível misturar aliases e caixas de correio dentro de um domínio virtual.

en: Messages addressed to a virtual mailbox domain are stored in mailboxes not assigned to a local system user.
pt-BR: As mensagens endereçadas a um domínio de caixa de correio virtual são armazenadas em caixas de correio não atribuídos a um usuário do sistema local.

en: Enabling a virtual mailbox domain requires naming this domain in the <literal>virtual_mailbox_domains</literal> variable, and referencing a mailbox mapping file in <literal>virtual_mailbox_maps</literal>. The <literal>virtual_mailbox_base</literal> parameter contains the directory under which the mailboxes will be stored.
pt-BR: Ativando um domínio de caixa de correio virtual requer nomear este domínio na variável <literal>virtual_mailbox_domains</literal>, e referenciar um arquivo de mapeamento de caixa de correio no <literal>virtual_mailbox_maps</literal>. O parâmetro <literal>virtual_mailbox_base</literal> contém o diretório sob o qual as caixas de correio serão armazenadas.

en: The <literal>virtual_uid_maps</literal> parameter (respectively <literal>virtual_gid_maps</literal>) references the file containing the mapping between the email address and the system user (respectively group) that “owns” the corresponding mailbox. To get all mailboxes owned by the same owner/group, the <literal>static:5000</literal> syntax assigns a fixed UID/GID (of value 5000 here).
pt-BR: O parâmetro <literal>virtual_uid_maps</literal> (<literal>virtual_gid_maps</literal> respectivamente) faz referência ao arquivo que contém o mapeamento entre o endereço de e-mail e o usuário do sistema (grupo respectivamente) que "possui" a caixa correspondente. Para obter todas as caixas de correio de propriedade do mesmo dono/grupo, a sintaxe <literal>static:5000</literal> atribui um UID/GID fixo (de valor 5000 aqui).

en: Again, the syntax of the <filename>/etc/postfix/vmailbox</filename> file is quite straightforward: two fields separated with whitespace. The first field is an email address within one of the virtual domains, and the second field is the location of the associated mailbox (relative to the directory specified in <emphasis>virtual_mailbox_base</emphasis>). If the mailbox name ends with a slash (<literal>/</literal>), the emails will be stored in the <emphasis>maildir</emphasis> format; otherwise, the traditional <emphasis>mbox</emphasis> format will be used. The <emphasis>maildir</emphasis> format uses a whole directory to store a mailbox, each individual message being stored in a separate file. In the <emphasis>mbox</emphasis> format, on the other hand, the whole mailbox is stored in one file, and each line starting with “<literal>From </literal>” (<literal>From</literal> followed by a space) signals the start of a new message.
pt-BR: Novamente, a sintaxe do arquivo <filename>/etc/postfix/vmailbox</filename> é bastante simples: dois campos separados por espaço em branco. O primeiro campo é um endereço de e-mail dentro de um dos domínios virtuais, e o segundo campo é a localização da caixa de correio associada (relativo ao diretório especificado no <emphasis>virtual_mailbox_base</emphasis>). Se o nome da caixa de correio termina com uma barra (<literal>/</literal>), os e-mails serão armazenados no formato <emphasis>maildir</emphasis>; caso contrário, o tradicional formato <emphasis> mbox</emphasis> será usado. O formato <emphasis>maildir</emphasis> usa um diretório inteiro para armazenar a caixa de correio, cada mensagem que está sendo armazenada em um arquivo separado. No formato <emphasis>mbox</emphasis>, por outro lado, toda a caixa de correio é armazenado em um arquivo, e cada linha começando com "<literal>De </literal>" (<literal>De</literal> seguido de um espaço) indica o início de uma nova mensagem.

en: 
    # Jean's email is stored as maildir, with
    # one file per email in a dedicated directory
    jean@falcot.org falcot.org/jean/
    # Sophie's email is stored in a traditional "mbox" file,
    # with all mails concatenated into one single file
    sophie@falcot.org falcot.org/sophie
pt-BR: 
    # Os e-mails de Jean são armazenados como maildir, com
    # um arquivo por e-mail em um diretório dedicado
    jean@falcot.org falcot.org/jean/
    # Os e-mails de Sophie são armazenados em um arquivo tradicional "mbox",
    # com todos os e-mails concatenados em um arquivo único
    sophie@falcot.org falcot.org/sophie

en: Restrictions for Receiving and Sending
pt-BR: Restrições para Recebimento e Envio

en: The growing number of unsolicited bulk emails (<emphasis>spam</emphasis>) requires being increasingly strict when deciding which emails a server should accept. This section presents some of the strategies included in Postfix.
pt-BR: O crescente número de e-mails em massa não solicitados (<emphasis>spams</emphasis>) requer cada vez ser mais rigoroso ao decidir quais e-mails um servidor deve aceitar. Esta seção apresenta algumas das estratégias incluídas no Postfix.

en: If the reject-rules are too strict, it may happen that even legitimate email traffic gets locked out. It is therefor a good habit to test restrictions and prevent the permanent rejection of requests during this time using the <literal>soft_bounce = yes</literal> directive. By prepending a reject-type directive with <literal>warn_if_reject</literal> only a log message will be recorded instead of rejecting the request.
pt-BR: Se as reject-rules forem muito restritivas, pode acontecer que até mesmo emails válidos fiquem travados. Portanto, é um bom hábito testar restrições e prevenir a rejeição permanente de requisições durante este tempo usando a diretiva <literal>soft_bounce = yes</literal>. Adicionando uma diretiva reject-type com <literal>warn_if_reject</literal> faz com que apenas uma mensagem de log seja gravada ao invés de rejeitar a mensagem.

en: <emphasis>CULTURE</emphasis> The spam problem
pt-BR: <emphasis>CULTURA</emphasis> O problema do spam

en: <primary>unsolicited commercial email</primary><see>spam</see>
pt-BR: <primary>e-mail comercial não solicitado</primary><see>spam</see>

en: “Spam” is a generic term used to designate all the unsolicited commercial emails (also known as UCEs) that flood our electronic mailboxes; the unscrupulous individuals sending them are known as spammers. They care little about the nuisance they cause, since sending an email costs very little, and only a very small percentage of recipients need to be attracted by the offers for the spamming operation to make more money than it costs. The process is mostly automated, and any email address made public (for instance, on a web forum, or on the archives of a mailing list, or on a blog, and so on) will be likely discovered by the spammers' robots, and subjected to a never-ending stream of unsolicited messages. Also every contact found at a compromised system is targeted.
pt-BR: "Spam" é um termo genérico usado para designar todos os e-mails comerciais não solicitadas (também conhecidas como UCEs) que inundam nossas caixas de correio eletrônico; indivíduos sem escrúpulos que os enviam são conhecidos como spammers. Eles pouco se importam com o incômodo que causam já que os custos de envio de e-mail custa muito pouco e precisam somente atrair para suas ofertas uma percentagem muito pequena de quem os recebe para que a operação de spam gere mais dinheiro do que custa. O processo é praticamente todo automatizado, e qualquer endereço de e-mail tornado público (por exemplo, em um fórum na web, ou nos arquivos de uma lista de discussão, ou em um blog, e assim por diante) será descoberto pelos robôs dos spammers, e submetido para um fluxo interminável de mensagens não solicitadas. Além disso, todos os contatos encontrados em um sistema comprometido são direcionados.

en: All system administrators try to face this nuisance with spam filters, but of course spammers keep adjusting to try to work around these filters. Some even rent networks of machines compromised by a worm from various crime syndicates. Recent statistics estimate that up to 95% of all emails circulating on the Internet are spam!
pt-BR: Todos os administradores de sistema tentam enfrentar esse incômodo com filtros de spam, mas os spammers, claro, mantém os ajustes para tentar contornar esses filtros. Alguns até mesmo alugam redes de máquinas comprometidas por um worm de vários sindicatos do crime. Estatísticas recentes estimam que até 95% de todos os e-mails que circulam na Internet são spam!

en: IP-Based Access Restrictions
pt-BR: Restrições de Acesso Baseados no IP

en: <primary>email</primary><secondary>filtering on the client host</secondary>
pt-BR: <primary>e-mail</primary><secondary>filtrando na máquina cliente</secondary>

en: The <literal>smtpd_client_restrictions</literal> directive controls which machines are allowed to communicate with the email server.
pt-BR: A diretiva <literal>smtpd_client_restrictions</literal> controla quais máquinas tem permissão para se comunicar com o servidor de e-mail.

en: When a variable contains a list of rules, as in the example below, these rules are evaluated in order, from the first to the last. Each rule can accept the message, reject it, or leave the decision to a following rule. As a consequence, order matters, and simply switching two rules can lead to a widely different behavior.
pt-BR: Quando uma variável contém uma lista de regras, como no exemplo abaixo, essas regras são avaliadas em ordem, desde a primeira até a última. Cada regra pode aceitar a mensagem, rejeitá-la, ou deixar a decisão para a seguinte regra. Como consequência, a ordem importa e simplesmente mudar duas regras pode levar a um comportamento completamente diferente.

en: Restrictions Based on Client Address
pt-BR: Restrições Baseadas no Endereço do Cliente

en: The <literal>permit_mynetworks</literal> directive, used as the first rule, accepts all emails coming from a machine in the local network (as defined by the <literal>mynetworks</literal> configuration variable).
pt-BR: A diretiva <literal>permit_mynetworks</literal>, usada como primeira regra, aceita e-mails vindos de uma máquina na rede local (como definido na variável de configuração <literal>mynetworks</literal>).

en: The second directive would normally reject emails coming from machines without a completely valid DNS configuration. Such a valid configuration means that the IP address can be resolved to a name, and that this name, in turn, resolves to the IP address. This restriction is often too strict, since many email servers do not have a reverse DNS for their IP address. This explains why the Falcot administrators prepended the <literal>warn_if_reject</literal> modifier to the <literal>reject_unknown_client</literal> directive: this modifier <link linkend="postfix-safety-net">turns the rejection into a simple warning recorded in the logs</link>. The administrators can then keep an eye on the number of messages that would be rejected if the rule were actually enforced, and make an informed decision later if they wish to enable such enforcement.
pt-BR: A segunda diretiva normalmente rejeitaria e-mails provenientes de máquinas sem uma configuração de DNS completamente válido. Tal configuração válida significa que o endereço IP pode ser resolvida para um nome, e que esse nome, por sua vez, resolve o endereço IP. Essa restrição é muitas vezes demasiada rigorosa, uma vez que muitos servidores de e-mail não tem um DNS reverso para o seu endereço IP. Isso explica por que os administradores da Falcot prefixaram o modificador <literal>warn_if_reject</literal> para a diretiva <literal>reject_unknown_client</literal>: este modificador <link linkend="postfix-safety-net">transforma a rejeição em uma simples advertência registrada nos logs</link>. Os administradores podem, em seguida, manter um olho sobre o número de mensagens que seriam rejeitadas se a regra fosse realmente cumprida, e tomar uma decisão informada mais tarde, se quiser ativar essa aplicação.

en: <emphasis>TIP</emphasis> <emphasis>access</emphasis> tables
pt-BR: <emphasis>DICA</emphasis> tabelas de <emphasis>acesso</emphasis>

en: The <filename>/etc/postfix/access_clientip</filename> table lists IP addresses and networks; <filename>/etc/postfix/access_helo</filename> lists domain names; <filename>/etc/postfix/access_sender</filename> contains sender email addresses. All these files need to be turned into hash-tables (a format optimized for fast access) after each change, with the <command>sudo postmap /etc/postfix/<replaceable>file</replaceable></command> command.
pt-BR: A tabela <filename>/etc/postfix/access_clientip</filename> lista os endereços IP e redes; <filename>/etc/postfix/access_helo</filename> lista nomes de domínio; <filename>/etc/postfix/access_sender</filename> contém endereços de e-mail do remetente. Todos esses arquivos precisam ser transformados em tabelas-hash (um formato otimizado para acesso rápido) após cada alteração, com o comando <command>sudo postmap /etc/postfix/<replaceable>arquivo</replaceable></command>.

en: The last four rules reject any message coming from a server listed in one of the indicated blacklists. <acronym>RBL</acronym> is an acronym for <emphasis>Remote Black List</emphasis>, and <acronym>RHSBL</acronym> stands for <emphasis>Right-Hand Side Black List</emphasis>. The difference is that the former lists IP addresses, whereas the latter lists domain names. There are several such services. They list domains and IP addresses with poor reputation, badly configured servers that spammers use to relay their emails, as well as unexpected mail relays such as machines infected with worms or viruses.
pt-BR: As últimas quatro regras rejeitam qualquer mensagem proveniente de um servidor relacionado em uma das listas bloqueadas indicadas. <acronym>RBL</acronym> é um acrônimo para <emphasis>Remote Block List</emphasis> (Lista Bloqueada Remota) e <acronym>RHSBL</acronym> significa <emphasis>Right-Hand Side Block List</emphasis> (Lista Bloqueada de Confiança). A diferença é que a primeira lista endereços IP e a última lista nomes de domínio. Existem diversos desses serviços. Eles listam domínios e endereços IP de baixa reputação, servidores mal configurados que spammers usam para transmitir seus e-mails, bem como relays de e-mails inesperados como máquinas infectadas com worms ou vírus.

en: <emphasis>TIP</emphasis> White list and RBLs
pt-BR: <emphasis>DICA</emphasis> Listas brancas e RBLs

en: Blacklists sometimes include a legitimate server that has been suffering an incident. In these situations, all emails coming from one of these servers would be rejected unless the server is listed in a whitelist defined by <filename>/etc/postfix/access_clientip</filename>.
pt-BR: Listas negras, por vezes, incluem um servidor legítimo que tem sofrido um incidente. Nestas situações, todos os e-mails provenientes de um desses servidores seria rejeitado a menos que o servidor esteja listado em uma lista branca definida em <filename>/etc/postfix/access_clientip</filename>.

en: Prudence therefore recommends including in the whitelist(s) all the trusted servers from which many emails are usually received.
pt-BR: A prudência recomenda a inclusão de todos os servidores confiáveis na lista(s) branca de onde muito e-mail são geralmente recebidos.

en: Checking the Validity of the <literal>EHLO</literal> or <literal>HELO</literal> Commands
pt-BR: Verificando a Validade dos Comandos <literal>EHLO</literal> ou <literal>HELO</literal>

en: <primary>email</primary><secondary>filtering on the mail host</secondary>
pt-BR: <primary>e-mail</primary><secondary>filtrando na máquina de e-mail</secondary>

en: Each SMTP exchange starts with a <literal>HELO</literal> (or <literal>EHLO</literal>) command, followed by the name of the sending email server. Checking the validity of this name can be interesting. To fully enforce the restrictions listed in <literal>smtpd_helo_restrictions</literal> the <literal>smtpd_helo_required</literal> option needs to be enabled. Otherwise clients could skip the restrictions by not sending any <literal>HELO</literal>/<literal>EHLO</literal> command.
pt-BR: Cada troca SMTP inicia com um comando <literal>HELO</literal> (ou <literal>EHLO</literal>), seguido do nome do servidor de email remetente. Checar a validade deste nome pode ser interessante. Para garantir completamente as restrições listadas em <literal>smtpd_helo_restrictions</literal> a opção <literal>smtpd_helo_required</literal> precisa estar habilitada. Caso contrário os clientes podem pular as restrições não enviando nenhum comando <literal>HELO</literal>/<literal>EHLO</literal>.

en: Restrictions on the name announced in <literal>EHLO</literal>
pt-BR: Restrições no nome anunciado com <literal>EHLO</literal>

en: The first <literal>permit_mynetworks</literal> directive allows all machines on the local network to introduce themselves freely. This is important, because some email programs do not respect this part of the SMTP protocol adequately enough, and they can introduce themselves with nonsensical names.
pt-BR: A primeira diretiva <literal>permit_mynetworks</literal> permite que todas as máquinas da rede local se apresentem livremente. Isso é importante, porque alguns programas de e-mail não respeitam essa parte do protocolo SMTP de forma suficientemente correta e podem se apresentar com nomes sem sentido.

en: The <literal>reject_rhsbl_helo</literal> allows to specify a black list to check the hostname against an RHSBL.
pt-BR: O <literal>reject_rhsbl_helo</literal> permite especificar uma lista negra para verificar o nome da máquina num RHSBL.

en: Using <literal>permit_mynetworks</literal> as the first rule has an interesting side effect: the following rules only apply to hosts outside the local network. This allows blacklisting all hosts that announce themselves as part of the <literal>falcot.com</literal> network, for instance by adding a <literal>falcot.com REJECT You are not in our network!</literal> line to the <filename>/etc/postfix/access_helo</filename> file.
pt-BR: Usando <literal>permit_mynetworks</literal> como a primeira regra tem um efeito colateral interessante: as regras seguintes aplicam-se apenas aos hosts fora da rede local. Isso permite bloquear todos os hosts que se anunciam como parte da rede <literal>falcot.com</literal>, por exemplo adicionando uma linha <literal>falcot.com REJECT Você não é da nossa rede!</literal> no arquivo <filename>/etc/postfix/access_helo</filename>.

en: <primary>email</primary><secondary>filtering on the sender</secondary>
pt-BR: <primary>e-mail</primary><secondary>filtrando pelo remetente</secondary>

en: Every message has a sender, announced by the <literal>MAIL FROM</literal> command of the SMTP protocol; again, this information can be validated in several different ways.
pt-BR: Toda mensagem tem um remetente, anunciado pelo comando <literal>MAIL FROM</literal> do protocolo SMTP; novamente esta informação pode ser validada de diversas maneiras.

en: Sender checks
pt-BR: Verificações do Remetente

en: The <filename>/etc/postfix/access_sender</filename> table maps some special treatment to some senders. This usually means listing some senders into a white list or a black list.
pt-BR: A tabela <filename>/etc/postfix/access_sender</filename> mapeia algum tratamento especial a alguns remetentes. Isso geralmente significa listar alguns remetentes em uma lista branca ou uma lista negra.

en: Finally, the <literal>reject_non_fqdn_sender</literal> rule rejects emails purporting to come from addresses without a fully-qualified domain name. In practice, this means rejecting emails coming from <literal>user@machine</literal>: the address must be announced as either <literal>user@machine.example.com</literal> or <literal>user@example.com</literal>.
pt-BR: Finalmente, a regra <literal>reject_non_fqdn_sender</literal> rejeita e-mails que pretendem vir de endereços sem um nome de domínio totalmente qualificado. Na prática, isso significa rejeitar e-mails vindos de um usuário <literal>@máquina</literal>: o endereço deve ser anunciado como <literal>user@machine.example.com</literal> ou <literal>user@example.com</literal>.

en: The <literal>reject_rhsbl_sender</literal> rule reject senders based on a (domain-based) RHSBL service.
pt-BR: A regra <literal>reject_rhsbl_sender</literal> rejeita remetentes baseada num serviço RHSBL (baseado em domínio).

en: <primary>email</primary><secondary>filtering on the recipient</secondary>
pt-BR: <primary>e-mail</primary><secondary>filtrando pelo destinatário</secondary>

en: Each email has at least one recipient, announced with the <literal>RCPT TO</literal> command in the SMTP protocol. These addresses also warrant validation, even if that may be less relevant than the checks made on the sender address.
pt-BR: Todo e-mail tem ao menos um destinatário, anunciado com o comando <literal>RCPT TO</literal> no protocolo SMTP. Estes endereços também são passíveis de validação, mesmo que sejam menos relevantes do que as verificações feitas no endereço do remetente.

en: Recipient checks
pt-BR: Verificações pelo Destinatário

en: <literal>reject_unauth_destination</literal> is the basic rule that requires outside messages to be addressed to us; messages sent to an address not served by this server are rejected. Without this rule, a server becomes an open relay that allows spammers to send unsolicited emails; this rule is therefore mandatory, and it will be best included near the beginning of the list, so that no other rules may authorize the message before its destination has been checked.
pt-BR: <literal>reject_unauth_destination</literal> é a regra básica que exige que mensagens externas sejam endereçadas para nós; mensagens enviadas para um endereço não servido por este servidor são rejeitadas. Sem esta regra, um servidor se torna um retransmissor ("relay") aberto que permite que spammers enviem e-mails não solicitados; esta regra é, portanto, obrigatória, e vai ser melhor incluí-la perto do início da lista, de forma que nenhuma outra regra possa autorizar a mensagem antes de seu destino ser verificado.

en: The <literal>reject_unlisted_recipient</literal> rule rejects messages sent to non-existing local users, which makes sense. Finally, the <literal>reject_non_fqdn_recipient</literal> rule rejects non-fully-qualified addresses; this makes it impossible to send an email to <literal>jean</literal> or <literal>jean@machine</literal>, and requires using the full address instead, such as <literal>jean@machine.falcot.com</literal> or <literal>jean@falcot.com</literal>.
pt-BR: A regra <literal>reject_unlisted_recipient</literal> rejeita mensagens enviadas para usuários locais não-existentes, o que faz sentido. Finalmente, a regra <literal>reject_non_fqdn_recipient</literal> rejeita endereços não totalmente qualificados; isso faz com que seja impossível enviar um e-mail para <literal>jean</literal> ou <literal>jean@machine</literal>, e em vez disso requer o uso do endereço completo, como <literal>jean@machine.falcot.com</literal> ou <literal>jean@falcot.com</literal>.

en: The <literal>permit</literal> directive at the end is not necessary. But it can be useful at the end of a restriction list to make the default policy explicit.
pt-BR: A directiva <literal>permit</literal> no final não é necessária. Mas pode ser útil no final de uma lista de restrições para deixar explícita a política predeterminada.

en: Restrictions Associated with the <literal>DATA</literal> Command
pt-BR: Restrições Associadas ao Comando <literal>DATA</literal>

en: <primary>email</primary><secondary>filtering on SMTP commands</secondary>
pt-BR: <primary>e-mail</primary><secondary>filtro de comandos SMTP</secondary>

en: The <literal>DATA</literal> command of SMTP is emitted before the contents of the message. It doesn't provide any information per se, apart from announcing what comes next. It can still be subjected to checks.
pt-BR: O comando <literal>DATA</literal> do SMTP é emitido antes do conteúdo da mensagem. Ele não fornece qualquer informação, por si só, além de anunciar o que vem a seguir. Pode ainda ser submetidos a verificações.

en: <literal>DATA</literal> checks
pt-BR: Verificações pelo <literal>DATA</literal>

en: The <literal>reject_unauth_pipelining</literal> directives causes the message to be rejected if the sending party sends a command before the reply to the previous command has been sent. This guards against a common optimization used by spammer robots, since they usually don't care a fig about replies and only focus on sending as many emails as possible in as short a time as possible.
pt-BR: A diretiva <literal>reject_unauth_pipelining</literal> faz com que a mensagem seja rejeitada se o remetente envia um comando antes da resposta ao comando anterior foi enviado. Isso evita uma otimização comum usada por robôs de spammers, uma vez que eles geralmente não se importam em nada pelas respostas e se concentram apenas no envio de tantos e-mails quanto possível em tão curto espaço de tempo possível.

en: Applying Restrictions
pt-BR: Aplicando as Restrições

en: Although the above commands validate information at various stages of the SMTP exchange, Postfix sends the actual rejection as a reply to the <literal>RCPT TO</literal> command by default.
pt-BR: Embora os comandos acima validem as informações em vários estágios de troca SMTP, o Postfix envia por padrão a rejeição real como uma resposta ao comando <literal>RCPT TO</literal>.

en: This means that even if the message is rejected due to an invalid <literal>EHLO</literal> command, Postfix knows the sender and the recipient when announcing the rejection. It can then log a more explicit message than it could if the transaction had been interrupted from the start. In addition, a number of SMTP clients do not expect failures on the early SMTP commands, and these clients will be less disturbed by this late rejection.
pt-BR: Isto significa que mesmo se a mensagem for rejeitada devido a um comando <literal>EHLO</literal> inválido, o Postfix conhece o remetente e o destinatário ao anunciar a rejeição. Então ele pode registrar uma mensagem mais explícita do que ele poderia se a transação havia sido interrompida desde o início. Além disso, um número de clientes SMTP não esperam falhas nos comandos SMTP iniciais, e esses clientes serão menos perturbados por esta rejeição tardia.

en: A final advantage to this choice is that the rules can accumulate information during the various stages of the SMTP exchange; this allows defining more fine-grained permissions, such as rejecting a non-local connection if it announces itself with a local sender.
pt-BR: A vantagem final para esta escolha é que as regras podem acumular informação durante as várias fases do intercâmbio SMTP; este permite definir permissões mais refinadas, como a rejeição de uma conexão não-local se ele se anuncia com um remetente local.

en: The default behavior is controlled by the <literal>smtpd_delay_reject</literal> rule.
pt-BR: O comportamento padrão é controlado pela regra <literal>smtpd_delay_reject</literal>.

en: Filtering Based on the Message Contents
pt-BR: Filtrando Baseado no Conteúdo da Mensagem

en: <primary>email</primary><secondary>filtering on content inspection</secondary>
pt-BR: <primary>e-mail</primary><secondary>filtro de inspeção de conteúdo</secondary>

en: <primary>email</primary><secondary>filtering on contents</secondary>
pt-BR: <primary>e-mail</primary><secondary>filtro de conteúdo</secondary>

en: The validation and restriction system would not be complete without a way to apply checks to the message contents. Postfix differentiates the checks applying to the email headers from those applying to the email body.
pt-BR: O sistema de validação e restrição não seria completo sem uma maneira de aplicar verificações para o conteúdo da mensagem. O Postfix diferencia as verificações praticadas nos cabeçalhos de e-mail das que se aplicam ao corpo do e-mail.

en: Enabling content-based filters
pt-BR: Habilitação de filtros baseados em conteúdo

en: Both files contain a list of regular expressions (commonly known as <emphasis>regexps</emphasis> or <emphasis>regexes</emphasis>) and associated actions to be triggered when the email headers (or body) match the expression.
pt-BR: Ambos os arquivos contêm uma lista de expressões regulares (comumente conhecido como <emphasis>regexps</emphasis> ou <emphasis>regexes</emphasis>) e ações associadas a serem acionadas quando os cabeçalhos de e-mail (ou corpo) coincidir com a expressão.

en: <emphasis>QUICK LOOK</emphasis> Regexp tables
pt-BR: <emphasis>OLHADA RÁPIDA</emphasis> Tabelas de expressões regulares (regexp)

en: Example <filename>/etc/postfix/header_checks</filename> file
pt-BR: Exemplos do arquivo <filename>/etc/postfix/header_checks</filename>

en: <emphasis>BACK TO BASICS</emphasis> Regular expression
pt-BR: <emphasis>DE VOLTA AO BÁSICO</emphasis> Expressão regular

en: The <emphasis>regular expression</emphasis> term (shortened to <emphasis>regexp</emphasis> or <emphasis>regex</emphasis>) references a generic notation for expressing a description of the contents and/or structure of a string of characters. Certain special characters allow defining alternatives (for instance, <literal>foo|bar</literal> matches either “foo” or “bar”), sets of allowed characters (for instance, <literal>[0-9]</literal> means "any digit", and <literal>.</literal> — a dot — means "any character"), quantification (<literal>s?</literal> matches either <literal>s</literal> or the empty string, in other words 0 or 1 occurrence of <literal>s</literal>; <literal>s+</literal> matches one or more consecutive <literal>s</literal> characters; and so on). Parentheses allow grouping search results.
pt-BR: O termo <emphasis>expressão regular</emphasis> (abreviado como <emphasis>regexp</emphasis> ou <emphasis>regex</emphasis>) faz referência a uma notação genérica para expressar uma descrição do conteúdo e/ou da estrutura de um conjunto de caracteres. Alguns caracteres especiais permitem a definição de alternativas (por exemplo, <literal>foo|bar</literal> corresponde a "foo" ou "bar"), conjuntos de caracteres permitidos (por exemplo, <literal>[0-9]</literal > significa "qualquer dígito", e <literal>.</literal> - um ponto - significa "qualquer caractere"), quantidades (<literal>s?</literal> corresponde ou <literal>s</literal> ou uma cadeia vazia, em outras palavras 0 ou 1 ocorrência de <literal>s</literal>; <literal>s+</literal> corresponde a um ou mais caracteres <literal>s</literal> consecutivos, e assim por diante). Parênteses permite o agrupamento dos resultados da pesquisa.

en: The precise syntax of these expressions varies across the tools using them, but the basic features are similar. <ulink type="block" url="https://en.wikipedia.org/wiki/Regular_expression" />
pt-BR: A sintaxe precisa dessas expressões varia entre as ferramentas que as usam, mas as características básicas são semelhantes. <ulink type="block" url="https://en.wikipedia.org/wiki/Regular_expression" />

en: The first one checks the header mentioning the email software; if <literal>GOTO Sarbacane</literal> (a bulk email software) is found, the message is rejected. The second expression controls the message subject; if it mentions a virus notification, we can decide not to reject the message but to discard it immediately instead.
pt-BR: O primeiro verifica o cabeçalho mencionando o software de e-mail; a mensagem será rejeitada se <literal>GOTO Sarbacane</literal> (um software de e-mail em massa) for encontrado. A segunda expressão controla o assunto da mensagem; se menciona uma notificação de vírus, podemos decidir não rejeitar a mensagem, mas descartá-lo imediatamente.

en: Using these filters is a double-edged sword, because it is easy to make the rules too generic and to lose legitimate emails as a consequence. In these cases, not only the messages will be lost, but their senders will get unwanted (and annoying) error messages.
pt-BR: Usando esses filtros é uma espada de dois gumes, porque é fácil de fazer as regras demasiadamente genéricas e como consequência perder e-mails legítimos. Nestes casos, não apenas as mensagens serão perdidas, mas seus remetentes receberão mensagens de erro indesejadas (e chatas).

en: Setting Up <foreignphrase>greylisting</foreignphrase>
pt-BR: Configurando "listas cinzas" (<foreignphrase>greylisting</foreignphrase>)

en: <primary>greylisting</primary>
pt-BR: <primary>lista cinza</primary>

en: <primary>email</primary><secondary>greylisting</secondary>
pt-BR: <primary>e-mail</primary><secondary>lista cinza</secondary>

en: Postfix doesn't provide greylisting natively, but there is a feature by which the decision to accept or reject a given message can be delegated to an external program. The <emphasis role="pkg">postgrey</emphasis> package contains just such a program, designed to interface with this access policy delegation service.
pt-BR: Postfix não fornece lista cinza nativamente, mas existe uma funcionalidade na qual a decisão de aceitar ou rejeitar uma dada mensagem pode ser delegada a um programa externo. O pacote <emphasis role="pkg">postgrey</emphasis> contém tal programa, feito para ser uma interface com este serviço de delegação de políticas de acesso.

en: Once <emphasis role="pkg">postgrey</emphasis> is installed, it runs as a daemon and listens on port 10023. Postfix can then be configured to use it, by adding the <literal>check_policy_service</literal> parameter as an extra restriction:
pt-BR: Uma vez o <emphasis role="pkg">postgrey</emphasis> estando instalado, ele roda como um daemon e ouve na porta 10023. O Postfix pode então ser configurado para usá-lo. adicionando o parâmetro <literal>check_policy_service</literal> como uma restrição extra:

en: The main disadvantage of greylisting is that legitimate messages get delayed, which is not always acceptable. It also increases the burden on servers that send many legitimate emails.
pt-BR: A principal desvantagem de listas cinza é que mensagens legítimas podem ser atrasadas, o que nem sempre é aceitável. também aumenta a carga em servidores que mandam muitos email legítimos.

en: <emphasis>IN PRACTICE</emphasis> Shortcomings of greylisting
pt-BR: <emphasis>NA PRÁTICA</emphasis> Desvantagens das listas cinzas

en: Theoretically, greylisting should only delay the first mail from a given sender to a given recipient, and the typical delay is in the order of minutes. Reality, however, can differ slightly. Some large ISPs use clusters of SMTP servers, and when a message is initially rejected, the server that retries the transmission may not be the same as the initial one. When that happens, the second server gets a temporary error message due to greylisting too, and so on; it may take several hours until transmission is attempted by a server that has already been involved, since SMTP servers usually increase the delay between retries at each failure.
pt-BR: Teoricamente, a lista cinza deve apenas atrasar o primeiro email de um determinado remetente para um determinado destinatário e o atraso típico é da ordem de minutos. A realidade, contudo, pode diferir ligeiramente. Alguns grandes ISPs usam clusters de servidores SMTP e quando uma mensagem é rejeitada inicialmente, o servidor que repete a transmissão pode não ser o mesmo que o inicial. Quando isso acontece, o segundo servidor obtém uma mensagem de erro temporária devido à lista cinza também e assim por diante; Pode levar várias horas até que a transmissão seja tentada por um servidor que já esteve envolvido, uma vez que servidores SMTP geralmente aumentam o intervalo entre tentativas após cada falha.

en: As a consequence, the incoming IP address may vary in time even for a single sender. But it goes further: even the sender address can change. For instance, many mailing-list servers encode extra information in the sender address so as to be able to handle error messages (known as <emphasis>bounces</emphasis>). Each new message sent to a mailing-list may then need to go through greylisting, which means it has to be stored (temporarily) on the sender's server. For very large mailing-lists (with tens of thousands of subscribers), this can soon become a problem.
pt-BR: Como consequência, o endereço IP de entrada pode variar no tempo, mesmo para um único remetente. Porém isso vai mais além: até mesmo o endereço do remetente pode mudar. Por exemplo, muitos servidores de lista de discussão (mailing-list) codificam informações extra no endereço do remetente a fim de serem capazes de lidar com mensagens de erro (conhecidas como <emphasis>bounces</emphasis>). Cada nova mensagem enviada para uma lista de discussão pode então precisar passar por uma lista cinza, O que significa que ela tem que ser armazenada (temporariamente) no servidor do remetente. Para listas de discussão muito grandes (com dezenas de milhares de assinantes), isso pode em breve tornar-se um problema.

en: To mitigate these drawbacks, Postgrey manages a whitelist of such sites, and messages emanating from them are immediately accepted without going through greylisting. This list can easily be adapted to local needs, since it is stored in the <filename>/etc/postgrey/whitelist_clients</filename> file.
pt-BR: Para atenuar esses inconvenientes, o Postgrey gerencia uma lista branca de tais sites, e mensagens que são emanadas a partir deles são imediatamente aceitas sem passar pela lista cinza. Essa lista pode ser facilmente adaptada às necessidades locais, desde que ela seja armazenada no arquivo <filename>/etc/postgrey/whitelist_clients</filename>.

en: <emphasis>GOING FURTHER</emphasis> Selective greylisting with <emphasis role="pkg">milter-greylist</emphasis>
pt-BR: <emphasis>INDO MAIS LONGE</emphasis> greylisting seletivas com <emphasis role="pkg">milter-greylist</emphasis>

en: The drawbacks of greylisting can be mitigated by only using greylisting on the subset of clients that are already considered as probable sources of spam (because they are listed in a DNS blacklist). This is not possible with <emphasis role="pkg">postgrey</emphasis> but <emphasis role="pkg">milter-greylist</emphasis> can be used in such a way.
pt-BR: Os inconvenientes de uma lista cinza podem ser atenuados se a lista cinza só for usada em um subconjunto de clientes que já são considerados como prováveis fontes de spam (porque eles são listados em uma lista negra de DNS). Isso não é possível com o <emphasis role="pkg">postgrey</emphasis> mas o <emphasis role="pkg">milter-greylist</emphasis> pode ser utilizado para esse fim.

en: In that scenario, since DNS blacklists never triggers a definitive rejection, it becomes reasonable to use aggressive blacklists, including those listing all dynamic IP addresses from ISP clients (such as <literal>pbl.spamhaus.org</literal> or <literal>dul.dnsbl.sorbs.net</literal>).
pt-BR: Neste cenário, como a lista negra do DNS nunca desencadeia uma rejeição definitiva, torna-se razoável usar listas negras agressivas, incluindo aquelas que listam todos os endereços IP dinâmicos de clientes ISP (tais como <literal>pbl.spamhaus.org</literal> ou <literal>dul.dnsbl.sorbs.net</literal>).

en: Since <emphasis role="pkg">milter-greylist</emphasis> uses Sendmail's milter interface, the postfix side of its configuration is limited to “<literal>smtpd_milters = unix:/var/run/milter-greylist/milter-greylist.sock</literal>”. The <citerefentry><refentrytitle>greylist.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> manual page documents <filename>/etc/milter-greylist/greylist.conf</filename> and the numerous ways to configure milter-greylist. You will also have to edit <filename>/etc/default/milter-greylist</filename> to actually enable the service.
pt-BR: Como a <emphasis role="pkg">milter-greylist</emphasis> usa a interface milter do Sendmail, a configuração do lado do postfix é limitada a "<literal>smtpd_milters = unix:/var/run/milter-greylist/milter-greylist.sock</literal>”. A página de manual de <citerefentry><refentrytitle>greylist.conf</refentrytitle> <manvolnum>5</manvolnum></citerefentry> documenta o <filename>/etc/milter-greylist/greylist.conf</filename> e as inúmeras maneiras de configurar a milter-greylist. Você também terá que editar <filename>/etc/default/milter-greylist</filename> para realmente habilitar o serviço.

en: Customizing Filters Based On the Recipient
pt-BR: Personalização de filtros baseados no destinatário

en: <primary>email</primary><secondary>custom restriction classes</secondary>
pt-BR: <primary>e-mail</primary><secondary>classes de restrição personalizadas</secondary>

en: <xref linkend="sect.restrictions-for-receiving-and-sending" /> and <xref linkend="sect.setting-up-greylisting" /> reviewed many of the possible restrictions. They all have their use in limiting the amount of received spam, but they also all have their drawbacks. It is therefore more and more common to customize the set of filters depending on the recipient. At Falcot Corp, greylisting is interesting for most users, but it hinders the work of some users who need low latency in their emails (such as the technical support service). Similarly, the commercial service sometimes has problems receiving emails from some Asian providers who may be listed in blacklists; this service asked for a non-filtered address so as to be able to correspond.
pt-BR: <xref linkend="sect.restrictions-for-receiving-and-sending" /> e <xref linkend="sect.setting-up-greylisting" /> revisaram muitas das restrições possíveis. Todas objetivam limitar a quantidade de spam recebido, mas todas têm suas desvantagens. É portanto, mais e mais comum personalizar o conjunto de filtros dependendo do destinatário. Na Falcot Corp, a lista cinza é interessante para a maioria dos usuários, mas isso dificulta o trabalho de alguns usuários que precisam de baixa latência em seus e-mails (como o serviço de suporte técnico). De maneira similar, o serviço comercial às vezes tem problemas para receber e-mails de alguns provedores asiáticos que podem constar em listas negras; este serviço pede um endereço não filtrado de modo a ser capaz de corresponder.

en: Postfix provides such a customization of filters with a “restriction class” concept. The classes are declared in the <literal>smtpd_restriction_classes</literal> parameter, and defined the same way as <literal>smtpd_recipient_restrictions</literal>. The <literal>check_recipient_access</literal> directive then defines a table mapping a given recipient to the appropriate set of restrictions.
pt-BR: O Postfix fornece tal customização de filtros com o conceito de “classe de restrição”. As classes são declaradas no parâmetro <literal>smtpd_restriction_classes</literal>, e definidas da mesma maneira como <literal>smtpd_recipient_restrictions</literal>. A diretiva <literal>check_recipient_access</literal> então define uma tabela de mapeamento de um determinado destinatário para o conjunto apropriado de restrições.

en: Defining restriction classes in <filename>main.cf</filename>
pt-BR: Definição de classes de restrição em <filename>main.cf</filename>

en: The <filename>/etc/postfix/recipient_access</filename> file
pt-BR: O arquivo <filename>/etc/postfix/recipient_access</filename>

en: <primary>antivirus</primary>
pt-BR: <primary>antivírus</primary>

en: <primary>email</primary><secondary>virus scanning</secondary>
pt-BR: <primary>e-mail</primary><secondary>rastreio de vírus</secondary>

en: <emphasis>SECURITY</emphasis> Controversial Discussion of Anti-Virus Software
pt-BR: <emphasis>SEGURANÇA</emphasis> Discussão polêmica sobre software antivírus

en: The usage of virus scanners, or so called antivirus software, is controversial. There is usually a gap between the release of some piece of malware and the addition of detection rules to the antivirus database. During this gap, there is no software-based protection. Further, the usage often requires to run additional software, for example, to uncompress archives and scan all kinds of executables, which drastically increases the exploit potential of the antivirus software itself. Usage of such software solutions can therefor never replace awareness campaigns and simple behavioral rules (never open unsolicited sent attachments, etc.).
pt-BR: O uso de escáneres de virus, ou software antivírus, é controverso. Normalmente há um intervalo entre a publicação de um malware e a incorporação de regras de detecção na base de dados do antivírus. Durante este intervalo, não há proteção baseada em software. Ademas, o uso normalmente precisa da execução de software adicional, por exemplo, para descomprir arquivamentos e escanear todo tipo de executáveis, o que aumenta drasticamente o potencial de exploração do próprio antivírus. Portanto, o uso de tais soluções de software nunca substitui campanhas de conscientização e regras simples de comportamento (nunca abrir anexos enviados de desconhecidos, etc.).

en: <primary>antivirus</primary><secondary>controversy</secondary>
pt-BR: <primary>antivírus</primary><secondary>controvérsia</secondary>

en: The task of interfacing between antivirus and the email server goes to <command>clamav-milter</command>. A <emphasis>milter</emphasis> (short for <emphasis>mail filter</emphasis>) is a filtering program specially designed to interface with email servers. A milter uses a standard application programming interface (API) that provides much better performance than filters external to the email servers. Milters were initially introduced by <emphasis>Sendmail</emphasis>, but <emphasis>Postfix</emphasis> soon followed suit.
pt-BR: A tarefa de fazer a interface entre o antivírus e o servidor de email vai para o <command>clamav-milter</command>. Um<emphasis>milter</emphasis> (abreviação de <emphasis>mail filter</emphasis>) é um programa de filtragem especialmente projetado para fazer a interface com os servidores de email. O milter usa uma interface de programação de aplicativo (API) padrão que fornece uma performace muito melhor que os filtros externos para servidores de email. Os milters foram inicialmente introduzidos pelo <emphasis>Sendmail</emphasis>, mas o <emphasis>Postfix</emphasis> o adotou em seguida.

en: <emphasis>QUICK LOOK</emphasis> A milter for Spamassassin
pt-BR: <emphasis>OLHADA RÁPIDA</emphasis> Um milter para Spamassassin

en: The <emphasis role="pkg">spamass-milter</emphasis> package provides a milter based on <emphasis>SpamAssassin</emphasis>, the famous unsolicited email detector. It can be used to flag messages as probable spams (by adding an extra header) and/or to reject the messages altogether if their “spamminess” score goes beyond a given threshold.
pt-BR: O pacote <emphasis role="pkg">spamass-milter</emphasis> provê um milter baseado no <emphasis>SpamAssassin</emphasis>, o famoso detector de email não solicitado. Ele pode ser usado para sinalizar mensagens como prováveis spams (adicionando um cabeçalho extra) e/ou rejeitar as mensagens por completo se sua pontuação de “spam” ultrapassar um determinado limiar.

en: Once the <emphasis role="pkg">clamav-milter</emphasis> package is installed, the milter should be reconfigured to run on a TCP port rather than on the default named socket. This can be achieved with <command>dpkg-reconfigure clamav-milter</command>. When prompted for the “Communication interface with Sendmail”, answer “<literal>inet:10002@127.0.0.1</literal>”.
pt-BR: Uma vez que o pacote <emphasis role="pkg">clamav-milter</emphasis> esteja instalado, o milter deve ser reconfigurado para rodar em uma porta TCP ao invés do soquete nomeado padrão. Isso pode ser feito com <command>dpkg-reconfigure clamav-milter</command>. Quando questionado pela “Communication interface with Sendmail”, responda “<literal>inet:10002@127.0.0.1</literal>”.

en: <emphasis>NOTE</emphasis> Real TCP port vs named socket
pt-BR: <emphasis>NOTA</emphasis> Porta TCP real versus soquete nomeado

en: The reason why we use a real TCP port rather than the named socket is that the postfix daemons often run chrooted and do not have access to the directory hosting the named socket. You could also decide to keep using a named socket and pick a location within the chroot (<filename>/var/spool/postfix/</filename>).
pt-BR: A razão porque nós usamos uma porta TCP real ao invés de um socket nomeado é que os daemons do postfix geralmente são executados em um ambiente "chrooted" e não têm acesso ao diretório que hospeda o socket nomeado. Você também poderia decidir continuar usando um socket nomeado e escolher um local dentro do ambiente "chroot" (<filename>/var/spool/postfix/</filename>).

en: The standard ClamAV configuration fits most situations, but some important parameters can still be customized with <command>dpkg-reconfigure clamav-base</command>.
pt-BR: A configuração padrão do ClamAV se encaixa na maioria das situações, mas alguns parâmetros importantes ainda podem ser customizados com <command>dpkg-reconfigure clamav-base</command>.

en: The last step involves telling Postfix to use the recently-configured filter. This is a simple matter of adding the following directive to <filename>/etc/postfix/main.cf</filename>:
pt-BR: O último passo envolve informar ao Postfix para usar o filtro recém-configurado. Isso é uma simples questão de adicionar a seguinte diretiva ao <filename>/etc/postfix/main.cf</filename>:

en: If the antivirus causes problems, this line can be commented out, and <command>systemctl reload postfix</command> should be run so that this change is taken into account.
pt-BR: Se o antivírus causar problemas, essa linha pode ser retirada de comentário e <command>systemctl reload postfix</command> deve ser executado para que essa alteração seja levada em conta.

en: <emphasis>IN PRACTICE</emphasis> Testing the antivirus
pt-BR: <emphasis>NA PRÁTICA</emphasis> Testando o antivírus

en: Once the antivirus is set up, its correct behavior should be tested. The simplest way to do that is to send a test email with an attachment containing the <filename>eicar.com</filename> (or <filename>eicar.com.zip</filename>) file, which can be downloaded online: <ulink type="block" url="https://2016.eicar.org/86-0-Intended-use.html" />
pt-BR: Uma vez que o antivírus esteja configurado, seu comportamento correto deve ser testado. A maneira mais simples de fazer isso é enviar um e-mail de teste com um anexo contendo o arquivo <filename>eicar.com</filename> (ou <filename>eicar.com.zip</filename>), o qual pode ser baixado on-line em: <ulink type="block" url="https://www2016.eicar.org/86-0-Intended-use.html" />

en: This file is not a true virus, but a test file that all antivirus software on the market diagnose as a virus to allow checking installations.
pt-BR: Esse arquivo não é um vírus verdadeiro, mas um arquivo teste que todos os softwares de antivírus no mercado diagnosticam como um vírus para permitir a checagem das instalações.

en: All messages handled by Postfix now go through the antivirus filter.
pt-BR: Todas as mensagens manipuladas pelo Postfix agora passam pelo filtro de antivírus.

en: Fighting Spam with SPF, DKIM and DMARC
pt-BR: Lutando contr o spam com SPF, DKIM y DMARC

en: The high number of unsolicited email sent every day led to the creation of several standards, which aim at validating that the sending host of an email is authorized and that the email has not been tampered with. The following systems are all DNS-based and require the administrators to not only have control over the mail server, but over the DNS for the domain in question too.
pt-BR: O grande números de email não-solicitado enviado a cada dia levou à criação de vários padrões, que visam validar que a máquina que envou uma mensagem está autorizada e que o email não foi adulterado. Os seguintes sistemas estão baseados em DNS e precisam não apenas que os administradores tenham controle sobre o servidor de email, como também sobre o DNS para o domínio em questão.

en: <emphasis>CAUTION</emphasis> Controversial Discussion
pt-BR: <emphasis>ATENÇÃO</emphasis> Discussão polêmica

en: Integrating the Sender Policy Framework (SPF)
pt-BR: Integrando a Sender Policy Framework (SPF)

en: The Sender Policy Framework (<acronym>SPF</acronym>) is used to validate if a certain mail server is allowed to send emails for a given domain. It is mostly configured through DNS. The syntax for the entry to make is explained in detail at: <ulink type="block" url="http://www.open-spf.org/SPF_Record_Syntax" /> <ulink type="block" url="https://tools.ietf.org/html/rfc7208" /> <ulink type="block" url="https://en.wikipedia.org/wiki/Sender_Policy_Framework" />
pt-BR: A Sender Policy Framework (<acronym>SPF</acronym>) é utilizada para validar se um servidor de correio eletrônico tem permissão para enviar e-mails por um determinado domínio. É normalmente configurado através do DNS. A sintaxe para fazer uma entrada é explicada em detalhes em: <ulink type="block" url="http://www.open-spf.org/SPF_Record_Syntax" /> <ulink type="block" url="https://tools.ietf.org/html/rfc7208" /> <ulink type="block" url="https://en.wikipedia.org/wiki/Sender_Policy_Framework" />

en: Let's take a quick look at the <literal>falcot.org</literal> entry.
pt-BR: Vamos dar uma rápida olhada na entrada <literal>falcot.org</literal>.

en: It states that the IP of the sender must match the A record for the sending domain, or must be listed as one of the Mail Exchange Resource Records for the current domain, or must be one of the three mentioned IP4 addresses. All other hosts should be marked as not being allowed to send email for the sender domain. The latter is called a "soft fail" and is intended to mark the email accordingly, but still accept it.
pt-BR: Ele afirma que o IP do remetente deve corresponder ao registro A para o domínio de envio, ou deve ser listado com um dos registros de recursos de troca de mensagens para o domínio atual, ou deve ser um dos três endereços IPv4 mencionados. Todos os outros hosts devem ser marcados como não autorizados a enviar e-mail para o domínio remetente. Este último é chamado de "falha leve" e destina-se a marcar o e-mail de acordo, mas ainda assim aceitá-lo.

en: The <command>postfix</command> mail server can check the SPF record for incoming emails using the <emphasis role="pkg">postfix-policyd-spf-python</emphasis> package, a policy agent written in Python. The file <filename>/usr/share/doc/postfix-policyd-spf-python/README.Debian</filename> describes the necessary steps to integrate the agent into postfix, so we won't repeat it here.
pt-BR: O servidor de email <command>postfix</command> pode checar o registro SPF dos emails de entrada usando o pacote <emphasis role="pkg">postfix-policyd-spf-python</emphasis>, um agente de política escrito em Python. O arquivo <filename>/usr/share/doc/postfix-policyd-spf python/README.Debian</filename> descreve os passos necessários para integrar o agente ao postfix, então nós não iremos repetí-los aqui.

en: The configuration is done in the file <filename>/etc/postfix-policyd-spf-python/policyd-spf.conf</filename>, which is fully documented in <citerefentry><refentrytitle>policyd-spf.conf</refentrytitle> <manvolnum>5</manvolnum></citerefentry> and <filename>/usr/share/doc/postfix-policyd-spf-python/policyd-spf.conf.commented.gz</filename>. The main configuration parameters are <literal>HELO_reject</literal> and <literal>Mail_From_reject</literal>, which configure if emails should be rejected (<literal>Fail</literal>) or accepted with a header being appended (<literal>False</literal>), if checks fail. The latter is often useful, when the message is further processed by a spam filter.
pt-BR: A configuração é feita no arquivo <filename>/etc/postfix-policyd-spf-python/policyd-spf.conf</filename>, que é documentado em <citerefentry><refentrytitle>policyd-spf.conf</refentrytitle> <manvolnum>5</manvolnum></citerefentry> e <filename>/usr/share/doc/postfix-policyd-spf-python/policyd-spf.conf.commented.gz</filename>. Os principais parâmetro de configuração são <literal>HELO_reject</literal> e <literal>Mail_From_reject</literal>, que configuram se os e-mail devem ser rejeitados (<literal>Fail</literal>) ou aceitos com um cabeçalho anexado (<literal>False</literal>), se as verificações falharem. O último geralmente é útil, quando a mensagem é processada posteriormente por um filtro de spam.

en: If the result is intended to be used by <emphasis role="pkg">opendmarc</emphasis> (<xref linkend="sect.dmarc" />), then <literal>Header_Type</literal> must be set to <literal>AR</literal>.
pt-BR: Se o resultado se destina a ser usado por <emphasis role="pkg">opendmarc</emphasis> (<xref linkend="sect.dmarc" />), então <literal>Header_Type</literal> deve ser definido por <literal>AR</literal>.

en: Note that <emphasis role="pkg">spamassassin</emphasis> contains a plugin to check the SPF record.
pt-BR: Observe que o <emphasis role="pkg">spamassassin</emphasis> contém uma extensão para verificar o registro SPF.

en: Integrating DomainKeys (DKIM) Signing and Checking
pt-BR: Assinando e verificando DKIM (Integrating DomainKeys -- chaves de domínio integradas)

en: The Domain Keys Identified Mail (<acronym>DKIM</acronym>) standard is a sender authentication system. The mail transport agent, here <command>postfix</command>, adds a digital signature associated with the domain name to the header of outgoing emails. The receiving party can validate the message body and header fields by checking the signature against a public key, which is retrieved from the senders DNS records. <ulink type="block" url="http://dkim.org/" />
pt-BR: O padrão <acronym>DKIM</acronym> (Domain Keys Identified Mail) é um sistema de autenticação de emissário. O agente de transporte de email, no caso, o <command>postfix</command>, adiciona uma assinatura digital associada com o nome de domínio ao cabeçalho do emails de saída. O receptor pode validar os campos do corpo e cabeçalho da mensagem comparando a assinatura com uma chave pública, que é recuperada de registros de DNS de emissários. <ulink type="block" url="http://dkim.org/" />

en: The necessary tools are shipped with the <emphasis role="pkg">opendkim</emphasis> and <emphasis role="pkg">opendkim-tools</emphasis> packages.
pt-BR: As ferramentas necessárias são enviadas com os pacotes <emphasis role="pkg">opendkim</emphasis> e <emphasis role="pkg">opendkim-tools</emphasis>.

en: <emphasis>CAUTION</emphasis> Mailing List Software and DKIM
pt-BR: <emphasis>ATENÇÃO</emphasis> Software de lista de discussão e DKIM

en: Mailing list managers often rewrite some email headers, thus leading to invalid DKIM signatures. Even using a <literal>relaxed</literal> canonicalization does not always prevent this from happening. So the administrators must pay close attention to the mail severs log files to identify such issues. Otherwise such emails might be flagged as spam and might get rejected.
pt-BR: Os administradores de lista de discussão geralmente reescrevem alguns cabeçalhos de e-mail, resultando em assinaturas DKIM invalidas. Mesmo usando uma canonicalização <literal>relaxed</literal> nem sempre previne que isso aconteça. Assim, os administradores devem prestar muita atenção aos arquivos de log dos servidores de e-mail para identificar esses problemas. Caso contrário, tais e-mails podem ser sinalizados como spam e podem ser rejeitados.

en: First the private key must be created using the command <command>opendkim-genkey -s <replaceable>SELECTOR</replaceable> -d <replaceable>DOMAIN</replaceable></command>. <replaceable>SELECTOR</replaceable> must be a unique name for the key. It can be as simple as "mail" or the date of creation, if you plan to rotate keys.
pt-BR: Primeiro, a chave privada deve ser criada usando o comando <command>opendkim-genkey -s <replaceable>SELECTOR</replaceable> -d <replaceable>DOMAIN</replaceable></command>. <replaceable>SELECTOR</replaceable> deve ser um nome exclusivo para a chave. Pode ser tão simples como um "e-mail" ou a data de criação, se você planeja alterar as chaves.

en: Create a private key for signing E-Mails from falcot.com
pt-BR: Crie uma chave privada para assinar e-mails de falcot.com

en: This will create the files <filename>/etc/dkimkeys/mail.private</filename> and <filename>/etc/dkimkeys/mail.txt</filename> and set the appropriate ownership. The first file contains the private key, and the latter the public key that needs to be added to the DNS:
pt-BR: Isto criará os arquivos <filename>/etc/dkimkeys/mail.private</filename> e <filename>/etc/dkimkeys/mail.txt</filename> e atribuirá a propriedade apropriada. O primeiro arquivo contém a chave privada, e o último a chave pública que precisa ser adicionada ao DNS:

en: The <emphasis role="pkg">opendkim</emphasis> package in Debian defaults to a keysize of 2048 bit. Unfortunately some DNS servers can only handle text entries with a maximum length of 255 characters, which is exceeded by the chosen default keysize. In this case use the option <command>-b 1024</command> to chose a smaller keysize. If <command>opendkim-testkey</command> succeeds, the entry has been successfully set up. The syntax of the entry is explained here: <ulink type="block" url="https://tools.ietf.org/html/rfc6376" /> <ulink type="block" url="https://en.wikipedia.org/wiki/DKIM" />
pt-BR: O pacote <emphasis role="pkg">opendkim</emphasis> no Debian tem um tamanho de chave predeterminado de 2048 bits. Infelizmente alguns servidores DNS só lidam com entradas de texto com tamanho máximo de 255 caracteres, que é ultrapassado pelo tamanho de chave predeterminado. Neste caso, use a opção <command>-b 1024</command> para optar por um tamanho de chave menor. Se o <command>opendkim-testkey</command> tiver exito, a entrada se ajusta corretamente. Aqui se explica a sintaxe: <ulink type="block" url="https://tools.ietf.org/html/rfc6376" /> <ulink type="block" url="https://en.wikipedia.org/wiki/DKIM" />

en: To configure <emphasis role="pkg">opendkim</emphasis>, <literal>SOCKET</literal> and <literal>RUNDIR</literal> must be chosen in <filename>/etc/default/opendkim</filename>. Please note that <literal>SOCKET</literal> must be accessible from <literal>postfix</literal> in its chrooted environment. The further configuration is done in <filename>/etc/opendkim.conf</filename>. The following is a configuration excerpt, which makes sure that the <literal>Domain</literal> "falcot.com" and all subdomains (<literal>SubDomain</literal>) are signed by the <literal>Selector</literal> "mail" and the single private key (<literal>KeyFile</literal>) <filename>/etc/dkimkeys/mail.private</filename>. The "relaxed" <literal>Canonicalization</literal> for both the header and the body tolerates mild modification (by a mailing list software, for example). The filter runs both in signing ("s") and verification ("v") <literal>Mode</literal>. If a signature fails to validate (<literal>On-BadSignature</literal>), the mail should be quarantined ("q").
pt-BR: Para configurar o <emphasis role="pkg">opendkim</emphasis>, devem ser escolhidos <literal>SOCKET</literal> e <literal>RUNDIR</literal> em <filename>/etc/default/opendkim</filename>. Observe que <literal>SOCKET</literal> deve ser acessível a partir do <literal>postfix</literal> em seu ambiente com chroot. Configurações adicionais são feitas em <filename>/etc/opendkim.conf</filename>. A seguir um extrato de configuração, que garante que <literal>Domain</literal> "falcot.com" todos os subdomínios (<literal>SubDomain</literal>) estão assinados pelo <literal>Selector</literal> "mail" a chave privada única (<literal>KeyFile</literal>) <filename>/etc/dkimkeys/mail.private</filename>. A <literal>Canonicalization</literal> "relaxada" tanto para o cabeçalho quanto para o corpo tolera uma modificação suave (por exemplo, por um software de uma lista de correio). O filtro é executado tanto no <literal>Modo</literal> de assinatura ("s" de signing) quanto no verificação ("v"). Caso uma assinatura falhe em validar (<literal>On-BadSignature</literal>), o correio deve ser posto em quarentena ("q").

en: It is also possible to use multiple selectors/keys (<literal>KeyTable</literal>), domains (<literal>SigningTable</literal>) and to specify internal or trusted hosts (<literal>InternalHosts</literal>, <literal>ExternalIgnoreList</literal>), which may send mail through the server as one of the signing domains without credentials.
pt-BR: Também é possível usar os seletores/chaves (<literal>KeyTable</literal>), domains (<literal>SigningTable</literal>) e para especificar hosts internos ou de confiança (<literal>InternalHosts</literal>, <literal>ExternalIgnoreList</literal>), que podem enviar e-mails através do servidor como um dos domínios de assinatura sem credenciais.

en: The following directives in <filename>/etc/postfix/main.cf</filename> make <literal>postfix</literal> use the filter:
pt-BR: As seguintes diretivas em <filename>/etc/postfix/main.cf</filename> fazem o <literal>postfix</literal> usar o filtro:

en: To differentiate signing and verification it is sometimes more useful to add the directives to the services in <filename>/etc/postfix/master.cf</filename> instead.
pt-BR: Para diferenciar entre assinatura e a verificação, às vezes é mais útil adicionar diretivas aos serviços em <filename>/etc/postfix/master.cf</filename> em vez disso.

en: More information is available in the <filename>/usr/share/doc/opendkim/</filename> directory and the manual pages <citerefentry><refentrytitle>opendkim</refentrytitle> <manvolnum>8</manvolnum></citerefentry> and <citerefentry><refentrytitle>opendkim.conf</refentrytitle> <manvolnum>5</manvolnum></citerefentry>.
pt-BR: Há mais informações disponíveis no diretório <filename>/usr/share/doc/opendkim/</filename> e nas páginas de manual <citerefentry><refentrytitle>opendkim</refentrytitle> <manvolnum>8</manvolnum></citerefentry> e <citerefentry><refentrytitle>opendkim.conf</refentrytitle> <manvolnum>5</manvolnum></citerefentry>.

en: Note that <emphasis role="pkg">spamassassin</emphasis> contains a plugin to check the DKIM record.
pt-BR: Tenha em conta que <emphasis role="pkg">spamassassin</emphasis> contém um plugin para comprovar o registro DKIM.

en: Integrating Domain-based Message Authentication, Reporting and Conformance (DMARC)
pt-BR: Integrando Autenticação de Mensagens Basada em Domínios, relatórios e Conformidade (DMARC, en inglés)

en: The Domain-based Message Authentication, Reporting and Conformance (<acronym>DMARC</acronym>) standard can be used to define a DNS TXT entry with the name <literal>_dmarc</literal> and the action that should be taken when emails that contain your domain as the sending host fail to validate using DKIM and SPF. <ulink type="block" url="https://dmarc.org/overview/" />
pt-BR: O padrão de Autenticação de Mensagens Baseada em Domínios, Relatórios e Conformidade (<acronym>DMARC</acronym>, em inglês) é usado para definir uma entrada DNS TXT com o nome <literal>_dmarc</literal> e a ação que deve ser tomada quando os e-mails que contêm seu domínio como o host de envio não são validados usando DKIM e SPF. <ulink type="block" url="https://dmarc.org/overview/" />

en: Let's have a look at the entries of two large providers:
pt-BR: Vamos dar uma olhada nas entradas de dois grandes provedores:

en: Yahoo has a strict policy to <literal>reject</literal> all emails pretending to be sent from a Yahoo account but missing or failing DKIM and SPF checks. Google Mail (Gmail) propagates a very relaxed policy, in which such messages from the main domain should still be accepted (<literal>p=none</literal>). For subdomains they should be marked as spam (<literal>sp=quarantine</literal>). The addresses given in the <literal>rua</literal> key can be used to send aggregated DMARC reports to. The full syntax is explained here: <ulink type="block" url="https://tools.ietf.org/html/rfc7489" /> <ulink type="block" url="https://en.wikipedia.org/wiki/DMARC" />
pt-BR: Yahoo possui uma política rigorosa para <literal>rejeitar</literal> todos os e-mails que fingem ter sido enviados por uma conta Yahoo mas falham nas verificações DKIM e SPF. Google Mail (Gmail) propaga uma política muito relaxada, na qual tais mensagens do domínio principal ainda devem ser aceitas (<literal>p=none</literal>). Para subdomínios eles devem ser marcados como spam (<literal>sp=quarantine</literal>). Os endereços dados na chave <literal>rua</literal> podem ser utilizados para enviar relatórios agregados DMARC. A sintaxe completa é explicada aqui: <ulink type="block" url="https://tools.ietf.org/html/rfc7489" /> <ulink type="block" url="https://en.wikipedia.org/wiki/DMARC" />

en: The <command>postfix</command> mail server can use this information too. The <emphasis role="pkg">opendmarc</emphasis> package contains the necessary milter. Similar to <emphasis role="pkg">opendkim</emphasis> <literal>SOCKET</literal> and <literal>RUNDIR</literal> must be chosen in <filename>/etc/default/opendmarc</filename> (for Unix sockets you must make sure that they are inside the postfix chroot to be found). The configuration file <filename>/etc/opendmarc.conf</filename> contains detailed comments and is also explained in <citerefentry><refentrytitle>opendmarc.conf</refentrytitle> <manvolnum>5</manvolnum></citerefentry>. By default, emails failing the DMARC validation are not rejected but flagged, by adding an appropriate header field. To change this, use <literal>RejectFailures true</literal>.
pt-BR: O servidor de email <command>postfix</command> pode usar também esta informação. O pacote <emphasis role="pkg">opendmarc</emphasis> contém o filtro de email necessário. De forma similar a <emphasis role="pkg">opendkim</emphasis>, <literal>SOCKET</literal> e <literal>RUNDIR</literal> devem ser escolhidos em <filename>/etc/default/opendmarc</filename> (para soquetes Unix você tem que garantir que eles estão dentro do chroot do postfix). O arquivo de configuração <filename>/etc/opendmarc.conf</filename> contém comentários detalhados, e também se explica em <citerefentry><refentrytitle>opendmarc.conf</refentrytitle> <manvolnum>5</manvolnum></citerefentry>. Por padrão, os emails que falham na verificação DMARC não são rejeitados, mas etiquetados, adicionando um campo de cabeçalho apropriado. Para alterar isto, use <literal>RejectFailures true</literal>.

en: The milter is then added to <literal>smtpd_milters</literal> and <literal>non_smtpd_milters</literal>. If we configured the opendkim and opendmarc milters to run on ports 12345 and 54321, the entry in <filename>/etc/postfix/main.cf</filename> looks like this:
pt-BR: O filtro de correio se adiciona a <literal>smtpd_milters</literal> e <literal>non_smtpd_milters</literal>. Se cpnfiguramos os filtros de correio opendkim e opendmarc para funcionar nas portas 12345 y 54321, a entrada en <filename>/etc/postfix/main.cf</filename> tem este aspecto:

en: The milter can also be selectively applied to a service in <filename>/etc/postfix/master.cf</filename> instead.
pt-BR: Diretivas para serem adicionadas no arquivo <filename>/etc/postfix/main.cf</filename>.

en: Authenticated SMTP
pt-BR: SMTP autenticado

en: Being able to send emails requires an SMTP server to be reachable; it also requires said SMTP server to send emails through it. For roaming users, this may need regularly changing the configuration of the SMTP client, since Falcot's SMTP server rejects messages coming from IP addresses apparently not belonging to the company. Two solutions exist: either the roaming user installs an SMTP server on their computer, or they still use the company server with some means of authenticating as an employee. The former solution is not recommended since the computer won't be permanently connected, and it won't be able to retry sending messages in case of problems; we will focus on the latter solution.
pt-BR: Ser capaz de enviar emails requer um servidor SMTP ao alcance; e também requer que o referido servidor SMTP envie emails por ele. Para usuários móveis, pode ser preciso que eles alterem, regularmente, a configuração do cliente SMTP, já que o servidor SMTP da Falcot rejeita mensagens provenientes de endereços IP aparentemente não pertencentes à companhia. Existem duas soluções: ou o usuário instala um servidor SMTP em seu computador, ou ele usa o servidor da companhia com algum meio de autenticação como empregado. A primeira solução não é recomendada já que o computador não estará permanentemente conectado, e não será capaz de tentar enviar mensagens novamente em caso de problemas; nós iremos nos focar na última solução.

en: SMTP authentication in Postfix relies on SASL (<emphasis>Simple Authentication and Security Layer</emphasis>). It requires installing the <emphasis role="pkg">libsasl2-modules</emphasis> and <emphasis role="pkg">sasl2-bin</emphasis> packages, then registering a password in the SASL database for each user that needs authenticating on the SMTP server. This is done with the <command>saslpasswd2</command> command, which takes several parameters. The <literal>-u</literal> option defines the authentication domain, which must match the <literal>smtpd_sasl_local_domain</literal> parameter in the Postfix configuration. The <literal>-c</literal> option allows creating a user, and <literal>-f</literal> allows specifying the file to use if the SASL database needs to be stored at a different location than the default (<filename>/etc/sasldb2</filename>).
pt-BR: A autenticação SMTP no Postfix se apoia no SASL (<emphasis>Simple Authentication and Security Layer</emphasis>). Ela precisa dos pacotes <emphasis role="pkg">libsasl2-modules</emphasis> e <emphasis role="pkg">sasl2-bin</emphasis> instalados, e em seguida o registro de uma senha no banco de dados do SASL para cada usuário que precise autenticar no servidor SMTP. Isso é feito com o comando <command>saslpasswd2</command>, o qual recebe vários parâmetros. A opção <literal>-u</literal> define o domínio de autenticação, que deve corresponder com o parâmetro <literal>smtpd_sasl_local_domain</literal> na configuração do Postfix. A opção <literal>-c</literal> permite criar um usuário, e <literal>-f</literal> permite especificar o arquivo a ser usado se o banco de dados do SASL precisar ser armazenado em um local diferente do padrão (<filename>/etc/sasldb2</filename>).

en: 
    <computeroutput># </computeroutput><userinput>saslpasswd2 -u `postconf -h myhostname` -f /var/spool/postfix/etc/sasldb2 -c jean</userinput>
    <computeroutput>[... type jean's password twice ...]</computeroutput>
pt-BR: 
    <computeroutput># </computeroutput><userinput>saslpasswd2 -u `postconf -h nomedomeuhost` -f /var/spool/postfix/etc/sasldb2 -c jean</userinput>
    <computeroutput>[... digite a senha de jean duas vezes ...]</computeroutput>

en: Note that the SASL database was created in Postfix's directory. In order to ensure consistency, we also turn <filename>/etc/sasldb2</filename> into a symbolic link pointing at the database used by Postfix, with the <command>ln -sf /var/spool/postfix/etc/sasldb2 /etc/sasldb2</command> command.
pt-BR: Note que o banco de dados do SASL foi criado no diretório do Postfix. Para garantir consistência, nós também transformamos o <filename>/etc/sasldb2</filename> em uma ligação simbólica apontando para o banco de dados usado pelo Postfix, com o comando <command>ln -sf /var/spool/postfix/etc/sasldb2 /etc/sasldb2</command>.

en: Now we need to configure Postfix to use SASL. First the <literal>postfix</literal> user needs to be added to the <literal>sasl</literal> group, so that it can access the SASL account database. A few new parameters are also needed to enable SASL, and the <literal>smtpd_recipient_restrictions</literal> parameter needs to be configured to allow SASL-authenticated clients to send emails freely.
pt-BR: Agora nós precisamos configurar o Postfix para usar o SASL. Primeiro, o usuário <literal>postfix</literal> precisa ser adicionado ao grupo <literal>sasl</literal>, para que ele possa acessar a conta no banco de dados do SASL. Alguns novos parâmetros também são necessários para habilitar o SASL, e o parâmetro <literal>smtpd_recipient_restrictions</literal> precisa ser configurado para permitir que cliente autenticado pelo SASL possam enviar emails livremente.

en: Enabling SASL in <filename>/etc/postfix/main.cf</filename>
pt-BR: Ativando o SASL no <filename>/etc/postfix/main.cf</filename>

en: It is usually a good idea to not send passwords over an unencrypted connection. <emphasis>Postfix</emphasis> allows to use different configurations for each port (service) it runs on. All these can be configured with different rules and directives in the <filename>/etc/postfix/master.cf</filename> file. To turn off authentication at all for port 25 (<literal>smtpd</literal> service) add the following directive:
pt-BR: Normalmente, é uma boa ideia não enviar senhas em uma conexão sem criptografia. <emphasis>Postfix</emphasis> permite usar diferentes configurações para cada porta (serviço) onde executa. Todas elas podem se configurar com diferentes regras e diretivas no arquivo <filename>/etc/postfix/master.cf</filename>. Para desativar a autenticação por completo para a porta 25 (serviço <literal>smtpd</literal>) adicione a seguinte diretriz:

en: If for some reason clients use an outdated <literal>AUTH</literal> command (some very old mail clients do), interoperability with them can be enabled using the <literal>broken_sasl_auth_clients</literal> directive.
pt-BR: Se por alguma razão os clientes usam um comando <literal>AUTH</literal> desatualizado (alguns clientes de correio muito velhos o fazem), se pode habilitar la interoperabilidade com eles usando a diretiva <literal>broken_sasl_auth_clients</literal>.

en: <emphasis>EXTRA</emphasis> Authenticated SMTP client
pt-BR: <emphasis>EXTRA</emphasis> Cliente SMTP autenticado

en: Most email clients are able to authenticate to an SMTP server before sending outgoing messages, and using that feature is a simple matter of configuring the appropriate parameters. If the client in use does not provide that feature, the workaround is to use a local Postfix server and configure it to relay email via the remote SMTP server. In this case, the local Postfix itself will be the client that authenticates with SASL. Here are the required parameters:
pt-BR: A maioria dos clientes de e-mail são capazes de fazer autenticação em um servidor de SMTP antes de enviar mensagens de saída e usar esse recurso é uma simples questão de configurar os parâmetros apropriados. Se o cliente em uso não oferece esse recurso a solução alternativa é usar um servidor Postfix local e configurá-lo para fazer o relay do email através de um servidor SMTP remoto. Neste caso, o próprio Postfix local será o cliente que autentica com o SASL. Aqui estão os parâmetros necessários:

en: The <filename>/etc/postfix/sasl_passwd</filename> file needs to contain the username and password to use for authenticating on the <literal>mail.falcot.com</literal> server. Here is an example:
pt-BR: O arquivo <filename>/etc/postfix/sasl_passwd</filename> precisa conter o nome de usuário e senha para autenticar no servidor <literal>mail.falcot.com</literal>. Aqui está um exemplo:

en: As for all Postfix maps, this file must be turned into <filename>/etc/postfix/sasl_passwd.db</filename> with the <command>postmap</command> command.
pt-BR: Como em todos os mapeamentos do Postfix, esse arquivo tem que ser transformado em <filename>/etc/postfix/sasl_passwd.db</filename> através do comando <command>postmap</command>.

en: Web Server (HTTP)
pt-BR: Servidor web (HTTP)

en: <primary>server</primary><secondary>web</secondary>
pt-BR: <primary>servidor</primary><secondary>web</secondary>

en: <primary>web server</primary><seealso>Apache</seealso>
pt-BR: <primary>servidor web</primary><seealso>Apache</seealso>

en: <primary>server</primary><secondary>HTTP</secondary>
pt-BR: <primary>servidor</primary><secondary>HTTP</secondary>

en: <primary>HTTP</primary><secondary>server</secondary><seealso>Apache</seealso>
pt-BR: <primary>HTTP</primary><secondary>servidor</secondary><seealso>Apache</seealso>

en: <emphasis>ALTERNATIVE</emphasis> Other web servers
pt-BR: <emphasis>ALTERNATIVA</emphasis> Outros servidores web

en: Installing Apache
pt-BR: Instalação do Apache

en: Installing the <emphasis role="pkg">apache2</emphasis> package is all that is needed. It contains all the modules, including the <emphasis>Multi-Processing Modules</emphasis> (MPMs) that affect how Apache handles parallel processing of many requests, which used to be provided in separate <emphasis role="pkg">apache2-mpm-*</emphasis> packages. It will also pull <emphasis role="pkg">apache2-utils</emphasis> containing the command line utilities that we will discover later.
pt-BR: Instalar o pacote <emphasis role="pkg">apache2</emphasis> é tudo o que é preciso. Ele contém todos os módulos, incluindo os <emphasis>Multi-Processing Modules</emphasis> (MPMs - Módulos de Multiprocessamentos) que afetam como o Apache lida com processamento paralelo de muitas requisições e que geralmente eram fornecidos em pacotes <emphasis role="pkg">apache2-mpm-*</emphasis> separados. Ele também baixará <emphasis role="pkg">apache2-utils</emphasis> que contém os utilitários de linha de comando que iremos descobrir mais tarde.

en: The MPM in use affects significantly the way Apache will handle concurrent requests. With the <emphasis>worker</emphasis> MPM, it uses <emphasis>threads</emphasis> (lightweight processes), whereas with the <emphasis>prefork</emphasis> MPM it uses a pool of processes created in advance. With the <emphasis>event</emphasis> MPM it also uses threads, but the inactive connections (notably those kept open by the HTTP <emphasis>keep-alive</emphasis> feature) are handed back to a dedicated management thread.
pt-BR: O MPM em uso afeta significantemente a forma com que o Apache irá lidar com as requisições simultâneas. Com o MPM <emphasis>worker</emphasis>, ele usa <emphasis>threads</emphasis> (processos leves), enquanto que com o MPM <emphasis>prefork</emphasis> ele usa um grupo de processos criados antecipadamente. Com o MPM <emphasis>event</emphasis> ele também usa threads, porém as conexões inativas (notavelmente aquelas mantidas abertas pelo recurso HTTP <emphasis>keep-alive</emphasis>) são devolvidas a uma thread de gerenciamento dedicado.

en: <emphasis>SECURITY</emphasis> Execution under the <literal>www-data</literal> user
pt-BR: <emphasis>SEGURANÇA</emphasis> Execução sob o usuário <literal>www-data</literal>

en: <primary>Apache</primary><secondary><literal>www-data</literal>, user</secondary>
pt-BR: <primary>Apache</primary><secondary><literal>www-data</literal>, usuário(a)</secondary>

en: Using the <emphasis>suexec</emphasis> modules, provided by <emphasis role="pkg">apache2-suexec-*</emphasis> packages, allows bypassing this rule so that some CGI scripts are executed under the identity of another user. This is configured with a <literal>SuexecUserGroup <replaceable>user</replaceable><replaceable>group</replaceable></literal> directive in the Apache configuration.
pt-BR: O uso dos módulos <emphasis>suexec</emphasis>, fornecidos pelos pacotes <emphasis role="pkg">apache2-suexec-*</emphasis>, permite contornar essa regra para que alguns scripts CGI sejam executados sob a identidade de outro(a) usuário(a). Isso é configurado com a diretiva <literal>SuexecUserGroup <replaceable>usuário(a)</replaceable><replaceable>grupo</replaceable></literal> na configuração do Apache.

en: Another possibility is to use a dedicated MPM, such as the one provided by <emphasis role="pkg">libapache2-mpm-itk</emphasis>. This particular one has a slightly different behavior: it allows “isolating” virtual hosts (actually, sets of pages) so that they each run as a different user. A vulnerability in one website therefore cannot compromise files belonging to the owner of another website.
pt-BR: Outra possibilidade é usar um MPM dedicado, como o fornecido pelo <emphasis role="pkg">libapache2-mpm-itk</emphasis>. Esse módulo em particular tem um comportamento um pouco diferente: ele permite o “isolamento” de hosts virtuais (na verdade, conjuntos de páginas) para que cada um deles seja executado como um usuário diferente. Portanto, uma vulnerabilidade em um site web não pode comprometer arquivos pertencentes ao dono de outro site web.

en: <emphasis>QUICK LOOK</emphasis> List of modules
pt-BR: <emphasis>OLHADA RÁPIDA</emphasis> Lista de módulos

en: Apache is a modular server, and many features are implemented by external modules that the main program loads during its initialization. The default configuration only enables the most common modules, but enabling new modules is a simple matter of running <command>a2enmod <replaceable>module</replaceable></command>; to disable a module, the command is <command>a2dismod <replaceable>module</replaceable></command>. These programs actually only create (or delete) symbolic links in <filename>/etc/apache2/mods-enabled/</filename>, pointing at the actual files (stored in <filename>/etc/apache2/mods-available/</filename>).
pt-BR: O Apache é um servidor modular, e muitos recursos são implementados através de módulos externos que o programa principal carrega durante sua inicialização. A configuração padrão apenas habilita os módulos mais comuns, porém habilitar módulos novos é uma simples questão de rodar <command>a2enmod <replaceable>módulo</replaceable></command>; para desabilitar um módulo, o comando é <command>a2dismod <replaceable>módulo</replaceable></command>. Esses programas na verdade apenas criam (ou apagam) ligações simbólicas em <filename>/etc/apache2/mods-enabled/</filename>, que apontam para os arquivos reais (armazenados em <filename>/etc/apache2/mods-available/</filename>).

en: <emphasis>IN PRACTICE</emphasis> Checking the configuration
pt-BR: <emphasis>NA PRÁTICA</emphasis> Verificando a configuração

en: The <literal>mod_info</literal> module (<command>a2enmod info</command>) allows to access the comprehensive Apache server configuration and information via browser visiting <literal>http://localhost/server-info</literal>. Because it might contain sensitive information, access is only allowed from the local host by default. <ulink type="block" url="https://httpd.apache.org/docs/2.4/mod/mod_info.html" />
pt-BR: O módulo <literal>mod_info</literal> (<command>a2enmod info</command>) permite acessar a ampla configuração e informação do servidor Apache num navegador visitando <literal>http://localhost/server-info</literal>. Como pode conter informações confidenciais, o padrão ésó ser acessível da máquina local. <ulink type="block" url="https://httpd.apache.org/docs/2.4/mod/mod_info.html" />

en: With its default configuration, the web server listens on port 80 (as configured in <filename>/etc/apache2/ports.conf</filename>), and serves pages from the <filename>/var/www/html/</filename> directory (as configured in <filename>/etc/apache2/sites-enabled/000-default.conf</filename>).
pt-BR: Com sua configuração padrão, o servidor web ouve na porta 80 (como configurado em <filename>/etc/apache2/ports.conf</filename>), e serve páginas a partir do diretório <filename>/var/www/html/</filename> (como configurado em <filename>/etc/apache2/sites-enabled/000-default.conf</filename>).

en: Adding support for SSL
pt-BR: Adicionando suporte a SSL

en: Apache 2.4 includes the SSL module (<literal>mod_ssl</literal>) required for secure HTTP (HTTPS) out of the box. It just needs to be enabled with <command>a2enmod ssl</command>, then the required directives have to be added to the configuration files. A configuration example is provided in <filename>/etc/apache2/sites-available/default-ssl.conf</filename>. <ulink type="block" url="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html" />
pt-BR: O Apache 2.4 inclui o módulo SSL (<literal>mod_ssl</literal>) necessário para HTTP seguro (HTTPS) "de fábrica". Ele apenas precisa ser habilitado com <command>a2enmod ssl</command>, e então as diretivas necessárias têm que ser adicionadas aos arquivos de configuração. Um exemplo de configuração é fornecido em <filename>/etc/apache2/sites-available/default-ssl.conf</filename>. <ulink type="block" url="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html" />

en: If you want to generate trusted certificates, you can follow section <xref linkend="sect.trusted-certs" /> and then adjust the following variables:
pt-BR: Se queres gerar certificados de confiança, vá para a seção <xref linkend="sect.trusted-certs" /> e então ajuste as seguintes variáveis:

en: Configuring Virtual Hosts
pt-BR: Configuração de servidores virtuais

en: A virtual host is an extra identity for the web server.
pt-BR: Um servidor virtual é uma identidade adicional para o servidor web.

en: <primary>virtual host</primary>
pt-BR: <primary>host virtual</primary>

en: Apache considers two different kinds of virtual hosts: those that are based on the IP address (or the port), and those that rely on the domain name of the web server. The first method requires allocating a different IP address (or port) for each site, whereas the second one can work on a single IP address (and port), and the sites are differentiated by the hostname sent by the HTTP client (which only works in version 1.1 of the HTTP protocol — fortunately that version is old enough that all clients use it already).
pt-BR: Apache considera dois tipos diferentes de hosts virtuais: aqueles que se baseiam no endereço IP (ou na porta) e aqueles que se baseiam no nome de domínio do servidor web. O primeiro método requer a alocação de um endereço IP diferente (ou porta) para cada site, enquanto o segundo pode funcionar em um único endereço IP (e porta), os sites são diferenciados pelo nome de máquina enviado pelo cliente HTTP (que só funciona na versão 1.1 do protocolo HTTP — Felizmente essa versão é antiga o bastante, e assim, é utilizada por todos os clientes).

en: The (increasing) scarcity of IPv4 addresses usually favors the second method; however, it is made more complex if the virtual hosts need to provide HTTPS too, since the SSL protocol hasn't always provided for name-based virtual hosting; the SNI extension (<emphasis>Server Name Indication</emphasis>) that allows such a combination is not handled by all browsers. When several HTTPS sites need to run on the same server, they will usually be differentiated either by running on a different port or on a different IP address (IPv6 can help there).
pt-BR: A (crescente) escassez de endereços IPv4 geralmente favorece o segundo método; contudo, fica mais complexo se os hosts virtuais precisam fornecer HTTPS também, pois o protocolo SSL nem sempre é fornecido para hospedagem virtual baseada em nome; a extensão SNI (<emphasis>Server Name Indication</emphasis>) que permite uma combinação desse tipo não é suportada por todos os navegadores. Quando vários sites HTTPS precisam ser rodados no mesmo servidor, eles geralmente irão ser diferenciados ou por rodar em uma porta diferente ou um endereço IP diferente (IPv6 pode ajudar aqui).

en: The default configuration for Apache 2 enables name-based virtual hosts. In addition, a default virtual host is defined in the <literal>/etc/apache2/sites-enabled/000-default.conf</literal> file; this virtual host will be used if no host matching the request sent by the client is found.
pt-BR: A configuração padrão do Apache 2 habilita hosts virtuais baseados em nomes. Além disso, um host virtual padrão é definido no arquivo <literal>/etc/apache2/sites-enabled/000-default.conf</literal>; esse host virtual será usado se não for encontrado nenhum host que corresponda à solicitação enviada pelo cliente.

en: <emphasis>CAUTION</emphasis> First virtual host
pt-BR: <emphasis>ATENÇÃO</emphasis> Primeiro servidor virtual

en: Requests concerning unknown virtual hosts will always be served by the first defined virtual host, which is why we defined <literal>www.falcot.com</literal> first here.
pt-BR: Requisições relativas a hosts virtuais desconhecidos sempre serão servidas pelo primeiro host virtual definido, é por isso que nós definimos <literal>www.falcot.com</literal> em primeiro lugar aqui.

en: <emphasis>QUICK LOOK</emphasis> Apache supports SNI
pt-BR: <emphasis>OLHADA RÁPIDA</emphasis> Suporte Apache ao SNI

en: The Apache server supports an SSL protocol extension called <emphasis>Server Name Indication</emphasis> (SNI). This extension allows the browser to send the hostname of the web server during the establishment of the SSL connection, much earlier than the HTTP request itself, which was previously used to identify the requested virtual host among those hosted on the same server (with the same IP address and port). This allows Apache to select the most appropriate SSL certificate for the transaction to proceed.
pt-BR: O servidor Apache suporta uma extensão do protocolo SSL chamada <emphasis>Server Name Indication</emphasis> (SNI). Esta extensão permite ao navegador enviar o nome do nome do host do servidor web durante o estabelecimento da conexão SSL, muito antes do que o HTTP o solicitaria, que foi usado anteriormente para identificar o host virtual solicitado entre aqueles hospedados no mesmo servidor (com o mesmo endereço IP e porta). Isso permite ao Apache selecionar o certificado SSL mais adequado para a transação a proceder.

en: Before SNI, Apache would always use the certificate defined in the default virtual host. Clients trying to access another virtual host would then display warnings, since the certificate they received didn't match the website they were trying to access. Fortunately, most browsers now work with SNI; this includes Microsoft Internet Explorer starting with version 7.0 (starting on Vista), Mozilla Firefox starting with version 2.0, Apple Safari since version 3.2.1, and all versions of Google Chrome.
pt-BR: Antes do SNI, o Apache sempre usava o certificado definido no host virtual padrão. Clientes que tentavam acessar outro host virtual iriam então exibir avisos (warnings), pois eles recebiam o certificado que não correspondia com o site que eles estavam tentando acessar. Felizmente, a maioria dos navegadores agora trabalham com SNI; Isso inclui o Microsoft Internet Explorer a partir da versão 7.0 (começando no Vista), Mozilla Firefox começando com a versão 2.0, o Safari da Apple desde a versão 3.2.1 e todas as versões do Google Chrome.

en: The Apache package provided in Debian is built with support for SNI; no particular configuration is therefore needed.
pt-BR: O pacote Apache fornecido pelo Debian é construído com suporte a SNI; portanto, nenhuma configuração em particular é necessária.

en: Each extra virtual host is then described by a file stored in <filename>/etc/apache2/sites-available/</filename>. Setting up a website for the <literal>falcot.org</literal> domain is therefore a simple matter of creating the following file, then enabling the virtual host with <command>a2ensite www.falcot.org</command>.
pt-BR: Cada host virtual extra é então descrito por um arquivo armazenado em <filename>/etc/apache2/sites-available/</filename>. Configurar um site web para o domínio <literal>falcot.org</literal> é portanto uma simples questão de criar o seguinte arquivo, e então, habilita o host virtual com <command>a2ensite www.falcot.org</command>.

en: The <filename>/etc/apache2/sites-available/www.falcot.org.conf</filename> file
pt-BR: o arquivo <filename>/etc/apache2/sites-available/www.falcot.org.conf</filename>

en: The Apache server, as configured so far, uses the same log files for all virtual hosts (although this could be changed by adding <literal>CustomLog</literal> directives in the definitions of the virtual hosts). It therefore makes good sense to customize the format of this log file to have it include the name of the virtual host. This can be done by creating a <filename>/etc/apache2/conf-available/customlog.conf</filename> file that defines a new format for all log files (with the <literal>LogFormat</literal> directive) and by enabling it with <command>a2enconf customlog</command>. The <literal>CustomLog</literal> line must also be removed (or commented out) from the <filename>/etc/apache2/sites-available/000-default.conf</filename> file.
pt-BR: O servidor Apache, como configurado até agora, usa os mesmos arquivos de log para todos os hosts virtuais (embora isso possa ser alterado adicionando as diretivas <literal>CustomLog</literal> na definição de hosts virtuais). É, entretanto, boa prática customizar o formato desse arquivo de log para ter incluído o nome do host virtual. Isso pode ser feito criando um arquivo <filename>/etc/apache2/conf-available/customlog.conf</filename>, que define um novo formato para todos os arquivos de log (com a diretiva <literal>LogFormat</literal>), e habilitando-o com <command>a2enconf customlog</command> . A linha <literal>CustomLog</literal> tem também que ser removida (ou comentada) do arquivo <filename>/etc/apache2/sites-available/000-default.conf</filename>.

en: The <filename>/etc/apache2/conf-available/customlog.conf</filename> file
pt-BR: O arquivo <filename>/etc/apache2/conf-available/customlog.conf</filename>

en: Common Directives
pt-BR: Diretivas comuns

en: This section briefly reviews some of the commonly-used Apache configuration directives.
pt-BR: Essa seção revê, brevemente, algumas das diretivas comumente usadas na configuração do Apache.

en: <primary>directives, Apache</primary>
pt-BR: <primary>diretivas Apache</primary>

en: <primary>Apache</primary><secondary>directives</secondary>
pt-BR: <primary>Apache</primary><secondary>diretivas</secondary>

en: The main configuration file usually includes several <literal>Directory</literal> blocks; they allow specifying different behaviors for the server depending on the location of the file being served. Such a block commonly includes <literal>Options</literal> and <literal>AllowOverride</literal> directives.
pt-BR: O principal arquivo de configuração inclui vários blocos <literal>Directory</literal>; eles permitem especificar diferentes comportamentos para o servidor dependendo da localização do arquivo que está sendo servido. Um bloco desse tipo comumente inclui as diretivas <literal>Options</literal> e <literal>AllowOverride</literal>.

en: Directory block
pt-BR: Bloco Directory

en: The <literal>DirectoryIndex</literal> directive contains a list of files to try when the client request matches a directory. The first existing file in the list is used and sent as a response.
pt-BR: A diretiva <literal>DirectoryIndex</literal> contém uma lista de arquivos a serem experimentados quando uma requisição do cliente coincide com um diretório. O primeiro arquivo existente da lista é usado e enviado como resposta.

en: The <literal>Options</literal> directive is followed by a list of options to enable. The <literal>None</literal> value disables all options; correspondingly, <literal>All</literal> enables them all except <literal>MultiViews</literal>. Available options include:
pt-BR: A diretiva <literal>Options</literal> é seguida de uma lista de opções a serem habilitadas. O valor <literal>None</literal> desabilita todas as opções; correspondentemente, <literal>All</literal> habilita todas elas exceto <literal>MultiViews</literal>. As opções disponíveis incluem:

en: <literal>ExecCGI</literal> indicates that CGI scripts can be executed.
pt-BR: <literal>ExecCGI</literal> indica que scripts CGI podem ser executados.

en: <literal>FollowSymlinks</literal> tells the server that symbolic links can be followed, and that the response should contain the contents of the target of such links.
pt-BR: <literal>FollowSymlinks</literal> diz ao servidor que ligações simbólicas podem ser seguidas, e que a resposta deve conter o conteúdo do alvo dessas ligações.

en: <literal>Includes</literal> enables <emphasis>Server Side Includes</emphasis> (<emphasis>SSI</emphasis> for short). These are directives embedded in HTML pages and executed on the fly for each request.
pt-BR: <literal>Includes</literal> habilita <emphasis>Server Side Includes</emphasis> (<emphasis>SSI</emphasis> para abreviar). Essas são diretivas embutidas nas páginas HTML e executadas em tempo de execução para cada requisição.

en: <literal>IncludesNOEXEC</literal> allows <emphasis>Server Side Includes</emphasis> (<emphasis>SSI</emphasis>) but disables the <literal>exec</literal> command and limits the <literal>include</literal> directive to text/markup files.
pt-BR: <literal>IncludesNOEXEC</literal> permite <emphasis>inclusões no lado do servidor</emphasis> (<emphasis>SSI</emphasis>: «Server Side Includes»), mas desabilita a ordem <literal>exec</literal> e limita a diretiva <literal>include</literal> a arquivos de texto/marcado.

en: <literal>Indexes</literal> tells the server to list the contents of a directory if the HTTP request sent by the client points at a directory without an index file (i.e., when no files mentioned by the <literal>DirectoryIndex</literal> directive exists in this directory).
pt-BR: <literal>Indexes</literal> diz ao servidor para listar o conteúdo de um diretório se a requisição HTTP enviada pelo cliente aponta para um diretório sem um arquivo índex (i.e., quando nenhum arquivo mencionado na diretiva <literal>DirectoryIndex</literal> existe nesse diretório).

en: <literal>MultiViews</literal> enables content negotiation; this can be used by the server to return a web page matching the preferred language as configured in the browser.
pt-BR: <literal>MultiViews</literal> habilita a negociação de conteúdo; isso pode ser usado pelo servidor para retornar uma página web que coincida com a língua preferida configurada no navegador.

en: <emphasis>BACK TO BASICS</emphasis> <filename>.htaccess</filename> file
pt-BR: <emphasis>DE VOLTA AO BÁSICO</emphasis> Arquivo <filename>.htaccess</filename>

en: The <filename>.htaccess</filename> file contains Apache configuration directives enforced each time a request concerns an element of the directory where it is stored. The scope of these directives also recurses to all the subdirectories within.
pt-BR: O arquivo <filename>.htaccess</filename> contém as diretivas de configuração do Apache que são aplicadas cada vez que uma requisição diz respeito a um elemento do diretório aonde ele é armazenado. O âmbito dessas diretivas também repercute para todos os subdiretórios dentro desse diretório.

en: Most of the directives that can occur in a <literal>Directory</literal> block are also legal in a <filename>.htaccess</filename> file.
pt-BR: A maioria das diretivas que podem ser definidas no bloco <literal>Directory</literal> também podem ser definidas no arquivo <filename>.htaccess</filename>.

en: The <literal>AllowOverride</literal> directive lists all the options that can be enabled or disabled by way of a <filename>.htaccess</filename> file. A common use of this option is to restrict <literal>ExecCGI</literal>, so that the administrator chooses which users are allowed to run programs under the web server's identity (the <literal>www-data</literal> user).
pt-BR: A diretiva <literal>AllowOverride</literal> lista todas as opções que podem ser habilitadas ou desabilitadas pelo arquivo <filename>.htaccess</filename>. Um uso comum dessa opção é restringir <literal>ExecCGI</literal>, para que o administrador escolha quais usuários tem permissão para rodar programas sob a identidade do servidor web (o usuário <literal>www-data</literal>).

en: Requiring Authentication
pt-BR: Autenticação obrigatória

en: <primary>web authentication</primary>
pt-BR: <primary>autenticação web</primary>

en: <primary>Apache</primary><secondary>password-based authentication</secondary>
pt-BR: <primary>Apache</primary><secondary>autenticação baseada em senha</secondary>

en: <filename>.htaccess</filename> file requiring authentication
pt-BR: Arquivo <filename>.htaccess</filename> para autenticação obrigatária

en: <emphasis>SECURITY</emphasis> No security
pt-BR: <emphasis>SEGURANÇA</emphasis> Sem segurança

en: The authentication system used in the above example (<literal>Basic</literal>) has minimal security as the password is sent in clear text (it is only encoded as <emphasis>base64</emphasis>, which is a simple encoding rather than an encryption method). It should also be noted that the documents “protected” by this mechanism also go over the network in the clear. If security is important, the whole HTTP connection should be encrypted with SSL.
pt-BR: O sistema de autenticação usado no exemplo acima (<literal>Basic</literal>) tem uma segurança mínima já que a senha é enviada em texto puro (ela apenas é codificada com <emphasis>base64</emphasis>, que é uma codificação simples, ao invés de um método criptografado). Também deve ser notado que os documentos “protegidos” por esse mecanismo também trafegam pela rede em texto puro. Se segurança é importante, toda a conexão HTTP deve ser criptografada com SSL.

en: The <filename>/etc/apache2/authfiles/htpasswd-private</filename> file contains a list of users and passwords; it is commonly manipulated with the <command>htpasswd</command> command. For example, the following command is used to add a user or change their password:
pt-BR: O arquivo <filename>/etc/apache2/authfiles/htpasswd-private</filename> contém uma lista de usuários e senhas; ele é comumente manipulado com o comando <command>htpasswd</command>. Por exemplo, o seguinte comando é usado para adicionar um usuário ou alterar a senha:

en: Restricting Access
pt-BR: Restringindo Acesso

en: <primary>web access restriction</primary>
pt-BR: <primary>restrição de acesso web</primary>

en: <primary>Apache</primary><secondary>IP-based authentication</secondary>
pt-BR: <primary>Apache</primary><secondary>autenticação baseada em IP</secondary>

en: The <literal>Require</literal> directive controls access restrictions for a directory (and its subdirectories, recursively). <ulink type="block" url="https://httpd.apache.org/docs/2.4/howto/access.html" />
pt-BR: A diretiva <literal>Require</literal> controla as restrições de acesso em um diretório (e seus sub-diretórios, recursivamente).<ulink type="block" url="https://httpd.apache.org/docs/2.4/howto/access.html" />

en: It can be used to restrict access based on many criteria; we will stop at describing access restriction based on the IP address of the client, but it can be made much more powerful than that, especially when several <literal>Require</literal> directives are combined within a <literal>RequireAll</literal> block.
pt-BR: Isso pode ser usado para restringir acesso com base em muitos critérios; nós iremos parar na descrição de restrição de acesso com base no endereço IP de um cliente, mas isso pode ser feito de maneira muito mais poderosa, especialmente quando várias diretivas <literal>Require</literal> são combinadas dentro de um bloco <literal>RequireAll</literal>.

en: Only allow from the local network
pt-BR: Apenas permite a partir da rede local

en: <emphasis>ALTERNATIVE</emphasis> Old syntax
pt-BR: <emphasis>ALTERNATIVA</emphasis> Sintaxe antiga

en: The <literal>Require</literal> syntax is only available in Apache 2.4 (the version shipped since <emphasis role="distribution">Jessie</emphasis>). For users of <emphasis role="distribution">Wheezy</emphasis>, the Apache 2.2 syntax is different, and we describe it here mainly for reference, although it can also be made available in Apache 2.4 using the <literal>mod_access_compat</literal> module.
pt-BR: A sintaxe do <literal>Require</literal> só está disponível no Apache 2.4 (a versão enviada desde <emphasis role="distribution">Jessie</emphasis>). Para usuários(as) do <emphasis role="distribution">Wheezy</emphasis>, a sintaxe no Apache 2.2 é diferente e nós a descrevemos aqui principalmente para referência, embora ela também possa ser disponibilizada no Apache 2.4 usando o modulo <literal>mod_access_compat</literal>.

en: The <literal>Allow from</literal> and <literal>Deny from</literal> directives control access restrictions for a directory (and its subdirectories, recursively).
pt-BR: As diretivas <literal>Allow from</literal> e <literal>Deny from</literal> controlam as restrições de acesso em um diretório (e seus sub-diretórios, recursivamente).

en: The <literal>Order</literal> directive tells the server of the order in which the <literal>Allow from</literal> and <literal>Deny from</literal> directives are applied; the last one that matches takes precedence. In concrete terms, <literal>Order deny,allow</literal> allows access if no <literal>Deny from</literal> applies, or if an <literal>Allow from</literal> directive does. Conversely, <literal>Order allow,deny</literal> rejects access if no <literal>Allow from</literal> directive matches (or if a <literal>Deny from</literal> directive applies).
pt-BR: A diretiva <literal>Order</literal> informa ao servidor a ordem em que as diretivas <literal>Allow from</literal> e <literal>Deny from</literal> são aplicadas; A última que coincidir tem precedência. Em termos concretos, <literal>Order deny,allow</literal> permite acesso se nenhum <literal>Deny from</literal> se aplica, ou se uma diretiva <literal>Allow from</literal> aplica. Por outro lado, <literal>Order allow,deny</literal> rejeita acesso se nenhuma diretiva <literal>Allow from</literal> coincide (ou se uma diretiva <literal>Deny from</literal> se aplica).

en: The <literal>Allow from</literal> and <literal>Deny from</literal> directives can be followed by an IP address, a network (such as <literal>192.168.0.0/255.255.255.0</literal>, <literal>192.168.0.0/24</literal> or even <literal>192.168.0</literal>), a hostname or a domain name, or the <literal>all</literal> keyword, designating everyone.
pt-BR: As diretivas <literal>Allow from</literal> e <literal>Deny from</literal> podem ser seguidas de um endereço IP, uma rede (como <literal>192.168.0.0/255.255.255.0</literal>, <literal>192.168.0.0/24</literal> ou mesmo <literal>192.168.0</literal>), um nome de máquina ou nome de domínio, ou a palavra chave <literal>all</literal>, designando todos.

en: For instance, to reject connections by default but allow them from the local network, you could use this:
pt-BR: Por exemplo, para rejeitar conexões por padrão mas permiti-las a partir da rede local, você poderia usar isso:

en: Log Analyzers
pt-BR: Analisadores de Log

en: A log analyzer is frequently installed on a web server; since the former provides the administrators with a precise idea of the usage patterns of the latter.
pt-BR: Um analisador de log é frequentemente instalado em um servidor web; já que o primeiro fornece aos administradores uma ideia precisa do padrão de uso do último.

en: The Falcot Corp administrators selected <emphasis>AWStats</emphasis> (<emphasis>Advanced Web Statistics</emphasis>) to analyze their Apache log files.
pt-BR: Os administradores da Falcot Corp selecionaram o <emphasis>AWStats</emphasis> (<emphasis>Advanced Web Statistics</emphasis>) para analisar seus arquivos de log do Apache.

en: <primary>web logs analyzer</primary>
pt-BR: <primary>analisador de registros web</primary>

en: <primary>Apache</primary><secondary>log analyzer</secondary>
pt-BR: <primary>Apache</primary><secondary>analisador de registros (logs)</secondary>

en: The first configuration step is the customization of the <filename>/etc/awstats/awstats.conf</filename> file. The Falcot administrators keep it unchanged apart from the following parameters:
pt-BR: O primeiro passo de configuração é a customização do arquivo <filename>/etc/awstats/awstats.conf</filename>. O administradores da Falcot o mantiveram inalterado, exceto os seguintes parâmetros:

en: All these parameters are documented by comments in the template file. In particular, the <varname>LogFile</varname> and <varname>LogFormat</varname> parameters describe the location and format of the log file and the information it contains; <varname>SiteDomain</varname> and <varname>HostAliases</varname> list the various names under which the main web site is known.
pt-BR: Todos esses parâmetros são documentados através de comentários no arquivo de exemplo. Em particular, os parâmetros <varname>LogFile</varname> e <varname>LogFormat</varname> descrevem a localização e o formato do arquivo de log e a informação que ele contém; <varname>SiteDomain</varname> e <varname>HostAliases</varname> listam os vários nomes pelos quais o site web principal é conhecido.

en: For high traffic sites, <varname>DNSLookup</varname> should usually not be set to <literal>1</literal>; for smaller sites, such as the Falcot one described above, this setting allows getting more readable reports that include full machine names instead of raw IP addresses.
pt-BR: Para sites com alto tráfego, <varname>DNSLookup</varname> geralmente não deveria ser configurado como <literal>1</literal>; para sites menores, como o da Falcot descrito acima, essa configuração permite ter relatórios mais legíveis, que incluem o nome completo da máquina ao invés de simplesmente endereços IP.

en: <emphasis>SECURITY</emphasis> Access to statistics
pt-BR: <emphasis>SEGURANÇA</emphasis> Acesso as estatísticas

en: AWStats makes its statistics available on the website with no restrictions by default, but restrictions can be set up so that only a few (probably internal) IP addresses can access them; the list of allowed IP addresses needs to be defined in the <varname>AllowAccessFromWebToFollowingIPAddresses</varname> parameter
pt-BR: O AWStats deixa suas estatísticas disponíveis no site web sem restrições por padrão, mas restrições podem ser configuradas para que apenas alguns endereços IP (provavelmente internos) possam ter acesso a elas; a lista de endereços IP com permissão precisa ser definida no parâmetro <varname>AllowAccessFromWebToFollowingIPAddresses</varname>

en: AWStats will also be enabled for other virtual hosts; each virtual host needs its own configuration file, such as <filename>/etc/awstats/awstats.www.falcot.org.conf</filename>.
pt-BR: O AWStats também será habilitado para outros hosts virtuais; cada host virtual precisa de um arquivo de configuração próprio como <filename>/etc/awstats/awstats.www.falcot.org.conf</filename>.

en: AWStats configuration file for a virtual host
pt-BR: Arquivo de configuração dO AWStats para um servidor virtual

en: After a few minutes (and once the script has been run a few times), the results are available online: <ulink type="block" url="http://www.falcot.com/cgi-bin/awstats.pl" /><ulink type="block" url="http://www.falcot.org/cgi-bin/awstats.pl" />
pt-BR: Após alguns minutos (e uma vez que o script tenha sido rodado algumas vezes), os resultados ficarão disponíveis online: <ulink type="block" url="http://www.falcot.com/cgi-bin/awstats.pl" /><ulink type="block" url="http://www.falcot.org/cgi-bin/awstats.pl" />

en: <emphasis>CAUTION</emphasis> Log file rotation
pt-BR: <emphasis>ATENÇÃO</emphasis> Rotação dos arquivos de registro

en: FTP File Server
pt-BR: Servidor de Arquivos FTP

en: <primary>server</primary><secondary>file</secondary>
pt-BR: <primary>servidor</primary><secondary>arquivo</secondary>

en: <primary>server</primary><secondary>FTP</secondary>
pt-BR: <primary>servidor</primary><secondary>FTP</secondary>

en: FTP (<emphasis>File Transfer Protocol</emphasis>) is one of the first protocols of the Internet (RFC 959 was issued in 1985!). It was used to distribute files before the Web was even born (the HTTP protocol was created in 1990, and formally defined in its 1.0 version by RFC 1945, issued in 1996).
pt-BR: O FTP (<emphasis>File Transfer Protocol</emphasis>) é um dos primeiros protocolos da internet (a RFC 959 foi emitida em 1985!). Ele era usado para distribuir arquivos antes mesmo que a Web tivesse nascido (o protocolo HTTP foi criado em 1990, e formalmente definido em sua versão 1.0 pela RFC 1945, emitida em 1996).

en: Other FTP servers are mainly used to distribute files for public downloading; Debian packages are a good example. The contents of these servers is fetched from other, geographically remote, servers; it is then made available to less distant users. This means that client authentication is not required; as a consequence, this operating mode is known as “anonymous FTP”. To be perfectly correct, the clients do authenticate with the <literal>anonymous</literal> username; the password is often, by convention, the user's email address, but the server ignores it.
pt-BR: Outros servidores FTP são principalmente usados para distribuir arquivos para qualquer um baixar; os pacotes Debian são um bom exemplo. O conteúdo desses servidores é obtido de outro servidor geograficamente remoto; e então disponibilizados para usuários menos distantes. Isso significa que a autenticação do cliente não é necessária; como consequência, esse modo de operação é conhecido como “anonymous FTP”. Para ser mais correto, os cliente fazem uma autenticação com nome de usuário <literal>anonymous</literal>; a senha é, geralmente, por convenção, o endereço de email do usuário, mas o servidor ignora isso.

en: Installing the package creates an <literal>ftp</literal> system user. This account is always used for anonymous FTP connections, and its home directory (<filename>/srv/ftp/</filename>) is the root of the tree made available to users connecting to this service. The default configuration (in <filename>/etc/vsftpd.conf</filename>) requires some changes to cater to the simple need of making big files available for public downloads: anonymous access needs to be enabled (<literal>anonymous_enable=YES</literal>) and read-only access of local users needs to be disabled (<literal>local_enable=NO</literal>). The latter is particularly important since the FTP protocol doesn't use any form of encryption and the user password could be intercepted over the wire.
pt-BR: A instalação do pacote cria um usuário <literal>ftp</literal> no sistema. Essa conta é sempre usada para conexões de FTP anônimas, e seu diretório inicial (home) (<filename>/srv/ftp/</filename>) é a raiz da árvore que está disponível ao usuários que se conectam a esse serviço. A configuração padrão (em <filename>/etc/vsftpd.conf</filename>) necessita de algumas mudanças para atender a simples necessidade de tornar grandes arquivos disponíveis para baixar pelo público: o acesso anônimo precisa ser habilitado (<literal>anonymous_enable=YES</literal>) e o acesso apenas para leitura de usuários locais precisa ser desabilitado (<literal>local_enable=NO</literal>). Esse último é particularmente importante já que o protocolo FTP não usa nenhuma forma de criptografia e a senha do usuário poderia ser interceptada pelo cabo.

en: NFS File Server
pt-BR: Servidor de Arquivos NFS

en: <primary>server</primary><secondary>NFS</secondary>
pt-BR: <primary>servidor</primary><secondary>NFS</secondary>

en: NFS (<emphasis>Network File System</emphasis>) is a protocol allowing remote access to a filesystem through the network. All Unix systems can work with this protocol.
pt-BR: O NFS (<emphasis>Network File System</emphasis>) é um protocolo que permite acesso remoto a um sistema de arquivos através da rede. Todos os sistemas Unix podem trabalhar com esse protocolo.

en: <emphasis>SPECIFIC CASE</emphasis> Microsoft Windows and NFS Shares
pt-BR: <emphasis>CASO ESPECÍFICO</emphasis> Microsoft Windows e compartilhamentos NFS

en: When older or (so called) "Home" variants of Windows are involved, usually Samba (<xref linkend="sect.windows-file-server-with-samba" />) must be used instead of NFS. Modern Windows Server and "Pro" or "Enterprise" Desktop solutions however have built-in support for NFS. After installation of the "Services for NFS" components NFS shares can be accessed and temporarily or permanently mounted like any other network share. Be aware of possible encoding issues in file names.
pt-BR: Quando estão envolvidas versões mais antigas ou versões "Home" do Windows, normalmente o Samba (<xref linkend="sect.windows-file-server-with-samba" />) deve ser usado no lugar do NFS. Soluções modernas de Windows Server e versões "Pro" ou "Enterprise" tem compatibilidade com NFS incorporada. Depois da instalação dos componentes "Services for NFS", se podem acessar os recursos compatilhados NFS e montar temporaria ou permanentemente como qualquer outro recurso de rede. Lembre-se dos possíveis problemas de codificação em nomes de arquivos.

en: <primary>Network File System</primary><secondary>Windows client</secondary>
pt-BR: <primary>Network File System</primary><secondary>cliente Windows</secondary>

en: <primary>filesystem</primary><secondary>network</secondary>
pt-BR: <primary>sistema de arquivos</primary><secondary>rede</secondary>

en: <primary>file</primary><secondary>server</secondary>
pt-BR: <primary>arquivo</primary><secondary>servidor</secondary>

en: NFS is a very useful tool but, historically, it has suffered from many limitations, most of which have been addressed with version 4 of the protocol. The downside is that the latest version of NFS is harder to configure when you want to make use of basic security features such as authentication and encryption since it relies on Kerberos for those parts. And without those, the NFS protocol must be restricted to a trusted local network since data goes over the network unencrypted (a <emphasis>sniffer</emphasis> can intercept it) and access rights are granted based on the client's IP address (which can be spoofed).
pt-BR: O NFS é uma ferramenta muito útil, mas historicamente, ela tem sofrido com muitas limitações, a maioria delas tendo sido atribuídas a versão 4 do protocolo. A contrapartida é que a última versão do NFS é mais difícil de configurar quando você quer usar recursos básicos de segurança tais como autenticação e criptografia já que ele faz uso do Kerberos para esses assuntos. E sem isso, o protocolo NFS tem que ficar restrito a uma rede local confiável já que os dados viajam pela rede sem criptografia (um <emphasis>sniffer</emphasis> pode interceptá-los) e os direitos de acesso são optidos com base no endereço IP do cliente (que pode ser falsificado ("spoofed")).

en: <emphasis>DOCUMENTATION</emphasis> NFS HOWTO
pt-BR: <emphasis>DOCUMENTAÇÃO</emphasis> NFS HOWTO

en: Good documentation to deploy NFSv4 is rather scarce. Here are some pointers with content of varying quality but that should at least give some hints on what should be done. <ulink type="block" url="https://help.ubuntu.com/community/NFSv4Howto" /> <ulink type="block" url="https://wiki.linux-nfs.org/wiki/index.php/Nfsv4_configuration" />
pt-BR: Boa documentação para implementar o NFSv4 é bastante escassa. Aqui estão algumas indicações de conteúdo com qualidade variável, mas que devem ao menos dar algumas pistas sobre o que deve ser feito. <ulink type="block" url="https://help.ubuntu.com/community/NFSv4Howto" /> <ulink type="block" url="https://wiki.linux-nfs.org/wiki/index.php/Nfsv4_configuration" />

en: Securing NFS
pt-BR: Proteção do NFS

en: <primary>NFS</primary><secondary>security</secondary>
pt-BR: <primary>NFS</primary><secondary>segurança</secondary>

en: If you don't use the Kerberos-based security features, it is vital to ensure that only the machines allowed to use NFS can connect to the various required RPC servers, because the basic protocol trusts the data received from the network. The firewall must also block <emphasis>IP spoofing</emphasis> so as to prevent an outside machine from acting as an inside one, and access to the appropriate ports must be restricted to the machines meant to access the NFS shares.
pt-BR: Se você não usa recursos de segurança baseados no Kerberos, é vital garantir que apenas máquinas com permissão de usar o NFS possam se conectar nos vários servidores RPC requeridos, porque o protocolo básico confia nos dados recebidos a partir da rede. O firewall tem também que bloquear <emphasis>IP spoofing</emphasis> para prevenir que uma máquina de fora atue como uma de dentro, e acesso às portas apropriadas tem que ser restrito às máquinas destinadas a acessar os compartilhamentos NFS.

en: <emphasis>BACK TO BASICS</emphasis> RPC
pt-BR: <emphasis>DE VOLTA AO BÁSICO</emphasis> RPC

en: RPC (<emphasis>Remote Procedure Call</emphasis>) is a Unix standard for remote services. NFS is one such service.
pt-BR: RPC (<emphasis>Remote Procedure Call</emphasis>) é um padrão Unix para serviços remotos. O NFS é um desses serviços.

en: RPC services register to a directory known as the <emphasis>portmapper</emphasis>. A client wishing to perform an NFS query first addresses the <emphasis>portmapper</emphasis> (on port 111, either TCP or UDP), and asks for the NFS server; the reply usually mentions port 2049 (the default for NFS). Not all RPC services necessarily use a fixed port.
pt-BR: Os serviços RPC se registram em um diretório conhecido como <emphasis>portmapper</emphasis>. Um cliente querendo realizar uma consulta NFS primeiro consulta o <emphasis>portmapper</emphasis> (na porta 111, seja TCP ou UDP), e pergunta pelo servidor NFS; a resposta gralmente vem pela porta 2049 (a padrão para o NFS). Nem todos os serviços RPC necessariamente usam uma porta fixa.

en: Older versions of the protocol required other RPC services which used dynamically assigned ports. Fortunately, with NFS version 4, only port 2049 (for NFS) and 111 (for the portmapper) are needed and they are thus easy to firewall.
pt-BR: Versões mais antigas do protocolo necessitavam de outros serviços RPC que usavam portas dinamicamente atribuídas. Felizmente, com a versão 4 do NFS, apenas a porta 2049 (para NFS) e 111 (para o portmapper) são necessárias, e assim, fácil de configurar no firewall.

en: NFS Server
pt-BR: Servidor NFS

en: <primary>NFS</primary><secondary>server</secondary>
pt-BR: <primary>NFS</primary><secondary>servidor</secondary>

en: The NFS server is part of the Linux kernel; in kernels provided by Debian it is built as a kernel module. If the NFS server is to be run automatically on boot, the <emphasis role="pkg">nfs-kernel-server</emphasis> package should be installed; it contains the relevant start-up scripts.
pt-BR: O servidor NFS é parte do núcleo Linux; nos núcleos fornecidos peloDebian ele é construído como um módulo do núcleo. Se o servidor NFS tem que ser rodado automaticamente na inicialização, o pacote <emphasis role="pkg">nfs-kernel-server</emphasis> deve ser instalado; ele contém os scripts de inicialização relevantes.

en: 
    /directory/to/share machine1(option1,option2,...) machine2(...) ...
pt-BR: 
    /diretório/para/compartilhar máquina1(opção1,opção2,...) máquina2(...) ...

en: Note that with NFSv4, all exported directories must be part of a single hierarchy and that the root directory of that hierarchy must be exported and identified with the option <literal>fsid=0</literal> or <literal>fsid=root</literal>.
pt-BR: Note que com o NFSv4, todos os diretórios exportados tem que ser parte de uma única hierarquia e que o diretório raiz dessa hierarquia tem que ser exportado e identificado com a opção <literal>fsid=0</literal> ou <literal>fsid=root</literal>.

en: Each machine can be identified either by its DNS name or its IP address. Whole sets of machines can also be specified using either a syntax such as <literal>*.falcot.com</literal> or an IP address range such as <literal>192.168.0.0/255.255.255.0</literal> or <literal>192.168.0.0/24</literal>.
pt-BR: Cada máquina pode ser identificada tanto pelo seu nome no DNS quanto seu endereço IP. Todo um conjunto de máquinas pode também ser especificado usando tanto uma sintaxe como <literal>*.falcot.com</literal> ou um intervalo de endereços IP como <literal>192.168.0.0/255.255.255.0</literal> ou <literal>192.168.0.0/24</literal>.

en: Directories are made available as read-only by default (or with the <literal>ro</literal> option). The <literal>rw</literal> option allows read-write access. NFS clients typically connect from a port restricted to root (in other words, below 1024); this restriction can be lifted by the <literal>insecure</literal> option (the <literal>secure</literal> option is implicit, but it can be made explicit if needed for clarity).
pt-BR: Os diretórios ficam disponíveis apenas para leitura por padrão (ou com a opção <literal>ro</literal>). A opção <literal>rw</literal> permite o acesso a leitura-escrita. Os clientes NFS tipicamente fazem a conexão a partir de uma porta restrita ao root (em outras palavras, abaixo da 1024); essa restrição pode ser elevada pela opção <literal>insecure</literal> (a opção <literal>secure</literal> é implícita, mas pode ser explícita para mais clareza).

en: <primary>NFS</primary><secondary>options</secondary>
pt-BR: <primary>NFS</primary><secondary>opções</secondary>

en: By default, the server only answers an NFS query when the current disk operation is complete (<literal>sync</literal> option); this can be disabled with the <literal>async</literal> option. Asynchronous writes increase performance a bit, but they decrease reliability since there is a data loss risk in case of the server crashing between the acknowledgment of the write and the actual write on disk. Since the default value changed recently (as compared to the historical value of NFS), an explicit setting is recommended.
pt-BR: Por padrão, o servidor apenas responde a uma consulta NFS quando a operação de disco corrente é concluída (opção <literal>sync</literal>); isso pode ser desabilitado com a opção <literal>async</literal>. A escrita assíncrona aumenta um pouco a performance, mas ela diminui a confiança já que existe o risco de perda de dados no caso do servidor falhar entre comunicar a escrita e realmente escrever no disco. Como o valor padrão foi alterado recentemente (comparado ao valor histórico do NFS), uma configuração explícita é recomendada.

en: In order to not give root access to the filesystem to any NFS client, all queries appearing to come from a root user are considered by the server as coming from the <literal>nobody</literal> user. This behavior corresponds to the <literal>root_squash</literal> option, and is enabled by default. The <literal>no_root_squash</literal> option, which disables this behavior, is risky and should only be used in controlled environments. If all users should be mapped to the user <literal>nobody</literal>, use <literal>all_squash</literal>. The <literal>anonuid=<replaceable>uid</replaceable></literal> and <literal>anongid=<replaceable>gid</replaceable></literal> options allow specifying another fake user to be used instead of UID/GID 65534 (which corresponds to user <literal>nobody</literal> and group <literal>nogroup</literal>).
pt-BR: Para que não seja dado acesso de root no sistema de arquivos a nenhum cliente NFS, todas as consultas que parecem vir do usuário root são consideradas pelo servidor como vindo do usuário <literal>nobody</literal>. Esse comportamento corresponde à opção <literal>root_squash</literal> e é habilitado por padrão. A opção <literal>no_root_squash</literal>, que desabilita esse comportamento, é arriscada e só deve ser usada em ambientes controlados. Se todos(as) os(as) usuários(as) devem ser mapeados para o usuário <literal>nobody</literal>, use <literal>all_squash</literal>. As opções <literal>anonuid=<replaceable>uid</replaceable></literal> e <literal>anongid=<replaceable>gid</replaceable></literal> permitem especificar outro usuário falso a ser usado em vez de UID/GID 65534 (que corresponde ao usuário <literal>nobody</literal> e ao grupo <literal>nogroup</literal>).

en: With NFSv4, you can add a <literal>sec</literal> option to indicate the security level that you want: <literal>sec=sys</literal> is the default with no special security features, <literal>sec=krb5</literal> enables authentication only, <literal>sec=krb5i</literal> adds integrity protection, and <literal>sec=krb5p</literal> is the most complete level which includes privacy protection (with data encryption). For this to work you need a working Kerberos setup (that service is not covered by this book).
pt-BR: Com o NFSv4, você pode adicionar uma opção <literal>sec</literal> para indicar o nível de segurança que você quer: <literal>sec=sys</literal> é o padrão, sem recursos especiais de segurança, <literal>sec=krb5</literal> habilita apenas a autenticação, <literal>sec=krb5i</literal> adiciona proteção de integridade, e <literal>sec=krb5p</literal> é o mais completo nível, que inclui proteção de privacidade (com criptografia de dados). Para isso funcionar você precisa do Kerberos configurado e funcionando (esse serviço não é coberto por esse livro).

en: Other options are available; they are documented in the <citerefentry><refentrytitle>exports</refentrytitle> <manvolnum>5</manvolnum></citerefentry> manual page.
pt-BR: Outras opções estão disponíveis; elas estão documentadas na página de manual <citerefentry><refentrytitle>exports</refentrytitle> <manvolnum>5</manvolnum></citerefentry>.

en: <emphasis>CAUTION</emphasis> First installation
pt-BR: <emphasis>ATENÇÃO</emphasis> Primeira instalação

en: NFS Client
pt-BR: Cliente NFS

en: <primary>client</primary><secondary>NFS</secondary>
pt-BR: <primary>cliente</primary><secondary>NFS</secondary>

en: <primary>NFS</primary><secondary>client</secondary>
pt-BR: <primary>NFS</primary><secondary>cliente</secondary>

en: Manually mounting with the <command>mount</command> command
pt-BR: Montando manualmente com o comando <command>mount</command>

en: NFS entry in the <filename>/etc/fstab</filename> file
pt-BR: Entrada NFS no arquivo <filename>/etc/fstab</filename>

en: The entry described above mounts, at system startup, the NFS directory <filename>/shared/</filename> from the <literal>arrakis</literal> server into the local <filename>/srv/shared/</filename> directory. Read-write access is requested (hence the <literal>rw</literal> parameter). The <literal>nosuid</literal> option is a protection measure that wipes any <literal>setuid</literal> or <literal>setgid</literal> bit from programs stored on the share. If the NFS share is only meant to store documents, another recommended option is <literal>noexec</literal>, which prevents executing programs stored on the share. Note that on the server, the <filename>shared</filename> directory is below the NFSv4 root export (for example <filename>/export/shared</filename>), it is not a top-level directory.
pt-BR: A entrada descrita acima monta, ao iniciar o sistema, o diretório NFS <filename>/shared/</filename> no servidor <literal>arrakis</literal> no diretório local <filename>/srv/shared/</filename>. O acesso de leitura-escrita é requisitado (visto o parâmetro <literal>rw</literal>). A opção <literal>nosuid</literal> é uma medida de proteção que apaga qualquer bit <literal>setuid</literal> ou <literal>setgid</literal> de programas armazenados no compartilhamento. Se o compartilhamento NFS é apenas para armazenar documentos, outra opção recomendada é <literal>noexec</literal>, a qual previne a execução de programas armazenados no compartilhamento. Note que no servidor, o diretório <filename>shared</filename> está abaixo da raiz NFSv4 exportada ( por exemplo, <filename>/export/shared</filename>), não é um diretório de nível mais alto.

en: The <citerefentry><refentrytitle>nfs</refentrytitle> <manvolnum>5</manvolnum></citerefentry> manual page describes all the options in some detail.
pt-BR: A página de manual <citerefentry><refentrytitle>nfs</refentrytitle> <manvolnum>5</manvolnum></citerefentry> descreve todas as opções com alguns detalhes.

en: Setting Up Windows Shares with Samba
pt-BR: Configurando um Compartilhamento Windows com o Samba

en: <primary>Windows share</primary>
pt-BR: <primary>Compartilhamento Windows</primary>

en: <primary>server</primary><secondary>SMB</secondary>
pt-BR: <primary>servidor</primary><secondary>SMB</secondary>

en: <primary>server</primary><secondary>CIFS</secondary>
pt-BR: <primary>servidor</primary><secondary>CIFS</secondary>

en: Samba is a suite of tools handling the SMB protocol (also known as “CIFS”) on Linux. This protocol is used by Windows for network shares and shared printers.
pt-BR: O Samba é um conjunto de ferramentas para lidar com o protocolo SMB (também conhecido como “CIFS”) no Linux. Esse protocolo é usado pelo Windows para compartilhamento de rede e impressoras compartilhadas.

en: Samba can also act as a Windows domain controller. This is an outstanding tool for ensuring seamless integration of Linux servers and the office desktop machines still running Windows.
pt-BR: Samba também pode atuar como um controlador de domínio Windows. Esta é uma excelente ferramenta para garantir a perfeita integração de servidores Linux com as máquinas desktop de escritório ainda executando Windows.

en: Samba Server
pt-BR: Servidor Samba

en: <primary>server</primary><secondary>Samba</secondary>
pt-BR: <primary>servidor</primary><secondary>Samba</secondary>

en: <primary>Samba</primary><secondary>installation</secondary>
pt-BR: <primary>Samba</primary><secondary>instalação</secondary>

en: <primary>Samba</primary><secondary>server</secondary>
pt-BR: <primary>Samba</primary><secondary>servidor</secondary>

en: The <emphasis role="pkg">samba</emphasis> package contains the main two servers of Samba 4, <command>smbd</command> and <command>nmbd</command>.
pt-BR: O pacote <emphasis role="pkg">samba</emphasis> contém os dois principais servidores do Samba 4, <command>smbd</command> e <command>nmbd</command>.

en: <emphasis>DOCUMENTATION</emphasis> Going further
pt-BR: <emphasis>DOCUMENTAÇÃO</emphasis> Aprofundando

en: <primary>domain controller</primary>
pt-BR: <primary>controle de domínio</primary>

en: <primary>Windows domain</primary>
pt-BR: <primary>Domínio Windows</primary>

en: <primary>Samba</primary><secondary>domain controller</secondary>
pt-BR: <primary>Samba</primary><secondary>controlador de domínio</secondary>

en: The <emphasis role="pkg">samba</emphasis> package contains all the necessary manual pages and in <filename>/usr/share/doc/samba/examples/</filename> a wealth of commented example files. If you are looking for a more comprehensive documentation, you may check the <emphasis>Samba</emphasis> website. <ulink type="block" url="https://www.samba.org/samba/docs/" />
pt-BR: O pacote <emphasis role="pkg">samba</emphasis> contém todas as páginas de manual necessárias e em <filename>/usr/share/doc/samba/examples/</filename> uma grande quantidade de arquivos de exemplos comentados. Se você está procurando uma documentação mais completa, acesse o site web do <emphasis>Samba</emphasis>. <ulink type="block" url="https://www.samba.org/samba/docs/" />

en: <emphasis>TOOL</emphasis> Authenticating with a Windows Server
pt-BR: <emphasis>FERRAMENTA</emphasis> Autenticando com um Servidor Windows

en: Winbind gives system administrators the option of using a Windows server as an authentication server. Winbind also integrates cleanly with PAM and NSS. This allows setting up Linux machines where all users of a Windows domain automatically get an account.
pt-BR: Winbind dá aos administradores de sistema a opção de usar um servidor Windows como um servidor de autenticação. Winbind também se integra de forma limpa com PAM e NSS. Isso permite configurar máquinas Linux aonde todos os usuários de um domínio Windows automaticamente tenham uma conta.

en: More information can be found in the <filename>/usr/share/doc/libpam-winbind/examples/pam_winbind/</filename> directory of the <emphasis role="pkg">libpam-winbind</emphasis> package.
pt-BR: Mais informações podem ser obtidas no diretório <filename>/usr/share/doc/libpam-winbind/examples/pam_winbind/</filename> do pacote <emphasis role="pkg">libpam-winbind</emphasis>.

en: Configuring with <command>debconf</command>
pt-BR: Configurando com <command>debconf</command>

en: <primary>Samba</primary><secondary>configuration</secondary>
pt-BR: <primary>Samba</primary><secondary>configurações</secondary>

en: On first installation the only piece of required information is the name of the workgroup where the Samba server will belong (the answer is <literal>FALCOTNET</literal> in our case).
pt-BR: Na primeira instalação, a única informação necessária é o nome do grupo de trabalho (workgroup) ao qual o servidor Samba pertencerá (a resposta é <literal>FALCOTNET</literal> em nosso caso).

en: In case of a package update (from the old stable Debian version) or if the SMB server has already been configured to use a WINS server (<literal>wins server</literal>), the package also proposes identifying the WINS server from the information provided by the DHCP daemon. The Falcot Corp administrators rejected this option, since they intend to use the Samba server itself as the WINS server.
pt-BR: No caso de uma atualização de pacote (da versão estável anterior do Debian) ou se o servidor SMB já foi configurado para usar um servidor WINS (<literal>wins server</literal>), o pacote também propõe identificar o servidor WINS a partir das informações fornecidas pelo daemon DHCP. Os(as) administradores(as) da Falcot Corp rejeitaram esta opção, já que pretendem usar o servidor Samba mesmo como servidor WINS.

en: Configuring Manually
pt-BR: Configurando Manualmente

en: Changes to <filename>smb.conf</filename>
pt-BR: Mudanças no <filename>smb.conf</filename>

en: The requirements at Falcot require other options to be modified in the <filename>/etc/samba/smb.conf</filename> configuration file. The following excerpts summarize the changes that were effected in the <literal>[global]</literal> section.
pt-BR: Os requerimentos na Falcot fazem necessário que outras opção sejam modificadas no arquivo de configuração <filename>/etc/samba/smb.conf</filename>. O trecho a seguir resumem as alterações que foram feitas na seção <literal>[global]</literal>.

en: This is the default value for this parameter; however, since it is central to the Samba configuration, filling it explicitly is recommended. Each user must authenticate before accessing any share.
pt-BR: Esse é o valor padrão para esse parâmetro; contudo, como ele é central para a configuração do Samba, o recomendado é preenchê-lo explicitamente. cada usuário tem que se autenticar antes de acessar qualquer compartilhamento.

en: Adding Users
pt-BR: Adicionando Usuários

en: <primary>Samba</primary><secondary>add users</secondary>
pt-BR: <primary>Samba</primary><secondary>adicionar usuários(as)</secondary>

en: Each Samba user needs an account on the server; the Unix accounts must be created first, then the user needs to be registered in Samba's database. The Unix step is done quite normally (using <command>adduser</command> for instance).
pt-BR: Cada usuário do Samba precisa ter uma conta no servidor; as contas Unix tem que ser criadas primeiro, depois o usuário precisa ser registrado no banco de dados do Samba. O passo no Unix é feito bem facilmente (usando o <command>adduser</command> por exemplo).

en: Adding an existing user to the Samba database is a matter of running the <command>smbpasswd -a <replaceable>user</replaceable></command> command; this command asks for the password interactively.
pt-BR: Adicionar um usuário existente ao banco de dados do Samba é uma questão de rodar o comando <command>smbpasswd -a <replaceable>usuário</replaceable></command>; esse comando pergunta pela senha interativamente.

en: A user can be deleted with the <command>smbpasswd -x <replaceable>user</replaceable></command> command. A Samba account can also be temporarily disabled (with <command>smbpasswd -d <replaceable>user</replaceable></command>) and re-enabled later (with <command>smbpasswd -e <replaceable>user</replaceable></command>).
pt-BR: Um usuário pode ser apagado com o comando <command>smbpasswd -x <replaceable>usuário</replaceable></command>. Uma conta Samba também pode ser temporariamente desabilitada (com <command>smbpasswd -d <replaceable>usuário</replaceable></command>) e reabilitada mais tarde (com <command>smbpasswd -e <replaceable>usuário</replaceable></command>).

en: Samba Client
pt-BR: Cliente Samba

en: <primary>Samba</primary><secondary>client</secondary>
pt-BR: <primary>Samba</primary><secondary>cliente</secondary>

en: The client features in Samba allow a Linux machine to access Windows shares and shared printers. The required programs are available in the <emphasis role="pkg">cifs-utils</emphasis> and <emphasis role="pkg">smbclient</emphasis> packages.
pt-BR: Os recursos do cliente no Samba permitem que uma máquina Linux acesse compartilhamentos Windows e impressoras compartilhadas. Os programas necessários estão disponíveis nos pacotes <emphasis role="pkg">cifs-utils</emphasis> e <emphasis role="pkg">smbclient</emphasis>.

en: The <command>smbclient</command> Program
pt-BR: O Programa <command>smbclient</command>

en: The <command>smbclient</command> program queries SMB servers. It accepts a <literal>-U <replaceable>user</replaceable></literal> option, for connecting to the server under a specific identity. <command>smbclient //<replaceable>server</replaceable>/<replaceable>share</replaceable></command> accesses the share in an interactive way similar to the command-line FTP client. <command>smbclient -L <replaceable>server</replaceable></command> lists all available (and visible) shares on a server.
pt-BR: O programa <command>smbclient</command> consulta servidores SMB. Ele aceita a opção <literal>-U <replaceable>usuário</replaceable></literal>, para conectar em um servidor sob uma identidade específica. <command>smbclient //<replaceable>servidor</replaceable>/<replaceable>compartilhamento</replaceable></command> acessa o compartilhamento de maneira interativa, similar a linha de comando de um cliente FTP. <command>smbclient -L <replaceable>servidor</replaceable></command> lista todos os compartilhamentos disponíveis (e visíveis) em um servidor.

en: Mounting Windows Shares
pt-BR: Montando Compartilhamentos Windows

en: The <command>mount</command> command allows mounting a Windows share into the Linux filesystem hierarchy (with the help of <command>mount.cifs</command> provided by <emphasis role="pkg">cifs-utils</emphasis>).
pt-BR: O comando <command>mount</command> permite montar um compartilhamento Windows na hierarquia do sistema de arquivos do Linux (com a ajuda do <command>mount.cifs</command> fornecido pelo <emphasis role="pkg">cifs-utils</emphasis>).

en: Mounting a Windows share
pt-BR: Montando um compartilhamento Windows

en: The <filename>/etc/smb-credentials</filename> file (which must not be readable by users) has the following format:
pt-BR: O arquivo <filename>/etc/smb-credentials</filename> (o qual não deve ser legível pelos usuários) tem o seguinte formato:

en: <primary>Samba</primary><secondary>credentials</secondary>
pt-BR: <primary>Samba</primary><secondary>credenciais</secondary>

en: 
    username = <replaceable>user</replaceable>
    password = <replaceable>password</replaceable>
pt-BR: 
    username = <replaceable>usuário(a)</replaceable>
    password = <replaceable>senha</replaceable>

en: Other options can be specified on the command-line; their full list is available in the <citerefentry><refentrytitle>mount.cifs</refentrytitle> <manvolnum>1</manvolnum></citerefentry> manual page. Two options in particular can be interesting: <literal>uid</literal> and <literal>gid</literal> allow forcing the owner and group of files available on the mount, so as not to restrict access to root.
pt-BR: Outras opções podem ser especificadas pela linha de comando; sua lista completa está disponível na página de manual <citerefentry><refentrytitle>mount.cifs</refentrytitle> <manvolnum>1</manvolnum></citerefentry>. Duas opções em particular podem ser interessantes: <literal>uid</literal> e <literal>gid</literal> permitem forçar o dono e grupo dos arquivos disponíveis na montagem, de modo a não restringir o acesso para o root.

en: A mount of a Windows share can also be configured in <filename>/etc/fstab</filename>:
pt-BR: A montagem de um compartilhamento Windows também pode ser configurada em <filename>/etc/fstab</filename>:

en: 
    //<replaceable>server</replaceable>/shared /shared cifs credentials=/etc/smb-credentials
pt-BR: 
    //<replaceable>servidor</replaceable>/shared /shared cifs credentials=/etc/smb-credentials

en: Printing on a Shared Printer
pt-BR: Imprimindo com uma Impressora Compartilhada

en: CUPS is an elegant solution for printing from a Linux workstation to a printer shared by a Windows machine. When the <emphasis role="pkg">smbclient</emphasis> is installed, CUPS allows installing Windows shared printers automatically.
pt-BR: CUPS é uma solução elegante para impressão a partir de uma estação de trabalho Linux em uma impressora compartilhada por uma máquina Windows. Quando o <emphasis role="pkg">smbclient</emphasis> está instalado, o CUPS permite a instalação de impressoras Windows compartilhadas automaticamente.

en: <primary>printing</primary><secondary>network</secondary>
pt-BR: <primary>impressão</primary><secondary>rede</secondary>

en: <primary>Samba</primary><secondary>shared printers</secondary>
pt-BR: <primary>Samba</primary><secondary>impressoras compartilhadas</secondary>

en: Here are the required steps:
pt-BR: Aqui estão os passos necessários:

en: Enter the CUPS configuration interface: <literal>http://localhost:631/admin</literal>
pt-BR: Entre na interface de configuração do CUPS: <literal>http://localhost:631/admin</literal>

en: Click on “Add Printer”.
pt-BR: Clique em "Adicionar Impressora".

en: Choose the printer device, pick “Windows Printer via SAMBA”.
pt-BR: Selecione o dispositivo de impressora, escolha “Impressora Windows via SAMBA”.

en: Enter the connection URI for the network printer. It should look like the following:
pt-BR: Insira a conexão URI para a impressora de rede. Deve se parecer com o seguinte:

en: <literal>smb://<replaceable>user</replaceable>:<replaceable>password</replaceable>@<replaceable>server</replaceable>/<replaceable>printer</replaceable></literal>.
pt-BR: <literal>smb://<replaceable>usuário</replaceable>:<replaceable>senha</replaceable>@<replaceable>servidor</replaceable>/<replaceable>impressora</replaceable></literal>.

en: Enter the name that will uniquely identify this printer. Then enter the description and location of the printer. Those are the strings that will be shown to end users to help them identify the printers.
pt-BR: Digite o nome que irá identificar de maneira única essa impressora. Em seguida digite a descrição e localização da impressora. Essas são as cadeias de caracteres que irão ser mostradas aos usuários finais para ajudá-los a identificar as impressoras.

en: Indicate the manufacturer/model of the printer, or directly provide a working printer description file (PPD).
pt-BR: Indicar o fabricante/modelo da impressora, ou fornecer diretamente um arquivo funcional de descrição da impressora (PPD).

en: Voilà, the printer is operational!
pt-BR: Voilà, a impressora está operacional!

en: HTTP/FTP Proxy
pt-BR: Proxy HTTP/FTP

en: An HTTP/FTP proxy acts as an intermediary for HTTP and/or FTP connections. Its role is twofold:
pt-BR: Um proxy HTTP/FTP atua como um intermediário para conexões HTTP e/ou FTP. Seu papel é duplo:

en: Caching: recently downloaded documents are copied locally, which avoids multiple downloads.
pt-BR: Caching: documentos recentemente baixados são copiados localmente, o que evita baixá-los mais de uma vez.

en: Filtering server: if use of the proxy is mandated (and outgoing connections are blocked unless they go through the proxy), then the proxy can determine whether or not the request is to be granted.
pt-BR: Servidor de filtragem: se o uso do proxy é obrigatório (e conexões de saída são bloqueadas a menos que elas passem através do proxy), então o proxy pode determinar quando a requisição pode ser concedida.

en: <primary>HTTP/FTP proxy</primary>
pt-BR: <primary>proxy HTTP/FTP</primary>

en: Falcot Corp selected Squid as their proxy server.
pt-BR: Falcot Corp selecionou o Squid como seu servidor de proxy.

en: Installing
pt-BR: Instalando

en: <primary>Squid</primary><secondary>installation</secondary>
pt-BR: <primary>Squid</primary><secondary>instalação</secondary>

en: Prior to installing, care should be taken to check that the system can identify its own complete name: the <command>hostname -f</command> must return a fully-qualified name (including a domain). If it does not, then the <filename>/etc/hosts</filename> file should be edited to contain the full name of the system (for instance, <literal>arrakis.falcot.com</literal>). The official computer name should be validated with the network administrator in order to avoid potential name conflicts.
pt-BR: Antes da instalação, deve-se tomar o cuidado de checar que o sistema pode identificar seu próprio nome completo: o <command>hostname -f</command> tem que retornar um nome completo qualificado (incluindo o domínio). Se não, então o arquivo <filename>/etc/hosts</filename> deve ser editado para conter o nome completo do sistema (por exemplo, <literal>arrakis.falcot.com</literal>). O nome oficial do computador deve ser validado pelo administrador de rede para que sejam evitados potenciais conflitos de nome.

en: Configuring a Cache
pt-BR: Configurando um Cache

en: Enabling the caching server feature is a simple matter of editing the <filename>/etc/squid/squid.conf</filename> configuration file and allowing machines from the local network to run queries through the proxy. The following example shows the modifications made by the Falcot Corp administrators:
pt-BR: Habilitar o recurso de cache no servidor é uma simples questão de editar o arquivo de configuração <filename>/etc/squid/squid.conf</filename> e permitir que máquinas da rede local executem consultas através do proxy. Os exemplos a seguir mostram as modificações feitas pelos(as) administradores(as) da Falcot Corp:

en: The <filename>/etc/squid/squid.conf</filename> file (excerpts)
pt-BR: O arquivo <filename>/etc/squid/squid.conf</filename> (trecho)

en: Configuring a Filter
pt-BR: Configurando um Filtro

en: <command>squid</command> itself does not perform the filtering; this action is delegated to <command>squidGuard</command>. The former must then be configured to interact with the latter. This involves adding the following directive to the <filename>/etc/squid/squid.conf</filename> file:
pt-BR: O <command>squid</command> sozinho não faz a filtragem; essa ação é delegada ao <command>squidGuard</command>. O primeiro tem então que ser configurado para interagir com o último. Isso envolve a adição da seguinte diretiva ao arquivo <filename>/etc/squid/squid.conf</filename>:

en: The working database must be regenerated with <command>update-squidguard</command> after each change of the <command>squidGuard</command> configuration file (or one of the lists of domains or URLs it mentions). The configuration file syntax is documented on the following website: <ulink type="block" url="http://www.squidguard.org/Doc/configure.html" />
pt-BR: O banco de dados em uso tem que ser regenerado com <command>update-squidguard</command> após cada alteração feita no arquivo de configuração <command>squidGuard</command> (ou em uma das listas de domínios ou URLs que ele menciona). A sintaxe do arquivo de configuração é documentada no seguinte site web: <ulink type="block" url="http://www.squidguard.org/Doc/configure.html" />

en: <emphasis>ALTERNATIVE</emphasis> E2guardian (a DansGuardian Fork)
pt-BR: <emphasis>ALTERNATIVA</emphasis> E2guardian (um fork de DansGuardian)

en: LDAP Directory
pt-BR: Diretório LDAP

en: <primary>directory, LDAP</primary>
pt-BR: <primary>diretório, LDAP</primary>

en: OpenLDAP is an implementation of the LDAP protocol; in other words, it is a special-purpose database designed for storing directories. In the most common use case, using an LDAP server allows centralizing management of user accounts and the related permissions. Moreover, an LDAP database is easily replicated, which allows setting up multiple synchronized LDAP servers. When the network and the user base grows quickly, the load can then be balanced across several servers.
pt-BR: OpenLDAP é uma implementação do protocolo LDAP; em outras palavras, é um banco de dados com propósito especial desenvolvido para armazenar diretórios. No caso mais comum de uso, o uso de um servidor LDAP permite o gerenciamento centralizado de contas de usuários e permissões relacionadas. Além do mais, um banco de dados LDAP é facilmente replicável, o que permite configurar múltiplos servidores LDAP sincronizados. Quando a rede e a base de usuários cresce rapidamente, a carga pode então ser balanceada por entre vários servidores.

en: LDAP data is structured and hierarchical. The structure is defined by “schemas” which describe the kind of objects that the database can store, with a list of all their possible attributes. The syntax used to refer to a particular object in the database is based on this structure, which explains its complexity.
pt-BR: Os dados LDAP são estruturados e hierárquicos. A estrutura é definida por “schemas” que descrevem os tipos de objetos que o banco de dados pode armazenar, com uma lista de todos os seus possíveis atributos. A sintaxe usada para se referir a um objeto em particular no banco de dados é baseada em sua estrutura, o que explica sua complexidade.

en: The <emphasis role="pkg">slapd</emphasis> package contains the OpenLDAP server. The <emphasis role="pkg">ldap-utils</emphasis> package includes command-line tools for interacting with LDAP servers.
pt-BR: O pacote <emphasis role="pkg">slapd</emphasis> contém o servidor OpenLDAP. O pacote <emphasis role="pkg">ldap-utils</emphasis> inclui ferramentas de linha de comando para interação com os servidores LDAP.

en: Installing <emphasis role="pkg">slapd</emphasis> usually asks only for the administrator's password and the resulting database is unlikely to suit your needs. Fortunately a simple <command>dpkg-reconfigure slapd</command> will let you reconfigure the LDAP database with more details:
pt-BR: A instalação do <emphasis role="pkg">slapd</emphasis> geralmente requisita somente a senha do(a) administrador(a) e o banco de dados resultante provavelmente não atenderá suas necessidades. Felizmente, um simples <command>dpkg-reconfigure slapd</command> permitirá reconfigurar o banco de dados LDAP com mais detalhes:

en: Omit OpenLDAP server configuration? No, of course, we want to configure this service.
pt-BR: Omitir a configuração do servidor OpenLDAP? Não, claro que não, nós queremos configurar esse serviço.

en: DNS domain name: “<literal>falcot.com</literal>”.
pt-BR: DNS nome de domínio: “<literal>falcot.com</literal>”.

en: Organization name: “Falcot Corp”.
pt-BR: Nome da organização: “Falcot Corp”.

en: An administrative passwords needs to be typed in.
pt-BR: Senhas administrativas precisam ser digitadas.

en: Database backend to use: “MDB”.
pt-BR: Banco de dados para utilizar: "MDB".

en: Do you want the database to be removed when <emphasis role="pkg">slapd</emphasis> is purged? No. No point in risking losing the database in case of a mistake.
pt-BR: Você quer que o banco de dados seja removido quando o <emphasis role="pkg">slapd</emphasis> é removido (purged)? Não. Não faz sentido arriscar a perda do banco de dados em caso de um engano.

en: Move old database? This question is only asked when the configuration is attempted while a database already exists. Only answer “yes” if you actually want to start again from a clean database, for instance if you run <command>dpkg-reconfigure slapd</command> right after the initial installation.
pt-BR: Mover banco de dados antigo? Essa pergunta só é feita enquanto a configuração é feita e já existe um banco de dados. Só responda “sim” se você realmente querer iniciar a partir de um banco de dados limpo, por exemplo, se você rodar <command>dpkg-reconfigure slapd</command> logo após a instalação inicial.

en: <emphasis>BACK TO BASICS</emphasis> LDIF format
pt-BR: <emphasis>DE VOLTA AO BÁSICO</emphasis> Formato LDIF

en: An LDIF file (<emphasis>LDAP Data Interchange Format</emphasis>) is a portable text file describing the contents of an LDAP database (or a portion thereof); this can then be used to inject the data into any other LDAP server.
pt-BR: Um arquivo LDIF (<emphasis>formato de intercâmbios de dados LDAP</emphasis> - LDAP Data Interchange Format) é um arquivo de texto portável que descreve o conteúdo de uma base de dados LDAP (ou uma parte da mesma); pode ser utilizada para injetar dados em outro servidor LDAP.

en: A minimal database is now configured, as demonstrated by the following query:
pt-BR: Um base de dados miníma está configurada agora, como demonstrado pela seguinte consulta:

en: The query returned two objects: the organization itself, and the administrative user.
pt-BR: A consulta retornour dois objetos: a organização em si, e o usuário administrativo.

en: Filling in the Directory
pt-BR: Preenchendo o Diretório

en: Since an empty database is not particularly useful, we are going to inject into it all the existing directories; this includes the users, groups, services and hosts databases.
pt-BR: Como um banco de dados vazio não é particularmente útil, nós vamos injetar nele todos os diretórios existentes; isso inclui os banco de dados de usuários, grupos, serviços e máquinas.

en: The <emphasis role="pkg">migrationtools</emphasis> package provides a set of scripts dedicated to extract data from the standard Unix directories (<filename>/etc/passwd</filename>, <filename>/etc/group</filename>, <filename>/etc/services</filename>, <filename>/etc/hosts</filename> and so on), convert this data, and inject it into the LDAP database.
pt-BR: O pacote <emphasis role="pkg">migrationtools</emphasis> provê um conjunto de scripts dedicados a extrair dados a partir dos diretórios padrões do Unix (<filename>/etc/passwd</filename>, <filename>/etc/group</filename>, <filename>/etc/services</filename>, <filename>/etc/hosts</filename> e mais), converter seus dados, e injetá-los em um banco de dados LDAP.

en: Once the package is installed, the <filename>/etc/migrationtools/migrate_common.ph</filename> must be edited; the <varname>IGNORE_UID_BELOW</varname> and <varname>IGNORE_GID_BELOW</varname> options need to be enabled (uncommenting them is enough), and <varname>DEFAULT_MAIL_DOMAIN</varname>/<varname>DEFAULT_BASE</varname> need to be updated.
pt-BR: Uma vez que o pacote esteja instalado, o <filename>/etc/migrationtools/migrate_common.ph</filename> tem que ser editado; as opções <varname>IGNORE_UID_BELOW</varname> e <varname>IGNORE_GID_BELOW</varname> precisam ser habilitadas (descomentá-las é suficiente), e <varname>DEFAULT_MAIL_DOMAIN</varname>/<varname>DEFAULT_BASE</varname> precisa ser atualizada.

en: The actual migration operation is handled by the <command>migrate_all_online.sh</command> command, as follows:
pt-BR: A real operação de migração é feita pelo comando <command>migrate_all_online.sh</command>, como a seguir:

en: The <command>migrate_all_online.sh</command> asks a few questions about the LDAP database into which the data is to be migrated. <xref linkend="tab-migrate-all" xrefstyle="select: label nopage" /> summarizes the answers given in the Falcot use-case.
pt-BR: <command>migrate_all_online.sh</command> faz algumas perguntas sobre o banco de dados LDAP para o qual os dados serão migrados. <xref linkend="tab-migrate-all" xrefstyle="select: label nopage" /> resume as respostas dadas no caso da Falcot.

en: Answers to questions asked by the <command>migrate_all_online.sh</command> script
pt-BR: Responda as perguntas feitas pelo script <command>migrate_all_online.sh</command>

en: Question
pt-BR: Questão

en: Answer
pt-BR: Resposta

en: X.500 naming context
pt-BR: Contexto de nome X.500

en: LDAP server hostname
pt-BR: Nome do servidor LDAP

en: Manager DN
pt-BR: Gerenciando o DN

en: Bind credentials
pt-BR: Credenciais Bind

en: the administrative password
pt-BR: a senha administrativa

en: Create DUAConfigProfile
pt-BR: Criar DUAConfigProfile

en: no
pt-BR: não

en: <emphasis>TOOL</emphasis> Browsing an LDAP directory
pt-BR: <emphasis>FERRAMENTA</emphasis> Navegando em diretório LDAP

en: The <command>jxplorer</command> command (in the package of the same name) is a graphical tool allowing to browse and edit an LDAP database. It is an interesting tool that provides an administrator with a good overview of the hierarchical structure of the LDAP data.
pt-BR: O comando <command>jxplorer</command> (do pacote de mesmo nome) é uma ferramenta gráfica que permite navegar e editar um banco de dados LDAP. Ele é uma ferramenta interessante que provê ao administrador uma boa visualização da estrutura hierárquica dos dados LDAP.

en: Also note the use of the <literal>-c</literal> option to the <command>ldapadd</command> command; this option requests that processing doesn't stop in case of error. Using this option is required because converting the <filename>/etc/services</filename> often generates a few errors that can safely be ignored.
pt-BR: Note também o uso da opção <literal>-c</literal> do comando <command>ldapadd</command>; essa opção faz com que o processamento não pare em caso de erro. O uso dessa opção é necessário porque a conversão do <filename>/etc/services</filename> geralmente gera alguns erros que podem ser ignorados com segurança.

en: Managing Accounts with LDAP
pt-BR: Gerenciando Contas com LDAP

en: Now the LDAP database contains some useful information, the time has come to make use of this data. This section focuses on how to configure a Linux system so that the various system directories use the LDAP database.
pt-BR: Agora o banco de dados LDAP contém algumas informações úteis, chegou a hora de fazer uso desses dados. Essa sessão foca em como configurar um sistema Linux para que os vários sistemas de diretórios usem o banco de dados LDAP.

en: Configuring NSS
pt-BR: Configurando o NSS

en: The NSS system (Name Service Switch, see sidebar <xref linkend="sidebar.intro-nss" />) is a modular system designed to define or fetch information for system directories. Using LDAP as a source of data for NSS requires installing the <emphasis role="pkg">libnss-ldap</emphasis> package. Its installation asks a few questions; the answers are summarized in <xref linkend="tab-libnss-ldap" xrefstyle="select: label nopage" />.
pt-BR: O sistema NSS (Name Service Switch, see sidebar <xref linkend="sidebar.intro-nss" />) é um sistema modular desenvolvido para definir ou obter informações para o sistema de diretórios. Para usar o LDAP como fonte de dados para o NSS requer a instalação do pacote <emphasis role="pkg">libnss-ldap</emphasis>. Sua instalação faz algumas perguntas; as respostas estão resumidas em <xref linkend="tab-libnss-ldap" xrefstyle="select: label nopage" />.

en: Distinguished name of the search base
pt-BR: Nome distinto da base de pesquisa

en: LDAP version to use
pt-BR: Versão LDAP para usar

en: LDAP account for root
pt-BR: Conta LDAP para root

en: LDAP root account password
pt-BR: A senha da conta de root do LDAP

en: Allow LDAP admin account behave like local root?
pt-BR: Permitir que a conta administrativa do LDAP se comporte como root local?

en: <literal>yes</literal>
pt-BR: <literal>sim</literal>

en: Does the LDAP database require login?
pt-BR: O banco de dados LDAP precisa de um login?

en: The <filename>/etc/nsswitch.conf</filename> file then needs to be modified, so as to configure NSS to use the freshly-installed <command>ldap</command> module. You can use the example provided in <filename>/usr/share/doc/libnss-ldap/examples/nsswitch.ldap</filename> or edit your existing configuration.
pt-BR: O arquivo <filename>/etc/nsswitch.conf</filename> precisa então ser modificado para configurar o NSS para usar o recém-instalado módulo <command>ldap</command>. Você pode usar o exemplo fornecido em <filename>/usr/share/doc/libnss-ldap/examples/nsswitch.ldap</filename> ou editar sua configuração existente.

en: The <filename>/etc/nsswitch.conf</filename> file
pt-BR: O arquivo <filename>/etc/nsswitch.conf</filename>

en: The <command>ldap</command> module is usually inserted before others, and it will therefore be queried first. The notable exception is the <literal>hosts</literal> service since contacting the LDAP server requires consulting DNS first (to resolve <literal>ldap.falcot.com</literal>). Without this exception, a hostname query would try to ask the LDAP server; this would trigger a name resolution for the LDAP server, and so on in an infinite loop.
pt-BR: O módulo <command>ldap</command> usualmente é inserido antes dos outros, e ele irá então ser consultado primeiro. A notável exceção é o serviço <literal>hosts</literal> já que contactar o servidor LDAP requer consultar o DNS primeiro (para resolver <literal>ldap.falcot.com</literal>). Sem essa exceção, uma consulta de hostname iria recair ao servidor LDAP; isso iria disparar uma resolução de nome ao servidor LDAP, e cairia em um loop infinito.

en: If the LDAP server should be considered authoritative (and the local files used by the <command>files</command> module disregarded), services can be configured with the following syntax:
pt-BR: Se o servidor LDAP deve ser considerado autoritário (e os arquivos locais usados pelo módulo <command>files</command> desconsiderados), serviços podem ser configurados com a seguinte sintaxe:

en: <literal><replaceable>service</replaceable>: ldap [NOTFOUND=return] files</literal>.
pt-BR: <literal><replaceable>serviço</replaceable>: ldap [NOTFOUND=return] files</literal>.

en: If the requested entry does not exist in the LDAP database, the query will return a “not existing” reply even if the resource does exist in one of the local files; these local files will only be used when the LDAP service is down.
pt-BR: Se a entrada requisitada não existir no banco de dados LDAP, a consulta irá retornar uma resposta “não existe” mesmo que o recurso exista em um dos arquivos locais; esses arquivos locais irão apenas ser usados quando o serviço LDAP estiver parado.

en: Configuring PAM
pt-BR: Configurando o PAM

en: This section describes a PAM configuration (see sidebar <xref linkend="sidebar.intro-pam" />) that will allow applications to perform the required authentications against the LDAP database.
pt-BR: Essa seção descreve a configuração do PAM (see sidebar <xref linkend="sidebar.intro-pam" />) que irá permitir as aplicações realizarem as autenticações necessárias no banco de dados LDAP.

en: <emphasis>CAUTION</emphasis> Broken authentication
pt-BR: <emphasis>ATENÇÃO</emphasis> Autenticação quebrada

en: Changing the standard PAM configuration used by various programs is a sensitive operation. A mistake can lead to broken authentication, which could prevent logging in. Keeping a root shell open is therefore a good precaution. If configuration errors occur, they can be then fixed and the services restarted with minimal effort.
pt-BR: Alterar a configuração padrão do PAM usada por vários programas é uma operação delicada. Um erro pode levar a erros de autenticação, o que pode impedir um início de sessão. Manter um shell root aberto é então uma boa precaução. Se acontecerem erros de configuração, eles podem então ser consertados e os serviços reiniciados com um mínimo de esforço.

en: The LDAP module for PAM is provided by the <emphasis role="pkg">libpam-ldap</emphasis> package. Installing this package asks a few questions very similar to those in <emphasis role="pkg">libnss-ldap</emphasis>; some configuration parameters (such as the URI for the LDAP server) are even actually shared with the <emphasis role="pkg">libnss-ldap</emphasis> package. Answers are summarized in <xref linkend="tab-libpam-ldap" xrefstyle="select: label nopage" />.
pt-BR: O módulo LDAP para PAM é provido pelo pacote <emphasis role="pkg">libpam-ldap</emphasis>. A instalação deste pacote realiza umas poucas perguntas muito parecidas "aquelas no pacote <emphasis role="pkg">libnss-ldap</emphasis>; alguns parâmetros de configuração (como o URI do servidor LDAP) são inclusive compartilhados com o pacote <emphasis role="pkg">libnss-ldap</emphasis>. As respostas são resumidas em<xref linkend="tab-libpam-ldap" xrefstyle="select: label nopage" />.

en: Configuration of <emphasis>libpam-ldap</emphasis>
pt-BR: Configuração do <emphasis>libpam-ldap</emphasis>

en: Allow LDAP admin account to behave like local root?
pt-BR: Permitir a conta administrativa do LDAP se comportar como o root local?

en: Yes. This allows using the usual <command>passwd</command> command for changing passwords stored in the LDAP database.
pt-BR: Sim. Isto permite usar o comando usual <command>passwd</command> para modificar as senhas armazenadas no banco de dados LDAP.

en: Does the LDAP database require logging in?
pt-BR: O banco de dados LDAP necessita estar logado?

en: the LDAP database administrative password
pt-BR: A senha do banco de dados administrativo LDAP

en: Installing <emphasis role="pkg">libpam-ldap</emphasis> automatically adapts the default PAM configuration defined in the <filename>/etc/pam.d/common-auth</filename>, <filename>/etc/pam.d/common-password</filename> and <filename>/etc/pam.d/common-account</filename> files. This mechanism uses the dedicated <command>pam-auth-update</command> tool (provided by the <emphasis role="pkg">libpam-runtime</emphasis> package). This tool can also be run by the administrator should they wish to enable or disable PAM modules.
pt-BR: A instalação do <emphasis role="pkg">libpam-ldap</emphasis> automaticamente adapta a configuração padrão do PAM definida nos arquivos <filename>/etc/pam.d/common-auth</filename>, <filename>/etc/pam.d/common-password</filename> e <filename>/etc/pam.d/common-account</filename>. Esse mecanismo usa a ferramenta dedicada <command>pam-auth-update</command> (fornecida pelo pacote <emphasis role="pkg">libpam-runtime</emphasis>). Essa ferramenta pode também ser rodada pelo administrador caso ele queira habilitar ou desabilitar módulos PAM.

en: Securing LDAP Data Exchanges
pt-BR: Protegendo a Troca de Dados do LDAP

en: <primary>LDAP</primary><secondary>secure</secondary>
pt-BR: <primary>LDAP</primary><secondary>segurança</secondary>

en: By default, the LDAP protocol transits on the network as cleartext; this includes the (encrypted) passwords. Since the encrypted passwords can be extracted from the network, they can be vulnerable to dictionary-type attacks. This can be avoided by using an extra encryption layer; enabling this layer is the topic of this section.
pt-BR: Por padrão, o protocolo LDAP transita pela rede em texto puro; isso inclui as senhas (criptografadas). Como as senhas criptografadas podem ser extraídas da rede, elas pode ficar vulneráveis a ataques do tipo dicionário. Isso pode ser evitado usando um camada de criptografia extra; habilitar essa camada é o tópico desta seção.

en: Configuring the Server
pt-BR: Configurando o Servidor

en: <primary><foreignphrase>OpenSSL</foreignphrase></primary><secondary>creating keys</secondary>
pt-BR: <primary><foreignphrase>OpenSSL</foreignphrase></primary><secondary>criando chaves</secondary>

en: <primary>key pair</primary>
pt-BR: <primary>par de chaves</primary>

en: The first step is to create a key pair (comprising a public key and a private key) for the LDAP server. The Falcot administrators reuse <emphasis>easy-rsa</emphasis> to generate it (see <xref linkend="sect.easy-rsa" />). Running <command>./easyrsa build-server-full ldap.falcot.com nopass</command> will ask you about the “common name”. The answer to that question <emphasis>must</emphasis> be the fully-qualified hostname for the LDAP server; in our case, <literal>ldap.falcot.com</literal>.
pt-BR: O primeiro passo é criar um par de chaves (contendo uma chave pública e uma chave privada) para o servidor LDAP. Os(As) administradores(as) da Falcot usaram novamente <emphasis>easy-rsa</emphasis> para gerá-las (veja <xref linkend="sect.easy-rsa" />). Ao executar <command>./easyrsa build-server-full ldap.falcot.com nopass</command> você será perguntado(a) sobre um “common name” (nome comum). A resposta para a pergunta <emphasis>deve</emphasis> ser um nome de máquina completamente qualificado para o servidor LDAP; em nosso caso, <literal>ldap.falcot.com</literal>.

en: This command creates a certificate in the <filename>pki/issued/ldap.falcot.com.crt</filename> file; the corresponding private key is stored in <filename>pki/private/ldap.falcot.com.key</filename>.
pt-BR: Esse comando cria um certificado no arquivo <filename>pki/issued/ldap.falcot.com.crt</filename>; a chave privada correspondente é armazenada em <filename>pki/private/ldap.falcot.com.key</filename>.

en: Now these keys have to be installed in their standard location, and we must make sure that the private file is readable by the LDAP server which runs under the <literal>openldap</literal> user identity:
pt-BR: Agora essas chaves tem que ser instaladas em seu local padrão, e nós temos que garantir que o arquivo privado pode ser lido pelo servidor LDAP, o qual roda sob a identidade do usuário <literal>openldap</literal>:

en: The <command>slapd</command> daemon also needs to be told to use these keys for encryption. The LDAP server configuration is managed dynamically: the configuration can be updated with normal LDAP operations on the <literal>cn=config</literal> object hierarchy, and the server updates <filename>/etc/ldap/slapd.d</filename> in real time to make the configuration persistent. <command>ldapmodify</command> is thus the right tool to update the configuration:
pt-BR: O daemon <command>slapd</command> também precisa ser informado para usar essas chaves para criptografia. A configuração do servidor LDAP é gerenciada dinamicamente: a configuração pode ser atualizada através de operações normais do LDAP no objeto hierárquico <literal>cn=config</literal>, e o servidor atualiza o <filename>/etc/ldap/slapd.d</filename> em tempo real para fazer com que a configuração seja persistente. <command>ldapmodify</command> é, assim, a ferramenta certa para atualizar a configuração:

en: Configuring <command>slapd</command> for encryption
pt-BR: Configurando <command>slapd</command> para criptografia

en: <emphasis>TOOL</emphasis> <command>ldapvi</command> to edit an LDAP directory
pt-BR: <emphasis>FERRAMENTA</emphasis> <command>ldapvi</command> para editar um diretório LDAP

en: It is thus a convenient way to update the configuration of the LDAP server, simply by editing the <literal>cn=config</literal> hierarchy.
pt-BR: Esta é, portanto, uma maneira coveniente de atualizar a configuração do servidor LDAP, simplesmente editando a hierarquia <literal>cn=config</literal>.

en: The last step for enabling encryption involves changing the <varname>SLAPD_SERVICES</varname> variable in the <filename>/etc/default/slapd</filename> file. We'll play it safe and disable unsecured LDAP altogether.
pt-BR: O último passo para habilitar a criptografia envolve alterar a variável <varname>SLAPD_SERVICES</varname> no arquivo <filename>/etc/default/slapd</filename>. Nós vamos torná-lo seguro e desabilitar o LDAP inseguro de uma vez só.

en: The <filename>/etc/default/slapd</filename> file
pt-BR: O nome <filename>/etc/default/slapd</filename>

en: Configuring the Client
pt-BR: Configurando o Cliente

en: On the client side, the configuration for the <emphasis>libpam-ldap</emphasis> and <emphasis>libnss-ldap</emphasis> modules needs to be modified to use an <literal>ldaps://</literal> URI.
pt-BR: No lado do cliente, a configuração para os módulos <emphasis>libpam-ldap</emphasis> e <emphasis>libnss-ldap</emphasis> precisa ser modificada para usar a URI <literal>ldaps://</literal>.

en: Last but not least, the default LDAP URI and default base DN used by the various command line tools can be modified in <filename>/etc/ldap/ldap.conf</filename>. This will save quite some typing.
pt-BR: Por último, mas não menos importante, a URI padrão do LDAP e o DN base padrão usado por várias ferramentas de linha de comando podem ser modificados em <filename>/etc/ldap/ldap.conf</filename>. Isso irá evitar, consideravelmente, digitação.

en: The <filename>/etc/ldap/ldap.conf</filename> file
pt-BR: O arquivo <filename>/etc/ldap/ldap.conf</filename>

en: Real-Time Communication Services
pt-BR: Serviços de Comunicação em Tempo Real

en: Real-Time Communication (RTC) services include voice, video/webcam, instant messaging (IM) and desktop sharing. This chapter gives a brief introduction to three of the services required to operate RTC, including a TURN server, SIP server and XMPP server. Comprehensive details of how to plan, install and manage these services are available in the Real-Time Communications Quick Start Guide which includes examples specific to Debian. <ulink type="block" url="https://rtcquickstart.org" />
pt-BR: Serviços de Comunicação em Tempo Real (Real-Time Communication - RTC) incluem voz, vídeo/webcam, mensagem instantânea (IM) e compartilhamento de área de trabalho. Esse capítulo oferece uma breve introdução a três dos serviços necessários para operar um RTC, incluindo os servidores TURN, SIP e XMPP. Detalhes abrangentes de como planejar, instalar e gerenciar esses serviços estão disponíveis no Guia de Início Rápido para Comunicações em Tempo Real, que inclui exemplos específicos para o Debian. <ulink type="block" url="https://rtcquickstart.org" />

en: Both SIP and XMPP can provide the same functionality. SIP is slightly more well known for voice and video while XMPP is traditionally regarded as an IM protocol. In fact, they can both be used for any of these purposes. To maximize connectivity options, it is recommended to run both in parallel.
pt-BR: Tanto o SIP quanto o XMPP podem fornecer a mesma funcionalidade. O SIP é um pouco mais conhecido para voz e vídeo, enquanto que o XMPP é tradicionalmente considerado como um protocolo IM. Na verdade, os dois podem ser usados para qualquer um desses propósitos. Para maximizar as opções de conectividade, é recomendado rodar os dois em paralelo.

en: These services rely on X.509 certificates both for authentication and confidentiality purposes. See <xref linkend="sect.x509-cert" /> for more information.
pt-BR: Estes serviços contam com certificados X.509 para fins de autenticação e confidencialidade. Veja <xref linkend="sect.x509-cert" /> para mais informações.

en: DNS settings for RTC services
pt-BR: Configurações de DNS para serviços RTC

en: TURN Server
pt-BR: Servidor TURN

en: TURN is a service that helps clients behind NAT routers and firewalls to discover the most efficient way to communicate with other clients and to relay the media streams if no direct media path can be found. It is highly recommended that the TURN server is installed before any of the other RTC services are offered to end users.
pt-BR: TURN é um serviço que ajuda clientes atrás de roteadores NAT e firewalls a descobrir a maneira mais eficiente de comunicar com outros clientes e para retransmitir o fluxo de mídia caso nenhum caminho de mídia direto possa ser encontrado. É altamente recomendado que o servidor TURN seja instalado antes de outros serviços RTC serem oferecidos para os usuários finais.

en: <primary>TURN</primary><secondary>server</secondary>
pt-BR: <primary>TURN</primary><secondary>servidor</secondary>

en: TURN and the related ICE protocol are open standards. To benefit from these protocols, maximizing connectivity and minimizing user frustration, it is important to ensure that all client software supports ICE and TURN.
pt-BR: TURN e o protocolo ICE relacionado são padrões abertos. Para se beneficiar desses protocolos, maximizar a conectividade e minimizar a frustração do usuário, é importante garantir que todos os softwares clientes tenham suporte a ICE e TURN.

en: For the ICE algorithm to work effectively, the server must have two public IPv4 addresses.
pt-BR: Para que o algorítimo ICE funcione efetivamente, o servidor tem que ter dois endereços IPv4 públicos.

en: Install the <emphasis role="pkg">coturn</emphasis> package and edit the <filename>/etc/turnserver.conf</filename> configuration file. By default, a SQLite database is configured in <filename>/var/db/turndb</filename> for user account settings, but PostgreSQL, MySQL or Redis can be set up instead if preferred. The most important thing to do is insert the IP addresses of the server.
pt-BR: Instale o pacote <emphasis role="pkg">coturn</emphasis> e edite o arquivo de configuração <filename>/etc/turnserver.conf</filename>. Por padrão, um banco de dados SQLite é configurado em <filename>/var/db/turndb</filename> para definições das contas de usuários(as), mas pode-se configurar PostgreSQL, MySQL ou Redis se preferir. O mais importante a se fazer é inserir o endereço de IP do servidor.

en: By default, the TURN server uses anonymous access. We have to add the users we want to use:
pt-BR: Por padrão, o servidor TURN usa acesso anônimo. Temos que adicionar os(as) usuários(as) que queremos usar:

en: <computeroutput># </computeroutput><userinput>turnadmin -a -u roland -p <replaceable>secret_password</replaceable> -r falcot.com</userinput>
    <computeroutput># </computeroutput><userinput>turnadmin -A -u admin -p <replaceable>secret_password</replaceable></userinput>
pt-BR: <computeroutput># </computeroutput><userinput>turnadmin -a -u roland -p <replaceable>senha_secreta</replaceable> -r falcot.com</userinput>
    <computeroutput># </computeroutput><userinput>turnadmin -A -u admin -p <replaceable>senha_secreta</replaceable></userinput>

en: We use the argument <literal>-a</literal> to add a normal user and <literal>-A</literal> to add an admin user.
pt-BR: Usamos o argumento <literal>-a</literal> para adicionar um(a) usuário(a) normal e <literal>-A</literal> para adicionar um(a) usuário(a) administrador(a).

en: SIP Proxy Server
pt-BR: Servidor Proxy SIP

en: A SIP proxy server manages the incoming and outgoing SIP connections between other organizations, SIP trunking providers, SIP PBXes such as Asterisk, SIP phones, SIP-based softphones and WebRTC applications.
pt-BR: Um servidor proxy SIP gerencia entrada e saída de conexões SIP entre outras organizações, provedores de trunking SIP, PBXes SIP tais como Asterisk, telefones SIP, softphones baseados em SIP e aplicações WebRTC.

en: <primary>SIP</primary><secondary>server</secondary>
pt-BR: <primary>SIP</primary><secondary>servidor</secondary>

en: It is strongly recommended to install and configure the SIP proxy before attempting a SIP PBX setup. The SIP proxy normalizes a lot of the traffic reaching the PBX and provides greater connectivity and resilience.
pt-BR: É altamente recomendado instalar e configurar o proxy SIP antes de tentar uma configuração do PBX SIP. O proxy SIP normaliza muito do tráfego que atinge o PBX e fornece uma melhor conectividade e resiliência.

en: Install the SIP proxy
pt-BR: Instalar o proxy SIP

en: Now we focus on the configuration file <filename>/etc/kamailio/kamailio.cfg</filename>. Falcot needs user authentication and persistent user location, so they add the following <literal>#!define</literal> directives at the top of that file:
pt-BR: Agora vamos nos concentrar no arquivo de configuração <filename>/etc/kamailio/kamailio.cfg</filename>. A Falcot precisa de autenticação do usuário e localização persistente do usuário, então eles(elas) adicionaram as seguintes diretivas <literal>#!define</literal> no topo do arquivo:

en: XMPP Server
pt-BR: Servidor XMPP

en: An XMPP server manages connectivity between local XMPP users and XMPP users in other domains on the public Internet.
pt-BR: Um servidor XMPP gerencia a conectividade entre usuários XMPP locais e usuários XMPP em outros domínios na internet pública.

en: <emphasis>VOCABULARY</emphasis> XMPP or Jabber?
pt-BR: <emphasis>VOCABULÁRIO</emphasis> XMPP ou Jabber?

en: XMPP is sometimes referred to as Jabber. In fact, Jabber is a trademark and XMPP is the official name of the standard.
pt-BR: O XMPP é, algumas vezes, referenciado como Jabber. Na verdade, Jabber é uma marca registrada e XMPP é o nome oficial do padrão.

en: Install the XMPP server
pt-BR: Instalar o servidor XMPP

en: Install the <emphasis role="pkg">prosody</emphasis> package.
pt-BR: Instale o pacote <emphasis role="pkg">prosody</emphasis>.

en: Review the <filename>/etc/prosody/prosody.cfg.lua</filename> configuration file. The most important thing to do is insert JIDs of the users who are permitted to manage the server.
pt-BR: Reveja o arquivo de configuração <filename>/etc/prosody/prosody.cfg.lua</filename>. A coisa mais importante a fazer é inserir as JIDs dos usuários que tem permissão para gerenciar o servidor.

en: An individual configuration file is also needed for each domain. Copy the sample from <filename>/etc/prosody/conf.avail/example.com.cfg.lua</filename> and use it as a starting point. Here is <literal>falcot.com.cfg.lua</literal>:
pt-BR: Um arquivo de configuração individual também é necessário para cada domínio. Copie o exemplo de <filename>/etc/prosody/conf.avail/example.com.cfg.lua</filename> e use-o como ponto de partida. Aqui está o <literal>falcot.com.cfg.lua</literal>:

en: To enable the domain, there must be a symlink from <filename>/etc/prosody/conf.d/</filename>. Create it that way:
pt-BR: Para habilitar o domínio, tem que existir um symlink de <filename>/etc/prosody/conf.d/</filename>. Crie-o dessa forma:

en: Restart the service to use the new configuration.
pt-BR: Reinicie o serviço para usar a nova configuração.

en: Managing the XMPP server
pt-BR: Gerenciando o servidor XMPP

en: See the <ulink url="https://prosody.im/doc/configure"> Prosody online documentation</ulink> for more details about how to customize the configuration.
pt-BR: Veja a <ulink url="https://prosody.im/doc/configure"> documentação on-line do Prosody</ulink> para mais detalhes sobre como customizar a configuração.

en: Running services on port 443
pt-BR: Rodando serviços na porta 443

en: Some administrators prefer to run all of their RTC services on port 443. This helps users to connect from remote locations such as hotels and airports where other ports may be blocked or Internet traffic is routed through HTTP proxy servers.
pt-BR: Alguns administradores preferem rodar todos os serviços RTC na porta 443. Isso ajuda os usuários a se conectar a partir de localizações remotas, tais como hotéis e aeroportos, onde outras portas podem estar bloqueadas ou o tráfego de Internet é roteado através de servidores proxy HTTP.

en: To use this strategy, each service (SIP, XMPP and TURN) needs a different IP address. All the services can still be on the same host as Linux supports multiple IP addresses on a single host. The port number, 443, must be specified in the configuration files for each process and also in the DNS SRV records.
pt-BR: Para usar essa estratégia, cada serviço (SIP, XMPP e TURN) precisa de um endereço IP diferente. Todos os serviços ainda podem estar na mesma máquina, já que o Linux tem suporte a múltiplos endereços IP em uma única máquina. O número de porta, 443, tem que ser especificado nos arquivos de configuração de cada processo e também nos registros DNS SRV.

en: Adding WebRTC
pt-BR: Adicionando WebRTC

en: Falcot wants to let customers make phone calls directly from the web site. The Falcot administrators also want to use WebRTC as part of their disaster recovery plan, so staff can use web browsers at home to log in to the company phone system and work normally in an emergency.
pt-BR: A Falcot que deixar os clientes fazerem chamadas telefônicas a partir do site web. Os administradores da Falcot também querem usar o WebRTC como parte de seu plano de resgate em um disastre, para que a equipe possa usar navegadores web em casa para iniciar uma sessão no sistema de telefonia da companhia e trabalhar normalmente em uma emergência.

en: <emphasis>IN PRACTICE</emphasis> Try WebRTC
pt-BR: <emphasis>NA PRÁTICA</emphasis> Experimente o WebRTC

en: <primary>WebRTC</primary><secondary>demonstration</secondary>
pt-BR: <primary>WebRTC</primary><secondary>desmonstração</secondary>

en: WebRTC is a rapidly evolving technology and it is essential to use packages from the <emphasis role="distribution">Testing</emphasis> distribution. Another option is to compile the software.
pt-BR: O WebRTC é uma tecnologia de vem se desenvolvendo rapidamente e é essencial usar pacotes da distribuição <emphasis role="distribution">teste (testing)</emphasis> . Outra opção é compilar o software.

en: WebRTC uses a simple API to provide browsers and mobile applications with RTC, it is free software and it is being developed by Google. <ulink type="block" url="https://webrtc.org" />
pt-BR: O WebRTC usa uma API simples para fornecer navegadores e aplicativos móveis com RTC, é um software livre e está sendo desenvolvido pelo Google. <ulink type="block" url="https://webrtc.org" />

en: More advanced click-to-call web sites typically use server-side scripting to generate the <literal>config.js</literal> file dynamically. The <ulink url="https://www.drupal.org/project/drucall">DruCall</ulink> source code demonstrates how to do this with PHP.
pt-BR: Sites web clique-para-chamar mais avançados tipicamente usam scritps do lado do servidor para gerar o arquivo <literal>config.js</literal> dinamicamente. O código fonte <ulink url="https://www.drupal.org/project/drucall">DruCall</ulink>demonstra como fazer isso com PHP.

en: This chapter sampled only a fraction of the available server software; however, most of the common network services were described. Now it is time for an even more technical chapter: we'll go into deeper detail for some concepts, describe massive deployments and virtualization.
pt-BR: Esse capítulo mostrou apenas uma fração dos softwares de servidor disponíveis; contudo, a maioria dos serviços de rede comuns foram descritos. Agora é hora de um capítulo ainda mais técnico: nós iremos entrar mais detalhadamente ainda em alguns conceitos, descrevendo implementações massivas e virtualização.
