Realizar atualizações periódicas dos usuários PIMS com o status existente no servidor de domínio da empresa, mas também permitir que tenhamos canais de integração onde outras aplicações ERP possam acionar o PIMS e realizar as atualizações de status em tempo real para garantir que as políticas de segurança sejam aplicadas de forma imediata.
Nessa integração tem o objetivo de um ERP específico faça a chamada para que um específico usuário seja inativado dentro do PIMS seguindo as regras de verificação dentro do Servidor AD.
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).
O que levou a criação da integração foi a necessidade e facilidade do cliente para inativar um usuário dentro do PIMS.
Na interface de Inativação de usuários estaremos realizando um check adicional para garantir a inativação do usuário apenas quando o mesmo já estiver inativo no AD ou ERP.
Após receber o código do usuário deveremos verificar se o mesmo existe no cadastro Pims, levando em consideração o método de autenticação de usuário simples ou extendido.
Com a validação de existência no cadastro de usuário deveremos passar a verificar se o seu status atual no AD ou ERP esta como inativo, se ocorrer de estar ativo então deveremos retornar mensagem para a interface e não executar a inativação.
No caso do usuário já estar inativo no AD ou ERP então prosseguiremos com a Rotina de Inativação enviando o usuário e o código de Origem 2.
Interface de Integração de Inativação do Usuário
Rotina de Inativação de Usuário
Bibliotecas a serem adicionadas:
Caso esteja utilizando o gerenciador de dependências Maven, adicione as seguintes linhas no pom.xml:
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.2.4</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.1</version>
</dependency>
Para todos os serviços, deve-se usar o seguinte cabeçalho de requisição HTTP:
Content-Type: application/json; charset=utf-8
usuario: usuárioPIMSautorizado
senha: SenhaDoUsuário
idioma: pt_BR
instancia: instanciaDoUsuário
Ativar Usuário
Tipo do Método: PUT
URI: GUtilitRest/rest/integracao/GUtilitRest/InativaUsuario
Dados necessários no formato JSON:
{
"usuario": "strUsuarioParaAtivar"
}
Objeto de Banco: GUTILITWEB.WEBSERVICE.desativarUsuario
Retorno do Serviço: TRUE ou FALSE
1. Sistemas operacionais
Exige-se, no mínimo, Windows XP SP3, sendo possível realizar a instalação em servidores com Windows 2003 Server, Windows 2008 Server ou ainda Windows 7. O sistema operacional também deve ser 64 bits.
2. JDK - Java Development Kit
a. Versões do JDK suportadas pelo PIMS Web
Para a instalação do PIMS Web, a SDK Java é exigida. Deve-se utilizar a versão 6, mais atualizada.
b. Obtenção do Software
O software JDK está disponível para diversos sistemas operacionais e plataformas (32 bits e 64 bits). A versão mais recente (atualizada) do software pode ser obtida através das seguintes fontes:
Download direto do site da Oracle:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
Obtenção através do FTP disponibilizado pela TOTVS. Neste caso é necessário entrar em contato com o suporte para obter os dados de acesso.
c. Requisitos de espaço em disco
No mínimo 300MB devem estar disponíveis no disco de instalação. Porém, recomenda-se 500MB durante a instalação.
http://www.oracle.com/technetwork/java/javase/windows-diskspace-140460.html
3. Servidor de Aplicações JBoss 6.1
a. Versões do JBoss suportadas pelo PIMS Web
Para a implantação do PIMS Web, a instalação de um Servidor de Aplicações é exigida. O único servidor de aplicações homologado para a execução do PIMS Web, atualmente é o JBoss Application Server, em sua versão 6.1.0.
b. Obtenção do Software
O software JBoss AS é open-source e multiplataforma, o que significa que seu instalador pode ser utilizado para diversos sistemas operacionais e plataformas (32 bits e 64 bits) que suportem a plataforma Java.
Apesar de estar gratuitamente disponível para download no site do fornecedor, obtenção do instalador do JBoss para o PIMS Web Agrícola deve ser feita através do FTP disponibilizado pela TOTVS, pois o mesmo já estará pré-configurado com as bibliotecas necessárias para o funcionamento do PIMS Web.
Portanto, para a obtenção do instalador, é necessário entrar em contato com o suporte da TOTVS para obter os dados de acesso ao FTP.
c. Requisitos de espaço em disco
Para a instalação do JBoss AS 6.1.0, no mínimo 15GB devem estar disponíveis no disco de instalação.
d. Concorrência de outros serviços Java
Há casos em que o servidor destinado à instalação do aplicativo já possui outras aplicações Java instaladas, como aplicações desktop (standalone) ou servidoras.
Quando este for o caso, a equipe técnica da TOTVS deverá ser notificada com a descrição de tais aplicativos/serviços, afim de que se possam prever possíveis conflitos na instalação.
Recursos de Hardware
4. Plataforma
O hardware utilizado para a instalação do PIMS Web deve ser uma máquina dedicada e possuir uma arquitetura de 64 bits, devido à possibilidade de aumento de memória e melhor desempenho.
5. Memória RAM
8GB disponíveis (por disponível entenda a quantidade de memória livre, além daquela já utilizada pelo sistema operacional e outros aplicativos; não se trata da quantidade total de memória da máquina).
6. Processador
Dual Core 2.0 GHZ ou XEON 2.0 GHZ
7. Espaço em Disco
30GB (o espaço em disco total leva em conta os espaços requeridos pelo SDK Java, pelo Servidor de aplicações JBoss 6.1, o tamanho da aplicação e espaço para armazenamento de logs da aplicação. O armazenamento necessário para o banco de dados do cliente deve ser considerado à parte).
ATENÇÃO: Estes valores são uma referência de configuração mínima, e podem sofrer alterações de acordo com as necessidades do contexto do cliente. Qualquer alteração nas recomendações, para mais ou para menos, deverão ser analisadas pela equipe técnica da TOTVS.
O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
Observação: Este modelo de suporte está sendo revisado pela TOTVS.
ERP solicita via HTTP/Rest a Inativação de usuário e espera o retorno do Web Service em Síncrono.
Método | ID | Descrição | Origem | Destino | HTTP |
Processo | 01 | Inativar Usuário | ERP | PIMS | GUtilitRest/rest/integracao/GUtilitRest/InativaUsuario |
