Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation IPv6 pour la messagerie locale
<a name="use-ipv6"></a>

Vous pouvez configurer le composant de détection IP à utiliser IPv6 pour envoyer des messages locaux.

**Note**  
Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour pouvoir IPv6 envoyer des messages locaux.

Vous pouvez déployer le [composant de détection IP](ip-detector-component.md) pour détecter et utiliser IPv6 des adresses. Vous devez mettre à jour la configuration du composant du détecteur IP à utiliser à la IPv6 place de IPv4. Pour de plus amples informations, veuillez consulter [Utiliser le détecteur IP pour gérer automatiquement les points de terminaison](manage-core-device-endpoints.md#use-ip-detector).

**Topics**
+ [Configurer le détecteur IP à utiliser IPv6](#configure-ip-detector-ipv6)

## Configurer le détecteur IP à utiliser IPv6
<a name="configure-ip-detector-ipv6"></a>

Si vous disposez d'une configuration réseau simple, telle que les appareils clients sur le même réseau que le périphérique principal, vous pouvez déployer le [composant de détection IP](ip-detector-component.md) à utiliser IPv6 pour la messagerie locale.

Le composant du détecteur IP remplace les points de terminaison que vous avez définis manuellement.

**Important**  
La AWS IoT politique de l'appareil principal doit `greengrass:UpdateConnectivityInfo` autoriser l'utilisation du composant de détection IP. Pour plus d’informations, consultez [AWS IoT politiques relatives aux opérations du plan de données](device-auth.md#iot-policies) et [Configuration de la AWS IoT politique des objets](connect-client-devices.md#configure-iot-policy-requirement).

Vous pouvez effectuer l'une des opérations suivantes pour déployer le composant de détection IP :
+ Utilisez la page **Configurer la découverte** de la console. Pour de plus amples informations, veuillez consulter [Configuration de la découverte du cloud (console)](connect-client-devices.md#configure-cloud-discovery-console).
+ Créez et révisez les déploiements pour inclure le détecteur IP. Vous pouvez utiliser la console ou l' AWS CLI AWS API pour gérer les déploiements. Pour de plus amples informations, veuillez consulter [Créer des déploiements](create-deployments.md).

### Déployer le composant de détection IP (console)
<a name="deploy-ip-detector-console-ipv6"></a>

1. Dans le menu de navigation de la [AWS IoT Greengrass console](https://console.aws.amazon.com/greengrass), sélectionnez **Composants**.

1. Sur la page **Composants**, choisissez l'onglet **Composants publics**, puis sélectionnez **aws.greengrass.clientdevices.IPDetector**.

1. Sur la page **aws.greengrass.clientdevices.IPDetector**, choisissez **Deploy (Déployer)**.

1. <a name="deploy-component-choose-deployment-step"></a>Dans **Ajouter au déploiement**, choisissez un déploiement existant à réviser ou choisissez de créer un nouveau déploiement, puis choisissez **Suivant**.

1. <a name="deploy-component-choose-target-step"></a>Si vous avez choisi de créer un nouveau déploiement, choisissez le périphérique principal ou le groupe d'objets cible pour le déploiement. Sur la page **Spécifier la cible**, sous **Cible de déploiement**, choisissez un périphérique principal ou un groupe d'objets, puis cliquez sur **Suivant**.

1. Sur la page **Sélectionner les composants**, vérifiez que le **aws.greengrass.clientdevices.IPDetector**composant est sélectionné, puis choisissez **Next**.

1. Sur la page **Configurer les composants**, sélectionnez **aws.greengrass.clientdevices.IPDetector**, puis effectuez les opérations suivantes :

   1. Choisissez **Configure component (Configurer un composant)**.

   1. Dans le aws.greengrass.clientdevices.IPDetector mode **Configurer**, sous **Mise à jour de la configuration**, dans **Configuration à fusionner**, vous pouvez saisir une mise à jour de configuration pour configurer le composant du détecteur IP. Vous pouvez spécifier l'une des options de configuration suivantes. Définissez `includeIPv4Addrs` sur `false` et `includeIPv6Addrs` sur `true`. Vous pouvez ensuite mettre à jour les autres options IPv6 de configuration.
      + `defaultPort`— <a name="ip-detector-component-configuration-default-port-definition"></a>(Facultatif) Le port du broker MQTT à signaler lorsque ce composant détecte des adresses IP. Vous devez spécifier ce paramètre si vous configurez le broker MQTT pour utiliser un port différent du port par défaut 8883. 
      + `includeIPv4LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses de IPv4 boucle. Il s'agit d'adresses IP, par exemple`localhost`, où un appareil peut communiquer avec lui-même. Utilisez cette option dans les environnements de test dans lesquels le périphérique principal et le périphérique client s'exécutent sur le même système. 
      + `includeIPv4LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses IPv4 [locales liées aux liens](https://en.wikipedia.org/wiki/Link-local_address). Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole DHCP (Dynamic Host Configuration Protocol) ou d'adresses IP attribuées de manière statique. 
      + `includeIPv6LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses de IPv6 boucle. Il s'agit d'adresses IP, par exemple`localhost`, où un appareil peut communiquer avec lui-même. Utilisez cette option dans les environnements de test dans lesquels le périphérique principal et le périphérique client s'exécutent sur le même système. Vous devez `includeIPv4Addrs` définir sur `false` et `includeIPv6Addrs` sur `true` pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.
      + `includeIPv6LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses IPv6 [locales liées aux liens](https://en.wikipedia.org/wiki/Link-local_address). Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole DHCP (Dynamic Host Configuration Protocol) ou d'adresses IP attribuées de manière statique. Vous devez `includeIPv4Addrs` définir sur `false` et `includeIPv6Addrs` sur `true` pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.
      + `includeIPv4Addrs`— <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(Facultatif) La valeur par défaut est définie sur true. Vous pouvez activer cette option pour publier IPv4 les adresses présentes sur l'appareil principal. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.
      + `includeIPv6Addrs`— <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour publier IPv6 les adresses trouvées sur l'appareil principal. Réglez `false` sur `includeIPv4Addrs` pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

      La mise à jour de configuration peut ressembler à l'exemple suivant.

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

   1. Choisissez **Confirmer** pour fermer le modal, puis cliquez sur **Suivant**.

1. <a name="deploy-component-configure-advanced-settings-step"></a>Sur la page **Configure advanced settings (Configurer les paramètres avancés)**, conservez les paramètres de configuration par défaut et choisissez **Next (Suivant)**.

1. <a name="deploy-component-review-and-deploy-step"></a>Sur la page **Review (Révision)**, choisissez **Deploy (Déployer)**.

   Le déploiement peut prendre jusqu'à une minute.

### Déployer le composant du détecteur IP (AWS CLI)
<a name="deploy-ip-detector-cli-ipv6"></a>

Pour déployer le composant du détecteur IP, créez un document de déploiement qui inclut `aws.greengrass.clientdevices.IPDetector` l'`components`objet et spécifiez la mise à jour de configuration du composant. Suivez les instructions [Créer des déploiements](create-deployments.md) pour créer un nouveau déploiement ou modifier un déploiement existant.

Vous pouvez spécifier l'une des options suivantes pour configurer le composant du détecteur IP lorsque vous créez le document de déploiement :
+ `defaultPort`— <a name="ip-detector-component-configuration-default-port-definition"></a>(Facultatif) Le port du broker MQTT à signaler lorsque ce composant détecte des adresses IP. Vous devez spécifier ce paramètre si vous configurez le broker MQTT pour utiliser un port différent du port par défaut 8883. 
+ `includeIPv4LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses de IPv4 boucle. Il s'agit d'adresses IP, par exemple`localhost`, où un appareil peut communiquer avec lui-même. Utilisez cette option dans les environnements de test dans lesquels le périphérique principal et le périphérique client s'exécutent sur le même système. 
+ `includeIPv4LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses IPv4 [locales liées aux liens](https://en.wikipedia.org/wiki/Link-local_address). Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole DHCP (Dynamic Host Configuration Protocol) ou d'adresses IP attribuées de manière statique. 
+ `includeIPv6LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses de IPv6 boucle. Il s'agit d'adresses IP, par exemple`localhost`, où un appareil peut communiquer avec lui-même. Utilisez cette option dans les environnements de test dans lesquels le périphérique principal et le périphérique client s'exécutent sur le même système. Vous devez `includeIPv4Addrs` définir sur `false` et `includeIPv6Addrs` sur `true` pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.
+ `includeIPv6LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses IPv6 [locales liées aux liens](https://en.wikipedia.org/wiki/Link-local_address). Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole DHCP (Dynamic Host Configuration Protocol) ou d'adresses IP attribuées de manière statique. Vous devez `includeIPv4Addrs` définir sur `false` et `includeIPv6Addrs` sur `true` pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.
+ `includeIPv4Addrs`— <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(Facultatif) La valeur par défaut est définie sur true. Vous pouvez activer cette option pour publier IPv4 les adresses présentes sur l'appareil principal. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.
+ `includeIPv6Addrs`— <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour publier IPv6 les adresses trouvées sur l'appareil principal. Réglez `false` sur `includeIPv4Addrs` pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

L'exemple de document de déploiement partiel suivant indique à utiliser IPv6.

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