Índice

Objetivo

...

Para acessar com segurança recursos e serviços externos ao fluig à partir de processos de workflow (que podem ser encontrados aqui)  ou customizaçõesfluig (seja a partir de Desenvolvimento de Workflow ou desenvolvimentos sobre a plataforma), pode-se utilizar o recurso Serviços REST no fluig.

Este a funcionalidade do Authorize Client no Fluig. Essa funcionalidade consiste em um cadastro de configurações de acesso e segurança do serviço externo a ser invocadoconsumido, 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 token's de os tokens de acesso, chaves, usuário, senha, etc. 

Cadastro de Client para chamada a Serviços externos.

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 client para chamada a serviços externos

...

Para exibir o cadastro de serviços REST, acesse o fluig com o usuário administrador, acione Para acesso ao cadastro do Authorize Client, acessar no Fluig o menu Painel de Controle, aba WCM, opção Authorize Client. A funcionalidade provê recursos localize o agrupador Desenvolvimento e acione a opção Serviços. O recurso contém opções para inclusão, alteração, exclusão, consulta e teste dos client's.dos clients.

Image Added

Dependendo do client de Dependendo do client de serviço a ser cadastrado, pode-se utilizar mecanismos de autenticação distintos, como OAuth 1, OAuth 2  ou Basic Authentication, para cada caso serão obrigatórias informações específicas para cada protocolo, Basic, Custom e até sem autenticação, com o NONE. Para cada tipo de autenticação existem informações específicas, que deverão ser preenchidas.

Métodos HTTP suportados

...

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

...

...

...

...

...

...

...

...

...

...

OAuth 2

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Basic Authentication

...

...

...

...

...

...

...

...

...

...

...

...

...

Custom Authentication

...

None Authentication

...

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

...

Após o cadastro do client

Testando configurações de Autorização do Client cadastrado.

Após o cadastro do Client, é possível testar as configurações de acesso utilizando o endpoint GET a URL para teste do Serviço (Endpoint GET) cadastrado. Basta selecionar o o client e  e clicar no link Testar Serviço na pagina principal da funcionalidade.

...

botão Testar Serviço:

Image Added

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 desenvolvimento de workflows ou de desenvolvimento sobre a plataforma, deve-se informar os seguintes parâmetros no

...

Javascript:

Como montar os parâmetros?

Para envio dos parâmetros no JSON, é obrigatório utilizar o nome das chaves conforme descrito abaixo.

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

...

• method (método http : Método HTTP do serviço).
• params (parametros : Parâmetros em formato JSON para envio ao serviço.
• options: Parâmetros em formato JSON para configuração do request (se o mesmo não for definido ele vai com as opções padrões que seria encoding: UTF-8 e mediaType: application/json).
• headers: Parâmetros em formato JSON para configuração do header do request

Exemplo de chamada aos serviços com

...

HTTP methodPOST no JavaScript do desenvolvimento

...

	try{
		var clientService = fluigAPI.getAuthorizeClientService();
		var data = {
			companyId : getValue("WKCompany") + '',
			serviceCode : 'bamboo',
			endpoint : '/api/public/2.0/users/create',
			method : 'post',// 'delete', 'patch', 'put', 'get'      
			timeoutService: '100', // segundos
			params : {
				login : 'authorize.client',
				email : '[email protected]',
				code : 'authorize.client',
				firstName : 'authorize',
				lastName : 'client',
				fullName : 'authorize client',
				password : '123',
				extData :{
					'addicional-data':'123456'
				}
			},
          options : {
             encoding : 'UTF-8',
			 mediaType: 'application/json',
			 useSSL : true
          },
		 headers: {
 			 Content-Type: 'application/json;charset=UTF-8'
		 }
		}
		// OU 
		var data = {
			companyId : getValue("WKCompany") + '',
			serviceCode : 'google',
			endpoint : '/userinfo/v2/me',
			method : 'get',
			timeoutService: '100' // segundos
		}
		// OU
		var data = {                                                    
			companyId : getValue("WKCompany") + '',
			serviceCode : 'fluig-local-basic',                      
			endpoint : '/api/public/2.0/testauthorizeclient/put',   
			method : 'put', // 'delete', 'patch', 'post', 'get'                                         
			timeoutService: '100', // segundos
			params : {                                              
					teste : 'teste'                                     
			}                                                       
		}                                                           
		var vo = clientService.invoke(JSON.stringify(data));

		if(vo.getResult()== null || vo.getResult().isEmpty()){
			throw new Exception("Retorno está vazio"); 
		}else{
			log.info(vo.getResult());
		}
	} catch(err) {
		throw new Exception(err); 
	}
 

Retorno da chamada

A chamada "clientService.invoke(JSON.stringify(data));" retorna um objeto com os parâmetros abaixo:

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

Chamada via componente SDK

O recurso para consumo do serviço externo também está disponível no componente SDK através do AuthorizeClientSdkService.

Veja a seguir o exemplo para a chamado ao serviço no SDK:

private getAuthorizeClientSdkService getAuthorizeClientSdkService() throws SDKException {
	return new FluigAPI().getAuthorizeClientSdkService();
}

...