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 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, para que seja realizado apresentar como realizar o gerenciamento das credenciais geradas pelo TSS, com intuito de efetuar a autenticação das requisições recebidas do ERPrecebidas 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. 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 TSSMONITOR ou TSSINTERFACE com usuário ADMIN.

Image Added

2 - Clicar em Credenciais.

Poderá realizar as seguintes ações:

Gerar: gera um nova credencial no TSS.

Excluir: exclui um credencial no TSS.

Entidades: apresenta as entidades que estão utilizando a credencial.

...

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

Deck of Cards
id conf_cred_tss
Card default true id filtrar label Filtrar title Filtrar Credencial Filtrar: filtra as credenciais. Poderá ser através: Cliente ID: Verifica se o Client ID existe, caso exista será apresentado. Dt geração de: Data início da geração da credencial, podendo ser filtrado um intervalo de data da geração das credenciais. Dt geração até: Data fim da geração da credencial, podendo ser filtrado um intervalo de data da geração das credenciais. Entidade: Verifica se a Entidade existe, caso exista será apresentado. Nota icon false title Observação Caso realize alguma outra ação, o filtro será perdido. Image Added Card id gerar label Gerar Secret title Gerar Credencial Gerar Secret: gera uma ou varias credenciais para a identificação, apresentando possibilidade de enviar por e-mail como também exportar em arquivo .txt. Image Added Card id excluir label Excluir Secret title Excluir Credencial Excluir Secret: exclui as credenciais marcadas da identificação. Image Added Card id exportar label Exportar title Exportar Credencial Exportar: exportar os dados das credenciais marcadas. Image Added Card id enviar label Enviar e-mail title Enviar Credencial Enviar e-mail: envia por e-mail os dados

...

das credenciais marcadas. Image Added Image Added