CONTEÚDO
- Visão Geral
- Configuração
- 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).
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
- Efetue a criação de um App do ERP Datasul no Identity
- 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;
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,
