# Como instalar uma integração import DocButton from '~/components/webkit/DocButton.vue'; 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: - [Applications functions](#edge-application-functions) - [Firewall functions](#edge-firewall-functions)
--- ## Applications functions Essas integrações executam tarefas e serviços no edge, mais perto do usuário, empregando uma application *existente*. :::tip Para criar uma nova application, acesse a jornada de [Build](/pt-br/documentacao/produtos/guias/build/criar-uma-aplicacao/) para obter mais detalhes sobre este tópico. ::: Para instalar e instanciar esse tipo de integração, siga os próximos passos. ### Obter a integração Acesse o [Azion Console](https://console.azion.com) 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. :::tip Você pode procurar qualquer integração navegando pelos cards ou digitando uma palavra-chave na barra de busca. ::: ### 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. :::tip Vá para a [página de guias da Azion](/pt-br/documentacao/produtos/guias/#marketplace) para ler as especificações de cada integração. ::: ### 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**. 3. 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. 4. 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](https://console.azion.com) 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. :::tip Você pode procurar qualquer integração navegando pelos cards ou digitando uma palavra-chave na barra de busca. ::: ### 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. :::tip Vá para a [página de guias da Azion](/pt-br/documentacao/produtos/guias/#marketplace) para ler as especificações de cada integração. ::: ### 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. 6. 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. :::tip Vá para a [página de guias da Azion](/pt-br/documentacao/produtos/guias/#marketplace) para ler as especificações de cada integração. ::: --- ## 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](https://console.azion.com). 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. ---