기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 로컬 메시징에 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>

클라이언트 디바이스가 코어 디바이스와 동일한 네트워크에 있는 것처럼 네트워크 설정이 간단한 경우에는 [IP 감지기 구성 요소](ip-detector-component.md)를 배포하여 로컬 메시징에 IPv6를 사용할 수 있습니다.

IP 감지기 구성 요소는 수동으로 설정한 엔드포인트를 덮어씁니다.

**중요**  
코어 디바이스의 AWS IoT 정책은 IP 감지기 구성 요소를 사용할 수 있는 `greengrass:UpdateConnectivityInfo` 권한을 허용해야 합니다. 자세한 내용은 [AWS IoT 데이터 영역 작업에 대한 정책](device-auth.md#iot-policies) 및 [AWS IoT 사물 정책 구성](connect-client-devices.md#configure-iot-policy-requirement) 섹션을 참조하세요.

다음 중 하나를 수행하여 IP 감지기 구성 요소를 배포할 수 있습니다.
+ 콘솔의 **검색 구성** 페이지를 사용합니다. 자세한 내용은 [클라우드 검색 구성(콘솔)](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) 탐색 메뉴에서 **구성 요소**를 선택합니다.

1. **구성 요소** 페이지의 **퍼블릭 구성 요소** 탭을 선택한 다음 **aws.greengrass.clientdevices.IPDetector**를 선택합니다.

1. **aws.greengrass.clientdevices.IPDetector** 페이지에서 **배포**를 선택합니다.

1. <a name="deploy-component-choose-deployment-step"></a>**배포에 추가**에서 수정할 기존 배포를 선택하거나 새 배포 생성을 선택하고 **다음**을 선택합니다.

1. <a name="deploy-component-choose-target-step"></a>새 배포 생성을 선택한 경우 배포의 대상 코어 디바이스 또는 사물 그룹을 선택합니다. **대상 지정** 페이지의 **배포 대상**에서 코어 디바이스 또는 사물 그룹을 선택하고 **다음**을 선택합니다.

1. **구성 요소 선택** 페이지에서 **aws.greengrass.clientdevices.IPDetector** 구성 요소가 선택되었는지 확인하고 **다음**을 선택합니다.

1. **구성 요소 구성** 페이지에서 **aws.greengrass.clientdevices.IPDetector**를 선택하고 다음을 수행합니다.

   1. **구성 요소 구성**을 선택합니다.

   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 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: `localhost`)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다.
      + `includeIPv4LinkLocalAddrs` – <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(선택 사항) 이 옵션을 활성화하여 IPv4 [링크-로컬 주소](https://en.wikipedia.org/wiki/Link-local_address)를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 DHCP(Dynamic Host Configuration Protocol) 또는 정적 할당 IP 주소가 없는 경우 이 옵션을 사용합니다.
      + `includeIPv6LoopbackAddrs` – <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(선택 사항) 이 옵션을 활성화하여 IPv6 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: `localhost`)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다. 이 옵션을 사용하려면 `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)를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 DHCP(Dynamic Host Configuration Protocol) 또는 정적 할당 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. **확인**을 선택하여 모달을 닫고 **다음**을 선택합니다.

1. <a name="deploy-component-configure-advanced-settings-step"></a>**고급 설정 구성** 페이지에서 기본 구성 설정을 유지하고 **다음**을 선택합니다.

1. <a name="deploy-component-review-and-deploy-step"></a>**검토** 페이지에서 **배포**를 선택합니다.

   배포를 완료하는 데 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 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: `localhost`)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다.
+ `includeIPv4LinkLocalAddrs` – <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(선택 사항) 이 옵션을 활성화하여 IPv4 [링크-로컬 주소](https://en.wikipedia.org/wiki/Link-local_address)를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 DHCP(Dynamic Host Configuration Protocol) 또는 정적 할당 IP 주소가 없는 경우 이 옵션을 사용합니다.
+ `includeIPv6LoopbackAddrs` – <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(선택 사항) 이 옵션을 활성화하여 IPv6 루프백 주소를 감지하고 보고할 수 있습니다. 이들은 디바이스가 자체적으로 통신할 수 있는 IP 주소(예: `localhost`)입니다. 코어 디바이스와 클라이언트 디바이스가 동일한 시스템에서 실행되는 테스트 환경에서 이 옵션을 사용합니다. 이 옵션을 사용하려면 `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)를 감지하고 보고할 수 있습니다. 코어 디바이스의 네트워크에 DHCP(Dynamic Host Configuration Protocol) 또는 정적 할당 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\",}"
      }
    }
  }
}
```