Cod para autenticação do OTRS em um AD Windows Server 2008 ou 2012 (testado e aprovado)

Documento: Autenticação do OTRS 3.3.3 (Sistemas de chamados Free) em AD

Objetivo: Autenticação com AD Windows Server 2008 e 2012

Organização: Conectividade / compatibilidade / comunicação

Autor: Eduardo Popovici

*******************************************************************************

SORTEIO DO LIVRO

Falando sobre Hardware

NÃO PRECISA COMPRAR NADA, É SÓ PARTICIPAR

Amigos, vou sortear meu ultimo livro pelo sorteie.me no Facebook. Quem quiser participar ai esta o link da promoção. Pode acessar a área de promoções da página da HTBRAZ no Facebook ou clicar no link abaixo.

Sorteio:
https://www.facebook.com/htbraz?sk=app_154246121296652&app_data=%7B%22id%22%3A369625%7D

O sorteio será no final deste ano... obrigado a todos e sucesso.

Lembre-se de seguir as regras para validar o sorteio do livro.

*******************************************************************************

Depois de instalar e configurar o OTRS, crie um atalho nas maquinas de seus usuários para que seja possível abrir o Customer Portal de modo fácil. Veja como fazer clicando aqui.

*******************************************************************************

Baixe o MySql 5.5.34 aqui

*******************************************************************************

Instale o servidor de chat. Tutorial aqui

*******************************************************************************

OTRS é um sistema de chamados Free (open), e cheio de recursos porém como todo bom sistema open, é preciso carinho e muita dedicação para a configuração dos módulos e detalhes disponíveis. Pode ser uma verdadeira batalha aos navegantes de primeira viagem deixar o sistema com uma performance no mínimo aceitável, mas vamos deixar esse assunto para outro post. Nesta postagem vou mostrar como configurar a autenticação com o AD através de LDAP.

É importante lembrar que você deve ter a porta UDP 389 aberta no Firewall (porta do LDAP).

Utilizado

• Sistema operácional Windows 7, 8, 2008 e 2012 (sim fiz teste e instalação em todos eles e funcionou perfeitamente)
• Banco de dados: MySql
• AD: Windows Server 2012
• Quantidade de objetos no AD: 800
• Nível funcional da floresta: Windows Server 2008
• Hardware: Servidor HP DL320e 
• Servidor de e-mail´s Exchange 2007

Vantagens: 

• Todo o catálogo de usuários do AD pode ser utilizada
• Vida mais próxima do single-sing-on (login único)

Desvantagem:

• ADs muito grandes com muitos usuários deixam o sistema incrivelmente lento e pode ser necessário uma customização bem dispendiosa.
• Se o usuário da pessoa for bloqueado na rede, não será possível efetuar a abertura de chamados pela configuração padrão.

Importante (portais):

• Server/otrs/customer.pl --> Este é o portal do usuário para a abertura de chamados
• Server/otrs/index.pl --> Este é o portal de administração e da equipe de suporte

Mão na massa:

Bom vamos colocar a mão na massa. Acesse o caminho C:\otrs\OTRS\Kernel e faça uma cópia do arquivo Config.pm. Coloque como Config.pmOld pois pode ser necessário em algum momento retornar a configuração (principalmente se deletar alguma linha do script e não souber desfazer).

Use o bloco de notas para isso editar o arquivo Config.pm e digite o script abaixo. Lembrando que o sinal de # é utilizado para comentário. Deixei bem esmiuçado abaixo, e recomendo que mantenha algo parecido, pois quem fizer a manutenção do sistema precisa saber do que se trata a configuração.

############## Inicio do Script de configuração  Config.pm ##############

# --
# Kernel/Config.pm - Config file for OTRS kernel
# Copyright (C) 2001-2013 OTRS AG, http://otrs.org/
# --
# This software comes with ABSOLUTELY NO WARRANTY. For details, see
# the enclosed file COPYING for license information (AGPL). If you
# did not receive this file, see http://www.gnu.org/licenses/agpl.txt.
# --
#  Note:
#
#  -->> Most OTRS configuration should be done via the OTRS web interface
#       and the SysConfig. Only for some configuration, such as database
#       credentials and customer data source changes, you should edit this
#       file. For changes do customer data sources you can copy the definitions
#       from Kernel/Config/Defaults.pm and paste them in this file.
#       Config.pm will not be overwritten when updating OTRS.
# --

package Kernel::Config;

use strict;
use warnings;
use utf8;

sub Load {
    my $Self = shift;

    # ---------------------------------------------------- #
    # database settings                                    #
    # ---------------------------------------------------- #

    # Coloque aqui o servidor ou endereço do servidor de base de dados
    $Self->{'DatabaseHost'} = 'MySqlServer';

    # Coloque aqui o nome da base de dados
    $Self->{'Database'} = "DataBase";

    # Coloque aqui o usuário da base de dados
    $Self->{'DatabaseUser'} = "UserDatabase";

    # Coloque aqui a senha da base de dados. You also can use bin/otrs.CryptPassword.pl
    # for crypted passwords
    $Self->{'DatabasePw'} = 'senha do banco de dados';

    # The database DSN for MySQL ==> more: "perldoc DBD::mysql"
    $Self->{'DatabaseDSN'} = "DBI:mysql:database=$Self->{Database};host=$Self->{DatabaseHost}";

    # The database DSN for PostgreSQL ==> more: "perldoc DBD::Pg"
    # if you want to use a local socket connection
#    $Self->{DatabaseDSN} = "DBI:Pg:dbname=$Self->{Database};";
    # if you want to use a TCP/IP connection
#    $Self->{DatabaseDSN} = "DBI:Pg:dbname=$Self->{Database};host=$Self->{DatabaseHost};";
    # if you have PostgresSQL 8.1 or earlier, activate the legacy driver with this line:
#    $Self->{DatabasePostgresqlBefore82} = 1;

    # The database DSN for Microsoft SQL Server - only supported if OTRS is
    # installed on Windows as well
#    $Self->{DatabaseDSN} = "DBI:ODBC:driver={SQL Server};Database=$Self->{Database};Server=$Self->{DatabaseHost},1433";

    # The database DSN for Oracle ==> more: "perldoc DBD::oracle"
#    $ENV{ORACLE_HOME} = '/u01/app/oracle/product/10.2.0/client_1';
#    $ENV{NLS_DATE_FORMAT} = 'YYYY-MM-DD HH24:MI:SS';
#    $ENV{NLS_LANG} = "american_america.utf8";

#    $Self->{DatabaseDSN} = "DBI:Oracle:sid=OTRS;host=$Self->{DatabaseHost};port=1522;";

    # ---------------------------------------------------- #
    # fs root directory
    # ---------------------------------------------------- #
    $Self->{Home} = 'C:/otrs/OTRS';

    # ---------------------------------------------------- #
    # insert your own config settings "here"               #
    # config settings taken from Kernel/Config/Defaults.pm #
    # ---------------------------------------------------- #
    # $Self->{SessionUseCookie} = 0;
    # $Self->{CheckMXRecord} = 0;

    # ---------------------------------------------------- #

    # ---------------------------------------------------- #
    # data inserted by installer                           #
    # ---------------------------------------------------- #

    $Self->{'LogModule'}          = 'Kernel::System::Log::File';
    $Self->{'LogModule::LogFile'} = 'C:/otrs/OTRS/var/log/otrs.log';
    # $DIBI$

############# Inicio do código #############
# ---------------------------------------------------- #
# Integração do AD com sistema de chamados OTRS
# Desenvolvedor: Eduardo Popovici
# Data: 03/01/2014
# ---------------------------------------------------- #

$Self->{'AuthModule'} = 'Kernel::System::Auth::LDAP';
# Coloque nesta linha o nome de seu DC totalmente qualifica (FQDN) ou o IP do servidor de AD. Você também pode colocar o IP do servidor para cara entrada LDAP para Host
$Self->{'AuthModule::LDAP::Host'} = 'servidor.dominio.local';

#Coloque nesta linha a OU aonde estão todos os usuários
$Self->{'AuthModule::LDAP::BaseDN'} = 'DC=dominio,DC=local';
$Self->{'AuthModule::LDAP::UID'} = 'sAMAccountName';

#Aqui você deve informar o caminho do usuário p/ permitir a leitura da base de usuários do AD
$Self->{'AuthModule::LDAP::SearchUserDN'} = 'CN=usuario,CN=Users,DC=dominio,DC=local';

# Aqui você informa a senha que cadastrou para este usuario
$Self->{'AuthModule::LDAP::SearchUserPw'} = 'SenhaDoUsuario';
$Self->{'Customer::AuthModule'} = 'Kernel::System::CustomerAuth::LDAP';

# Aqui você coloca o nome de seu DC totalmente qualifica (FQDN)
$Self->{'Customer::AuthModule::LDAP::Host'} = 'dominio.local';

#Aqui você informa o OU aonde estão todos os usuários
$Self->{'Customer::AuthModule::LDAP::BaseDN'} = 'DC=dominio,DC=local';
$Self->{'Customer::AuthModule::LDAP::UID'} = 'sAMAccountName';

#Aqui você deve informar o caminho do usuário p/ permitir a leitura da base de usuários do AD
$Self->{'Customer::AuthModule::LDAP::SearchUserDN'} = 'CN=usuario,CN=Users,DC=dominio,DC=local';

# Aqui você informa a senha que cadastrou para este usuário
$Self->{'Customer::AuthModule::LDAP::SearchUserPw'} = 'senha';
$Self->{CustomerUser} = { Module => 'Kernel::System::CustomerUser::LDAP',

# Aqui você coloca o nome de seu DC totalmente qualifica (FQDN)
Params => { Host => 'dominio.local',

#Aqui você informa o OU aonde estão os usuários
BaseDN => 'DC=dominio,DC=local',
SSCOPE => 'sub',

##Aqui você deve informar o caminho do usuário p/ permitir a leitura da base de usuários do AD
UserDN => 'CN=usuario,CN=Users,DC=dominio,DC=local',

# Aqui você informa a senha que cadastrou para este usuário
UserPw => 'senha',
},

CustomerKey => 'sAMAccountName',
CustomerID => 'mail',
CustomerUserListFields => ['sAMAccountName', 'cn', 'mail'],
CustomerUserSearchFields => ['sAMAccountName', 'cn', 'mail'],
CustomerUserPostMasterSearchFields => 'mail',
CustomerUserNameFields => ['givenname', 'sn'],

Map => [
# note: Login, Email and CustomerID needed!
# var, frontend, storage, shown, required, storage-type
# [ 'UserSalutation', 'Title', 'title', 1, 0, 'var' ],

[ 'UserFirstname', 'Firstname', 'givenname', 1, 1, 'var' ],
[ 'UserLastname', 'Lastname', 'sn', 1, 1, 'var' ],
[ 'UserLogin', 'Login', 'sAMAccountName', 1, 1, 'var' ],
[ 'UserEmail', 'Email', 'mail', 1, 1, 'var' ],
[ 'UserCustomerID', 'CustomerID', 'mail', 0, 1, 'var' ],

# [ 'UserPhone', 'Phone', 'telephonenumber', 1, 0, 'var' ],
# [ 'UserAddress', 'Address', 'postaladdress', 1, 0, 'var' ],
# [ 'UserComment', 'Comment', 'description', 1, 0, 'var' ],
],
};
############## Fim do código de autenticação do AD ##############

    # ---------------------------------------------------- #
    # ---------------------------------------------------- #
    #                                                      #
    # end of your own config options!!!                    #
    #                                                      #
    # ---------------------------------------------------- #
    # ---------------------------------------------------- #
}

# ---------------------------------------------------- #
# needed system stuff (don't edit this)                #
# ---------------------------------------------------- #

use base qw(Kernel::Config::Defaults);

# -----------------------------------------------------#

1;

############## Fim do Script de configuração  Config.pm ##############