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

# 디바이스 온보딩 및 운영을 위한 간단한 설정
<a name="managedintegrations-sdk-v2-cookbook-ss"></a>

관리형 사물을 생성하고 허브에 연결하여 관리형 통합 허브에 온보딩되도록 디바이스를 설정합니다. 이 섹션에서는 간단한 설정을 사용하여 디바이스 온보딩 프로세스를 완료하는 단계를 설명합니다.

## 사전 조건
<a name="managedintegrations-sdk-v2-cookbook-ss-prereq"></a>

디바이스 온보딩을 시도하기 전에 다음 단계를 완료합니다.
+ 허브 디바이스를 관리형 통합 허브에 온보딩합니다.
+ [관리형 통합 AWS CLI 명령 참조](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/) AWS CLI 에서의 최신 버전 설치
+ [DEVICE\_LIFE\_CYCLE](managedintegrations-notifications.md#managedintegrations-notification-setup) 이벤트 알림을 구독합니다.

**Topics**
+ [사전 조건](#managedintegrations-sdk-v2-cookbook-ss-prereq)
+ [1단계: 자격 증명 로커 생성](#managedintegrations-sdk-v2-cookbook-credential-locker)
+ [2단계: 허브에 자격 증명 로커 추가](#managedintegrations-sdk-v2-cookbook-add-to-hub)
+ [3단계: 자격 증명으로 관리형 사물을 생성합니다.](#managedintegrations-sdk-v2-cookbook-ss-create-managed-thing)
+ [4단계: 디바이스를 연결하고 상태를 확인합니다.](#managedintegrations-sdk-v2-cookbook-ss-check-device-status)
+ [5단계: 디바이스 기능 가져오기](#managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities)
+ [6단계: 관리형 사물에 명령 전송](#managedintegrations-sdk-v2-cookbook-ss-control-device)
+ [7단계: 허브에서 관리형 사물 제거](#managedintegrations-sdk-v2-cookbook-clean-up)

## 1단계: 자격 증명 로커 생성
<a name="managedintegrations-sdk-v2-cookbook-credential-locker"></a>

디바이스에 대한 자격 증명 로커를 생성합니다.

**자격 증명 로커를 생성하려면**
+ `create-credential-locker` 명령을 사용합니다. 이 명령을 실행하면 Wi-Fi 설정 키 페어 및 디바이스 인증서를 포함한 모든 제조 리소스가 생성됩니다.

  **create-credential-locker 예**

  ```
  aws iot-managed-integrations create-credential-locker \
    --name {{"DEVICE_NAME"}}
  ```

  **응답**:

  ```
  {    
    "Id": {{"LOCKER_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:credential-locker/{{LOCKER_ID}}
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  자세한 내용은 관리형 통합 명령 참조의 [create-credential-locker](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-credential-locker.html) *명령을 참조*하세요 AWS CLI .

## 2단계: 허브에 자격 증명 로커 추가
<a name="managedintegrations-sdk-v2-cookbook-add-to-hub"></a>

허브에 자격 증명 로커를 추가합니다.

**허브에 자격 증명 로커를 추가하려면**
+ 다음 명령을 사용하여 허브에 자격 증명 로커를 추가합니다.

  ```
  aws iotmi --region {{AWS_REGION}} --endpoint {{AWS_ENDPOINT}} update-managed-thing \
  --identifier {{"HUB_MANAGED_THING_ID"}} --credential-locker-id {{"LOCKER_ID"}}
  ```

## 3단계: 자격 증명으로 관리형 사물을 생성합니다.
<a name="managedintegrations-sdk-v2-cookbook-ss-create-managed-thing"></a>

디바이스의 자격 증명을 사용하여 관리형 사물을 생성합니다. 각 디바이스에는 자체 관리형 사물이 필요합니다.

**관리형 사물을 생성하려면**
+ `create-managed-thing` 명령을 사용하여 디바이스에 대한 관리형 사물을 생성합니다.

  **create-managed-thing 예**

  ```
  #ZWAVE: 
  aws iot-managed-integrations create-managed-thing --role DEVICE \
  --authentication-material '900137947003133...' \ #auth material from zwave qr code
  --authentication-material-type ZWAVE_QR_BAR_CODE \
  --credential-locker-id ${locker_id}
  
  #ZIGBEE:
  aws iot-managed-integrations create-managed-thing --role DEVICE \
  --authentication-material 'Z:286...$I:A4DC00.' \ #auth material from zigbee qr code
  --authentication-material-type ZIGBEE_QR_BAR_CODE \
  --credential-locker-id ${locker_id}
  ```
**참고**  
Z-wave 및 Zigbee 디바이스에는 별도의 명령이 있습니다.

  **응답**:

  ```
  {    
    "Id": {{"DEVICE_MANAGED_THING_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:managed-thing/{{DEVICE_MANAGED_THING_ID}}"
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  자세한 내용은 관리형 통합 명령 참조의 [create-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html) *명령을 참조*하세요 AWS CLI .

## 4단계: 디바이스를 연결하고 상태를 확인합니다.
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-status"></a>

**디바이스를 연결하고 상태를 확인합니다.**
+ `get-managed-thing` 명령을 사용하여 디바이스의 상태를 확인합니다. 관리형 사물의 ProvisioningStatus가 활성화되어 있어야 합니다. ProvisioningStatus에 대한 자세한 내용은 [디바이스 프로비저닝을 참조하세요](https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html).

  **get-managed-thing 예**

  ```
  #KINESIS NOTIFICATION:
  {
      "version": "1.0.0",
      "messageId": "4ac684bb7f4c41adbb2eecc1e7991xxx",
      "messageType": "DEVICE_LIFE_CYCLE",
      "source": "aws.iotmanagedintegrations",
      "customerAccountId": "12345678901",
      "timestamp": "2025-06-10T05:30:59.852659650Z",
      "region": "us-east-1",
      "resources": ["XXX"],
      "payload": {
          "deviceDetails": {
              "id": "1e84f61fa79a41219534b6fd57052XXX",
              "arn": "XXX",
              "createdAt": "2025-06-09T06:24:34.336120179Z",
              "updatedAt": "2025-06-10T05:30:59.784157019Z"
          },
          "status": "ACTIVATED"
      }
  }
  aws iot-managed-integrations get-managed-thing \
  --identifier {{:"DEVICE_MANAGED_THING_ID"}}
  ```

  **응답**:

  ```
  {    
    "Id": {{"DEVICE_MANAGED_THING_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:managed-thing/{{MANAGED_THING_ID}}"
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  자세한 내용은 관리형 통합 명령 참조의 [get-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing.html) *명령을 참조*하세요 AWS CLI .

## 5단계: 디바이스 기능 가져오기
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities"></a>

`get-managed-thing-capabilities` 명령을 사용하여 엔드포인트 ID를 가져오고 디바이스에 대해 가능한 작업 목록을 봅니다.

**디바이스의 기능을 가져오려면**
+ `get-managed-thing-capabilities` 명령을 사용하고 엔드포인트 ID를 기록해 둡니다.

  **get-managed-thing-capabilties 예**

  ```
  aws iotmi get-managed-thing-capabilities \
  --identifier {{"DEVICE_MANAGED_THING_ID"}}
  ```

  **응답**:

  ```
  {    
      "ManagedThingId": "1e84f61fa79a41219534b6fd57052cbc",
      "CapabilityReport": {
          "version": "1.0.0",
          "nodeId": "zw.FCB10009+06",
          "endpoints": [
              {
                  "id": {{"ENDPOINT_ID"}}
                  "deviceTypes": [
                      "On/Off Switch"
                  ],
                  "capabilities": [
                      {
                          "id": "matter.OnOff@1.4",
                          "name": "On/Off",
                          "version": "6",
                          "properties": [
                              "OnOff"
                          ],
                          "actions": [
                              "Off",
                              "On"
                          ],
                          "events": []
                      }
                      ...
  }
  ```

  자세한 내용은 관리형 통합 명령 참조의 [get-managed-thing-capabilities](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-capabilities.html) *명령을 참조*하세요 AWS CLI .

## 6단계: 관리형 사물에 명령 전송
<a name="managedintegrations-sdk-v2-cookbook-ss-control-device"></a>

`send-managed-thing-command` 명령을 사용하여 토글 작업 명령을 관리형 사물로 보냅니다.

**관리형 사물에 명령을 보내려면**
+ `send-managed-thing-command` 명령을 사용하여 관리형 사물에 명령을 보냅니다.

  **send-managed-thing-command 예**

  ```
  json=$(jq -cr '.|@json') <<EOF
  [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "matter.OnOff@1.4",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "Toggle",
              "parameters": {}
            }
          ]
        }
      ]
    }
  ]
  EOF
  aws iot-managed-integrations send-managed-thing-command \
  --managed-thing-id {{"DEVICE_MANAGED_THING_ID"}} --endpoints {{"ENDPOINT_ID"}}
  ```
**참고**  
이 예제에서는 jq cli를에 사용하지만 전체 `endpointId` 문자열을 전달할 수도 있습니다.

  **응답**:

  ```
  {    
  "TraceId": {{"TRACE_ID"}}
  }
  ```

  자세한 내용은 관리형 통합 명령 참조의 [send-managed-thing-command](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/send-managed-thing-command.html) *명령을 참조*하세요 AWS CLI .

## 7단계: 허브에서 관리형 사물 제거
<a name="managedintegrations-sdk-v2-cookbook-clean-up"></a>

관리형 사물을 제거하여 허브를 정리합니다.

**관리형 사물을 삭제하려면**
+ `delete-managed-thing` 명령을 사용하여 디바이스 허브에서 관리형 사물을 제거합니다.

  **delete-managed-thing 예**

  ```
  aws iot-managed-integrations delete-managed-thing \
  --identifier {{"DEVICE_MANAGED_THING_ID"}}
  ```

  자세한 내용은 관리형 통합 명령 참조의 [delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html) *명령을 참조*하세요 AWS CLI .
**참고**  
디바이스가 `DELETE_IN_PROGRESS` 상태로 멈춘 경우 `--force` 플래그를에 추가합니다`delete-managed-thing command`.
**참고**  
Z파 디바이스의 경우 명령을 실행한 후 디바이스를 페어링 모드로 전환해야 합니다.