# Use a integração Massive Redirect

O **Massive Redirect** é uma integração *serveless* disponível no Marketplace da Azion. Esse tipo de integração é usada principalmente para lidar com um grande número de redirecionamentos de domínio, como migrações de domínio.

Essa integração permite controlar esse redirecionamento diretamente no edge, centralizando o gerenciamento de várias configurações em um único local. Isto também possibilita que você opere em uma variedade de situações, como migração de um CMS ou de uma plataforma de comércio eletrônico, atualizações de sites e assim por diante. Não importa quantas páginas você tenha, você pode configurar todos os seus redirecionamentos de forma fácil e rápida com a integração *Massive Redirect*.

:::note
Atente-se ao limite máximo do seu arquivo `JSON`. Neste caso, **300 kb**.
:::

---

## Obtenha a integração

Para usar Massive Redirect fornecido pelo Marketplace da Azion:

1. Acesse o [Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Marketplace**.
2. Na homepage do Marketplace, selecione o card da integração.
3. Quando a página da integração abrir, clique no botão **Install**, localizado no canto inferior da direita.

Aparecerá uma mensagem indicando que a integração foi instalada com sucesso.

:::tip
Você pode procurar qualquer integração navegando pelos cards, usando os filtros ou digitando uma palavra-chave na barra de busca.
:::

---

## Configure a integração

A integração obtida no Marketplace é adicionada à sua lista de **Functions**. Portanto, para usar a integração **Massive Redirect**, você deverá criar uma nova application para incorporar a nova função.

:::tip
Para criar uma nova application, acesse a [seção de Build](/pt-br/documentacao/produtos/guias/build/criar-uma-aplicacao/).
:::

### Configure uma regra dentro do Firewall

Para configurar a sua integração, siga os passos:

1. No canto superior esquerdo da página, selecione **Products menu** > **Application**.
2. Na lista de applications, selecione aquela na qual deseja configurar a integração Massive Redirect.
3. Certifique-se de habilitar o switch **Functions** na página principal da sua application para permitir o uso da sua nova integração.
4. Clique em **Save** no canto inferior direito.

Você receberá uma mensagem de sucesso indicando sua application foi atualizada. Agora, o uso de **Functions** está habilitado para a sua aplicação.

:::caution[Atenção]
Se qualquer produto ou módulo for ativado, pode gerar custos relacionados ao uso. Consulte a [página de preços](/pt-br/documentacao/produtos/precos/) para obter mais informações.
:::

### Instancie a integração

Para instanciar sua integração, siga os passos abaixo:

1. Na lista superior, selecione a aba **Functions Instances**.
2. Clique no botão **+ Function Instance**.
3. Escolha um nome fácil de lembrar para a sua função.
4. No menu suspenso, selecione a integração **Massive Redirect**.

Esta ação irá carregar a aba **Args**, onde você pode adicionar os parâmetros para executar sua aplicação.

:::note
Há várias seções na aba **Args**. Isso acontece porque você pode configurar diversos redirecionamentos diferentes ao mesmo tempo.
:::

A aba de **Args** irá apresentar um código em JSON como o abaixo:

```json
[
  {
    "from": "https://www.azion.com.br",
    "found": "https://www.azion.com"
  }, {
    "from_regex": "http://www\\.(azion)\\.com$",
    "moved": "https://www.%s.com"
  },{
    "from_regex":"http://www\\.azion\\.com/t/other/([\\w_]+)/([\\w_]+)/([\\w_]+)/$",
    "moved":"https://www.azion.com.br/doc/%3$/%1$/%2$/"
  }
]
```

Onde:
1. `from`: aqui, você passará a URL antiga, aquela que você deseja redirecionar para uma nova.
2. `moved`: aqui, você passará a nova URL, aquela que você deseja que seja o alvo da sua regra de redirecionamento. Essa URL será usada como um redirecionamento permanente para a URL antiga.
3. `from_regex`: essa opção permite que você passe vários redirecionamentos em um comando, passando mais de um endereço em uma linha.
4. `found`: tem o mesmo comportamento que `moved`, mas nesse caso você tem um redirecionamento *temporário* para uma URL.

:::note
Se você esqueceu de passar as chaves `moved` e/ou `found` na aba Args, você receberá uma mensagem de erro com o código `JA001`.
:::

### Configure uma regra para Rules Engine

Ainda na página **Applications**, você deve configurar uma regra para **Rules Engine** de forma a executar sua função.

Para fazer isso, siga estes passos:

1. Adicione uma nova regra clicando no botão **+ Rule**.
2. Dê um nome fácil de lembrar e, opcionalmente, uma descrição para sua regra.
3. Selecione **Request Phase**.
4. Defina um critério (*criteria*) para verificar seu domínio (*domain*). Você terá algo como `if: $ {domain} is equal xpto.com`.
5. Na seção de comportamento (*behavior*), em `Then`, selecione `Run a function` no primeiro menu suspenso e a função `Massive Redirect` (**conforme você a nomeou anteriormente**) no segundo menu suspenso.
6. Clique no botão **Save** no canto inferior direito.

:::tip
Você pode obter informações e referências mais detalhadas no artigo [Configure redirecionamento em massa para migração de domínios](/pt-br/documentacao/produtos/guias/massive-redirect-integration/).
:::

---