Linha Datasul

Árvore de páginas

CONTEÚDO

  1. Visão Geral
  2. Configuração
  3. Exemplo de utilização

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

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

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);


  • 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. 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,