Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Para acessar com segurança recursos e serviços externos ao fluig fluig (seja a partir de de Desenvolvimento de Workflow ou  ou desenvolvimentos sobre a plataforma), pode-se utilizar o recurso recurso Serviços REST no  no fluig.

Este consiste em um cadastro de configurações de acesso e segurança do serviço externo a ser consumido, ou seja, para cada caso de protocolo de segurança sendo OAuth 1, OAuth 2 ou ou Basic Authentication, serão informados e cadastrados os os tokens de  de acesso, chaves, usuário, senha, etc. 

Na atualização 1.6.2 do fluig disponibilizamos as autorizações Custom e None Authentication. Com a Custom é possível realizar o cadastro de acesso e segurança do serviço externo a ser consumido de forma personalizada, não obedecendo o cadastro padrão fixo do protocolo HTTP. Para acessar um serviço interno que não necessite de autenticação, utilize o None Authentication. 

Cadastro de de client para  para chamada a serviços externos

Para exibir o cadastro de de Serviços RESTacesse no fluig o menu Painel de Controle, aba WCM, opção opção Serviços REST. O recurso contém opções para inclusão, alteração, exclusão, consulta e teste dos dos clients.

 


Dependendo do do client de  de serviço a ser cadastrado, pode-se utilizar mecanismos de autenticação distintos, como OAuth 1, OAuth 2 ou ou Basic Authentication. Para cada tipo de autenticação existem informações específicas, que deverão ser preenchidas.

...

  • Para tipo de autorização OAuth 1, os métodos HTTP disponíveis são: PUT, POST, GET, DELETE.
  • Para tipo de autorização OAuth 2, os métodos HTTP disponíveis são: PUT, POST, GET, DELETE, PATCH.
  • Para tipo de autorização autorização Basic, os métodos HTTP disponíveis são: PUT, POST, GET, DELETE, PATCH.
  • Para tipo de autorização Custom, os métodos HTTP disponíveis são: PUT, POST, GET, DELETE, PATCH.
  • Em Nenhuma Autorização (None), os métodos HTTP disponíveis são: PUT, POST, GET, DELETE, PATCH.


OAuth 1

Deck of Cards
idOAuth 1
effectTypeslidefade
 
Card
defaulttrue
labelCadastro


  • Para cadastrar client com o tipo de autorização OAuth 1, informar os campos:
CampoCondição
Código do ServiçoObrigatório
DomínioObrigatório
Tipo de AutenticaçãoObrigatório
Consumer KeyObrigatório
Consumer SecretObrigatório
Token de acesso
Obrigatório
Token secreto
Obrigatório
URL Token de acesso
Obrigatório
URL solicitação de TokenObrigatório
URL Autorização de UsuárioObrigatório
URL para teste de ServiçoOpcional
Card
labelImagem

 


 


OAuth 2

Deck of Cards
idOAuth 2
effectTypeslidefade
 
Card
labelCadastro


  • Para cadastrar client com o tipo de autorização OAuth 2, informar os campos:
CampoCondição
Código do ServiçoObrigatório
DomínioObrigatório
Tipo de AutenticaçãoObrigatório
Id ClienteObrigatório
Client SecretObrigatório
Refresh TokenApenas se disponibilizado pelo Serviço
Token de acessoObrigatório
URL Refresh TokenApenas se disponibilizado pelo Serviço
URL para teste de ServiçoOpcional
 



Informações
titleNota

Para o OAuth 2 utilizamos a autenticação do tipo Baerer

Card
labelImagem

Image Modified 


Image Modified

Basic Authentication

Deck of Cards
effectDuration0.5
historyfalse
idBasic Auth
effectTypefade
 
Card
labelCadastro


  • Para cadastrar client com o tipo de autorização Basic, informar os campos:
CampoCondição
Código do ServiçoObrigatório
DomínioObrigatório
Tipo de AutenticaçãoObrigatório
UsuárioObrigatório
SenhaObrigatório
Confirmação da SenhaObrigatório
URL para teste do ServiçoOpcional
Card
labelImagem

Image Modified

...


Custom Authentication

Deck of Cards
effectDuration0.5
historyfalse
idCustom
effectTypefade
Card
defaulttrue
id1
labelCadastro


  • Para cadastrar client com o tipo de autorização Custom, informar os campos:
CampoCondição
Código do ServiçoObrigatório
DomínioObrigatório
Tipo de AutenticaçãoObrigatório
PersonalizadoObrigatório
URL para teste do ServiçoOpcional
Card
id2
labelImagem

Image Added

None Authentication

Deck of Cards
effectDuration0.5
historyfalse
idNone
effectTypefade
Card
defaulttrue
id1
labelCadastro


  • Para cadastrar client com o tipo Nenhuma (None) autorização, informar os campos:
CampoCondição
Código do ServiçoObrigatório
DomínioObrigatório
Tipo de AutenticaçãoObrigatório
URL para teste do ServiçoOpcional
Card
id2
labelImagem

Image Added


Testando configurações de autorização do do client cadastrado cadastrado

Após o cadastro do do client, é possível testar as configurações de acesso utilizando a URL para teste do Serviço (Endpoint GET) cadastrado. Basta selecionar o client e  e clicar no botão Testar  Testar Serviço:

...


Consumindo o serviço com autenticação OAuth 1, OAuth 2, Basic Authentication, Custom Authentication e None Authentication

Chamada via JavaScript

Para consumo do serviço a partir do do desenvolvimento de de workflows ou  ou de desenvolvimento sobre a plataforma, deve-se informar os seguintes parâmetros no Javascript:

...

  • companyId: Id da empresa. (sempre com o valor: getValue("WKCompany") + '')
  • serviceCode: Chave única cadastrada.
  • endpoint: Endpoint que  que será chamado.
  • timeoutService: definir limite de tempo (em segundos) durante a chamada ao serviço.

...

Exemplo de chamada aos serviços com HTTP methodPOST  methodPOST no JavaScript do desenvolvimento

...

  • companyId: Id da empresa. (sempre com o valor: getValue("WKCompany") + '')
  • serviceCode: Chave única cadastrada.
  • description: Informa o serviceCode e  e se obteve sucesso. Ex: "google:SUCCESS".
  • endopint: Endpoint chamado chamado.
  • result: String com  com o resultado retornado.
  • method: Método http do serviço.
  • strParams: Parâmetros em formato formato String.
  • params: Parâmetros em formato formato Map<String, Object> utilizados.

Chamada via componente SDK

...