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.

# Détecteur IP
<a name="ip-detector-component"></a>

Le composant du détecteur IP (`aws.greengrass.clientdevices.IPDetector`) effectue les opérations suivantes :
+ Surveille les informations de connectivité réseau de l'appareil central Greengrass. Ces informations incluent les points de terminaison réseau du périphérique principal et le port sur lequel fonctionne un courtier MQTT.
+ Met à jour les informations de connectivité de l'appareil principal dans le service AWS IoT Greengrass cloud.

Les appareils clients peuvent utiliser Greengrass Cloud Discovery pour récupérer les informations de connectivité des principaux appareils associés. Les appareils clients peuvent ensuite essayer de se connecter à chaque périphérique principal jusqu'à ce qu'ils se connectent correctement.

**Note**  <a name="client-device-component-context"></a>
Les appareils clients sont des appareils IoT locaux qui se connectent à un appareil principal de Greengrass pour envoyer des messages MQTT et des données à traiter. Pour de plus amples informations, veuillez consulter [Interagissez avec les appareils IoT locaux](interact-with-local-iot-devices.md).

Le composant du détecteur IP remplace les informations de connectivité existantes d'un appareil principal par les informations qu'il détecte. Comme ce composant supprime les informations existantes, vous pouvez soit utiliser le composant de détection IP, soit gérer manuellement les informations de connectivité.

**Topics**
+ [Versions](#ip-detector-component-versions)
+ [Type](#ip-detector-component-type)
+ [Système d’exploitation](#ip-detector-component-os-support)
+ [Prérequis](#ip-detector-component-requirements)
+ [Dépendances](#ip-detector-component-dependencies)
+ [Configuration](#ip-detector-component-configuration)
+ [Fichier journal local](#ip-detector-component-log-file)
+ [Journal des modifications](#ip-detector-component-changelog)

## Versions
<a name="ip-detector-component-versions"></a>

Les versions de ce composant sont les suivantes :
+ 2.2.x
+ 2,1x
+ 2,0.x

## Type
<a name="ip-detector-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Ce composant est un composant de plugin (`aws.greengrass.plugin`). Le [noyau Greengrass](greengrass-nucleus-component.md) exécute ce composant dans la même machine virtuelle Java (JVM) que le noyau. Le noyau redémarre lorsque vous modifiez la version de ce composant sur le périphérique principal.

<a name="public-component-type-plugin-para2"></a>Ce composant utilise le même fichier journal que le noyau Greengrass. Pour de plus amples informations, veuillez consulter [AWS IoT Greengrass Journaux de surveillance](monitor-logs.md).

<a name="public-component-type-more-information"></a>Pour de plus amples informations, veuillez consulter [Types de composants](develop-greengrass-components.md#component-types).

## Système d’exploitation
<a name="ip-detector-component-os-support"></a>

Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :
+ Linux
+ Windows

## Prérequis
<a name="ip-detector-component-requirements"></a>

Ce composant répond aux exigences suivantes :
+ Le [rôle de service Greengrass](greengrass-service-role.md) doit être associé à vos autorisations Compte AWS et autoriser les autorisations`iot:GetThingShadow`. `iot:UpdateThingShadow`
+ La AWS IoT politique de l'appareil principal doit autoriser l'`greengrass:UpdateConnectivityInfo`autorisation. Pour plus d’informations, consultez [AWS IoT politiques relatives aux opérations du plan de données](device-auth.md#iot-policies) et [AWS IoT Politique minimale de prise en charge des appareils clients](device-auth.md#client-device-support-minimal-iot-policy).
+ Si vous configurez le composant broker MQTT du périphérique principal pour utiliser un port autre que le port par défaut 8883, vous devez utiliser le détecteur IP v2.1.0 ou version ultérieure. Configurez-le pour signaler le port sur lequel le broker opère.
+ Si vous avez une configuration réseau complexe, le composant du détecteur IP risque de ne pas être en mesure d'identifier les points de terminaison auxquels les appareils clients peuvent se connecter au périphérique principal. Si le composant du détecteur IP ne peut pas gérer les points de terminaison, vous devez plutôt gérer manuellement les points de terminaison de l'appareil principal. Par exemple, si le périphérique principal se trouve derrière un routeur qui lui transmet le port du broker MQTT, vous devez spécifier l'adresse IP du routeur comme point de terminaison pour le périphérique principal. Pour de plus amples informations, veuillez consulter [Gérez les principaux points de terminaison des appareils](manage-core-device-endpoints.md).
+ Le composant du détecteur IP est compatible pour fonctionner dans un VPC.

## Dépendances
<a name="ip-detector-component-dependencies"></a>

Lorsque vous déployez un composant, il déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez satisfaire aux exigences relatives au composant et à toutes ses dépendances pour réussir le déploiement du composant. Cette section répertorie les dépendances des [versions publiées](#ip-detector-component-changelog) de ce composant et les contraintes de version sémantiques qui définissent les versions des composants pour chaque dépendance. Vous pouvez également consulter les dépendances de chaque version du composant dans la [AWS IoT Greengrass console](https://console.aws.amazon.com//greengrass). Sur la page de détails du composant, recherchez la liste des **dépendances**.

------
#### [ 2.2.3 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.3 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,17,0 | Flexible | 

------
#### [ 2.2.2 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.2 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,16,0 | Flexible | 

------
#### [ 2.2.1 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.1 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,15,0 | Flexible | 

------
#### [ 2.2.0 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.0 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,14.0 | Flexible | 

------
#### [ 2.1.8 – 2.1.9 ]

Le tableau suivant répertorie les dépendances pour les versions 2.1.8 et 2.1.9 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,13,0 | Flexible | 

------
#### [ 2.1.7 ]

Le tableau suivant répertorie les dépendances pour la version 2.1.7 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,12,0 | Flexible | 

------
#### [ 2.1.6 ]

Le tableau suivant répertorie les dépendances pour la version 2.1.6 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,11,0 | Flexible | 

------
#### [ 2.1.5 ]

Le tableau suivant répertorie les dépendances pour la version 2.1.5 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,1,0 | Flexible | 

------
#### [ 2.1.4 ]

Le tableau suivant répertorie les dépendances pour la version 2.1.4 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,9,0 | Flexible | 

------
#### [ 2.1.3 ]

Le tableau suivant répertorie les dépendances pour la version 2.1.3 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,8,0 | Flexible | 

------
#### [ 2.1.2 ]

Le tableau suivant répertorie les dépendances pour la version 2.1.2 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,7,0 | Flexible | 

------
#### [ 2.1.1 ]

Le tableau suivant répertorie les dépendances pour la version 2.1.1 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,6,0 | Flexible | 

------
#### [ 2.1.0 and 2.0.2 ]

Le tableau suivant répertorie les dépendances pour les versions 2.1.0 et 2.0.2 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,5,0 | Flexible | 

------
#### [ 2.0.1 ]

Le tableau suivant répertorie les dépendances pour la version 2.0.1 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,4,0 | Flexible | 

------
#### [ 2.0.0 ]

Le tableau suivant répertorie les dépendances pour la version 2.0.0 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) | >=2,2,0 <2,3,0 | Flexible | 

------

Pour plus d'informations sur les dépendances des composants, consultez la [référence de la recette des composants](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuration
<a name="ip-detector-component-configuration"></a>

Ce composant fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant.

------
#### [ 2.2.x ]

`defaultPort`  <a name="ip-detector-component-configuration-default-port"></a>
<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.  
Par défaut : `8883`

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<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.  
Par défaut : `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<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.  
Par défaut : `false`

`includeIPv6LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs"></a>
<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.  
Par défaut : `false`

`includeIPv6LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs"></a>
<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.  
Par défaut : `false`

`includeIPv4Addrs`  <a name="ip-detector-component-configuration-include-ipv4-addrs"></a>
<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.  
Par défaut : `true`

`includeIPv6Addrs`  <a name="ip-detector-component-configuration-include-ipv6-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Facultatif) Vous pouvez activer cette option pour publier IPv6 les adresses présentes sur l'appareil principal. Réglez `false` sur `includeIPv4Addrs` pour utiliser cette option.  
Par défaut : `false`

------
#### [ 2.1.x ]

`defaultPort`  <a name="ip-detector-component-configuration-default-port"></a>
<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.  
Par défaut : `8883`

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<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.  
Par défaut : `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<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.  
Par défaut : `false`

------
#### [ 2.0.x ]

`includeIPv4LoopbackAddrs`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<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.  
Par défaut : `false`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<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.  
Par défaut : `false`

------

## Fichier journal local
<a name="ip-detector-component-log-file"></a>

Ce composant utilise le même fichier journal que le composant [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Pour consulter les journaux de ce composant**
+ Exécutez la commande suivante sur le périphérique principal pour afficher le fichier journal de ce composant en temps réel. Remplacez `/greengrass/v2` ou *C:\$1greengrass\$1v2* par le chemin d'accès au dossier AWS IoT Greengrass racine.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Journal des modifications
<a name="ip-detector-component-changelog"></a>

Le tableau suivant décrit les modifications apportées à chaque version du composant.


|  **Version**  |  **Modifications**  | 
| --- | --- | 
|  2.2.3  |  Version mise à jour pour la version 2.16.0 de Greengrass Nucleus.  | 
|  2.2.2  | Version mise à jour pour la version 2.15.0 de Greengrass Nucleus. | 
|  2.2.1  | Version mise à jour pour la version 2.14.0 de Greengrass Nucleus. | 
|  2.2.0  | Version mise à jour pour la version 2.13.0 de Greengrass Nucleus. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.9  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.8  | Version mise à jour pour la version 2.12.0 de Greengrass Nucleus. | 
|  2.1.7  | Version mise à jour pour la version 2.11.0 de Greengrass Nucleus. | 
|  2.1.6  | Version mise à jour pour la version 2.10.0 de Greengrass Nucleus. | 
|  2.1.5  | Version mise à jour pour la version 2.9.0 de Greengrass Nucleus. | 
|  2.1.4  | Version mise à jour pour la version 2.8.0 de Greengrass Nucleus. | 
|  2.1.3  |  Version mise à jour pour la version 2.7.0 de Greengrass Nucleus.  | 
|  2.1.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.1.1  |  Version mise à jour pour la version 2.5.0 de Greengrass Nucleus.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/ip-detector-component.html)  | 
|  2.0.2  |  Version mise à jour pour la version 2.4.0 de Greengrass Nucleus.  | 
|  2.0.1  |  Version mise à jour pour la version 2.3.0 de Greengrass Nucleus.  | 
|  2.0.0  |  Première version.  |