Esta página aplica-se ao Apigee e ao Apigee Hybrid.
Veja a documentação do
Apigee Edge.
Pode fazer com que os fluxos partilhados realizem o pré-processamento de pedidos repetitivos ou o pós-processamento de respostas num conjunto de APIs. Com um flow hook, anexa um fluxo partilhado para que seja executado no mesmo local para todos os proxies de API implementados num ambiente específico. Isto dá-lhe uma sequência de lógica implementada e implementada separadamente que não faz parte do código de implementação de um proxy.
Uma vez que o código anexado a um gancho de fluxo está fora do contexto da lógica principal do proxy de API, alguns dos seus comportamentos diferem dos proxies de API. Tenha em atenção o seguinte:
- Tem de ter autorização para anexar um fluxo partilhado a um ponto de união de fluxo. Tem de ser um admin. org.
- Só pode anexar um fluxo partilhado a cada ponto de união do fluxo.
- Pode anexar o mesmo fluxo partilhado a vários pontos de acionamento de fluxo.
- Se um fluxo partilhado associado a um ponto de ligação de fluxo gerar uma falha ou ocorrerem erros durante a execução do fluxo partilhado, a mensagem é rejeitada e a falha é enviada de volta para o autor da chamada.
- Se uma mensagem for rejeitada durante a execução de um flow hook, os detalhes são registados nos dados de estatísticas no contexto do proxy chamado. O fluxo partilhado também pode gerar uma falha com um código personalizado e uma mensagem de erro
O vídeo seguinte demonstra como associar um fluxo partilhado a um ponto de ligação de fluxo e, em seguida, rastreá-lo na IU do Apigee.
Um fluxo partilhado anexado a um proxy através de um gancho de fluxo oferece um excelente local para a lógica que aplica requisitos de políticas gerais. Por exemplo, imagine que tem uma equipa a gerir um único conjunto de requisitos de segurança para várias equipas que representam diferentes linhas de negócio (LOBs). Cada equipa de LOB pode desenvolver APIs de acordo com os seus próprios requisitos e sem ter de ter em conta os requisitos de segurança mais amplos. A equipa de segurança pode implementar esses requisitos de segurança num fluxo partilhado e, em seguida, anexar o fluxo ao ambiente do Apigee através de um gancho de fluxo. Uma vez que o fluxo partilhado não faz parte do código do proxy, a equipa de segurança pode revê-lo conforme necessário sem interferir com o código da LOB.
Os fluxos partilhados anexados através de hooks de fluxo são executados nessa posição para todos os proxies de API implementados no ambiente do hook de proxy. Por este motivo, a capacidade de usar hooks de fluxo só está disponível para os administradores de uma organização do Apigee.
Para saber mais sobre fluxos partilhados, consulte o artigo Crie fluxos partilhados reutilizáveis.
Anexa um fluxo partilhado a um ponto de interceção de fluxo através da IU do Apigee ou da API Flowhooks. Pode anexar, no máximo, um fluxo partilhado a um ponto de acionamento de fluxo em cada um dos seguintes locais:
-
Pre-proxy flow hook para lógica que tem de ser aplicada ANTES de um ponto final do proxy ser executado.
Por exemplo, pode ter lógica para aplicar a segurança em todas as APIs num ambiente.
Pre-target flow hook para lógica que tem de ser aplicada ANTES de um ponto final de destino ser executado.
Por exemplo, pode implementar o registo antes de o pedido chegar ao back-end. Também pode aplicar a mediação removendo determinados campos do pedido.
Post-target flow hook para a lógica que tem de ser aplicada DEPOIS de a resposta do alvo ser executada.
Esta ação é aplicada imediatamente após a resposta do back-end. Pode usá-lo para registar a resposta do back-end ou realizar alguma mediação removendo campos sensíveis da resposta do back-end.
Post-proxy flow hook para lógica que tem de ser aplicada APÓS o ponto final do proxy e imediatamente antes de a resposta ser enviada para o cliente.
Isto pode incluir alguma lógica de aplicação para CORS, registar a resposta ou realizar alguma combinação ou formatação.
Anexar um fluxo partilhado a um ponto de união de fluxo
Para anexar um fluxo partilhado a um ponto de ligação de fluxo, tem de ser um administrador na organização que contém o fluxo partilhado.
Apigee na Cloud Console
Para anexar um fluxo partilhado a um ponto de entrada do fluxo:
Na Google Cloud consola, aceda à página Gestão > Ambientes.
- Selecione a organização que contém o fluxo partilhado. Consulte o artigo
Alternar entre as suas organizações.
O fluxo partilhado vai estar disponível para todos os proxies de API e fluxos partilhados implementados num ambiente desta organização. Não estará disponível a partir de fora desta organização.
- Selecione o ambiente que quer editar na lista de ambientes disponíveis.
- Clique no separador Flow hooks na página Detalhes do ambiente.
A vista Flow hooks é apresentada.
- Na lista de pontos de união de fluxos, identifique o ponto de união de fluxos ao qual quer anexar o fluxo partilhado.
O ponto de ligação do fluxo que escolher depende do local onde quer que o fluxo partilhado seja executado.
Localização do ponto de inserção do fluxo Descrição Pré-proxy Executa-se antes da execução de um ponto final de proxy Pré-segmentação Executa-se antes de um ponto final de destino ser executado Pós-destino Executa-se depois de a resposta de destino ser executada Post-proxy Executa-se após o ponto final do proxy e imediatamente antes de a resposta ser enviada para o cliente - Na caixa de lista do ponto de união do fluxo que escolheu, selecione o fluxo partilhado que quer anexar.
- Anexe fluxos partilhados a outros pontos de acionamento de fluxos, conforme necessário.
- Clique em Guardar para anexar os fluxos partilhados selecionados aos pontos de acionamento de fluxo.
Apigee clássico
Para anexar um fluxo partilhado a um ponto de entrada do fluxo:
- Inicie sessão na IU do Apigee.
- Selecione a organização que contém o fluxo partilhado. Consulte o artigo
Alternar entre as suas organizações.
O fluxo partilhado vai estar disponível para todos os proxies de API e fluxos partilhados implementados num ambiente desta organização. Não estará disponível a partir de fora desta organização.
- Selecione Administração > Ambientes > Hooks de fluxo na barra de navegação esquerda.
A vista Flow hooks apresenta:
- Na lista pendente de ambientes, selecione o ambiente que quer modificar.
- Na lista de pontos de união de fluxos, identifique o ponto de união de fluxos ao qual quer anexar o fluxo partilhado.
O ponto de ligação do fluxo que escolher depende do local onde quer que o fluxo partilhado seja executado.
Localização do ponto de inserção do fluxo Descrição Pré-proxy Executa-se antes da execução de um ponto final de proxy Pré-segmentação Executa-se antes de um ponto final de destino ser executado Post-proxy Executa-se após o ponto final do proxy e imediatamente antes de a resposta ser enviada para o cliente Pós-destino Executa-se depois de a resposta de destino ser executada - Posicione o cursor sobre o ponto de união do fluxo na lista para apresentar a coluna de ações.
- Clique em Editar.
- Na caixa de diálogo Fluxo partilhado, selecione o fluxo partilhado que quer anexar no menu Fluxo partilhado.
- Clique em OK.
- Anexe fluxos partilhados a outros pontos de acionamento de fluxos, conforme necessário.