Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Administración de puntos de conexión del dispositivo principal Cuando utiliza la detección en la nube, almacena los puntos de conexión del agente de MQTT para los dispositivos principales en el servicio en la nube de AWS IoT Greengrass . Los dispositivos cliente se conectan AWS IoT Greengrass para recuperar estos puntos finales y otra información para sus dispositivos principales asociados. Para cada dispositivo principal, puede administrar los puntos de conexión de forma automática o manual. + **Administración automática de los puntos de conexión con un detector de IP** Puede implementar el [componente detector de IP](ip-detector-component.md) para administrar automáticamente los puntos de conexión de los dispositivos principales si tiene una configuración de red no compleja, por ejemplo, si los dispositivos cliente están en la misma red que el dispositivo principal. No puede utilizar el componente detector de IP si el dispositivo principal está detrás de un enrutador que reenvía el puerto agente de MQTT al dispositivo principal, por ejemplo. El componente detector de IP también es útil si se implementa en grupos de objetos, ya que administra los puntos de conexión de todos los dispositivos principales del grupo de objetos. Para obtener más información, consulte [Uso del detector de IP para administrar automáticamente los puntos de conexión](#use-ip-detector). + **Administración manual de los puntos de conexión** Si no puede utilizar el componente detector de IP, debe administrar manualmente los puntos de conexión de los dispositivos principales. Puede actualizar estos puntos de conexión con la consola o la API. Para obtener más información, consulte [Administración manual de los puntos de conexión](#manually-manage-endpoints). **Topics** + [Uso del detector de IP para administrar automáticamente los puntos de conexión](#use-ip-detector) + [Administración manual de los puntos de conexión](#manually-manage-endpoints) ## Uso del detector de IP para administrar automáticamente los puntos de conexión Si tiene una configuración de red sencilla, como los dispositivos de cliente en la misma red que el dispositivo principal, puede implementar el [componente detector de IP](ip-detector-component.md) para hacer lo siguiente: + Supervise la información de conectividad de red local del dispositivo principal de Greengrass. Esta información incluye los puntos de conexión de la red del dispositivo principal y el puerto en el que opera el agente de MQTT. + Informe la información de conectividad del dispositivo principal al servicio AWS IoT Greengrass en la nube. El componente detector de IP sobrescribe los puntos de conexión que se configuran manualmente. **importante** La AWS IoT política del dispositivo principal debe permitir el `greengrass:UpdateConnectivityInfo` permiso para usar el componente detector de IP. Para obtener más información, consulte [AWS IoT políticas para las operaciones del plano de datos](device-auth.md#iot-policies) y [Configure la política de AWS IoT cosas](connect-client-devices.md#configure-iot-policy-requirement). Puede realizar uno de los siguientes procedimientos para implementar el componente detector de IP: + Utilice la página **Configurar la detección** en la consola. Para obtener más información, consulte [Configuración de la detección en la nube (consola)](connect-client-devices.md#configure-cloud-discovery-console). + Cree y revise las implementaciones para incluir el detector de IP. Puede usar la consola o la AWS API para administrar las implementaciones. AWS CLI Para obtener más información, consulte [Crear implementaciones](create-deployments.md). ### Implementación del componente detector de IP (consola) 1. En el menú de navegación de la [consola de AWS IoT Greengrass](https://console.aws.amazon.com/greengrass), elija **Componentes**. 1. En la página **Componentes**, elija la pestaña **Componentes públicos** y, luego, elija **aws.greengrass.clientdevices.IPDetector**. 1. En la página **aws.greengrass.clientdevices.IPDetector**, elija **Implementar**. 1. En **Agregar a la implementación**, elija una implementación existente para revisarla o cree una nueva y, a continuación, elija **Siguiente**. 1. Si opta por crear una nueva implementación, elija el dispositivo principal o el grupo de objetos de destino para la implementación. En la página **Especificar el destino**, en **Destino de la implementación**, elija un dispositivo principal o un grupo de objetos y, a continuación, elija **Siguiente**. 1. En la página **Seleccionar componentes**, compruebe que el componente **aws.greengrass.clientdevices.IPDetector** esté seleccionado y elija **Siguiente**. 1. En la página **Configurar componentes**, seleccione **aws.greengrass.clientdevices.IPDetector** y haga lo siguiente: 1. Seleccione **Configurar componente**. 1. En el cuadro **Configurar aws.greengrass.clientdevices.IPDetector**, en **Actualizar configuración**, en **Configuración para combinar**, puede introducir una actualización de configuración para configurar el componente detector de IP. Puede especificar una de las siguientes opciones de configuración: + `defaultPort`: (opcional) el puerto del agente MQTT para informar cuando este componente detecta direcciones IP. Debe especificar este parámetro si configura el agente MQTT para que utilice un puerto diferente al puerto predeterminado 8883. + `includeIPv4LoopbackAddrs`— (Opcional) Puede habilitar esta opción para detectar y reportar las direcciones de IPv4 bucle invertido. Estas son direcciones IP, por ejemplo, `localhost`, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema. + `includeIPv4LinkLocalAddrs`— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones locales de los IPv4 [enlaces](https://en.wikipedia.org/wiki/Link-local_address). Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática. + `includeIPv6LoopbackAddrs`— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones de IPv6 bucle invertido. Estas son direcciones IP, por ejemplo, `localhost`, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema. Debe configurar `includeIPv4Addrs` en `false` y `includeIPv6Addrs` en `true` para utilizar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción. + `includeIPv6LinkLocalAddrs`— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones locales de los IPv6 [enlaces](https://en.wikipedia.org/wiki/Link-local_address). Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática. Debe configurar `includeIPv4Addrs` en `false` y `includeIPv6Addrs` en `true` para utilizar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción. + `includeIPv4Addrs`: (opcional) el valor predeterminado está establecido en verdadero. Puede activar esta opción para publicar IPv4 las direcciones que se encuentran en el dispositivo principal. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción. + `includeIPv6Addrs`— (Opcional) Puede activar esta opción para publicar IPv6 las direcciones que se encuentran en el dispositivo principal. Configure `includeIPv4Addrs` en `false` para usar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción. La actualización de la configuración podría parecerse al siguiente ejemplo. ``` { "defaultPort": "8883", "includeIPv4LoopbackAddrs": false, "includeIPv4LinkLocalAddrs": false } ``` 1. Elija **Confirmar** para cerrar el cuadro y, a continuación, elija **Siguiente**. 1. En la página **Configurar ajustes avanzados**, mantenga los ajustes de configuración predeterminados y seleccione **Siguiente**. 1. En la página **Revisar**, elija **Implementar**. La implementación puede tardar hasta un minuto para completarse. ### Implementación del componente detector de IP (AWS CLI) Para implementar el componente detector de IP, cree un documento de implementación que incluya `aws.greengrass.clientdevices.IPDetector` en el objeto `components` y especifique la actualización de configuración del componente. Siga las instrucciones en [Crear implementaciones](create-deployments.md) para crear una implementación nueva o revisar una implementación existente. Puede especificar cualquiera de las siguientes opciones para configurar el componente detector de IP cuando cree el documento de implementación: + `defaultPort`: (opcional) el puerto del agente MQTT para informar cuando este componente detecta direcciones IP. Debe especificar este parámetro si configura el agente MQTT para que utilice un puerto diferente al puerto predeterminado 8883. + `includeIPv4LoopbackAddrs`— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones de IPv4 bucle invertido. Estas son direcciones IP, por ejemplo, `localhost`, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema. + `includeIPv4LinkLocalAddrs`— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones locales de los IPv4 [enlaces](https://en.wikipedia.org/wiki/Link-local_address). Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática. + `includeIPv6LoopbackAddrs`— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones de IPv6 bucle invertido. Estas son direcciones IP, por ejemplo, `localhost`, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema. Debe configurar `includeIPv4Addrs` en `false` y `includeIPv6Addrs` en `true` para utilizar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción. + `includeIPv6LinkLocalAddrs`— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones locales de los IPv6 [enlaces](https://en.wikipedia.org/wiki/Link-local_address). Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática. Debe configurar `includeIPv4Addrs` en `false` y `includeIPv6Addrs` en `true` para utilizar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción. + `includeIPv4Addrs`: (opcional) el valor predeterminado está establecido en verdadero. Puede activar esta opción para publicar IPv4 las direcciones que se encuentran en el dispositivo principal. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción. + `includeIPv6Addrs`— (Opcional) Puede activar esta opción para publicar IPv6 las direcciones que se encuentran en el dispositivo principal. Configure `includeIPv4Addrs` en `false` para usar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción. El siguiente ejemplo de documento de implementación parcial especifica declarar el puerto 8883 como puerto agente de MQTT. ``` { ..., "components": { ..., "aws.greengrass.clientdevices.IPDetector": { "componentVersion": "2.1.1", "configurationUpdate": { "merge": "{\"defaultPort\":\"8883\",}" } } } } ``` ## Administración manual de los puntos de conexión Puede administrar manualmente los puntos de conexión del agente de MQTT para los dispositivos principales. Cada punto de conexión del agente de MQTT tiene la siguiente información: **Punto de conexión** (`HostAddress`) Una dirección IP o una dirección DNS donde los dispositivos de cliente pueden conectarse a un agente de MQTT en el dispositivo principal. **Port** (`PortNumber`) El puerto en el que opera el agente de MQTT en el dispositivo principal. Puede configurar este puerto en el [componente agente de MQTT de Moquette](mqtt-broker-moquette-component.md), que utiliza de forma predeterminada el puerto 8883. **Metadatos** (`Metadata`) Metadatos adicionales para proporcionarlos a los dispositivos de cliente que se conectan a este punto de conexión. **Topics** + [Administración de los puntos de conexión (consola)](#manually-manage-endpoints-console) + [Administración de puntos de conexión (AWS CLI)](#manually-manage-endpoints-cli) + [Administración de puntos de conexión (API)](#manually-manage-endpoints-api) ### Administración de los puntos de conexión (consola) Puede usar la AWS IoT Greengrass consola para ver, actualizar y eliminar los puntos finales de un dispositivo principal. **Cómo administrar los puntos de conexión de un dispositivo principal (consola)** 1. Vaya a la [consola de AWS IoT Greengrass](https://console.aws.amazon.com/greengrass). 1. Elija **Dispositivos principales**. 1. Elija el dispositivo principal que desee administrar. 1. En la página de detalles del dispositivo principal, elija la pestaña **Client devices (Dispositivos cliente)**. 1. En la sección de **puntos de conexión del agente de MQTT**, puede ver los puntos de conexión del agente de MQTT del dispositivo principal. Seleccione **Administrar puntos de conexión**. 1. En el cuadro **Administrar puntos de conexión**, agregue o elimine los puntos de conexión del agente de MQTT para el dispositivo principal. 1. Elija **Actualizar**. ### Administración de puntos de conexión (AWS CLI) Puede usar AWS Command Line Interface (AWS CLI) para administrar los puntos finales de un dispositivo principal. **nota** Como la compatibilidad con dispositivos cliente AWS IoT Greengrass V2 es retrocompatible AWS IoT Greengrass V1, puedes utilizar AWS IoT Greengrass V2 nuestras operaciones de AWS IoT Greengrass V1 API para gestionar los puntos finales principales de los dispositivos. **Cómo obtener puntos de conexión para un dispositivo principal (AWS CLI)** + Ejecute cualquiera de los siguientes comandos: + [greengrassv2: get-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrassv2/get-connectivity-info.html) + [hierba verde: get-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html) **Cómo actualizar los puntos de conexión de un dispositivo principal (AWS CLI)** + Ejecute cualquiera de los siguientes comandos: + [hierba verde v2: update-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrassv2/update-connectivity-info.html) + [hierba verde: update-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrass/update-connectivity-info.html) ### Administración de puntos de conexión (API) Puede usar la AWS API para administrar los puntos finales de un dispositivo principal. **nota** Como la compatibilidad con dispositivos cliente AWS IoT Greengrass V2 es retrocompatible AWS IoT Greengrass V1, puedes utilizar AWS IoT Greengrass V2 nuestras operaciones de AWS IoT Greengrass V1 API para gestionar los puntos finales principales de los dispositivos. **Para obtener puntos finales para un dispositivo principal (API)AWS** + Ejecute cualquiera de las siguientes operaciones: + [V2: GetConnectivityInfo](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_GetConnectivityInfo.html) + [V1: GetConnectivityInfo](https://docs.aws.amazon.com/greengrass/v1/apireference/getconnectivityinfo-get.html) **Para actualizar los puntos finales de un dispositivo principal (AWS API)** + Ejecute cualquiera de las siguientes operaciones: + [V2: UpdateConnectivityInfo](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_UpdateConnectivityInfo.html) + [V1: UpdateConnectivityInfo](https://docs.aws.amazon.com/greengrass/v1/apireference/updateconnectivityinfo-put.html)