Histórico da Página

...

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

...

1. 1. de autenticação WebService SOAP
   2. Configuração 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 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á A autenticação estará somente disponível a partir do Release 12.1.X.

...

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

Link do pacote de expedição do Release 12.1.X

Verificar se poderá colocar os release anteriores:

...

Segue o link para download do instalador do TSS 12.1.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:

1 - Criar a configuração TSSSECURITY na seção JOB_WS.

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

Exemplo:

Image Added

1 = Ativado

0 = Desativado

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

Exemplo:

Image Added

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. 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 TSSMONITOR ou TSSINTERFACE com usuário ADMIN.

Image Added

2 - Clicar em Configurações e, em 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

...

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

...

Para ativar a autenticação é necessário criar a configuração TSSSECURITY na seção JOB_WS.

Exemplo:

Image Removed

1 = Ativado

...