Como instalar uma integração

As Azion Integrations permitem que você melhore, componha ou personalize suas aplicações. Essas integrações são baseadas em funções que são executadas no edge. Esta documentação lhe guiará no processo para instalar uma integração em uma edge application existente.

Considerando que o Marketplace da Azion tem integrações que executam edge functions de duas maneiras, você precisará proceder de acordo com o tipo de integração que deseja instalar:

Saiba mais sobre integrações
Consulte os guias das integrações

Edge Application functions

Essas integrações executam tarefas e serviços no edge, mais perto do usuário, empregando uma edge application existente.

Para instalar e instanciar esse tipo de integração, siga os próximos passos.

Obter a integração

Acesse o Azion Console e entre no Marketplace para selecionar a integração que deseja instalar.

Depois de selecionar a integração, clique no botão Get It Now, no canto inferior direito da página, e uma mensagem de sucesso aparecerá para confirmar que sua integração está instalada.

Configurar a integração

Depois de obter sua integração, você terá que selecionar uma edge application existente para usar a integração. Para fazer isso:

  1. No canto superior esquerdo, selecione Products menu > Edge Application na seção de BUILD.
  2. Na página do Edge Application aparecem listadas todas as aplicações que você já criou. Selecione aquela que você deseja usar com a integração.
  3. Na página do aplicação, na aba Main Settings, ative a opção Edge Functions.
  4. Clique no botão Save.

Instanciar a integração

Para adicionar a função e definir os Args, ainda na página da aplicação:

  1. Selecione a aba Functions.
  2. Clique no botão Add ⁠Function.
  3. Escolha um nome fácil de lembrar para sua função.
  4. No menu suspenso, selecione a função relacionada à sua integração.

Esta ação carregará a função, mostrando um formulário com o código-fonte desta e, logo acima dele, duas abas: Code e Args.

Clique na aba Code e você poderá navegar pelo código-fonte da função, mas não poderá alterá-lo. Na aba Args, você passará os parâmetros.

Configurar uma regra no Rules Engine

Para concluir, você precisará criar uma nova regra, com os criteria (critérios) e o behavior (comportamento) a serem aplicados à sua função.

Ainda na página da edge application, proceda da seguinte forma:

  1. Selecione a aba Rules Engine.
  2. Clique em Default Rule.
  • Você não pode alterar o campo de critérios da regra padrão no Rules Engine.
  1. No campo de behavior (comportamento), selecione Run Function no menu suspenso > selecione a função de acordo com o nome que você deu na etapa de instanciação.
  2. Clique no botão Save.

Pronto. Agora sua função está sendo executada no edge.


Edge Firewall functions

Essas funções aproveitam os recursos do Edge Firewall e do Rules Engine para proteger sua rede, aplicações e recursos contra acesso não autorizado, tráfego malicioso, ataques cibernéticos, bots maliciosos e outras ameaças à segurança.

Para instalar e instanciar esse tipo de integração, siga os próximos passos.

Obter a integração

Acesse o Azion Console e entre no Marketplace para selecionar a integração que deseja instalar.

Depois de selecionar a integração, clique no botão Get It Now, no canto inferior direito da página, e uma mensagem de sucesso aparecerá para confirmar que sua integração está instalada.

Configurar um edge firewall

Para iniciar a configuração de uma integração de Edge Firewall, siga estas etapas:

  1. No Products menu, selecione Edge Firewall na seção SECURE.
  2. Clique no botão Add Rule Set.
  3. Dê um nome fácil de lembrar ao seu edge firewall.
  4. Selecione os domínios que deseja proteger com a função.
  5. Ative a opção Edge Functions.
  6. Clique no botão Save.

Configurar uma função no Edge Firewall

Para instanciar sua integração, ainda na página do Edge Firewall:

  1. Selecione a aba Functions.
  2. Clique no botão Add ⁠Function.
  3. Dê um nome fácil de lembrar à sua instância.
  4. No menu suspenso, selecione a função relacionada à sua integração.

Esta ação carregará a função, mostrando um formulário com o código-fonte desta e, logo acima dele, duas abas: Code e Args.

Clique na aba Code e você poderá navegar pelo código-fonte da função, mas não poderá alterá-lo. Na aba Args, você passará os parâmetros.

Configurar o Rules Engine

Para finalizar, você deve configurar o Rules Engine para definir os critérios e o comportamento para executar a função.

Ainda na página do Edge Firewall:

  1. Selecione a aba Rules Engine.
  2. Clique no botão New Rule.
  3. Dê um nome à regra.
  4. Selecione um criteria para executar a integração. Por exemplo: if Hostname is equal xxxxxxxxxxxx.map.azionedge.net/classes.
  5. Abaixo, selecione um behavior (comportamento) para os criteria (critérios). Neste caso, será Run Function.
  • Selecione a função adequada de acordo com o nome que você deu na etapa de instanciação.
  1. Clique no botão Save.

Pronto. Agora sua integração está sendo executada para cada requisição feita ao domínio que você indicou.


Integração com terceiros

Alguns desses recursos são integrados com ferramentas de terceiros para fornecer uma opção mais abrangente e moderna. O uso desses tipos de integrações exigirá a conformidade com certos requisitos, como a criação de uma conta ou a configuração inicial. Em alguns casos, integração com terceiros pode gerar custo por uso.


Gerenciar uma integração

Você pode visualizar todas as suas integrações em sua lista de Edge Functions. Para revisar suas funções, proceda da seguinte forma:

  1. Acesse o Azion Console.
  2. Abra o Products menu e selecione Edge Functions na seção Edge Libraries.

Isso abrirá sua lista de Edge Functions, mostrando todas as suas funções, incluindo aquelas relacionadas a integrações. Selecione qualquer função para verificar os detalhes.

Processo de atualização das integrações

As integrações publicadas no Marketplace não são estáticas. Os parceiros da Azion e a própria Azion podem atualizá-las quando lançarem novos recursos e funcionalidades. Assim, a recomendação é sempre ter a versão mais atualizada da integração.

Consulte o guia Como atualizar uma integração

Contribuidores