Neste tutorial, você verá como usar o assistente de proxy do Apigee para criar um proxy com um destino de integração. O proxy usa uma referência do gatilho de API de uma integração existente para iniciar a sequência de etapas na integração.
As etapas abaixo descrevem como configurar o proxy de destino de integração para executar uma integração bem-sucedida quando o proxy é chamado.
Antes de começar
- Confirme as credenciais de login e os detalhes da organização da Apigee. Essas informações são necessárias para acessar o recurso de integração da Apigee e o assistente de proxy na IU da Apigee.
- Crie e publique uma integração com um gatilho de API e pelo menos uma tarefa.
- Se você ainda não criou uma integração que usa um gatilho de API, siga as etapas em Primeiros passos com a integração da Apigee.
- Anote o nome da integração criada ou a integração atual que você quer usar, porque ela será usada em uma etapa posterior.
- Crie uma conta de serviço do Google no mesmo projeto do Google Cloud em que sua organização da Apigee foi criada e siga estas etapas:
- Atribua o papel Invocador de integração da Apigee
(roles/integrations.apigeeIntegrationInvokerRole)
à conta de serviço. Para informações sobre os papéis predefinidos da integração da Apigee, consulte Papéis predefinidos do IAM. - Permita que sua conta de usuário (principal) anexe contas de serviço a recursos com a permissão
iam.serviceAccounts.actAs
. Para informações sobre permissões da conta de serviço, consulte Papéis para a autenticação da conta de serviço .
É preciso fornecer essa conta de serviço ao implantar o proxy de API.
- Atribua o papel Invocador de integração da Apigee
Criar um proxy de destino de integração da Apigee
Faça o seguinte para criar um proxy de destino de integração na IU da Apigee:
- Acesse a IU da Apigee e faça login.
- Selecione a organização usando o menu suspenso no canto superior esquerdo da IU.
- Clique em API Proxies na visualização principal.
Como alternativa, selecione Develop > API Proxies no menu de navegação à esquerda.
- Na lista suspensa Ambiente, selecione o ambiente em que você quer criar um novo proxy de API.
- Clique em Criar nova.
- Clique em destino de integração na exibição dos tipos de proxy.
O assistente de criação de proxy será iniciado.
- Na página de configuração Detalhes do proxy, forneça os seguintes detalhes:
- Nome: digite um nome para o proxy.
Nomes de proxy podem conter caracteres alfanuméricos, traços e sublinhados.
- Caminho de base: é preenchido automaticamente com base no nome do proxy.
O Caminho base faz parte do URL usado para fazer solicitações à API. O Edge usa o URL para corresponder e rotear solicitações de entrada para o proxy da API apropriado.
- Descrição (opcional): digite uma breve descrição do proxy.
Por exemplo,
Proxy test for Apigee Integration
. - Região de integração: selecione a região da integração na lista suspensa.
- Destino da integração: selecione o nome do destino da integração na lista suspensa. A lista de destinos da integração é preenchida com base na região de integração selecionada.
- Gatilho: selecione o gatilho de API associado à integração na lista suspensa.
- Tipo de endpoint: selecione Sincronizar.
- Nome: digite um nome para o proxy.
- Clique em Próxima.
- Na página de configuração Políticas comuns, mantenha as seleções padrão e clique em Avançar.
- Na página Resumo, clique em Criar.
Um proxy de destino de integração foi criado.
Implante o proxy
Siga estas etapas para implantar o proxy recém-criado:
- Na IU da Apigee, selecione Desenvolver > Proxies de API.
A IU exibe uma lista de proxies de API e os status de implantação deles:
- Na lista suspensa Ambiente, selecione o ambiente em que você quer implantar o proxy da API.
Clique no proxy recém-criado que você quer implantar. A IU exibe a página Visão geral por padrão.
- Para implantar as alterações, primeiro clique em Implantar para exibir a caixa de diálogo Implantar.
- Digite o seguinte:
- Revisão: o número de revisão do proxy que você quer implantar.
- Ambiente: o ambiente em que você quer implantar o proxy.
- Conta de serviço: a conta de serviço criada para o proxy.
- Clique em Implantar.
A IU inicia o processo de implantação da revisão selecionada. A implantação do proxy pode levar até um minuto para ser concluída.
Quando o proxy é implantado, a coluna Status na seção Implantações mostra um ícone verde para mostrar que a revisão 1 do proxy está implantada.
Testar o proxy de destino da integração
Execute o seguinte comando na janela do terminal para invocar o proxy e acionar a integração:
curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME
em que o YOUR_ENV_GROUP_HOSTNAME
é o nome do host de um grupo de ambientes que contém o ambiente em que o proxy foi implantado.
Exemplo:
curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy
Para confirmar se a integração foi acionada invocando o proxy:
- Abra a IU da Apigee.
- Clique em Desenvolver > Integrações.
- Pesquise ou selecione o nome da integração criada nas etapas acima e clique no nome da integração.
- Clique em Registros.
- Verifique se há um registro de execução para a integração acionada. Para ver os detalhes do registro, clique na linha para expandir os detalhes da execução.
Atualizar o payload da solicitação de proxy (opcional)
Siga estas etapas para atualizar o payload da solicitação do proxy:
- Na IU da Apigee, selecione Develop > API Proxies no menu de navegação à esquerda.
- Clique no proxy criado recentemente.
Por padrão, a IU exibe a guia Visão geral desse proxy no editor de proxy.
- Clique na guia Desenvolver.
- No painel Navigator, selecione Set Integration Request no cabeçalho Policies.
- Remova a marca de comentário do bloco
<Parameters>
e insira os detalhes do parâmetro.Para especificar parâmetros individuais, use o elemento
<Parameter>
. Para especificar matrizes de parâmetro, use o elemento<ParameterArray>
. - Clique em Save.
A seguir
Explore o layout do designer de integração e entenda os vários conceitos descritos em Todos os conceitos.