--- name: azion-instale-uma-integracao description: >- Instale uma integração do Marketplace na sua conta e execute-a em uma aplicação ou em um firewall com uma function instance e uma regra do Rules Engine. --- # Instale uma integração Você instala uma integração pelo Azion Marketplace e a executa em uma aplicação ou em um firewall pelo Azion Console. Esta página é o procedimento que todas as integrações compartilham. Cada integração também tem um guia próprio, com os argumentos que ela recebe. Para essa lista e para saber onde cada integração roda, consulte [Integrações do Marketplace](/pt-br/documentacao/plataforma/marketplace/integracoes/). As integrações são instaladas de uma de duas formas. Algumas abrem um drawer de instalação que configura a integração em uma aplicação que você seleciona. Outras adicionam a function da integração à sua conta imediatamente. Depois, você ativa o módulo **Functions** de uma aplicação ou de um firewall, cria uma function instance ali e cria uma regra do Rules Engine que executa a instância. --- ## Pré-requisitos - Uma conta Azion. Para entrar, consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). - Uma [aplicação](/pt-br/documentacao/plataforma/applications/) servida por um [workload](/pt-br/documentacao/plataforma/workloads/). Para criar uma, consulte [Primeiros passos com Applications](/pt-br/documentacao/plataforma/applications/primeiros-passos/). - Para uma integração que roda em um [firewall](/pt-br/documentacao/plataforma/firewall/), um firewall e a [Azion CLI](/pt-br/documentacao/devtools/cli/) instalada e autorizada. A CLI vincula o firewall ao workload. - Ativar um produto ou um módulo pode gerar custos de uso. Para mais informações, consulte [Preços](/pt-br/documentacao/fundamentos/precos/). --- ## Instale a integração Você instala uma integração uma vez por conta. Para instalá-la pelo Azion Console: 1. **Abra o Marketplace** Acesse [Azion Console](https://console.azion.com/) > **Marketplace**. 2. **Encontre a integração** Insira o nome da integração no campo **Search on Marketplace** e selecione o card dela. Navegar pelos cards e pelas **Categories** leva à mesma página. 3. **Selecione Install** O que acontece em seguida depende da integração. Se o drawer **Install an Integration** abrir, a integração inclui um template de instalação. Para preencher o drawer: 1. **Selecione a aplicação** Na seção **Select an Application**, selecione uma **Application**. Para criar uma, selecione **Create New**. 2. **Preencha os campos da integração** O drawer exibe um formulário com os argumentos próprios da integração. O guia da integração descreve cada um. 3. **Revise as permissões** O drawer lista os privilégios que o Azion Marketplace exige na aplicação selecionada. Para saber o que cada um permite, consulte [Permissões do Marketplace](/pt-br/documentacao/plataforma/marketplace/permissoes-marketplace/). 4. **Selecione Deploy** O Azion Console confirma que a integração foi instalada, e a integração roda na aplicação selecionada. As seções abaixo não se aplicam a ela. Se nenhum drawer abrir, a instalação termina imediatamente. O card exibe `Successfully installed!` e `Latest version installed!`, e a function aparece na lista **Function** do drawer **Create Instance**. Continue com [Execute-a em uma aplicação](#execute-a-em-uma-aplicacao) ou [Execute-a em um firewall](#execute-a-em-um-firewall), conforme o guia da integração indica. --- ## Execute-a em uma aplicação Uma integração que roda em uma aplicação precisa de três alterações nessa aplicação. Faça-as na ordem abaixo. ### Ative o módulo Functions Uma aplicação executa uma function instalada somente enquanto o módulo **Functions** dela está ativado. Para ativar o módulo: 1. **Abra sua aplicação** Acesse [Azion Console](https://console.azion.com/) > **Applications** > **sua aplicação**. 2. **Abra a seção Modules** Na aba **Main Settings**, vá para a seção **Modules**. 3. **Ative a chave Functions** 4. **Selecione Save** A aplicação exibe uma aba **Functions Instances**, onde você instancia a function. ### Crie a function instance Uma function instance contém os argumentos que a integração lê em uma aplicação. Para criar a instância: 1. **Abra a aba Functions Instances** Em **Applications**, selecione sua aplicação e selecione a aba **Functions Instances**. 2. **Selecione + Function** Uma aplicação ainda sem instância oferece a mesma ação como **Function Instance**. O drawer **Create Instance** abre. 3. **Dê um nome à instância** Em **Name**, insira um nome único que identifique a instância. 4. **Selecione a function instalada** Em **Function**, selecione a integração. O editor **Arguments** é preenchido com os argumentos padrão da integração em JSON. 5. **Edite os argumentos** Em **Arguments**, substitua os valores padrão pelos seus. O guia da integração descreve cada chave. 6. **Selecione Save** A instância aparece na aba **Functions Instances** com o nome que você inseriu. ### Crie a regra A instância só roda quando uma regra do [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/) a chama com o behavior **Run Function**. A regra abaixo corresponde a todas as requisições. Para criá-la: 1. **Abra a aba Rules Engine** Em **Applications**, selecione sua aplicação e selecione a aba **Rules Engine**. 2. **Selecione + Rule** 3. **Dê um nome à regra** Em **Name**, insira um nome. Por exemplo: `Run my integration`. 4. **Selecione a fase** Na seção **Phase**, selecione *Request Phase*. 5. **Defina o critério** Na seção **Criteria**, mantenha a variável `${uri}` e o operador *starts with* e insira `/` como argumento. 6. **Adicione o behavior Run Function** Na seção **Behaviors**, selecione *Run Function* e selecione a instância pelo nome que você deu a ela. 7. **Selecione Save** A regra aparece na aba **Rules Engine**, na fase de requisição, e executa a instância em todas as requisições. Algumas integrações precisam de mais behaviors na mesma regra, como *Bypass Cache* ou *Forward Cookies*. Esses behaviors e os critérios extras exigem o módulo **Application Accelerator**, e o guia da integração os lista. --- ## Execute-a em um firewall Uma integração que roda em um firewall precisa de três alterações no firewall e, depois, de um vínculo entre o firewall e seu workload. ### Ative o módulo Functions Um firewall exibe a aba **Functions Instances** somente enquanto o módulo **Functions** dele está ativado. Para ativar o módulo: 1. **Abra seu firewall** Acesse [Azion Console](https://console.azion.com/) > **Firewalls** > **seu firewall**. 2. **Abra a seção Modules** Na aba **Main Settings**, vá para a seção **Modules**. 3. **Ative a chave Functions** 4. **Selecione Save** O firewall exibe a aba **Functions Instances**. Para todas as configurações deste formulário, consulte [Defina as configurações principais de um firewall](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/firewall-definir-main-settings/). ### Crie a function instance Uma function instance de firewall contém os argumentos que a integração lê nesse firewall. Para criar a instância: 1. **Abra a aba Functions Instances** Em **Firewalls**, selecione seu firewall e selecione a aba **Functions Instances**. 2. **Selecione + Function** Um firewall ainda sem instância oferece a mesma ação como **Function Instance**. O drawer **Create Instance** abre. 3. **Dê um nome à instância** Em **Name**, insira um nome único que identifique a instância. 4. **Selecione a function instalada** Em **Function**, selecione a integração. A lista contém somente as functions que rodam em um firewall. 5. **Edite os argumentos** Em **Arguments**, substitua os valores padrão no editor JSON pelos seus. O guia da integração descreve cada chave. 6. **Selecione Save** A instância aparece na aba **Functions Instances**. ### Crie a regra Uma regra do [Rules Engine for Firewall](/pt-br/documentacao/plataforma/firewall/rules-engine/) seleciona as requisições que chegam à instância, por meio do behavior **Run Function**. Para criar a regra: 1. **Abra a aba Rules Engine** Em **Firewalls**, selecione seu firewall e selecione a aba **Rules Engine**. 2. **Selecione + Rule** 3. **Dê um nome à regra** Em **Name**, insira um nome. Por exemplo: `Run my integration`. 4. **Defina o critério** Na seção **Criteria**, selecione as requisições que executam a integração. Por exemplo: if `Hostname` *is equal* `xxxxxxxxxxxx.map.azionedge.net`. 5. **Adicione o behavior Run Function** Na seção **Behaviors**, selecione **Run Function** e selecione a instância pelo nome que você deu a ela. 6. **Selecione Save** O firewall executa a instância em todas as requisições que correspondem ao critério. ### Vincule o firewall ao workload Um firewall inspeciona as requisições de um workload somente quando o deployment do workload o indica. Para criar um deployment que indique a aplicação e o firewall: ```bash azion create workload-deployment --workload-id --name \ --application-id --firewall-id --strategy-type default \ --active true --current true ``` O comando exibe o ID do novo deployment: ```text Created Workload Deployment with ID ``` As requisições ao domínio do workload chegam ao firewall, e a regra executa a instância nas requisições que correspondem ao critério dela. --- ## Integrações de terceiros Algumas integrações chamam uma ferramenta de outro fornecedor. Antes de instalar uma delas, você pode precisar de uma conta com esse fornecedor ou de uma configuração inicial do lado dele. Algumas dessas integrações também podem gerar custos de uso com o fornecedor. A coluna **Third-party account** de [Integrações do Marketplace](/pt-br/documentacao/plataforma/marketplace/integracoes/) informa quais integrações precisam de uma conta com o fornecedor. O guia próprio da integração descreve a configuração. --- ## Encontre e atualize integrações instaladas Cada integração instalada aparece na lista **Function** do drawer **Create Instance**. A lista **Functions** também pode exibir uma integração instalada, marcada por um ícone de carrinho na coluna **Vendor**. A Azion e os parceiros dela publicam novas versões de integrações. Atualizar cria uma nova instância da function da integração. Para atualizar uma integração e mover suas instâncias para a nova versão, consulte [Atualize uma integração](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/atualizar-uma-integracao/). --- ## Próximos passos - [Integrações do Marketplace](/pt-br/documentacao/plataforma/marketplace/integracoes.md): Todas as integrações, onde cada uma roda e o guia com os argumentos dela. - [Atualize uma integração](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/atualizar-uma-integracao.md): Obtenha a versão mais recente de uma integração instalada e mova suas instâncias para ela. - [Permissões do Marketplace](/pt-br/documentacao/plataforma/marketplace/permissoes-marketplace.md): Os privilégios que uma integração solicita em uma aplicação ou em um firewall. - [Como o Marketplace funciona](/pt-br/documentacao/plataforma/marketplace/como-funciona.md): Como instalar, instanciar e executar uma integração se encaixam.