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 application existente.

Considerando que o Marketplace da Azion tem integrações que executam 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

Applications functions

Essas integrações executam tarefas e serviços no edge, mais perto do usuário, empregando uma 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 application existente para usar a integração. Para fazer isso:

  1. No canto superior esquerdo, selecione Products menu > Applications na seção de BUILD.
  2. Na página do Applications 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 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 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.


Firewall functions

Essas funções aproveitam os recursos do 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 firewall

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

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

Configurar uma função no Firewall

Para instanciar sua integração, ainda na página do 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 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 Functions. Para revisar suas funções, proceda da seguinte forma:

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

Isso abrirá sua lista de 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