# AWS IoT Core for LoRaWAN에 게이트웨이 추가
<a name="lorawan-onboard-gateway-add"></a>

콘솔 또는 CLI를 사용하여 AWS IoT Core for LoRaWAN에 게이트웨이를 추가할 수 있습니다.

게이트웨이를 추가하기 전에 [AWS IoT Core for LoRaWAN에 게이트웨이 온보딩](lorawan-onboard-gateways.md)의 **게이트웨이를 온보딩하기 전에** 단원에서 언급한 요소를 고려하는 것이 좋습니다.

게이트웨이를 처음 추가하는 경우 콘솔을 사용하는 것이 좋습니다. 대신 CLI를 사용하여 게이트웨이를 추가하려면 게이트웨이가 AWS IoT Core for LoRaWAN에 연결할 수 있도록 필요한 IAM 역할을 생성해야 합니다. 역할 생성 방법에 대한 자세한 내용은 [CUPS(Configuration and Update Server)가 게이트웨이 자격 증명을 관리할 수 있도록 IAM 역할을 추가합니다.](lorawan-rfregion-permissions.md#lorawan-onboard-permissions) 단원을 참조하세요.

## 콘솔을 사용하여 게이트웨이 추가
<a name="lorawan-onboard-gateway-console"></a>

AWS IoT 콘솔의 [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing) **소개(Intro)** 페이지로 이동하여 **시작하기(Get started)**를 선택한 다음 **게이트웨이 추가(Add gateway)**를 선택합니다. 게이트웨이를 이미 추가한 경우 **게이트웨이 보기(View gateway)**을 선택하여 추가한 게이트웨이를 봅니다. 게이트웨이를 더 추가하려면 **게이트웨이 추가(Add gateway)**를 선택합니다.

1. 

**게이트웨이 세부 정보 및 주파수 대역 정보 제공**  
**게이트웨이 세부 정보(Gateway details)** 단원을 참조하여 게이트웨이의 EUI 및 주파수 대역 구성과 같은 디바이스 구성 데이터에 대한 정보를 제공합니다.
   + 

**게이트웨이 EUI**  
개별 게이트웨이 디바이스의 EUI(확장 고유 식별자)입니다. EUI는 LoRaWAN 네트워크에서 게이트웨이를 고유하게 식별하는 `c0ee40ffff29df10`과 같은 16자리 영숫자 코드입니다. 이 정보는 게이트웨이 모델에 따라 다르며 게이트웨이 디바이스 또는 사용 설명서에서 찾을 수 있습니다.
**참고**  
게이트웨이의 EUI는 게이트웨이 디바이스에 인쇄되어 있을 수 있는 Wi-Fi MAC 주소와 다릅니다. EUI는 게이트웨이를 고유하게 식별하는 EUI-64 표준을 따르기 때문에 다른 AWS 계정 및 리전에서 사용할 수 없습니다.
   + 

**주파수 대역(RFRegion)**  
게이트웨이의 주파수 대역입니다. 게이트웨이가 지원하는 것과 게이트웨이가 물리적으로 연결하는 국가 또는 리전에 따라 `US915`, `EU868`, `AU915` 또는 `AS923-1`에서 선택할 수 있습니다. 대역에 대한 자세한 내용은 [게이트웨이 및 디바이스 연결을 위한 LoRa 주파수 대역 선택 고려](lorawan-rfregion-permissions.md#lorawan-frequency-bands) 단원을 참조하세요.

1. 

**무선 게이트웨이 구성 데이터 지정(선택 사항)**  
이러한 필드는 선택 사항이며 게이트웨이 및 해당 구성에 대한 추가 정보를 제공하는 데 사용할 수 있습니다.
   + 

**게이트웨이의 이름, 설명 및 태그**  
이러한 선택적 필드의 정보는 무선 시스템의 요소를 구성하고 설명하는 방법에 따라 제공됩니다. **이름**을 게이트웨이에 지정하고, **설명** 필드를 사용하여 게이트웨이에 대한 정보를 제공하고, **태그**를 사용하여 게이트웨이에 대한 메타데이터의 키-값 페어를 추가할 수 있습니다. 리소스 이름 지정 및 설명에 대한 자세한 내용은 [AWS IoT 무선 리소스 설명](iotwireless-describe-resources.md) 단원을 참조하세요.
   + 

**하위 밴드 및 필터를 사용한 LoRaWAN 구성**  
선택적으로, LoRaWAN 구성 데이터(예: 사용하려는 하위 밴드, 트래픽 흐름을 제어할 수 있는 필터)를 지정할 수도 있습니다. 이 자습서에서는 이 필드를 건너뛸 수 있습니다. 자세한 내용은 [게이트웨이의 하위 밴드 및 필터링 기능 구성](lorawan-subband-filter-configuration.md) 단원을 참조하십시오.

1. 

**AWS IoT 사물과 게이트웨이 연결**  
AWS IoT 사물의 생성 여부를 지정하고 이를 게이트웨이와 연결합니다. AWS IoT의 사물을 사용하면 디바이스를 더 쉽게 검색하고 관리할 수 있습니다. 게이트웨이와 사물을 연결하면 게이트웨이가 다른 AWS IoT Core 기능에 액세스할 수 있습니다.

1. 

**게이트웨이 인증서 만들기 및 다운로드**  
게이트웨이가 AWS IoT와 안전하게 통신할 수 있도록 게이트웨이를 인증하려면 LoRaWAN 게이트웨이가 프라이빗 키와 인증서를 AWS IoT Core for LoRaWAN에 제시해야 합니다. AWS IoT이(가) X.509 표준을 사용하여 게이트웨이의 자격 증명을 확인할 수 있도록 **게이트웨이 인증서**를 생성합니다.

   **인증서 생성(Create certificate)** 버튼을 클릭하고 인증서 파일을 다운로드합니다. 이것은 나중에 게이트웨이를 구성하는 데 사용합니다.

1. 

**CUPS 및 LNS 엔드포인트 복사 및 인증서 다운로드**  
AWS IoT Core for LoRaWAN에 연결을 설정할 때 LoraWAN 게이트웨이는 CUPS 또는 LNS 엔드포인트에 연결해야 합니다. CUPS 엔드포인트는 구성 관리도 제공하므로 CUPS 엔드포인트를 사용하는 것이 좋습니다. AWS IoT Core for LoRaWAN 엔드포인트의 신뢰성을 확인하기 위해 게이트웨이는 각 CUPS 및 LNS 엔드포인트에 대해 신뢰 인증서를 사용합니다.

   **복사** 버튼을 클릭하여 CUPS 및 LNS 엔드포인트를 복사해 둡니다. 나중에 게이트웨이를 구성할 때 이 정보가 필요합니다. **서버 신뢰 인증서 다운로드** 버튼을 클릭하여 CUPS 및 LNS 엔드포인트에 대한 신뢰 인증서를 다운로드합니다.

1. 

**게이트웨이 권한에 대한 IAM 역할 생성**  
CUPS(Configuration and Update Server)가 게이트웨이 자격 증명을 관리할 수 있도록 허용하는 IAM 역할을 추가해야 합니다.
**참고**  
이 단계에서는 **IoTWirelessGatewayCertManager** 역할을 생성합니다. 이 역할을 이미 생성했다면 이 단계를 건너뛸 수 있습니다. LoRaWAN 게이트웨이가 AWS IoT Core for LoRaWAN과 연결을 시도하기 전에 이 작업을 수행해야 하며, 한 번만 수행하면 됩니다.

   계정에 대한 **IoTWirelessGatewayCertManager** IAM 역할을 생성하려면 **역할 생성** 버튼을 클릭합니다. 역할이 이미 존재할 경우 드롭다운 목록에서 선택합니다.

   **제출**을 클릭하여 게이트웨이 생성을 완료합니다.

## API를 사용하여 게이트웨이 추가
<a name="lorawan-onboard-gateway-api"></a>

API 또는 CLI를 사용하여 처음으로 게이트웨이를 추가하는 경우 **IoTWirelessGatewayCertManager** IAM 역할을 추가해야 게이트웨이가 AWS IoT Core for LoRaWAN과 연결할 수 있습니다. 역할 생성 방법에 대한 자세한 내용은 [CUPS(Configuration and Update Server)가 게이트웨이 자격 증명을 관리할 수 있도록 IAM 역할을 추가합니다.](lorawan-rfregion-permissions.md#lorawan-onboard-permissions) 단원을 참조하세요.

다음 목록에서는 LoraWAN 게이트웨이 추가, 업데이트 또는 삭제와 관련된 작업을 수행하는 API 작업에 대해 설명합니다.

**AWS IoT 무선 게이트웨이에 대한 AWS IoT Core for LoRaWAN API 작업**
+ [CreateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessGateway.html)
+ [GetWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessGateway.html)
+ [ListWirelessGateways](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessGateways.html)
+ [ UpdateWirelessGateway ](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessGateway.html)
+ [DeleteWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessGateway.html)

AWS IoT Core for LoRaWAN 리소스 생성 및 관리에 사용할 수 있는 작업 및 데이터 유형의 전체 목록은 [AWS IoT 무선 API 참조](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html)를 참조하세요.

**AWS CLI를 사용하여 게이트웨이를 추가하는 방법**  
AWS CLI를 사용하여 [create-wireless-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-wireless-gateway.html) 명령으로 무선 게이트웨이를 만들 수 있습니다. 다음 예제에서는 무선 LoRaWAN 디바이스 게이트웨이를 만듭니다. 게이트웨이 인증서 및 프로비저닝 자격 증명과 같은 추가 세부 정보가 포함된 `input.json` 파일을 제공할 수도 있습니다.

**참고**  
여기에 표시된 CLI 명령에 해당하는 AWS API의 메서드를 사용하여 API로 이 절차를 수행할 수도 있습니다.

```
aws iotwireless create-wireless-gateway \
    --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \
    --name "myFirstLoRaWANGateway" \
    --description "Using my first LoRaWAN gateway"
    --cli-input-json input.json
```

사용할 수 있는 CLI에 대한 자세한 내용은 [AWS CLI 참조](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html)를 참조하세요.