Histórico da Página

...

1. Visão Geral
2. Pré-requisitos
3. Configurações
   1. Configuração de autenticação WebService SOAP
   2. Configuração

...

1. 1. de autenticação API REST
2. Gerenciamento das credenciais

...

Âncora
geral geral

01. Visão geral

Este documento tem como objetivo apresentar como realizar a configuração da utilização do Token de autenticação do produto TSS. O fluxo de autenticação necessita de credenciais criada pelo TSS, por padrão, caso não tenha nenhuma credencial criada é gerada automaticamenteo gerenciamento das credenciais geradas pelo TSS, com intuito de efetuar a autenticação das requisições recebidas do ERP, assim contemplando a LGPD (Lei Geral de Proteção de Dados).

...

Obs.: A autenticação WS SOAP estará disponível a partir do Release 12.1.X, a partir de 01/01/2021.

...

33 e autenticação REST Server estará disponível a partir da Release 12.1.2410.

Âncora
pre_requisitos pre_requisitos

02. Pré-requisitos

1 - Seu ERP deve ser compatível com a utilização de autenticação do Token do TSS. Deverá entrar em contato com o suporte de seu ERP, para verificar se já foi implementado em qual Release foi implementada essa melhoria.

...

2 - Atualizar o seu TSS com os pacotes de expedição contínua:

A funcionalidade somente estará disponível, a partir da data 01/01/2021.

Segue o link para download do instalador do TSS 12.1.

...

Verificar se poderá colocar os release anteriores:

...

33:

Link do instalador Windows

Link do instalador Linux

Âncora
configuracao configuracao

03. Configuração

a. Configuração de autenticação WebService SOAP

Âncora
soap soap

Caso seja executado a instalação do TSS 12.1.33, não há necessidade de realizar os processos abaixo.

Para realizar a configuração da autenticação do TSS, basta seguir o passo a passo abaixo

...

12.1.27: https://suporte.totvs.com/portal/p/10098/download?e=955332

...

:

1 - Criar a

...

configuração TSSSECURITY

...

 na seção JOB_WS.

Esta configuração é habilitada por padrão.

Exemplo:

Image Modified

1 = Ativado

0 = Desativado

2 - Ajustar a configuração ONCONNECT na seção JOB_WS.

Exemplo:

Image Modified

...

b. Configuração de autenticação API REST

Âncora
rest rest

Caso seja executado a instalação do TSS 12.1.2410 ou superior, não há necessidade de realizar os processos abaixo.

Para realizar a configuração da autenticação do TSS para APIs REST, basta seguir o passo a passo do documento: TSS REST SERVER 1.0 - O servidor REST do TSS

Image Added

Após a atualização do INI será necessário reiniciar o serviço do TSS.

Âncora
gerenciamento gerenciamento

04. Gerenciamento das credenciais

Somente o usuário Administrador (ADMIN) do TSS terá permissão para realizar a gestão das credenciais.

...

Pré-requisito.

...

 Poderá ser através das rotinas: TSSMONITOR e TSSINTERFACE.

Procedimento para acessar as interfaces gráficas do TSS

Passo a passo:

1 - Acessar a rotina TSSMANAGER com usuário criado no pré-requisitorotina TSSMONITOR ou TSSINTERFACE com usuário ADMIN.

Image Added

2 - Clicar em Configuraçõesem Configurações e, em seguida Entidades. Assim será apresentado todas as entidades (empresas/filiais) que foram vinculados em seu cadastro.

3 - Posicionado na entidade que deseja configurar o usuário autenticador, basta ir em Outras Ações e clicar em Configurar.

4 - Na aba Geral, serão apresentados os campos Autenticador (Campo que deverá ser informado o usuário autenticador da entidade), Senha (Campo que deverá ser informado a senha do usuário autenticador) e Status Autenticador (Campo que deverá ser informado se está ativado ou desativado).

...

seguida, Credenciais.

Image Added

3 - Ao realizar o primeiro acesso, será criada uma credencial e deverá ser informada uma identificação.

Image Added

4 - A tela da rotina é separada em ações, credenciais e entidades. Observe abaixo, as ações que poderão ser realizadas (Filtrar, Gerar Secret, Excluir Secret, Exportar e Enviar e-mail), como também os dados das credenciais e as entidades que estão vinculadas a identificação fornecida.

No exemplo, temos a identificação TOTVS DEV, onde possui uma credencial criada, porém não possui nenhuma entidade vinculada a identificação.

Image Added