# Agregar una puerta de enlace a AWS IoT Core para LoRaWAN
<a name="lorawan-onboard-gateway-add"></a>

Puede agregar la puerta de enlace a AWS IoT Core para LoRaWAN mediante la consola de o la CLI. 

Antes de agregar su puerta de enlace, le recomendamos que tenga en cuenta los factores mencionados en la sección **Antes de incorporar su puerta de enlace** de [Incorporar las puertas de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateways.md).

Si es la primera vez que agrega la puerta de enlace, le recomendamos que use la consola. Si, en su lugar, desea agregar la puerta de enlace mediante la CLI, debe haber creado ya el rol de IAM necesario para que la puerta de enlace pueda conectarse con AWS IoT Core para LoRaWAN. Para obtener más información acerca de cómo crear el rol, consulte [Agregue un rol de IAM para permitir que el servidor de configuración y actualización (CUPS) administre las credenciales de la puerta de enlace](lorawan-rfregion-permissions.md#lorawan-onboard-permissions).

## Agregar etiquetas a una puerta de enlace mediante la consola
<a name="lorawan-onboard-gateway-console"></a>

Vaya a la página **Introducción de [AWS IoT Core para LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing)** de la consola de AWS IoT, elija **Introducción** y, a continuación, elija **Agregar puerta de enlace**. Si ya ha agregado una puerta de enlace, seleccione **Ver puerta de enlace** para ver la puerta de enlace que ha agregado. Si desea agregar más puertas de enlace, elija **Agregar puerta de enlace**. 

1. 

**Proporcionar los detalles de la puerta de enlace y la información de banda de frecuencia**  
Utilice la sección **Detalles de la puerta de enlace** para proporcionar información sobre los datos de configuración del dispositivo, como el EUI de la puerta de enlace y la configuración de la banda de frecuencia.
   + 

**EUI de la puerta de enlace**  
El EUI (identificador único extendido) del dispositivo de puerta de enlace individual. El EUI es un código alfanumérico de 16 dígitos, por ejemplo `c0ee40ffff29df10`, que identifica de forma exclusiva una puerta de enlace de su red LoRaWAN. Esta información es específica de su modelo de puerta de enlace y puede encontrarla en su dispositivo de puerta de enlace o en su manual de usuario.
**nota**  
El EUI de la puerta de enlace es diferente de la dirección MAC de la red inalámbrica que puede ver impresa en su dispositivo de puerta de enlace. El EUI sigue un estándar EUI-64 que identifica de forma exclusiva la puerta de enlace y, por lo tanto, no se puede volver a utilizar en otras Cuenta de AWS y regiones.
   + 

**Banda de frecuencia (RFRegion)**  
La banda de frecuencia de la puerta de enlace. Puede elegir entre `US915`, `EU868`, `AU915` o `AS923-1`, según lo que admita su puerta de enlace y del país o la región desde la que se conecte físicamente la puerta de enlace. Para obtener más información sobre las bandas, consulte [Considere la posibilidad de seleccionar bandas de frecuencia LoRa para sus puertas de enlace y la conexión del dispositivo](lorawan-rfregion-permissions.md#lorawan-frequency-bands).

1. 

**Especifique los datos de configuración de la puerta de enlace inalámbrica (opcional)**  
Estos campos son opcionales y puede usarlos para proporcionar información adicional sobre la puerta de enlace y su configuración.
   + 

**Nombre, descripción y etiquetas de la puerta de enlace**  
La información de estos campos opcionales proviene de la forma en que organiza y describe los elementos de su sistema inalámbrico. Puede asignar un **nombre** a la puerta de enlace, usar el campo **Descripción** para proporcionar información sobre la puerta de enlace y utilizar **Etiquetas** para agregar pares de metadatos clave-valor sobre la puerta de enlace. Para obtener más información sobre cómo nombrar y describir sus recursos, consulte [Descripción de los recursos de AWS IoT Wireless](iotwireless-describe-resources.md).
   + 

**Configuración de LoRaWAN mediante subbandas y filtros**  
Opcionalmente, también puede especificar los datos de configuración de LoRaWAN, como las subbandas que desea utilizar y los filtros que pueden controlar el flujo de tráfico. Para ver el tutorial, puede omitir este paso. Para obtener más información, consulte [Configurar las subbandas y capacidades de filtrado de la puerta de enlace](lorawan-subband-filter-configuration.md).

1. 

**Asociar un objeto de AWS IoT a la puerta de enlace**  
Especifique si desea crear un objeto de AWS IoT y asociarlo a la puerta de enlace. Los objetos de AWS IoT incluidos pueden facilitar la búsqueda y la administración de los dispositivos. Al asociar un objeto a la puerta de enlace, la puerta de enlace puede acceder a otras características de AWS IoT Core.

1. 

**Crear y descargar el certificado de la puerta de enlace**  
Para autenticar su puerta de enlace y poder comunicarse de forma segura con AWS IoT, su puerta de enlace LoRaWAN debe presentar una clave privada y un certificado a AWS IoT Core para LoRaWAN. Cree un **certificado de puerta de enlace** para AWS IoT poder verificar la identidad de su puerta de enlace mediante el estándar X.509.

   Haga clic en el botón **Crear certificado** y descargue los archivos del certificado. Los usará más adelante para configurar su puerta de enlace.

1. 

**Copiar los puntos de conexión de CUPS y LNS, y descargar los certificados**  
Su puerta de enlace LoRaWAN debe conectarse a un puntos de conexión de CUPS o LNS cuando establece una conexión a AWS IoT Core para LoRaWAN. Le recomendamos que use el punto de conexión de CUPS, ya que también proporciona administración de la configuración. Para verificar la autenticidad de los puntos de conexión de AWS IoT Core para LoRaWAN, su puerta de enlace utilizará un certificado de confianza para cada uno de los puntos de conexión de CUPS y LNS.

   Haga clic en el botón **Copiar** para copiar los puntos de conexión de CUPS y LNS. Necesitará esta información más adelante para configurar la puerta de enlace. A continuación, elija el botón **Descargar los certificados de confianza del servidor** para descargar los certificados de confianza de los puntos de conexión de CUPS y LNS.

1. 

**Crear el rol de IAM para los permisos de la puerta de enlace**  
Debe agregar un rol de IAM que permita al servidor de configuración y actualización (CUPS) administrar las credenciales de la puerta de enlace.
**nota**  
En este paso, se crea el rol **IoTWirelessGatewayCertManager**. Puede omitir el paso si ya ha creado este rol. Debe hacerlo antes de que una puerta de enlace LoRaWAN intente conectarse a AWS IoT Core para LoRaWAN; sin embargo, solo debe hacerlo una vez.

   Para crear el rol de IAM **IoTWirelessGatewayCertManager** para su cuenta, elija el botón **Crear rol**. Si el rol ya existe, selecciónelo en la lista desplegable.

   Haga clic en **Enviar** para completar la creación de la puerta de enlace.

## Agregar una puerta de enlace mediante la API
<a name="lorawan-onboard-gateway-api"></a>

Si va a agregar una puerta de enlace por primera vez mediante la API o la CLI, debe agregar el rol de IAM **IoWirelessGatewayCertManager** para que la puerta de enlace pueda conectarse con AWS IoT Core para LoRaWAN. Para obtener más información sobre el funcionamiento del rol, consulte las siguiente sección [Agregue un rol de IAM para permitir que el servidor de configuración y actualización (CUPS) administre las credenciales de la puerta de enlace](lorawan-rfregion-permissions.md#lorawan-onboard-permissions).

En las siguientes listas, se describen las acciones API que realizan tareas asociadas a agregar, actualizar o eliminar una puerta de enlace LoRaWAN.

**Acciones de API de AWS IoT Wireless para puertas de enlace de AWS IoT Core para LoRaWAN**
+ [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)

Para ver la lista completa de las acciones y los tipos de datos disponibles para crear y administrar recursos de AWS IoT Core para LoRaWAN, consulte la [referencia de la API de AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html).

**Cómo utilizar la AWS CLI para agregar una puerta de enlace**  
Puede utilizar la AWS CLI para crear una puerta de enlace inalámbrica mediante el comando [create-wireless-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-wireless-gateway.html). En el siguiente ejemplo se crea una puerta de enlace inalámbrica de dispositivo LoRaWAN. También puede proporcionar un archivo `input.json` que contenga detalles adicionales, como el certificado de la puerta de enlace y las credenciales de aprovisionamiento.

**nota**  
También puede realizar este procedimiento con la API utilizando los métodos de la API de AWS que corresponden a los comandos CLI que se muestran aquí. 

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

Para obtener información sobre las CLI que puede usar, consulte la [referencia de AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html)