Histórico da Página
...
| Aviso | ||
|---|---|---|
| ||
O serviço de autenticação efetua somente a validação do usuário. Integrações com o ERP Datasul serão contempladas em outros componentes (autorizações). |
02. CONFIGURAÇÃO
TOMCAT
Para efetuar a instalação do serviço de login, é necessário configurar um servidor de aplicação Web, no exemplo abaixo é considerado o Apache Tomcat (versão 9.X):
- Efetuar o download do arquivo dss-authe.war e suas respectivas bibliotecas;
- Localizar a instalação do Tomcat e editar o arquivo ../conf/catalina.properties;
- Inserir o diretório ${catalina.home}/lib/datasul-lib/*.jar nas definições de common.loader. Inserir este mesmo valor em server.loader e shared.loader caso exista algum diretório configurado ;
| Bloco de código | ||||
|---|---|---|---|---|
| ||||
...
common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/lib/datasul-lib/*.jar"
... |
- Criar o diretório datasul-lib em ../lib e copiar as bibliotecas;
- Iniciar o Tomcat.
IDENTITY
- Efetue a criação de um App do ERP Datasul no Identity
- Consulte o link: https://tdn.totvs.com.br/pages/releaseview.action?pageId=185759323 para mais informações de como criar um App para o Datasul
...
- Habilite a integração do Identity com o Datasul
- Consulte os links: https://tdn.totvs.com/pages/releaseview.action?pageId=73892526 e https://tdn.totvs.com/pages/releaseview.action?pageId=268818355 para mais detalhes de parametrizações
SPRING BOOT
Para efetuar a instalação do serviço de login, com base em um diretório que foi copiado os arquivos, deve-se configurar:
- application.properties; Informar o appserver_url (endereço URL do AppServer ou PASOE);
- envprop_group (Opcional): Agrupador em que foi realizada as parametrizações do Identity no ERP Datasul;
- Criar um diretório onde o serviço de autenticação será instalado, copiar os arquivos application.properties, dss-authe.jar;
- Criar um sub-diretório cert e copiar os certificados do Identity;
- Instalar o serviço (disponível no diretório bin);
- Iniciar o serviço do spring boot.
| Dica | ||
|---|---|---|
| ||
Os certificados do Identity são gerados automaticamente após a parametrização do ERP Datasul com o Identity. Após salvar as propriedades, será gerado dois arquivos: datasul.cert e datasul.pk8, copie estes arquivos para o diretório /cert onde o serviço de autenticação foi instalado. |
03. EXEMPLO DE UTILIZAÇÃO
Após efetuada as configurações, caso o login seja realizado com sucesso, um token JWT (gerado pelo Datasul) será exibido.
...