MANUAL DE CONFIGURAÇÃO ACTIVE DIRECTORY DFE V3

Transcrição

1 MANUAL DE CONFIGURAÇÃO ACTIVE DIRECTORY DFE V3

2 SUMÁRIO INTRODUÇÃO... 3 PRÉ-REQUISITO... 3 CONFIGURAÇÃO... 4 TOMCAT... 4 WEBLOGIC... 7 GLASSFISH... 8 MUDANÇAS DE VERSÕES DO MANUAL SUPORTE TÉCNICO

3 INTRODUÇÃO Este documento foi elaborado com o objetivo de orientar sobre o procedimento para ativar autenticação no MASTERSAF DFE através do Microsoft Active Directory. PRÉ-REQUISITO MASTERSAF DFE Instalado: Versão mínima Microsoft Active Directory configurado: homologado com Windows Server 2008 R2. 3

4 CONFIGURAÇÃO Para ativar a funcionalidade de autenticação com Active Directory no MASTERSAF DFE, será necessário realizar as seguintes configurações de acordo com o servidor de aplicação: TOMCAT No arquivo context.xml localizado no diretório (\tomcat\conf) de instalação do tomcat no portal MASTERSAF DFE: 1. Por padrão as linhas de configuração do Active Directory estarão em comentário (desativadas). Para ativá-las, remova a notação de comentário XML para que fique conforme: <Environment name="activeprofiles" override="false" type="java.lang.string" value="activedirectory"/> <Environment name="activedirectorydomain" override="false" type="java.lang.string" value="thomsonreuterstest.com"/> <Environment name="activedirectoryaddress" override="false" type="java.lang.string" value="ldap:// "/> <Environment name="activedirectorysearchfilter" override="false" type="java.lang.string" value="(&(objectclass=user)(userprincipalname={0}))"/> <Environment name="activedirectorysearchfilterwithuserdomain" override="false" type="java.lang.string" value="true"/> 4

5 2. Preencha os respectivos valores de configuração dentro do parâmetro value= de cada linha: NAME VALUE Domínio completo para autenticação. Exemplo: domain.com Para múltiplos domínios, informar os domínios separados por vírgula e espaço em branco. Exemplo: dominio1.com, dominio2.com A configuração deste parâmetro é opcional, sendo que: Se configurado, no momento do login poderá ser informado apenas o código do usuário AD sem domínio. Exemplo: user activedirectorydomain Se não configurado, no momento do login deverá ser informado código do usuário AD mais o domínio. Exemplo: user@domain.com 5

6 Endereço IP do servidor Active Directory. Deve ser preenchido no padrão: ldap://ip Exemplo: ldap:// Para múltiplos servidores Active Directory, preencher com vírgula e espaço em branco entre cada padrão. Exemplo: ldap:// , ldap:// activedirectoryaddress Para acesso SSL com servidor Active Directory, preencher com o padrão: ldaps://ip Exemplo: ldaps:// activedirectorysearchfilter activedirectorysearchfilter WithUserDomain Quando preenchido no padrão ldap://ip, a porta de conexão default é a 389, e para o padrão ldaps://ip a porta default é a 636. Para outra porta de acesso, a mesma deve ser preenchida em conjunto com o IP. Exemplo: ldap:// :222 Usado para definir qual será o atributo usado na consulta ao servidor AD. Exemplos: "(&(objectclass=user)(userprincipalname={0}))" "(&(objectclass=user)(samaccountname={0}))" Define se o domínio será utilizado na consulta ao AD. Caso esteja configurado com a opção true, o Sistema irá concatenar o domínio ao usuário de rede, fornecido pelo usuário durante o cadastro no sistema. Exemplo de arquivo context.xml configurado para Active Directory: Para desativar a função de autenticação com o Active Directory, será necessário adicionar a notação de comentário XML no arquivo context.xml nas linhas de configuração do Active Directory, conforme abaixo e reiniciar o serviço do tomcat. 6

7 Exemplo de arquivo context.xml configurado para Active Directory utilizando dois domínios: WEBLOGIC 1. A configuração de autenticação WebLogic 12c e Microsoft Active Directory deve ser realizada via inclusão ou edição da variável de ambiente JAVA_OPTIONS, conforme abaixo: Contendo os parâmetros: -DactiveProfiles=activeDirectory -DactiveDirectoryDomain=dominio.empresa.com -DactiveDirectoryAddress="ldap:// " -DactiveDirectorySearchFilter="(&(objectClass=user)(userPrincipalName={0}))" -DactiveDirectorySearchFilterWithUserDomain=true 2. Preencha os respectivos valores de configuração dentro do parâmetro value= de cada linha: Obs.: Mesma regra apresentada no item 2, quadro configuração de parâmetros, do TOMCAT. *Obs.: Para servidores WebLogic 12c e múltiplos domínios Ldap, configurar a variável de ambiente com aspas e vírgula entre os endereços. (Ex. -DactiveDirectoryAddress= ldap:// , ldap:// , ldap:// ) Exemplo da variável de ambiente para Active Directory: 7

8 -DactiveProfiles=activeDirectory -DactiveDirectoryDomain= dominio.empresa.com -DactiveDirectoryAddress="ldap:// " -DactiveDirectorySearchFilter="(&(objectClass=user)(userPrincipalName={0}))" -DactiveDirectorySearchFilterWithUserDomain=true Para desativar a função de autenticação com o Active Directory, basta remover a variável de ambiente JAVA_OPTIONS. GLASSFISH 1. A configuração de autenticação Glassfish v3 e Microsoft Active Directory deve ser realizada via inclusão ou edição da variável de ambiente JAVA_TOOL_OPTIONS, conforme abaixo: Contendo os parâmetros: -DactiveProfiles=activeDirectory -DactiveDirectoryDomain=dominio.empresa.com -DactiveDirectoryAddress="ldap:// " -DactiveDirectorySearchFilter="(&(objectClass=user)(userPrincipalName={0}))" -DactiveDirectorySearchFilterWithUserDomain=true 8

9 2. Preencha os respectivos valores de configuração dentro do parâmetro value= de cada linha: Obs.: Mesma regra apresentada no item 2, quadro configuração de parâmetros, do TOMCAT. *Obs.: Para servidores Glassfish v3 e múltiplos domínios Ldap, configurar a variável de ambiente com aspas e vírgula entre os endereços. (Ex. -DactiveDirectoryAddress= ldap:// , ldap:// , ldap:// ) Exemplo da variável de ambiente para Active Directory: -DactiveProfiles=activeDirectory -DactiveDirectoryDomain=dominio.empresa.com -DactiveDirectoryAddress="ldap:// " -DactiveDirectorySearchFilter="(&(objectClass=user)(userPrincipalName={0}))" -DactiveDirectorySearchFilterWithUserDomain=true Para desativar a função de autenticação com o Microsoft Active Directory, basta remover a variável de ambiente JAVA_TOOL_OPTIONS. IMPORTANTE Nota 1: A integração do MATERSAF DFE com Microsoft Active Directory está homologada somente para servidor de aplicação Tomcat, Weblogic 12c e Glassfish v3. Solicite a homologação desta integração para outro servidor de aplicação através de um chamado. Nota 2: Para informações funcionais sobre a integração do MASTERSAF DFE com Microsoft Active Directory favor consultar Manual Operacional Active Directory. 9

10 MUDANÇAS DE VERSÕES DO MANUAL VERSÃO DATA MUDANÇAS VERSÃO DFE /08/2012 Criação do manual baseado em MASTERSAF DFE Homologação de MATERSAF DFE com Microsoft Active Directory - e servidor de aplicação TOMCAT /05/2016 Nova configuração Homologação: 1. MATERSAF DFE com Microsoft Active Directory e servidor de aplicação WebLogic 12c. Item WEBLOGIC MATERSAF DFE com Microsoft Active Directory e servidor de aplicação Glassfish v3. Item GLASSFISH. 3 25/10/2016 Novos parâmetros de configuração para integração MATERSAF DFE com Microsoft Active Directory: 1. Servidor de aplicação TOMCAT. Item TOMCAT Servidor de aplicação WebLogic 12c. Item WEBLOGIC. 3. Servidor de aplicação Glassfish v3. Item GLASSFISH. 4 26/09/2017 Configurar mais de um domínio AD simultaneamente

11 SUPORTE TÉCNICO Para dúvidas ou problemas, abra um chamado no Contact Center ou entre em contato com nossa equipe de Suporte Técnico MASTERSAF pelo Telefone: (11) opção 2 (Atendimento das Soluções DFE). Nosso horário de atendimento é de segunda à sexta-feira de 09h às 18h. 11