Índice:

Objetivo:

       Realizar a integração de um Produto com o TReports e entender o fluxo da autenticação entre Produto x TReports x Provedor Integrado.

Definições Gerais:

       Para exemplificar a integração, será utilizado o projeto TReportsServerClient (https://github.com/totvs/treports-server-client)

       O TReports utiliza o Rac para gerenciamento dos usuários e permissões configurados por Tenant.

Recuperando Access Token:

       Para realizar a integração do produto com o TReports, é utilizado o Fluxo Resource Owner (password). Este fluxo necessita de um usuário e senha válidos no Tenant configurado para o TReports para que a autenticação seja realizada.

       Este usuário precisa conter a permissão de execução de relatório (ExecuteReport).

       POST
       Host: {Endereço do Rac}
       Content-type: application/x-www-form-urlenconded

       grant_type=password
       &username=exampleuser
       &password=1234luggage
       &client_id=xxxxxxxxxx
       &client_secret=xxxxxxxxxx

       Para mais informações: https://developer.okta.com/blog/2018/06/29/what-is-the-oauth2-password-grant

Autenticação Externa - Rac:

       O Tenant pode ser configurado para realizar a autenticação externa, onde a validação do usuário e senha serão realizadas em um endpoint do produto.

Será realizado uma chamada no endpoint do Produto configurado no Tenant do Rac para que o usuário e senha sejam validados pelo Produto, em casso de sucesso, o Access Token é retornado para o Produto.