As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Use IPv6 para mensagens locais
<a name="use-ipv6"></a>

Você pode configurar o componente detector de IP a ser usado IPv6 para enviar mensagens locais.

**nota**  
Você deve ter o detector de IP v2.2.0 ou posterior para usar IPv6 para enviar mensagens locais.

Você pode implantar o [componente detector de IP](ip-detector-component.md) para detectar e usar IPv6 endereços. Você deve atualizar a configuração do componente detector de IP a ser usado IPv6 em vez do IPv4. Para obter mais informações, consulte [Use o detector de IP para gerenciar automaticamente os endpoints](manage-core-device-endpoints.md#use-ip-detector).

**Topics**
+ [Configurar o detector IP para usar IPv6](#configure-ip-detector-ipv6)

## Configurar o detector IP para usar IPv6
<a name="configure-ip-detector-ipv6"></a>

Se você tiver uma configuração de rede simples, como os dispositivos cliente na mesma rede do dispositivo principal, poderá implantar o [componente detector de IP](ip-detector-component.md) IPv6 para uso em mensagens locais.

O componente detector de IP substitui os endpoints que você define manualmente.

**Importante**  
A AWS IoT política do dispositivo principal deve permitir a `greengrass:UpdateConnectivityInfo` permissão para usar o componente detector de IP. Para obter mais informações, consulte [AWS IoT políticas para operações de plano de dados](device-auth.md#iot-policies) e [Configure a política da AWS IoT coisa](connect-client-devices.md#configure-iot-policy-requirement).

É possível executar uma das seguintes ações para implantar o componente detector de IP:
+ Usar a página **Configurar a descoberta** no console. Para obter mais informações, consulte [Configurar a descoberta na nuvem (console)](connect-client-devices.md#configure-cloud-discovery-console).
+ Criar e revisar as implantações para incluir o detector de IP. Você pode usar o console ou AWS CLI a AWS API para gerenciar implantações. Para obter mais informações, consulte [Criar implantações](create-deployments.md).

### Implantar o componente detector de IP (console)
<a name="deploy-ip-detector-console-ipv6"></a>

1. No menu de navegação do [console do AWS IoT Greengrass](https://console.aws.amazon.com/greengrass), selecione **Componentes**.

1. Na página **Componentes**, escolha a guia **Componentes públicos** e **aws.greengrass.clientdevices.IPDetector**.

1. Na página **aws.greengrass.clientdevices.IPDetector**, escolha **Implantar**.

1. <a name="deploy-component-choose-deployment-step"></a>Em **Adicionar à implantação**, escolha uma implantação existente para revisar ou opte por criar uma nova e, em seguida, escolha **Avançar**.

1. <a name="deploy-component-choose-target-step"></a>Se você criar uma nova implantação, escolha o dispositivo principal ou grupo de objetos de destino para ela. Na página **Especificar destino**, em **Destino de implantação**, escolha um dispositivo principal ou grupo de objetos e, depois, **Avançar**.

1. Na página **Selecionar componentes**, verifique se o componente **aws.greengrass.clientdevices.IPDetector** está selecionado e escolha **Avançar**.

1. Na página **Configurar componentes**, selecione **aws.greengrass.clientdevices.IPDetector** e faça o seguinte:

   1. Escolha **Configurar componente**.

   1. No modal **Configurar aws.greengrass.clientdevices.IPDetector**, em **Atualização de configuração** e **Configuração a ser mesclada**, você pode inserir uma atualização de configuração para configurar o componente detector de IP. Você também pode especificar qualquer uma das opções de configuração a seguir. Defina `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true`. Em seguida, você pode atualizar as outras opções IPv6 de configuração.
      + `defaultPort` (opcional): <a name="ip-detector-component-configuration-default-port-definition"></a>a porta do agente MQTT para relatar quando esse componente detecta endereços IP. É necessário especificar esse parâmetro se configurar o agente MQTT para usar uma porta diferente da porta padrão 8883. 
      + `includeIPv4LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv4 loopback. Esses são endereços IP, como, por exemplo, `localhost`, em que um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. 
      + `includeIPv4LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv4 [locais de links](https://en.wikipedia.org/wiki/Link-local_address). Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. 
      + `includeIPv6LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv6 loopback. Esses são endereços IP, como, por exemplo, `localhost`, em que um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. É necessário definir `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
      + `includeIPv6LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv6 [locais de links](https://en.wikipedia.org/wiki/Link-local_address). Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. É necessário definir `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
      + `includeIPv4Addrs` (opcional): <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>o padrão é definido como verdadeiro. Você pode ativar essa opção para publicar IPv4 endereços encontrados no dispositivo principal. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
      + `includeIPv6Addrs`— <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Opcional) Você pode ativar essa opção para publicar IPv6 endereços encontrados no dispositivo principal. Defina `includeIPv4Addrs` como `false` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

      A atualização de configuração pode ser semelhante ao exemplo a seguir.

      ```
      {
        "defaultPort": "8883",
        "includeIPv4LoopbackAddrs": false,
        "includeIPv4LinkLocalAddrs": false,
        "includeIPv6LoopbackAddrs": true,
        "includeIPv6LinkLocalAddrs": true,
        "includeIPv4Addrs": false,
        "includeIPv6Addrs": true
      }
      ```

   1. Escolha **Confirmar** para fechar o modal e, em seguida, escolha **Avançar**.

1. <a name="deploy-component-configure-advanced-settings-step"></a>Na página **Definir configurações avançadas**, mantenha as configurações padrão e escolha **Avançar**.

1. <a name="deploy-component-review-and-deploy-step"></a>Na página **Pré-visualizar**, escolha **Implantar**.

   A implantação pode levar até um minuto para ser concluída.

### Implantar o componente detector de IP (AWS CLI)
<a name="deploy-ip-detector-cli-ipv6"></a>

Para implantar o componente detector de IP, crie um documento de implantação que inclua `aws.greengrass.clientdevices.IPDetector` no objeto `components` e especifique a atualização de configuração do componente. Siga as instruções em [Criar implantações](create-deployments.md) para criar uma nova implantação ou revisar uma existente.

É possível especificar qualquer uma das seguintes opções para configurar o componente detector de IP ao criar o documento de implantação:
+ `defaultPort` (opcional): <a name="ip-detector-component-configuration-default-port-definition"></a>a porta do agente MQTT para relatar quando esse componente detecta endereços IP. É necessário especificar esse parâmetro se configurar o agente MQTT para usar uma porta diferente da porta padrão 8883. 
+ `includeIPv4LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv4 loopback. Esses são endereços IP, como, por exemplo, `localhost`, em que um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. 
+ `includeIPv4LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv4 [locais de links](https://en.wikipedia.org/wiki/Link-local_address). Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. 
+ `includeIPv6LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv6 loopback. Esses são endereços IP, como, por exemplo, `localhost`, em que um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. É necessário definir `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
+ `includeIPv6LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv6 [locais de links](https://en.wikipedia.org/wiki/Link-local_address). Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. É necessário definir `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
+ `includeIPv4Addrs` (opcional): <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>o padrão é definido como verdadeiro. Você pode ativar essa opção para publicar IPv4 endereços encontrados no dispositivo principal. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
+ `includeIPv6Addrs`— <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Opcional) Você pode ativar essa opção para publicar IPv6 endereços encontrados no dispositivo principal. Defina `includeIPv4Addrs` como `false` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

O exemplo de documento de implantação parcial a seguir especifica o uso IPv6.

```
{
  ...,
  "components": {
    ...,
    "aws.greengrass.clientdevices.IPDetector": {
      "componentVersion": "2.1.1",
      "configurationUpdate": {
        "merge": "{\"defaultPort\":\"8883\",}"
      }
    }
  }
}
```