

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ローカルメッセージングに IPv6 を使用する
<a name="use-ipv6"></a>

IPv6 を使用してローカルメッセージを送信するように IP ディテクターコンポーネントを設定できます。

**注記**  
IPv6 を使用してローカルメッセージを送信するには、IP ディテクター v2.2.0 以降が必要です。

[IP ディテクターコンポーネント](ip-detector-component.md)をデプロイして IPv6 アドレスを検出および使用できます。IPv4 の代わりに IPv6 を使用するように IP ディテクターコンポーネントの設定を更新する必要があります。詳細については、「[IP ディテクタを使用してエンドポイントを自動的に管理](manage-core-device-endpoints.md#use-ip-detector)」を参照してください。

**Topics**
+ [IPv6 を使用するように IP ディテクターを設定する](#configure-ip-detector-ipv6)

## IPv6 を使用するように IP ディテクターを設定する
<a name="configure-ip-detector-ipv6"></a>

コアデバイスと同じネットワーク上でクライアントデバイスなど、ネットワーク設定が単純な場合、ローカルメッセージングに IPv6 を使用するために [IP ディテクターコンポーネント](ip-detector-component.md)をデプロイできます。

IP ディテクタコンポーネントは、手動で設定するエンドポイントを上書きします。

**重要**  
コアデバイスの AWS IoT ポリシーでは、IP ディテクターコンポーネントを使用するアクセス`greengrass:UpdateConnectivityInfo`許可を に許可する必要があります。詳細については、「[AWS IoT データプレーンオペレーションの ポリシー](device-auth.md#iot-policies)」および「[AWS IoT モノのポリシーを設定する](connect-client-devices.md#configure-iot-policy-requirement)」を参照してください。

IP ディテクターコンポーネントをデプロイするため、次のいずれかを行います。
+ コンソールの **[Configure discovery]** (ディスカバリの設定) ページを使用します。詳細については、「[クラウドディスカバリを設定する (コンソール)](connect-client-devices.md#configure-cloud-discovery-console)」を参照してください。
+ IP ディテクタを含めるようにデプロイを作成と改訂します。コンソール、 AWS CLI、または AWS API を使用してデプロイを管理できます。詳細については、「[デプロイの作成](create-deployments.md)」を参照してください。

### IP ディテクタコンポーネントをデプロイ (コンソール)
<a name="deploy-ip-detector-console-ipv6"></a>

1. [AWS IoT Greengrass コンソール](https://console.aws.amazon.com/greengrass)のナビゲーションメニューで、**[Components]** (コンポーネント) を選択します。

1. **[Components]** (コンポーネント) ページで、**[Public components]** (公開コンポーネント) タブを選択し、次に **aws.greengrass.clientdevices.IPDetector** を選択します。

1. **aws.greengrass.clientdevices.IPDetector** ページで、**[Deploy]** (デプロイ) を選択します。

1. <a name="deploy-component-choose-deployment-step"></a>**[Add to deployment]** (デプロイに追加) で、改訂する既存のデプロイを選択するか、新しいデプロイを作成することを選択して、**[Next]** (次へ) を選択します。

1. <a name="deploy-component-choose-target-step"></a>新しいデプロイの作成を選択した場合、デプロイのターゲットコアデバイスまたはモノグループを選択します。リポジトリの **[Specify target]** (ターゲットを指定) ページの、**[Deployment target]** (ターゲットのデプロイ) で、コアデバイスまたはモノグループを選択し、**[Next]** (次へ) を選択します。

1. **[Select components]** (コンポーネントを選択) ページで、**aws.greengrass.clientdevices.IPDetector** コンポーネントが選択されていることを確認し、**[Next]** (次) を選択します。

1. **[Configure components]** (コンポーネントを設定) ページで、**aws.greengrass.clientdevices.IPDetector** を選択したら、次の操作を行います。

   1. **[Configure component]** (コンポーネントを設定) を選択します。

   1. **[aws.greengrass.clientdevices.IPDetector を設定]** モーダルで、**[マージする設定]** の **[設定の更新]** 内に、設定更新を入力して IP ディテクタコンポーネントを設定できます。次の設定オプションのいずれかを指定できます。`includeIPv4Addrs` を `false` に、`includeIPv6Addrs` を `true` に設定します。その後、他の IPv6 設定オプションを更新できます。
      + `defaultPort` - <a name="ip-detector-component-configuration-default-port-definition"></a>(オプション) このコンポーネントが IP アドレスを検出するときに報告する MQTT ブローカーポート。デフォルトポート 8883 とは異なるポートを使用するように MQTT ブローカーを設定する場合、このパラメータを指定する必要があります。
      + `includeIPv4LoopbackAddrs` - <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(オプション) このオプションを有効にして IPv4 ループバックアドレスを検出して報告します。これらは、`localhost` など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。
      + `includeIPv4LinkLocalAddrs` - <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(オプション) このオプションを有効にして IPv4 [リンクローカルアドレス](https://en.wikipedia.org/wiki/Link-local_address)を検出して報告します。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。
      + `includeIPv6LoopbackAddrs` - <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(オプション) このオプションを有効にして IPv6 ループバックアドレスを検出して報告します。これらは、`localhost` など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定し、`includeIPv6Addrs` を `true` に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。
      + `includeIPv6LinkLocalAddrs` - <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(オプション) このオプションを有効にして IPv6 [リンクローカルアドレス](https://en.wikipedia.org/wiki/Link-local_address)を検出して報告します。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定し、`includeIPv6Addrs` を `true` に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。
      + `includeIPv4Addrs` – <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(オプション) デフォルトは True に設定されています。このオプションを有効にして、コアデバイスにある IPv4 アドレスを発行できます。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。
      + `includeIPv6Addrs` – <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(オプション) このオプションを有効にして、コアデバイスにある IPv6 アドレスを発行できます。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定します。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

      設定更新は、次の例のようになることがあります。

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

   1. **[Confirm]** (確認) を選択してモーダルを閉じ、次に **[Next]** (次) を選択します。

1. <a name="deploy-component-configure-advanced-settings-step"></a>**[Configure advanced settings]** (詳細設定) ページはデフォルト設定のままにし、**[Next]** (次へ) を選択します。

1. <a name="deploy-component-review-and-deploy-step"></a>[**Review**] ページで、[**デプロイ**] を選択します。

   デプロイに最大 1 分かかる場合があります。

### IP ディテクタコンポーネント (AWS CLI) の展開
<a name="deploy-ip-detector-cli-ipv6"></a>

IP ディテクタコンポーネントをデプロイするには、`components` オブジェクトに `aws.greengrass.clientdevices.IPDetector` を含むデプロイドキュメントを作成してコンポーネントの設定更新を指定します。[デプロイの作成](create-deployments.md) の指示に従って、新しいデプロイを作成または既存のデプロイを改訂します。

デプロイドキュメントの作成時に IP ディテクタコンポーネントを設定するため、次のオプションのいずれかを指定できます。
+ `defaultPort` - <a name="ip-detector-component-configuration-default-port-definition"></a>(オプション) このコンポーネントが IP アドレスを検出するときに報告する MQTT ブローカーポート。デフォルトポート 8883 とは異なるポートを使用するように MQTT ブローカーを設定する場合、このパラメータを指定する必要があります。
+ `includeIPv4LoopbackAddrs` - <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(オプション) このオプションを有効にして IPv4 ループバックアドレスを検出して報告します。これらは、`localhost` など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。
+ `includeIPv4LinkLocalAddrs` - <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(オプション) このオプションを有効にして IPv4 [リンクローカルアドレス](https://en.wikipedia.org/wiki/Link-local_address)を検出して報告します。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。
+ `includeIPv6LoopbackAddrs` - <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(オプション) このオプションを有効にして IPv6 ループバックアドレスを検出して報告します。これらは、`localhost` など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定し、`includeIPv6Addrs` を `true` に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。
+ `includeIPv6LinkLocalAddrs` - <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(オプション) このオプションを有効にして IPv6 [リンクローカルアドレス](https://en.wikipedia.org/wiki/Link-local_address)を検出して報告します。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定し、`includeIPv6Addrs` を `true` に設定する必要があります。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。
+ `includeIPv4Addrs` – <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(オプション) デフォルトは True に設定されています。このオプションを有効にして、コアデバイスにある IPv4 アドレスを発行できます。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。
+ `includeIPv6Addrs` – <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(オプション) このオプションを有効にして、コアデバイスにある IPv6 アドレスを発行できます。このオプションを使用するには、`includeIPv4Addrs` を `false` に設定します。このオプションを使用するには、IP ディテクター v2.2.0 以降が必要です。

次の部分的なデプロイドキュメントの例では、IPv6 を使用するように指定しています。

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