TOTVS Fluig

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 15

changes.mady.by.user Samara Buettgen

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Julia Larissa Schultz

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleAtenção

Esta página foi revisada para considerar as configurações do fluig TOTVS Fluig Plataforma a partir da atualização 1.6.Caso possua uma atualização anterior do fluig acesse: DES 069 - Fluig API.

Índice

Índice
outlinetrue
exclude.*ndice
stylenone

...

Para cadastrar um aplicativo no fluig, autentique-se como um administrador e na plataforma, acompanhe os passos a seguir:

Deck of Cards
effectDuration0.5
historyfalse
idsamples
effectTypefade
Card
defaulttrue
id1
labelPasso1
  • Acesse o menu Painel de controle, localize o agrupador Parâmetros técnicos e acione a opção Oauth Provider.

note

Em atualizações anteriores à 1.6.5 (Liquid), essa opção está localizada na aba Colaboração do Painel de controle.
Card
id2
labelPasso 2
  • Clique em Adicionar, preencha os campos conforme a imagem e salve.

Cadastro de provedor Oauth 

Detalhes:

CampoExemplo
Código01
OAuth ProviderWCM
DescriçãoAplicativo de exemplo
Acess Token URL

http://<ServerFluig>/portal/api/rest/oauth/access_token


Request Token URL

http://<ServerFluig>/portal/api/rest/oauth/request_token 


User Authorization URL http://<ServerFluig>/portal/api/rest/oauth/authorize
Request MethodGET
Signature MethodHMAC-SHA
Card
id3
labelPasso 3
  • Volte para o Painel de controle e acesse agora a opção Oauth application.

Nota
Em atualizações anteriores à 1.6.5 (Liquid), essa opção está localizada na aba Colaboração do Painel de controle.


  • Clique em Adicionar, preencha os campos Costumer Consumer Key, Descrição e Costumer Consumer Secret, pois são todos campos obrigatórios, conforme imagem abaixo e acione Salvar:

Cadastro de aplicativo Oauth 

Detalhes:

CamposExemplo
Consumer Key

<chave publica de seu aplicativo>

OAuth Provider

Provedor cadastrado no Passo 2

Consumer Secret<chave secreta de seu aplicativo>


Card
id4
labelPasso 4
  • Opcional: Caso seu aplicativo execute ações em nome próprio, você pode criar um usuário aplicativo.
Nota
titleAtenção

Caso a plataforma Fluig esteja configurada para autenticação utilizando o TOTVS Identity, é requerida a criação de um usuário aplicativo que será utilizado na conexão com a API.

  • Na mesma tela de cadastro de aplicativo OAuth existe uma ação chamada Usuário Aplicativo. Ao acessá-la poderão ser gerados tokens exclusivos para o aplicativo.
Informações

Se desejar que o usuário aplicativo execute ações em nome de outro usuário cadastrado na plataforma, basta selecionar a opção Permite Impersonalização. Selecionando este recurso, o usuário aplicativo pode, por exemplo, fazer um post em uma comunidade em nome de outro usuário, sendo apresentado da seguinte forma:

  • 'Usuário x' fez uma publicação na comunidade, em vez de 'App X' fez uma publicação na comunidade.

Este comportamento é válido para todos métodos da API como por exemplo, publicação de documentos, movimentar processos entre outros.

  • Na mesma tela de cadastro de aplicativo OAuth existe uma ação chamada Usuário Aplicativo. Ao acessá-la poderão ser gerados tokens exclusivos para o aplicativo.
  • Caso as ações do seu aplicativo devam ser executadas em nome de um usuário, então o aplicativo deve passar pelo processo padrão de autenticação OAuth.

Usuário aplicativo

...

Você verá que é necessário construir um objeto FluigClient e este objeto recebe alguns parâmetros como host, consumer key e consumer secret. Você deve alterar os valores passados na construção para um host conhecido e informar o consumer key e secret da aplicação de sua responsabilidade, conforme o código abaixo:

Bloco de código
languagejava
FluigClient fluig = new FluigClient()
			.setHost("http://127.0.0.1:8080")
			.setConsumerKey("informe aqui o seu consumer key")
			.setConsumerSecret("informe aqui o seu consumer secret")
			.connect();

No caso da autenticação no Identity, também será necessário informar o Access Token e Token Secret apresentados na criação do usuário aplicativo.

Bloco de código
languagejava
FluigClient fluig = new FluigClient()
			.setHost("http://127.0.0.1:8080")
			.setConsumerKey("informe aqui o seu consumer key")
			.setConsumerSecret("informe aqui o seu consumer secret")
			.setTokenAccess("informe aqui o seu Token Access")
			.setTokenSecret("informe aqui o seu Token Secret")
			.connect();

Mais abaixo no código, podemos reparar que a aplicação cria e lê posts de comunidades. Você deve informar uma comunidade válida do seu ambiente para executar a aplicação demonstração;

...