Neste artigo, vamos explicar como configurar uma Pré-requisição para obter um token de acesso OAuth 2.0 para conectar a uma API usando um API Gateway.
O OptiSigns API Gateway permite autenticação OAuth através de Pré-requisição. Isto dá aos utilizadores a capacidade de consumir API que requer autenticação OAuth ou similar.
Para começar, terá de configurar uma requisição API. Passe o cursor sobre Nome da Conta → Mais → Clique em Fontes de Dados:
A partir daí, clique em Adicionar Requisição.
Crie uma Requisição GET e insira o seu endpoint API, depois clique em Pré-requisição:
Dentro do campo Pré-requisição, insira o seguinte código:
const body = {
"grant_type": "client_credentials",
"client_id": "<CLIENT_ID>",
"client_secret": "<CLIENT_SECRET>"
};
const params = Object.keys(body || {}).map((key) => {
return key + '=' + body[key];
}).join('&');
const {data, headers} = await os.postRequest("<OAUTH_AUTHENTICATION_URL>", params,{headers: {'content-type': 'application/x-www-form-urlencoded'}});
const token = 'Bearer' + data.access_token;
os.context.set("request.headers.authorization", token);
Notas:
- "grant_type": Use "client_credentials", porque "client_credentials" é o tipo de concessão em OAuth para integração do lado do servidor sem interação do utilizador.
- <CLIENT_ID> e <CLIENT_SECRET> referem-se ao código do utilizador para a API que está a ser acedida, isto terá de ser fornecido pelo utilizador.
- <OAUTH_AUTHENTICATION_URL> refere-se ao URL de onde o token de acesso está a ser obtido. Este URL terá de ser fornecido pelo utilizador.
Agora configure o Cabeçalho:
Com isto e o resto dos campos obrigatórios preenchidos, configurou corretamente a sua Pré-requisição. Clicar em Executar Teste deverá retornar uma Resposta 200 OK.
Se sim, clique em Guardar para finalizar a sua Requisição API.
É tudo!
Se tiver questões adicionais, preocupações ou qualquer feedback sobre o OptiSigns, não hesite em contactar a nossa equipa de suporte em support@optisigns.com.