A conectividade REST pode ser utilizada com serviços web que utilizem APIs REST, tais como SAP Business One, Zoho CRM, iugu e Google Fit.
Se o sistema já possuir uma API, a plataforma poderá usá-la diretamente, adicionando controles de rate limit e segurança, o que facilita a sua integração com outras plataformas.
A plataforma trabalha com o formato JSON, permitindo os seguintes métodos de requisição HTTP:
POST
GET
UPDATE
DELETE
PATCH
Tipos de autenticação
Se você escolher o tipo de conectividade REST, terá as seguintes opções de Tipo de autenticação:
No Auth: conexão aberta, sem nenhum tipo de autenticação;
Basic: conexão simples, com usuário e senha;
Bearer Token: conexão que requer token no formato JSON Web Token (JWT) ou outro desejado;
OAuth 1: conexão com autenticação no padrão OAuth 1.0;
OAuth 2: conexão com autenticação no padrão OAuth 2.0;
Cookie: conexão que usa cookies para autenticar requisições de clientes e armazenar as informações de uma sessão de usuário;
AWS: conexão com autenticação HMAC, que permite acessar os serviços AWS;
OAuth2 JWT: conexão com autenticação no padrão OAuth 2.0 e que utiliza token JWT;
Header Authentication: uso de informações de cabeçalho (headers) em uma solicitação.
Como conectar uma conta
Após a definição do tipo de conectividade, o próximo passo consiste em escolher o tipo de autenticação. Somente após dessas definições é que você poderá adicionar uma nova conta, além de poder selecionar, editar ou remover uma das contas previamente cadastradas.
Para adicionar uma conta conectada, clique em "Conta conectada" e, em seguida, "Adicionar conta conectada".
Para seguir com a configuração, clique na aba do tipo de autenticação escolhido:
Importante: atente-se ao campo “Host” da configuração da Conta Conectada, pois os dados serão concatenados com as configuração de operações.
No Auth
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Terminal (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "Agente" correspondente;
Nome da conta: nome da conta cadastrada;
Host: endereço IP da API;
Porta: número da porta da API.
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.
Basic
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Terminal (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "Agente" correspondente;
Nome da conta: nome da conta cadastrada;
Host: endereço IP da API;
Porta: número da porta da API;
Usuário;
Senha.
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos
Bearer Token
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Terminal (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "Agente" correspondente;
Nome da conta: nome da conta cadastrada;
Host: endereço IP da API;
Porta: número da porta da API;
Token: token criado.
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.
OAuth 1
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Terminal (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "Agente" correspondente;
Nome da conta: nome da conta cadastrada
Host: endereço IP da API
Porta: número da porta da API
Customer Key: usuário necessário para a autenticação
Customer Secret: senha necessária para a autenticação
Access token: token utilizado para acessar uma API
Token secret: token obtido para conceder um novo access token sem que o usuário precise se logar novamente
Método de assinatura: técnica de segurança que utiliza HMAC-SHA1 para garantir a autenticidade.
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.
OAuth 2
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Nome da conta: nome da conta cadastrada
Host: endereço IP da API
Porta: número da porta da API
Client ID: usuário necessário para a autenticação
Client Secret: senha necessária para a autenticação
Access token: token utilizado para acessar uma API
Refresh token: token obtido para conceder um novo access token sem que o usuário precise se logar novamente
Endpoint de troca de token: URL utilizada para obter tokens para autorizar usuários
Content type: formato de dados que será transmitido na requisição. Por padrão, é no formato JSON, podendo ser alterado para o URL Encoded.
Parâmetros do payload do token:
Chave: identificador ou nome associado a uma determinada informação do payload do token.
Valor: dado associado à chave, contextualizando as informações da autenticação já inseridas anteriormente.
Chave da resposta com o token: chave do JSON que irá retornar a informação do token no body. Por padrão, é o Access Token (neste caso, não é preciso inserir no campo), porém nos casos em que será outro (Zoho Token, por exemplo) é preciso especificá-lo.
Chave da resposta com o refresh token: chave do JSON que irá retornar a informação do Refresh Token no body.
Enviar parâmetros de troca de token como query string: se selecionado, faz com que os parâmetros do Refresh Token sejam enviados como query string
Parâmetros no cabeçalho da requisição após autenticação:
Chave: Nome do parâmetro que será enviado na chamada GET Clientes em um Resource Server. Por exemplo: Authorization.
Valor: Dado associado que será necessário para transmitir ou autenticar o acesso. Por exemplo: Bearer <>token</>
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.
Cookie
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Terminal (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "Agente" correspondente;
Nome da conta: nome da conta cadastrada;
Host: endereço IP da API;
Porta: número da porta da API;
Endpoint de autenticação: URL utilizada para autenticação do usuário;
Cookie (opcional): conteúdo do cookie
Body (opcional) : conteúdo do corpo da requisição necessário para gerar o cookie.
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.
AWS
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Nome da conta: nome da conta cadastrada;
Host: endereço IP da API;
Porta: número da porta da API;
AWS Access Key ID: usuário da conta AWS;
AWS Secret Access Key: senha da conta AWS;
Serviço AWS : Serviço da AWS que deseja utilizar. Exemplos: s3, ses, ecs2;
Região AWS: região, dentro da nomenclatura da AWS. Exemplos: us-east-1, ap-southeast-1.
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.
OAuth2 JWT
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Nome da conta: nome da conta cadastrada;
Host: endereço IP da API;
Porta (opcional): número da porta da API;
Private Key: clique para carregar um arquivo de chave privada (.pem);
URL de autenticação: URL para a solicitação do token de autenticação;
Tempo de expiração .JWT (s): tempo antes que o token JWT expire (em segundos)
Content type: formato de dados que será transmitido na requisição. Por padrão, é no formato JSON, podendo ser alterado para o URL Encoded.
Parâmetros no payload JWT - parâmetros que podem ser informados (campos CHAVE e VALOR):
iss (issuer): emissor do token
aud (audience): destinatário do token, representa a aplicação que irá usá-lo
scope: escopo de dados requisitados
Parâmetros no corpo da requisição do token - parâmetros que podem ser informados (campos CHAVE e VALOR):
authorization: informe aqui o valor do token de autorização
Chave da resposta: token
Parâmetros no cabeçalho da requisição após autenticação - parâmetros que podem ser informados (campos CHAVE e VALOR):
authorization: informe aqui o valor do token de autorização
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.
Header Authentication
Ao escolher a opção "Adicionar conta conectada", o seguinte modal será apresentado:
Preencha os dados, sendo que:
Nome da conta: nome da conta cadastrada;
Host: endereço IP da API;
Porta (opcional): número da porta da API;
Opções do header:
Chave: Nome do parâmetro que será enviado.
Valor: Dado associado que será necessário para transmitir ou autenticar o acesso.
Após preencher os dados, clique em "Criar conta".
Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos
Para finalizar, clique em "Salvar alterações" para definir as configurações do seu módulo.
Importante: após salvar as alterações, não será possível mais alterar o Tipo de conectividade e/ou Tipo de autenticação.
