# ゲートウェイを 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 ロールを既に作成済みである必要があります。ロールを作成する方法については、「[Configuration and Update Server (CUPS) がゲートウェイ認証情報を管理することを許可するための 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 は `c0ee40ffff29df10` などの 16 桁の英数字コードであり、LoRaWAN ネットワーク内のゲートウェイを一意に識別します。この情報はゲートウェイモデルに固有のものであり、ゲートウェイデバイスまたはそのユーザーマニュアルに記載されています。
**注記**  
ゲートウェイの EUI は、ゲートウェイデバイスに表示される Wi-Fi MAC アドレスとは異なります。EUI は、ゲートウェイを一意に識別する EUI-64 標準に準拠しているため、他の AWS アカウント とリージョンで再利用できません。
   + 

**周波数帯域 (RFRegion)**  
ゲートウェイの周波数帯。ゲートウェイがサポートするもの、およびゲートウェイの物理的な接続元の国または地域に応じて、`US915`、`EU868`、`AU915`、または `AS923-1` から選択できます。帯域の詳細については、[ゲートウェイとデバイス接続用の LoRa 周波数帯域の選択を検討する](lorawan-rfregion-permissions.md#lorawan-frequency-bands) を参照してください。

1. 

**ワイヤレスゲートウェイ設定データを指定する (オプション)**  
これらのフィールドはオプションで、ゲートウェイとその設定に関する追加情報を提供するために使用できます。
   + 

**ゲートウェイの名前、説明、タグ**  
これらのオプションフィールドの情報は、ワイヤレスシステムの要素をどのように編成および説明するかによって決まります。ゲートウェイに**名前**を追加し、[**Description**] (説明) フィールドを使用してゲートウェイに関する情報を提供し、**タグ**を使用してゲートウェイに関するメタデータのキーと値のペアを追加できます。リソースの命名と説明の詳細については、[AWS IoT Wireless リソースについて説明する](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 標準を使用してゲートウェイの ID を確認できるように、**ゲートウェイ証明書**を作成します。

   [**Create certificate**] (証明書の作成) ボタンをクリックして、証明書ファイルをダウンロードします。これらはゲートウェイを設定するために後で使用します。

1. 

**CUPS エンドポイントと LNS エンドポイントをコピーし、証明書をダウンロードする**  
LoRaWAN ゲートウェイは、AWS IoT Core for LoRaWAN への接続を確立するときに、CUPS エンドポイントまたは LNS エンドポイントに接続する必要があります。CUPS エンドポイントでは設定管理も提供されるため、CUPS エンドポイントを使用することをお勧めします。AWS IoT Core for LoRaWAN エンドポイントの真正性を確認するために、ゲートウェイは CUPS エンドポイントおよび LNS エンドポイントごとに信頼証明書を使用します。

   [**Copy**] (コピー) ボタンをクリックして CUPS エンドポイントと LNS エンドポイントをコピーします。この情報はゲートウェイを構成するために後で必要になります。次に、[**Download server trust certificates**] (サーバー信頼証明書のダウンロード) ボタンをクリックして、CUPS エンドポイントおよび LNS エンドポイントの信頼証明書をダウンロードします。

1. 

**ゲートウェイのアクセス許可のための IAM ロールを作成する**  
Configuration and Update Server (CUPS) がゲートウェイ認証情報を管理することを許可する IAM ロールを追加する必要があります。
**注記**  
このステップでは、**IoTWirelessGatewayCertManager** ロールを作成します。すでにこのロールを作成している場合は、このステップをスキップできます。LoRaWAN ゲートウェイが AWS IoT Core for LoRaWAN との接続を試みる前に、これを行う必要があります。ただし、実行する必要があるのは 1 回だけです。

   アカウントに **IoTWirelessGatewayCertManager** IAM ロールを作成するには、[**Create role**] (ロールの作成) ボタンをクリックします。ロールが既に存在する場合は、ドロップダウンリストから選択します。

   [**Submit**] (送信) をクリックして、ゲートウェイの作成を完了します。

## API を使用してゲートウェイを追加する
<a name="lorawan-onboard-gateway-api"></a>

API または CLI を使用して初めてゲートウェイを追加する場合は、ゲートウェイが AWS IoT Core for LoRaWAN と接続できるように **IoTWirelessGatewayCertManager** IAM ロールを追加する必要があります。ロールの作成方法については、「[Configuration and Update Server (CUPS) がゲートウェイ認証情報を管理することを許可するための IAM ロールを追加する](lorawan-rfregion-permissions.md#lorawan-onboard-permissions)」セクションを参照してください。

以下に、LoRaWAN ゲートウェイの追加、更新、削除に関連するタスクを実行する API アクションを示します。

**AWS IoT Core for LoRaWAN ゲートウェイ向けの AWS IoT Wireless 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 Wireless API reference](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)」を参照してください。