...
- Visão Geral
- Configuração
- Exemplo de utilização
- Anexos
01. VISÃO GERAL
Esta documentação tem como objetivo demonstrar a configuração e exemplos de utilização do serviço de login para o Datasul Smart Services (DSS).
...
| 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
...
IDENTITY
Para efetuar a instalação do serviço de login, basta iniciar o o tratamento dos erros descritos anteriormente, é necessário efetuar algumas configurações no Apache Tomcat (versão 9.X):
- Localizar a instalação do Tomcat e editar o arquivo ../conf/server.xml
- Localizar a tag Host utilizada na inicialização do serviço e adicionar o atributo errorReportValveClass com o valor apresentado no exemplo abaixo:
- 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 |
|---|
| language | powershell |
|---|
| title | catalina.properties |
|---|
|
...
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
- Efetue a criação de um App do ERP Datasul no Identity
| Nota |
|---|
|
- No campo Assertion Consumer URL, informe a URL http://<SERVIDOR>:<PORTA>/dss-authe/idp/ACS, onde os campos <SERVIDOR> e <PORTA> deve corresponder ao servidor de aplicação Web parametrizado anteriormente
- Não é necessário configurar a aba Provisionar.
|
DATASUL
- Habilite a integração do Identity com o Datasul
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:
- Criar um diretório onde o serviço de autenticação será instalado (por exemplo,C:\Datasul\servico_auth), copiar os arquivos application.properties (que deve estar em dss-authe\src\main\resources) e dss-authe.jar (que deve estar em dss-authe\target);
OBS.: O nome do arquivo .jar deve obrigatoriamente ser dss-authe.jar, se necessário renomeie o nome deste arquivo;
- application.properties: Informar o appserver_url (endereço URL do AppServer ou PASOE, você pode encontrar essa informação no arquivo context.xml, dentro da pasta /conf da instalação do Tomcat);
- envprop_group (Opcional): Agrupador em que foi realizada as parametrizações do Identity no ERP Datasul;
- Dentro do diretório que você criou, crie uma sub-pasta chamada /cert e copie os certificados do Identity;
| 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 (estes arquivos estarão dentro da instalação do Tomcat). copie estes arquivos para o diretório /cert onde o serviço de autenticação foi instalado. |
- Edite o arquivo install.bat disponível em /dss-authe/src/bin/Windows, na linha 6 do arquivo modifique-o para que contenha o diretório onde foi instalado o serviço de autenticação (no exemplo da imagem, foi criado em C:\Datasul\servico_auth);
Image Added
- Depois de editar o arquivo install.bat, execute-o para fazer a instalação;
- Verificar se a variável de ambiente DSS_AUTHE_HOME (diretório base do serviço) foi gerada, caso negativo, efetue manualmente a geração;
- Alterar os arquivos para os diretórios de sua preferência.
- Inicie o serviço do spring boot, o nome do serviço deverá estar descrito como Datasul Smart Service - Authentication.
03. 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.
Posteriormente com o uso deste token as integrações com outros componentes são autorizadas de um modo mais simples e eficaz,
Image Added
...
