Primeiros passos com os objetivos de integração da Apigee e de proxy da Apigee

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.

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:

  1. Acesse a IU da Apigee e faça login.
  2. Selecione a organização usando o menu suspenso no canto superior esquerdo da IU.
  3. Clique em API Proxies na visualização principal.

    Como alternativa, selecione Develop > API Proxies no menu de navegação à esquerda.

  4. Na lista suspensa Ambiente, selecione o ambiente em que você quer criar um novo proxy de API.
  5. Clique em Criar nova.
  6. Clique em destino de integração na exibição dos tipos de proxy.

    O assistente de criação de proxy será iniciado.

  7. 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.
  8. Clique em Próxima.
  9. Na página de configuração Políticas comuns, mantenha as seleções padrão e clique em Avançar.
  10. 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:

  1. 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:

  2. Na lista suspensa Ambiente, selecione o ambiente em que você quer implantar o proxy da API.
  3. Clique no proxy recém-criado que você quer implantar. A IU exibe a página Visão geral por padrão.

  4. Para implantar as alterações, primeiro clique em Implantar para exibir a caixa de diálogo Implantar.
  5. 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.
  6. 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:

  1. Abra a IU da Apigee.
  2. Clique em Desenvolver > Integrações.
  3. Pesquise ou selecione o nome da integração criada nas etapas acima e clique no nome da integração.
  4. Clique em Registros.
  5. 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:

  1. Na IU da Apigee, selecione Develop > API Proxies no menu de navegação à esquerda.
  2. Clique no proxy criado recentemente.

    Por padrão, a IU exibe a guia Visão geral desse proxy no editor de proxy.

  3. Clique na guia Desenvolver.
  4. No painel Navigator, selecione Set Integration Request no cabeçalho Policies.
  5. 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>.

  6. Clique em Save.

A seguir

Explore o layout do designer de integração e entenda os vários conceitos descritos em Todos os conceitos.